支持与销售:(888) 806-3081
申请我的免费试用

贵金属市场的#1软件提供商

我们在这里为您提供帮助

查看我们的教程、技术指南和 API 文档。

免费试用 nFusion 软件 14 天。

200+

联网经销商

99.99%

平台正常运行时间

10000+

产品

我们能帮你什么吗?

我们专业的支持团队随时为您解答任何问题或挑战。无论您需要技术指导还是需要帮助了解我们的服务,我们只需点击一下即可为您提供所需的解决方案。

视频教程

4 Videos

在 nFusion Solutions,我们的现货价格来自值得信赖的全球供应商精选网络,包括领先的全球交易所和金融机构,例如 SIX集团 (瑞士证券交易所)、晨星、瑞银、盛宝银行、摩根士丹利、AFX 和法国巴黎银行。我们使用专有的置信度评分系统持续监控这些实时数据,以确保数据最准确、及时和可靠。

我们的系统会筛选最可靠的报价并过滤异常值,从而计算出最佳买卖价 (BBO)。在此基础上,我们得出一个清晰的中间价,并根据当前市场状况构建均衡的买卖价。

想要更深入地了解这一切是如何运作的吗? 阅读我们关于贵金属现货价格的完整指南 ›

如果现货价格似乎没有更新,可能是因为市场休市。贵金属的市场交易时间对应于 CME Globex 金属期货交易时间

配置金属的自定义现货定价:

  1. 登录您的 nFusion 仪表板 作为管理员。
  2. 导航至 “金属价格配置” 主页上的部分。
  3. 启用自定义覆盖 切换该部分顶部的开关。启用后:
    • 您可以选择设置 “到期日” 日期。这决定了您的自定义定价何时到期并自动恢复为全球现货价格。
  4. 配置单个金属的现货价格:
    在切换和到期日期下方,您将看到一个列出每种受支持金属的表格:
    金、银、铂、钯、铑和铜。

    对于每种金属,您可以:

    • 设置 固定出价 和/或 固定卖价 价值来锁定特定的价格。
    • 应用 出价调整 或者 询问调整 自动增加或减少现货价格。

    例如:
    设定黄金的固定卖价为 $1,215.75,点击黄金的铅笔图标,输入 1215.75 在 固定卖价 字段,然后保存。
    要动态调整价格,请输入 0.5 在 询问调整 和 -0.5 在 出价调整 相对于实时现货价格,将您的卖价提高 50¢,并将您的出价降低 50¢。

  5. 编辑金属定价:
    点击您想要配置的金属旁边的铅笔图标。这将打开一个编辑对话框,您可以在其中输入相应金属的所需值。

有许多 影响现货价格计算方式的因素 以及它们的显示方式。

  1. 站点 Y 可能使用不同的数据源。如果他们使用不同的数据提供商,由于计算、交付、缓存和时间安排的差异,他们的现货价格几乎肯定会略有不同。
  2. 站点 Y 可能会对全球现货价格进行调整,以影响其站点显示定价数据的方式。
  3. 站点 Y 可能与您的站点有所不同,例如速度、延迟、交付、缓存、轮询间隔和代码。

要访问 XML 或 JSON 格式的现货价格数据,请先登录您的 nFusion 仪表板. 从仪表板:

转到“连接”页面并向下滚动到“API 密钥”部分。

点击相应市场数据 API 密钥的“文档”列中的“查看”按钮,即可访问详细的使用说明,包括支持的格式和端点。.

默认情况下,API 响应以 JSON 格式返回。如果您更喜欢 XML 格式,可以在请求中设置相应的 Accept 标头 (application/xml),或使用格式查询参数(例如 ?format=xml)。由于 JSON (application/json) 具有广泛的兼容性和性能,我们建议在大多数情况下使用 JSON。

HTTP 403(禁止访问)响应,子状态码为 502,通常表示您的 API 请求已超出速率限制。如果您在短时间内发出过多调用,就会发生这种情况。

To resolve this, reduce the number of API requests you’re making per second. Implementing caching on your server or delaying certain requests can help stay within the allowed limits.

对于高频用例,请考虑尽可能批处理或聚合您的请求,以优化效率并保持在允许的范围内。

要访问 nFusion Solutions API,您需要一个或多个 API 令牌,具体取决于您的用例。要查找您的 API 令牌,请执行以下操作:

  1. 登录到您的 nFusion 仪表板。
  2. 导航至“连接”页面。
  3. 找到 API 密钥部分来查看您的令牌并访问相应的文档以获取完整的实施细节。

您的 API 令牌属于敏感凭证,应妥善保管。切勿在客户端代码(例如浏览器中运行的 JavaScript)中公开它们,因为这可能会让其他人查看并滥用您的令牌。建议您使用安全代理通过您自己的服务器路由请求,例如:

https://yoursite.com/proxy/metals/spot

该服务器端代理可以使用您的令牌安全地调用 nFusion API,同时使其对公众隐藏。

为了提高性能并减少冗余 API 调用,我们强烈建议您在代理服务器上实施缓存。这可确保多个客户端请求不会导致 nFusion API 的调用率达到 1:1。

发出 API 请求时,请根据需要使用以下 HTTP 标头:

  • 接受:建议值为 application/json。对于 XML,请使用 application/xml。
  • 接受编码:使用 deflate、gzip 进行压缩并获得更快的响应。
  • 内容类型:对于带有正文的 POST 或 PUT 请求,请使用 application/json。
  • 用户代理:我们建议将其设置为您的客户 ID,以便进行识别。

如需进一步指导,请参阅仪表板链接的 API 文档。

使用您的管理员电子邮件地址登录警报服务门户。以管理员身份登录管理 URL 后,您将看到以下选项:

  • 设置提醒电子邮件的营销信息
  • 立即向所有用户发送促销信息
  • 导出用户列表
  • 管理电子邮件模板

Choose on the second option, send a promotional message now to all users. This option allows the admin to push a message at any time to all users who have opted in to receive news and promotional messages. After choosing the second option, you will be directed to a new page containing a text entry box where you may add your desired message.

Once you have finished creating your message, simply click the Send button. Subsequently, a page will display the results of your message. These results contain information regarding the message. For example, you will be shown how many notifications were sent out with further detail pertaining to whether or not they were push or SMS notifications. This allows you to understand how many people your message is reaching and how it is reaching them, therefore allowing you to enhance your marketing strategies.

我们已经测试并确认了与 WordPress 插件商店中三个最受欢迎的多货币插件的兼容性。这些插件将开箱即用 我们的插件 从版本 2.9.9 开始。如果您使用的插件版本不低于 2.9.9,货币切换插件可能不兼容。请注意它们经过测试的版本。

  1. CURCY – WooCommerce 的多货币
  2. WOOCS – WooCommerce 货币切换器
  3. WooCommerce 货币切换器

如果您没有使用我们已确认在提到的列表中兼容的插件之一 这里,有几件事需要寻找。 我们的插件 depends on the get woocommerce_currency() function which returns the current WooCommerce currency code. If your currency switcher plugin is not updating the WooCommerce currency then our plugin will not update the product prices with the new currency.

The other thing that may be causing your plugin to not work properly is the priority at which the woocommerce_product_get_price filter is set. As of version 2.9.9, our Product Catalog plugin is setting the priority of the aforementioned filter to 10000 in an attempt for our hook to be run last. If the priority of said filter in the currency plugin is higher than 10000, it may be overriding the price that is being returned from your nFusion Bullion Pricing Engine.

如果 我们的免费插件 不支持您特定的所需行为,如果您选择,您可以修改插件的本地副本以具有自定义行为。如果您决定修改插件,请记住以下注意事项:
  1. We do not offer support for modified versions of our plugins. Once you have modified the code from its public source all development support for that plugin is out of scope for our team.
  2. If you modify your local copy and don’t disable auto-updates for that plugin, then the next time we release a new version your local changes will be overwritten and lost.
  3. If you do disable auto-updates and modify your local copy you will no longer receive upgrades when we release them. This me you will not receive the benefit of future bug fixes and/or feature enhancements. It may be possible for your developer to examine the code in the public repository and merge in the changes, but our team can provide no support for the merge, nor for any of the code of your customized plugin.

为此,您必须使用我们支持的货币切换器插件之一。如果您使用受支持的货币切换器,您有两个选择:

  1. 使用我们的 WordPress 图表和小部件插件: As of version 1.2.4, our widgets plugin will work out of the box with any of the aforementioned supported currency switchers
  2. Use our currency helper script: The currency helper script is implemented in a very similar fashion to our default widget scripts. You simply need to paste a script into the page where you would like to display the widget. If you would like to use this option, please visit our 有关如何实现货币助手脚本的教程.

You can personalize the styling of your widgets through the nFusion Dashboard app. To get started, follow these steps:

访问小部件页面: 登录您的 nFusion 仪表板 并导航到小部件页面。

编辑小部件: In the widgets page, locate the widget you want to customize, and click the ‘edit’ pencil icon in the actions column. This action will take you to the widget’s editor screen.

定制部分: On the widget’s editor screen, you’ll find two main sections:

  • 文件上传部分: 此部分允许您上传文件,例如 CSS 和(JS,仅在高级小部件包中可用)以及图像文件。
  • 小部件设置部分: Here, you can configure specific widget settings. In this guide, we’ll focus on the file upload section and explore how to upload a custom CSS file.

在你开始之前:

在上传您的自定义 CSS 之前,我们强烈建议您查看我们的 CSS 最佳实践 文档以确保您的样式应用没有任何冲突。

上传自定义 CSS:

要上传自定义 CSS 文件,请按照下列步骤操作:

  1. Click the ‘upload’ icon button under the ‘Upload CSS’ column. This action will open a file explorer, allowing you to select the CSS file you wish to upload.
  2. Once you’ve selected a CSS file, you’ll receive a confirmation message confirming that your CSS file has been successfully uploaded.

预览您的更改:

To see your customizations in action, return to the widgets page and click the ‘preview’ button for the widget you’ve just edited. This will open a widget preview page where you can view your new CSS styling.

CSS 应用程序故障排除:

如果您发现自定义 CSS 未应用,请考虑以下解决方案:

  • 清除缓存并硬重新加载:
    • 使用 Control+Shift+I (Windows/Linux) 或 Option+Command+I (Mac),或者通过工具 > 开发人员 > 开发人员工具,或者右键单击并选择“检查”,打开开发人员控制台。
    • 按住或右键单击刷新图标。
    • Choose “Empty Cache and Hard Reload” from the dropdown.
  • 检查 CSS 特异性:
    • Open the Developer Console and inspect the element you want to style. In the “Styles” panel on the right-hand side, ensure that your CSS rule is not crossed out. If it is, this indicates a different CSS rule may have higher specificity.
  • 验证 CSS 选择器和文件:
    • 检查 CSS 选择器及其顺序中的拼写错误。
    • Ensure the CSS file you uploaded is the correct one by using the Developer Console’s “Network” tab and finding the CSS request corresponding to your custom CSS file.

如果以上解决方案均无效,请联系我们的支持团队 support@nfusionsolutions.com. When reporting your issue, be sure to include all the steps you’ve taken to resolve the problem before reaching out. This will help us provide the quickest possible solution to your customization needs.

To do this, each widget must have a unique ID so that when they are loaded into the page, there are no JavaScript errors or conflicts. Therefore, when you are adding multiple instances of the same widget to a single page, you need to change the ID of the DIV element so that it is unique within that page; then, modify the src attribute within the script by adding “/your-id” to the end of the root domain.

By changing the ID and modifying the src, you are telling the script which DIV element to load the chart into. For example, here is a default chart widget script that has been copied from the preview page:


<div id='c528ee05-722d-4762-a635-213197f7b8b4' style='width:100%;height:100%;'></div>
<script>
    (function () {
        var t = document.getElementsByTagName('script')[0];
        var s = document.createElement('script');
        s.async = true;
        s.src =
            'https://widget.nfusionsolutions.com/widget /script/chart/1/32796899-2cc3-4454-ac51-2c95c78799af/c528ee05-722d-4762-a635-213197f7b8b4';
        t.parentNode.insertBefore(s, t);
    })();
</script>

现在假设您想在同一页面上添加另一个图表(例如,可能要更改选定的符号)。下面是将同一小部件的第二个实例添加到单个页面的样子:


<div id='my-custom-id' style='width:100%;height:100%;'></div>
<script>
    (function(){
        var t = document.getElementsByTagName('script')[0];
        var s = document.createElement('script'); s.async = true;
        s.src = 'https://widget.nfusionsolutions.com/widget/script/chart/1/32796899-2cc3-4454-ac51-2c95c78799af/c528ee05-722d-4762-a635-213197f7b8b4/my-custom-id';
        t.parentNode.insertBefore(s, t);
    })();
</script>

请注意,除了 DIV 元素 ID 和 src 属性的结尾之外,所有内容都相同。

To do this, you must connect the two elements, both the button and the iframe, via JavaScript. This tutorial will use the example of creating a button that changes the selected symbol of a chart.
First, start by adding your desired event listener. In this example, since we are using a button we would add a click event. Once you have added the event listener to the button element, create a function that will manipulate the iframe and call it from within the click event. Now, this function will run every time the button is clicked.
Next, you will need to get access to the iframe element. Once you have access, you may then manipulate its attributes. In this example, we will be manipulating the “src”. Once you get the src of the iframe, you simply need to replace or override that src URL with the new desired src URL.
例如,默认图表 src URL 如下所示:“https://widget.nfusionsolutions.com/widget/chart/1/fya3e32-e870-adf20-a9f3-c88c636f7s8d/188e705d-23afa-45dd-fce21-09c8298af4f2”
如果您想在单击按钮时更改符号,则 src URL 将如下所示:“https://widget.nfusionsolutions.com/widget/chart/1/fya3e32-e870-adf20-a9f3-c88c636f7s8d/188e705d- 23afa-45dd-fce21-09c8298af4f2?选定=银”
When you replace the src URL in the JavaScript the chart iframe will then update and display the new src URL.
下面是使用 jQuery 将图表所选交易品种切换为白银的示例代码片段:
let button = $('.sample-button'),
    widget = $('#188e705d-23afa-45dd-fce21-09c8298af4f2');
button.click(changeSymbol());

function changeSymbol() {
    widget.children("iframe").attr("src", "https://widget.nfusionsolutions.com/widget/script/chart/1/6e98ae99-d878-43a2-81f0-a2528bd3d47e/5444e580-e249-426f-b07f-d23c19049c08" + "?selected= silver");
}

要使用我们的货币助手实现您的小部件,有两个简单的步骤。

1. Ensure that the helper script is available before attempting to use it, you must add the following script within your header:


<script src="https://widgetcdn.nfusionsolutions.com/asset/static/1/common/1/js/currency-interop.min.js"></script>

2. Once the script is available to use, you can add a widget to the page by using code similar to the following:


<div id='YOUR-WIDGET-ID' style='width:100%;height:100%;'></div>
<script>
    (function(){
         nFSCurrencyHelper.init('YOUR-WIDGET-SCRIPT-SRC-URL');
     })();
</script>

Simply replace “YOUR-WIDGET-ID” in the above script with the ID that is in your widgets preview page script. Then similarily, replace the “YOUR-WIDGET-SCRIPT-SRC-URL” with the url being assigned to the s.src variable that is in your widgets preview page script.
该脚本与我们的默认小部件脚本非常相似,不同之处在于您需要使用“nFSCurrencyHelper.init”函数并将小部件的 src 传递给该函数。

Open your web browser and go to the nFusion Dashboard at https://dashboard.nfusionsolutions.com/. If you are not already signed in, you will be directed to the login page.

You can sign in using an existing Google, Microsoft, Apple, or Facebook account, as long as that account uses the same email address associated with your nFusion Dashboard invitation.

For example, if your Dashboard invitation was sent to a Gmail/Google Workspace address, select Google on the login page to authenticate with your Google account. This allows you to securely access your nFusion Dashboard without creating a separate password.

If your email address is not connected to one of the available social login providers, select Sign up now at the top of the login page. From there, you can create an account using your email address and a password of your choice.

Once your account is created or authenticated, you can log in and begin accessing your nFusion Dashboard.

要使用 nFusion Shopify 应用,您必须拥有 nFusion 产品定价引擎 service. If you do not currently have a subscription, please 联系我们的销售团队 for assistance.

1. Install the Shopify App

从 Shopify App Store 安装 nFusion Shopify 应用程序.

During installation, Shopify will ask you to approve the required app permissions. Review and accept the permissions to complete the installation.

2. Configure the App Settings

Once the app is installed, open the nFusion app from your Shopify admin.

You will need to configure the following settings:

  • 目录子域
  • 目录销售渠道
  • 目录 API 密钥

Your API Key and available Sales Channels can be found in your nFusion 仪表板.

3. 设置您的销售渠道

In the nFusion Dashboard, choose the sales channel you want to use for Shopify. You can use an existing sales channel or 创建新的, such as Website.

The selected sales channel determines which products are synced to your Shopify store.

To learn how to assign products to a sales channel, please refer to the 销售渠道分配设置指南.

4. Confirm Product SKUs

Before completing the integration, confirm that each product SKU in the nFusion Dashboard exactly matches the corresponding product SKU in Shopify.

SKU matching is required for price updates to work correctly. If a SKU does not match, nFusion will not be able to update pricing for that product in Shopify.

5. Complete the Integration

After the app is installed and all settings are configured, email support@nfusionsolutions.com 完成整合。

Our support team will complete the remaining setup steps and confirm when the integration is ready to use.

The Precious Metals Product Prices for WooCommerce can automatically re-index products when the Action Scheduler plugin is installed and active on your WordPress website.

Action Scheduler allows WordPress to process tasks in the background, which helps the nFusion plugin update and re-index WooCommerce products more efficiently.

What is Action Scheduler?

Action Scheduler is a scalable background processing tool for WordPress. It is commonly used by WordPress and WooCommerce plugins to manage larger queues of scheduled tasks without requiring server-level access.

Action Scheduler is developed and maintained by 自动, the company behind WordPress.com and WooCommerce, with significant early development completed by 不会飞的.

How to install and activate Action Scheduler

To install Action Scheduler on your WordPress website:

  1. Download the .zip archive of the latest 稳定发布.
  2. 在您的 WordPress 管理仪表板中,转到 Plugins → Add New → Upload Plugin.
  3. Select the .zip file you downloaded.
  4. Click Install Now.
  5. Once installation is complete, click 激活.

You can also install Action Scheduler by cloning the Git repository into your site’s wp-content/plugins folder.

How product re-indexing works

Once Action Scheduler is installed and active, the Product Catalog Plugin will automatically use it to re-index your WooCommerce products in the background.

This allows product re-indexing to run asynchronously, helping WooCommerce continue operating normally while the plugin processes product updates.

To use the nFusion plugin with WordPress and WooCommerce, you must have an active subscription to the nFusion Product Pricing Engine. If you do not currently have a subscription, please contact our sales team for assistance.

1.安装并激活插件

在您的 WordPress 管理仪表板中,转到 插件 → 添加新插件.

Search for and install the Precious Metals Product Prices for WooCommerce plugin. Once the plugin has been installed, select 激活.

2. Configure the nFusion Settings

激活后,前往 设置 → nFusion 设置 from the WordPress toolbar.

输入所需的配置详细信息:

  • 目录子域
  • 目录销售渠道
  • 目录 API 密钥

You can find your API Key and available Sales Channels in the nFusion Dashboard.

3. 创建或选择销售渠道

In the nFusion 仪表板, choose the sales channel you want to use for this integration. You can use an existing sales channel or 创建新的, such as Website.

The selected sales channel determines which products are eligible for automatic price updates in WooCommerce.

To learn how to assign products to a sales channel, please refer to the 销售渠道分配设置指南.

4. Link WooCommerce Products to nFusion Catalog SKUs

在您的 WordPress 管理仪表板中,转到 产品.

For each product you want to sync, open the Edit Product screen and locate the WooCommerce product SKU field.

输入 nFusion 产品目录中显示的准确 SKU。

SKU matching is required for price updates to work correctly. If a SKU in WooCommerce does not exactly match the corresponding SKU in the nFusion Catalog, nFusion will not be able to update pricing for that product.

5. Complete the Integration

Once these steps are complete, your WordPress plugin will be connected to the nFusion Product Pricing Catalog.

Your eligible WooCommerce products will then be ready to receive automatic price updates based on the products assigned to the selected sales channel.

To change your company name in nFusion, please email support@nfusionsolutions.com with the following information:

  • Your current company name
  • Your new company name
  • Your updated company address, if the address has also changed

Once your request is received, our support team will review the information and update your company record.

To assign products to a sales channel, sign in to your nFusion 仪表板 and go to the 产品 page.

There are two ways to assign products to a sales channel: you can add products individually, or you can add and remove products in bulk.

Option 1: Add products individually

Use this option when you only need to assign one or a few products to a sales channel.

  1. From the 产品 page, find the product you want to update.
  2. Click the pencil icon to edit the product.
  3. 前往 Sales Channels tab.
  4. Select the sales channel you want to assign the product to.
  5. Click Save.

Option 2: Add or remove products in bulk

Use this option when you want to add or remove all products from a specific sales channel at once.

  1. From the 产品 page, click the Product Actions button.
  2. Select View Product Attributes from the menu.
  3. On the Product Attributes page, go to the Sales Channels section.
  4. Select the sales channel you want to update.
  5. Add or remove all products from that sales channel as needed.

Once your changes are saved, the selected products will be associated with that sales channel. Sales channels can then be used to control which products are included in connected integrations, such as Shopify, WooCommerce, or eBay.

Following these best practices will help you get reliable, secure, and efficient performance when working with nFusion APIs.

使用 HTTPS

All API requests must be made over HTTPS using TLS 1.2 or higher.

Unsecured HTTP requests are not supported.

Protect your API tokens

To access nFusion APIs, you will be issued one or more API tokens based on your use case. API tokens are sensitive credentials and should be handled like passwords.

Do not expose your API token in client-side code, such as JavaScript that runs in a browser. Client-side code can be viewed publicly, which could allow your token to be copied and misused.

Instead, make requests to nFusion APIs from your server-side code. A common approach is to use a secure proxy on your own website or application.

例如:

https://yoursite.com/proxy/metals/spot

Your server can securely call the nFusion API using your API token, while keeping the token hidden from public access.

Use caching when possible

If you are using a proxy, we recommend implementing caching so your application does not send a new request to nFusion for every client request.

Caching can improve performance, reduce unnecessary API traffic, and help prevent your application from reaching rate limits.

Follow rate limits

To help avoid throttling, keep API requests under 1 call per second per service.

If rate limits are exceeded, you may receive a 403 Forbidden response with substatus 502.

Optimize API requests

When supported, use query parameters to consolidate requests instead of making multiple separate API calls. This helps reduce API traffic and improves overall efficiency.

Currency request example

Instead of making separate requests like this:

Currencies/summary?pairs=CAD/USD
Currencies/summary?pairs=USD/CAD

Use one combined request:

货币/摘要?货币对=CAD/USD,USD/CAD

Metals request example

Instead of making separate requests for each currency and metal:

Metals/spot/summary?currency=USD&metals=gold
Metals/spot/summary?currency=USD&metals=silver
Metals/spot/summary?currency=USD&metals=platinum
Metals/spot/summary?currency=USD&metals=palladium
Metals/spot/summary?currency=CAD&metals=gold
Metals/spot/summary?currency=CAD&metals=silver
Metals/spot/summary?currency=CAD&metals=platinum
Metals/spot/summary?currency=CAD&metals=palladium

Use one efficient request:

金属/现货/摘要?货币=美元、加元&金属=黄金、白银、铂金、钯金

Recommended HTTP headers

Depending on your use case, the following HTTP headers may be included with your API requests.

接受

We recommend using:

Accept: application/json

XML responses are also supported by using:

Accept: application/xml

For most use cases, JSON is recommended.

接受编码

We recommend using:

Accept-Encoding: deflate,gzip

This allows responses to be compressed, which can improve performance.

内容类型

For POSTPUT requests that include a message body, use:

Content-Type: application/json

用户代理

We recommend setting the 用户代理 header to a unique value, such as your tenant ID, tenant alias, or catalog subdomain.

This can make it easier to locate your API traffic in logs if support assistance is needed.

Additional documentation

For more information, please refer to the API documentation below:

When customizing nFusion widgets, use CSS selectors that are as specific as possible. This helps ensure your custom styles override the default widget styles consistently.

Use nFusion selectors

nFusion widgets include CSS selectors that can be used to customize their appearance.

To find the best selector to use, open your browser’s developer tools and inspect the widget element you want to style. This allows you to see the CSS rules currently being applied and identify the correct selector for your custom styles.

For example, the chart widget may apply a default font family using the following selector:

.nfusionsolutions-com-chart { font-family: '洛拉', 衬线字体;
}

To override the default font family, use the same selector and set your preferred font family:

.nfusionsolutions-com-chart { font-family: '您的自定义字体', 衬线字体;
}

Using the widget’s existing selector helps your custom CSS target the correct element without affecting unrelated parts of your website.

Keep your CSS organized

Organized CSS is easier to maintain, troubleshoot, and update over time.

We recommend grouping related styles together and using comments where helpful, especially if you are customizing multiple widgets or maintaining styles across several pages.

You may also want to follow a CSS structure such as BEM 或者 SMACSS to keep your styles consistent and scalable.

Use CSS tools and linters

CSS tools and linters can help identify errors before they affect your website.

Tools such as Stylelint 或者 CSSLint can help detect syntax issues, formatting problems, and common CSS mistakes. This is especially useful when maintaining custom styles across a larger website or ecommerce store.

Test your changes

After adding or updating custom CSS, test the affected widgets on your website to confirm the styles are being applied correctly.

Be sure to review the widget in different browsers and screen sizes when possible, especially if the changes affect layout, spacing, fonts, or responsive behavior.

Learn more about CSS best practices

If you are newer to CSS, there are many helpful resources available online. Sites such as MDN Web Docs, CSS-Tricks, and Stack Overflow can be useful starting points for learning CSS fundamentals and troubleshooting common styling issues.

Widget types, supported configuration options, and query parameters

nFusion widgets can be customized using both configuration settings查询字符串参数.

Configuration settings define the default behavior for a widget. Once updated, those settings become the default for that widget.

Query string parameters override the default configuration for a specific widget instance. This allows you to use the same widget multiple times on a website while displaying different data or layouts for each instance.

For example, if the default widget currency is set to USD, you can add a query string parameter to a specific chart URL to display that chart in a different currency without changing the default configuration for other widgets.

Standard configuration options

The following configuration options are commonly available across nFusion widgets:

  • Currency: Sets the default currency displayed in the widget.
  • Unit of measure: Sets the default unit of measure displayed in the widget.
  • Auto update: Enables or disables automatic price updates. This is enabled by default.
  • Update interval: Sets how often the widget updates pricing.
  • Link: Redirects users to a specified URL when they click within the widget area.
  • Timezone: Sets the default timezone displayed in the widget.
  • Whitelisted URLs: Controls which URLs are allowed to display the widget.

Standard query string parameters

The following query string parameters can be used to override widget defaults for a specific widget instance:

  • Symbols: ?symbols=

    Changes the symbols displayed in the widget. This can also be used to control the order in which symbols appear.

  • Currency: ?currency=

    Changes the currency used to display prices.

  • Unit of measure: ?unitofmeasure=

    Changes the unit of measure used to display prices.

  • Width: ?width=

    Changes the width of the widget iframe.

  • Height: ?height=

    Changes the height of the widget iframe.

Chart widgets

nFusion chart widgets are available in two versions: V1V2.

The difference between V1 and V2 is the layout of the chart elements. Both versions support the same functionality.

Chart configuration options

  • Display navigation bar: Shows or hides the navigation bar at the bottom of the chart. This is displayed by default.

Chart query string parameters

  • Selected symbol: ?selected=

    Sets the symbol that appears when the chart first loads.

  • Selected timeframe: ?timeframeindex=

    Sets the timeframe that appears when the chart first loads.

  • Chart type: ?charttype=

    Sets the line style displayed in the chart area.

Table widgets

nFusion table widgets are available in six versions:

  • V1: Standard table
  • V2: Carousel table
  • V3: Historical performance table
  • V4: Annual historical performance table
  • V5: Multi-unit table
  • V6: Multi-unit, multi-currency table

V1 and V2 tables

V1 and V2 tables provide the same core functionality. The main difference is the styling and positioning of table elements.

Configuration options

  • Table fields: Controls which fields are displayed in the table.

Available fields include:

  • 出价
  • 改变
  • Change percent
  • 高的
  • 低的
  • Pr. close
  • 打开
  • 最后的

查询字符串参数

V1 and V2 tables support the standard query string parameters.

V3 historical performance table

The V3 table displays historical performance data for a single selected symbol.

The table includes historical data for the following timeframes:

  • One day
  • One week
  • One month
  • Six months
  • One year
  • Five years
  • Ten years
  • Fifteen years

Configuration options

  • Table fields: Controls which fields are displayed in the table.

Available fields include:

  • 出价
  • 改变
  • 高的
  • 低的

查询字符串参数

The V3 historical performance table supports the standard query string parameters.

V4 annual historical performance table

The V4 table displays historical ask and change percent data points for multiple currencies at one-year intervals, up to 40 years.

Configuration options

The V4 table supports the standard configuration options.

查询字符串参数

  • Years: ?years=

    Sets the number of years of historical data displayed.

  • Currency: ?currency=

    A comma-separated list of currencies can be used to display data in multiple currencies.

V5 multi-unit table

The V5 table displays live spot prices for a single metal in multiple units of measure.

Configuration options

  • Table fields: Controls which fields are displayed in the table.

Available fields include:

  • 出价
  • 改变
  • Change percent
  • 高的
  • 低的
  • Pr. close

查询字符串参数

  • Unit of measure: ?unitofmeasure=

    A comma-separated list of units of measure can be used to display data in multiple units.

V6 multi-unit, multi-currency table

The V6 table displays live spot prices for multiple metals across multiple currencies and units of measure.

Configuration options

The V6 table supports the standard configuration options.

查询字符串参数

  • Unit of measure: ?unitofmeasure=

    A comma-separated list of units of measure can be used to display data in multiple units.

  • Currency: ?currency=

    A comma-separated list of currencies can be used to display data in multiple currencies.

Ticker widget

The nFusion spot price ticker displays real-time data in a responsive banner-style layout.

Configuration options

The ticker supports two display modes:

  • Scrolling: Displays ticker elements in a continuous scrolling layout. This is the default setting.
  • Fixed: Removes the scrolling effect and displays ticker elements in a mobile-responsive layout.

The ticker also supports configurable fields.

Available fields include:

  • 出价
  • 改变
  • Change percent
  • 高的
  • 低的
  • Pr. close

查询字符串参数

The ticker supports the standard query string parameters.

RMD calculator widget

The RMD, or required minimum distribution, calculator allows users to estimate their required minimum distribution using a user-friendly chart display.

The calculation is based on user-entered information, including:

  • Age
  • Account balance
  • Whether there is a primary beneficiary
  • Estimated rate of return

Product page widget

The product page widget uses the nFusion Product Catalog to create a full-page product display with live bid and ask prices.

This widget can use catalog features such as sales channels and product families to control which products are displayed.

Widget page

The widget page allows you to display multiple nFusion chart, table, and ticker widgets together in a single page layout.

From the widget page, users can change the symbol, currency, and unit of measure across every widget instance on the page at the same time.

查看支持:

货币: 访问我们的 API文档 在“货币”下,查看路径以“supported”结尾的端点

金属: 访问我们的 API文档 在 Metals 下,查看路径以“supported”结尾的端点

指数: 访问我们的 API文档 在“货币”下,查看路径以“supported”结尾的端点

基准: 访问我们的 API文档 在 Metals 下,查看路径包含“benchmark”的端点

让我们联系吧

了解我们如何提供帮助

如果您需要技术支持或有疑问,请填写以下表格或点击按钮致电。我们的支持时间为 周一至周五上午 8 点至下午 5 点(美国中部标准时间).

需要帮忙?

联系我们的支持团队

让我们帮助您拓展业务

就质量、功能、定制和服务而言,我们的金银软件解决方案无与伦比。让我们帮助您发展业务。