The currencies under the Payments tab on the Settings page are a list of all currencies available for your installed payment gateways. Installing payment gateways that support other currencies should add more options to the list. However, you might want to use a currency not supported by any payment gateways. This would be a common scenario for a Bank Transfer-style gateway. In this case, it would be helpful to add a custom currency to your theme.
Adding a currency is easy. Currencies can be added in either a plugin or a child theme. You’ll want to first follow our guide on how to create a child theme, or look at WordPress’s guide to writing plugins.
Payments has a single class that deals with currencies. It is called APP_Currencies
. This class allows you to register new currencies, get information about installed currencies, or format prices using the currency’s symbol.
To add a currency, you’ll want to use APP_Currencies::register_currency()
on the init
hook.
add_action( 'init', 'myplugin_add_currency' ); function myplugin_add_currency(){ // Give your currency a name and symbol $args = array( 'name' => 'My Currency', 'symbol' => 'M' ); // The first argument is the currency code. Usually a 3 letter code. ( United States Dollars = USD ) APP_Currencies::add_currency( 'APP', $args ); } |
note:Please change the
> |
to this character >
Adding this function will add ‘My Currency’ to the list of available currencies on the list. Selecting it will cause prices to be rendered as ‘M10’.
Like this tutorial? Subscribe and get the latest tutorials delivered straight to your inbox or feed reader.