internetrix / currency-converter
在您的 SilverStripe 网站中检索、存储和应用货币转换。
Requires
- silverstripe/framework: ~3.1
This package is not auto-updated.
Last update: 2024-09-28 20:20:01 UTC
README
在您的 SilverStripe 网站中检索、存储和应用货币转换。
安装
composer require internetrix/currency-converter
显示汇率
要输出转换后的货币,请调用 ConvertibleCurrency 类并包含金额。如果金额不是基础货币,请包含金额的货币。如果需要转换为特定货币,请包含该目标货币。 ConvertibleCurrency::convert($amount, $amountCurrency, $targetCurrency)
在模板内部,只需将 "AutoConversion" 添加到输出变量中。要获取货币符号,请附加 "Full"。AutoConversion 还可以接受两个参数:基础货币和目标货币。 <h2>总价: $Total.AutoConversion.Full</h2>
要切换显示汇率,请在 URL 中使用 "uscc" 变量添加目标货币(它将保持会话状态。)例如,要显示澳元: http://somewhere.com/mypage/?uscc=AUD
刷新汇率
要获取最新的货币转换汇率,请使用每日 cron 运行包含的任务。它将所有配置的货币之间的转换填充到数据库中。 /dev/tasks/UpdateCurrencyRatesTask
API 配置
该模块连接到 Fixer.io 以获取欧洲中央银行提供的最新货币转换汇率。目前它报告了 31 种货币。要使用不同的 API,请更新 config.yml latest_currency_rates_api : 'http://api.fixer.io/latest'
货币区域信息列在 yaml 文件中,这不是完整的,可能需要更新。请通过 other_currencies
部分对其进行修改,以包含/排除保存到数据库中的汇率。
注意,还有一个额外的查找 geoplugin.com,以确定当前用户的区域。