internetrix/currency-converter

在您的 SilverStripe 网站中检索、存储和应用货币转换。

安装: 21

依赖项: 0

建议者: 0

安全: 0

星星: 2

关注者: 5

分支: 1

开放问题: 0

类型:silverstripe-module

dev-master 2017-01-18 02:26 UTC

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,以确定当前用户的区域。