Tools for dealing with currency display and conversions. You can configure currencies and converters via the Settings page.

• Settings → Currencies
• Settings → Exchange Rates
• Settings → Site Definitions

Official Documentation

This plugin is partially documented in the official October CMS documentation.

Understanding Currency Definitions

There are multiple currency definition types that are important to operation the Currency plugin. Each definition type is described in more detail below.

Default Currency

The default currency is used when there is no multisite context or when there is no currency set in one of the other definitions. In the currency form widget, if the model does not implement the multisite feature, then the value is stored in the default currency.

Note: The default currency is set by opening the Settings → Currencies page and checking the Default checkbox on a currency listed on this page.

Primary / Base Currency

The primary currency is a base currency that sets the currency for use when writing values in a multisite context. For example, if the model implements the multisite feature, then the value is stored in the primary currency set by the active site.

The primary currency is available in Twig as this.site.base_currency and this.site.base_currency_code.

{{ this.site.base_currency_code }}

Note: The primary currency is set by opening the Settings → Site Definitions page and selecting a currency in the Base Currency dropdown.

{{ product.price|currency({ from: this.site.base_currency_code })}}

Display Currency

The display currency has a specific purpose of converting a currency from its stored value before displaying it.

The display currency is available in Twig as this.site.currency and this.site.currency_code.

{{ this.site.currency_code }}

For example, if a value is stored in the primary currency as USD and the site definition has a display currency of AUD.

{{ product.price|currency({
    from: this.site.base_currency_code,
    to: this.site.currency_code
})}}

This can be shortened by setting the site option to true.

{{ product.price|currency({ site: true })}}

Note: The primary currency is set by opening the Settings → Site Definitions page and selecting a currency in the Display Currency dropdown.

The following plugins extend or depend on the plugin

Free

Pay

Invoicing and Accounting

5,395 installations

# 100 in Free of all time.

Free

Pay

Invoicing and Accounting

E-Commerce

Free

Fewo Verwalter plugin

Interface to Fewo-Verwalter software, to display objects, houses and offers. IONCUBE is needed.

2,184 installations

# 409 in Free of all time.

Free

Fewo Verwalter plugin

Interface to Fewo-Verwalter software, to display objects, houses and offers. IONCUBE is needed.

Content, E-Commerce

Free

Money

Easy money management within October

1,479 installations

# 251 in Free of all time.

Free

Money

Easy money management within October

Developer Tools, E-Commerce

$15

Simple CRM

Simple Customer Relationship Management.

38 projects

# 151 in Paid of all time.

$15

Simple CRM

Simple Customer Relationship Management.

Content, Team tools

$25

Let's rent

The core component for building a rental database

3 projects

# 91 in Paid of all time.

$25

Let's rent

The core component for building a rental database

E-Commerce, Events & Calendar

$20

Let's rent cars

The perfect solution for any car rental business

3 projects

# 118 in Paid of all time.

$20

Let's rent cars

The perfect solution for any car rental business

E-Commerce, Events & Calendar

The following theme uses this plugin

$100

Freelance

10 projects

# 30 in Paid of all time.

$100

Freelance

A freelance marketplace website for remote and freelance workers.

Portfolio website