Multi-Currency
by Celena
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
- Add currencies in Currencies (e.g. code
USD, symbol$). - Press Update rates from ECB once, then add the daily cron line
shown on the page.
- 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.
- Open Plugins/Themes in your Celena admin panel.
- Click “Install from file” and upload the downloaded archive (or use “Install from marketplace” if connected).
- Activate the package — for paid packages, enter the license key when prompted.