Skip to content
Multi-Currency

Multi-Currency

Show shop prices in the visitor's currency without touching how orders and
payments work.

How it works

  • Add display currencies (e.g. USD, GBP, PLN) with a symbol and a rate:

how much of that currency 1 unit of your base shop currency costs.

  • Currencies marked ECB auto-update refresh daily from the European

Central Bank reference rates (no API keys; any base currency works via
cross-rates). Manual currencies keep whatever rate you type.

  • A floating currency switcher appears on the site when at least one

display currency is active. The choice is remembered in a cookie for
180 days.

  • Every price rendered through the shop's {price} tag is converted and

formatted with the currency's own decimals.

Orders stay in the base currency

Checkout, order totals and payment gateways always use the base shop
currency — converted prices are display only. This is the safe standard:
Stripe/PayPal receive exactly the amount and currency they were configured
for, and your accounting stays in one currency.

Setup checklist

  1. Add currencies in Currencies (e.g. code USD, symbol $).
  2. Press Update rates from ECB once, then add the daily cron line

shown on the page.

  1. Done — the switcher appears on the site automatically (can be disabled

in settings; themes may also place links to /multicurrency/set/{code}
wherever they like).

Requires the Shop plugin.

Version Date Requires Size
1.0.0 2026-08-24 PHP >=8.3 · Celena >=3.6 16 KB

Initial release: display currencies with ECB auto-update via cross-rates, manual rates, per-currency decimals, floating switcher with cookie memory, daily cron refresh; orders remain in the base currency.

Requirements

  • PHP >=8.3 or newer
  • Celena CMS >=3.6 or newer

Installation

After purchase you receive a license key. Install the package from the client admin panel — it will ask for the key on activation.

  1. Open Plugins/Themes in your Celena admin panel.
  2. Click “Install from file” and upload the downloaded archive (or use “Install from marketplace” if connected).
  3. Activate the package — for paid packages, enter the license key when prompted.

Full installation guide in the documentation →