Share and recommend this website:



CS Cart Auto currency exchange rate plugin



The problem:

This tool is very useful if you use more than one currency in your CS Cart online store. In case you use more than one currency you probably know that you need to set your primary currency (for example EUR) and then you need to add your other currencies (for example USD, GBP etc.). You will also need to manually enter an exchange rate for every choosen currency which can be a little bit annoying but necessary. You must set this exchange rate based on your primary choosen currency. If you will do this just once it's not really a problem but as you probably know currency exchange rates changes all the time so in order to get your currencies and store up to date you need to manually update exchange rates for all your choosen currencies all the time. Now this is annoying isn't it? Thats why we create a really simple and useful auto currency exchange rate plugin for your CS Cart store. We need it by ourself and now it's also available to others. Read CS cart review here


About this plugin:

Auto currency exchange rate plugin is basically just a single PHP file which does all the job for you. You simply upload this file, set the path to your CS cart config file and you are ready to go. Well almost ready. In CS cart admin panel you will need to add your currencies which you want to use it in your store and set your default (primary) currency. Now just visit our file with your browser and all your currencies will be updated with current exchange rates from Google API (Click here for example - API output for EUR/USD conversion).

You can also set a CRON job on your server to run our plugin automatically for example once per day or anything like that. When you do this your job with currency exchange rate update is completely automatic. Now you have a time to update other important things in your store.

How to install and use this plugin:

This is not really a plugin but just a single PHP file which handle all the logic and retrieve all the necessary information from your CS-cart config file and your MySql database. So it's pretty easy to install it and here is how you can do this:

1.) Install CS-Cart software to your domain (skip this step if you have CS Cart 4.x.x already installed)
2.) Login to Admin panel and add currencies which you want to use it in your store (Administration->Currencies->Add currency)
3.) Choose your primary currency by checking "primary currency" checbox when adding new currencies or edit existing ones
4.) Make sure you will use RIGHT currency codes for your choosen currencies otherwise our plugin WILL NOT work. Check for currency codes here
5.) Open our plugin file in text editor and change relative path to yours CS-cart config.local.php file
6.) Upload our plugin (file) to your CS cart installation directory or subdirectory (example: INSTALL_DIR/currency)
7.) Visit our plugin URL with your browser (example: www.your-domain.com/currency/currency.php)
8.) If you do everything correctly all your choosen currencies should be updated with current exchange rates
9.) Optionally: Set a CRON job which will run our plugin for example once per day or every XX hours. Now your currency rates are updated automatically (on auto pilot)

Benefits of using this plugin:

Easy to install and use
Fully automatic updates of currency exchange rates in your CS-cart
No matter how many different currencies you use in your online store
Available and tested on CS cart ULTIMATE version: 4.x.x and 3.x.x
You don't need any programmatically skills
Without CS cart code or template changes
Receive email notification (log) every time this plugin runs
You can add additional currency later on
We can install this plugin for you
One time fee

Limitation:

1.) This plugin is tested only in CS Cart Ultimate version: 4.x.x. and 3.x.x If you use previous versions of CS cart and you are interested in our plugin then maybe we can customize this plugin to work with your version too.

2.) At the beginning of your CS cart installation you can choose between 2 different database backends (Mysql and PDO). This plugin works ONLY if you choosed Mysql database.

3.) CURL library in recommended to be installed on your server. This plugin will also work without CURL installed but you will need to change this in our plugin file.

Price and order information:

CS Cart Auto currency exchange rate plugin: 39.90 EUR (one time fee)
Installation: 19.99 EUR (we can install this plugin for you)

Order JUST plugin by Paypal (click bellow):

39.90 EUR
Order plugin + installation by Paypal (click bellow):

59.89 EUR


* Contact us for other payment options
* Once you will pay we will contact you on your Paypal email and send you further instructions


Contact us (Additional questions, comments...):





Frequently asked questions (FAQ):

1.) What this plugin do?
In short and if sets correctly this plugin will update exchange rates for all your choosen currency in your CS Cart online store. All currency exchange rates are added in proper format and added directly into your CS Cart Mysql database. All calculations are based on your primary currency which you set it up in your CS cart admin panel. With setting a CRON job on your server this plugin will work on auto pilot as often as you like (once per day, every xx hours etc.). With this plugin all your prices in all currencies in your online store will be correct and current.

2.) How to install and use it?
For installation read installation guide above. We can also install this plugin for you for additional one time fee. You will also receive installation guide in TXT format with this plugin. Once set up you can simply use this plugin by visiting our plugin URL on your server. Every time you will visit it your currency exchange rates will be updated. Automate this process by seting up CRON job on your server.

3.) Is there any special requirements to use this plugin?
CURL library in recommended but not required. If you will set up notification on your email address (on errors, everytime script runs..) your server must be able to send out emails with php mail() function. Your CS cart MUST USE MySql database! You can choose database backend at the beginning of your CS Cart installation. This plugin (for now) only works and it's tested for MySql database.

4.) How to add/edit/modify new currencies in my CS cart online store?
You can add or edit your store currencies in your CS cart admin panel. Don't worry about our plugin this is just an "extension" to your store. You do everything as you will do it if you don't use our plugin. So login to CS cart admin panel then choose "Administration" and then "Currencies". Then you can add new currencies, set new primary currency, remove currency, make currency active or not. Once you are done with this, run our plugin which will "read" all your settings and changes you made and it will insert an exchange rate for every active currency.

5.) My currencies are not updated once i run this plugin?
There are some things which must be setup correctly in order to everything works as it should. Here are some things you should check:
a.) You added at least one currency in your CS cart admin panel (Administration->Currencies->Add currency)
b.) At least one of your currency in your CS cart is Active (only active currencies are updated!)
c.) You have one currency which is set as a primary currency (Administration->Currencies->Add currency->Primary currency checkbox)
d.) Your database backend is set to Mysql (This plugin for now only works for Mysql database). You choose this at the beginning of your CS cart installation
e.) You enter right currency codes for all your currencies (Example: EUR for Euro, USD for US dollar, RUB for Russian ruble etc.) -> currency codes f.) Your CS cart version is at least 3.x and NOT older
g.) You set your path to config.local.php file and other settings in our plugin file correctly? (Read our help)
h.) Still doesn't work? Contact us

6.) I enter my email address and turn on email notification in plugin file but i don't receive any emails?
Our plugin use basic php mail() function to send out notification emails to your email address. Make sure your server is able to send out mails. Then check if you enter right email address and that you turn on notification by setting $report_send value to 'YES'. After that make sure that you didn't receive email to your spam/junk folder.

7.) Do i get any output when i visit this plugin with my browser?
Once everything is set up correctly and if you visit this plugin URL you will get an output like this:


8.) How will i know that this plugin works when i set a CRON job to run this plugin?
You can turn on an email notification function which will send you an email with report log everytime this plugin is started. This email will look something like this:


You can set email notification in our plugin PHP file by turn on email reporting and with entering your email address. In case you will set a cron job to run this script make sure you will not run it too often (like every minute or so). It's not really a problem with updating your currencies so often but with email notification set to ON you will receive email every minute.

9.) How to run (start) this plugin?
Once you will receive our plugin (single PHP file) you just open it with TXT editor like Notepad or Editplus and change some settings like 'path to your CS cart config.local.php file, enter your email address and maybe turn on email notification function. Then save your changes, upload your file to your domain and visit it with your browser. At least for the first time we recommend that you visit it with your browser so you will know if it works or there are any errors. Once you are sure everything works you can set a CRON job to run our plugin for example twice per day. So you will automate the entire process. Instead of visiting a specific URL twice per day a CRON job will do this for you.

10.) What is CRON job?
A cron job is a Linux command for scheduling a command or script on your server to complete repetitive tasks automatically. Scripts executed as a cron job are typically used to modify files or databases; however, they can perform other tasks that do not modify data on the server, like sending out email notifications.
For example, you can set a cron job to delete temporary files every week so that your disk space is not being used up by unnecessary files. Some scripts, such as Drupal, may even require you to set up a cron job to perform certain functions.

11.) How to set up a CRON job?
Depends from your hosting provider but many hosting providers use CPANEL and bellow is a screenshot of setting a CRON job in CPANEL. You will need to login to your hosting admin panel and look for CRON jobs. Then you will need to specify how often you would like to run our plugin and enter a full path to a script you want to run. For example in our case and for running our plugin twice per day (every 12 hours) you will need to enter something like that: