Currency Converter

Maian Cart has a built in currency conversion system. This enables visitors to view prices in their own currencies as well as the default system currency. To access this option in the admin area select 'System>Currency Converter'. Currencies are obtained from WebServiceX.Net via its xml feed.

Only currencies shown in the admin area are supported by this option. Use the checkboxes provided to enable/disable currencies. If you don`t specify any currencies, the currency conversion drop down on your storefront will not appear.

Note that clicking the update button in the admin area also updates the currency rates. To manually update you would need to click this button from time to time or have the system auto update via a cron job/tab.

Display Pref / Rate

Specify display preference on how the price should display in your store. Use {PRICE} for the pricing position. Examples:

£{PRICE} - (For UK store)
{PRICE}€ - (For Euro based store)
${PRICE}AUD - (For Australian based store)
${PRICE} - (For US store)

Character entities (for currency symbols) can be used or just static text, ie: GBP{PRICE}

DO NOT use literal symbols (£,€,$) or you may see a ? in your store.

Rate is equivalent to 1 in your base currency. If manually updating rates can be obtained from Oanda.

Auto Update via Cron Job/Tab

IMPORTANT! SimpleXML functions MUST be installed on server for this to work!

The easiest way to make sure your currencies are up to date with the latest rates is to have the system automatically update them. This is done by using a Cron Tab or Cron Job. This is an automated task performed by your server via the time specified. For the currency conversion a daily update would be recommended. /usr/local/bin/php /home/admin/domains/yourdomain.co.uk/public_html/cart/currency-updater.php
php q /home/admin/domains/yourdomain.co.uk/public_html/cart/currency-updater.php
/usr/local/bin/php q /home/admin/domains/yourdomain.co.uk/public_html/cart/currency-updater.php
cmd /k C:\Windows\php\php.exe "C:\website\currency-updater.php" (Windows)
In the windows example. using cmd /k keeps the command line window open. Remove this to close window after execution.

If you don`t understand this, contact your host for assistance. Path is almost always the FULL server path to the cron file.

Cron licence.lic domain encoding error

On some servers the cron may return the following output:

The following encoding error has occured while running this software: The 'licence.lic' file within this installation cannot run on this server. Licence file is encoded for a different domain.

If this happens you need to instead run the 'cron.php' file in your store root. See the notes in that file for further instructions.

Understanding Cron Tabs/Jobs