Created : 15 April 2015
Last Modified : 03 May 2018

***********************************************************************************
Contents:

A. SUMMARY
B. FILE STRUCTURE
C. INSTALLATION INSTRUCTION
D. HOW TO USE
E. CONFIGURATION SETTINGS
F. DATABASE TABLES MODIFIED
G. LANGUAGE SETTINGS CHANGED
H. CHANGE LOGS
I.
TROUBLESHOOTING
J.
FAQ
K. COPYRIGHT NOTICE
L. TERMS AND CONDITIONS

***********************************************************************************

A. SUMMARY
==========

This interface is for use with Currency Converter module.

***********************************************************************************

B. FILE STRUCTURE
===================

Files included in the zip are:
- $readme_currencyconversion.txt
- admin\currencyconverter_setup.asp
- admin\currencyconverter_setup_config.asp
- admin\currencyconverter_setup_process.asp
- admin\shopa_updatecurrency.asp
- admin\shopa_updatecurrency_subs.asp
- admin\shopxmltransport_currency.asp
- admin\json\aspJSON1.17
- admin\sqlscripts\currencyconverter\*

***********************************************************************************

C. INSTALLATION INSTRUCTION
============================

1. Upload all the files into your shopping cart folder.

2. Log into super admin and execute setup file, eg: http://www.yourdomain.com/yourshoppingcartfolder/youradminfolder/currencyconverter_setup.asp

3. After setup the module, would be redirected Module configuration page for configure the module.

After installation, you can start to use this addon.

VPASP's Currency Conversion addon allows you to easily update the conversion table.

***********************************************************************************

D. HOW TO USE
===============

1. Login to your VPASP control panel.

2. Change URL to http://www.yourdomain.com/yourshoppingcartfolder/youradminfolder/shopa_updatecurrency.asp.

You are done.

All of your existing currency rates will be automatically updated with the new rates.

Note :

For all the currency types you accept, please ensure the "cid" in the currency table (ADVANCED SETTINGS > INTERNATIONAL > VIEW/EDIT CURRENCY) matches the 3-letter abbreviation below:

AED-UAE Dirham
AFA-Afghanistan Afghani
ALL-Albanian Lek
ANG-Neth Antilles Guilder
ARS-Argentine Peso
AUD-Australian Dollar
AWG-Aruba Florin
BBD-Barbados Dollar
BDT-Bangladesh Taka
BHD-Bahraini Dinar
BIF-Burundi Franc
BMD-Bermuda Dollar
BND-Brunei Dollar
BOB-Bolivian Boliviano
BRL-Brazilian Real
BSD-Bahamian Dollar
BTN-Bhutan Ngultrum
BWP-Botswana Pula
BZD-Belize Dollar
CAD-Canadian Dollar
CHF-Swiss Franc
CLP-Chilean Peso
CNY-Chinese Yuan
COP-Colombian Peso
CRC-Costa Rica Colon
CUP-Cuban Peso
CVE-Cape Verde Escudo
CYP-Cyprus Pound
CZK-Czech Koruna
DJF-Dijibouti Franc
DKK-Danish Krone
DOP-Dominican Peso
DZD-Algerian Dinar
EEK-Estonian Kroon
EGP-Egyptian Pound
ETB-Ethiopian Birr
EUR-Euro
FKP-Falkland Islands Pound
GBP-British Pound
GHC-Ghanian Cedi
GIP-Gibraltar Pound
GMD-Gambian Dalasi
GNF-Guinea Franc
GTQ-Guatemala Quetzal
GYD-Guyana Dollar
HKD-Hong Kong Dollar
HNL-Honduras Lempira
HRK-Croatian Kuna
HTG-Haiti Gourde
HUF-Hungarian Forint
IDR-Indonesian Rupiah
ILS-Israeli Shekel
INR-Indian Rupee
IQD-Iraqi Dinar
ISK-Iceland Krona
JMD-Jamaican Dollar
JOD-Jordanian Dinar
JPY-Japanese Yen
KES-Kenyan Shilling
KHR-Cambodia Riel
KMF-Comoros Franc
KPW-North Korean Won
KRW-Korean Won
KWD-Kuwaiti Dinar
KYD-Cayman Islands Dollar
KZT-Kazakhstan Tenge
LAK-Lao Kip
LBP-Lebanese Pound
LKR-Sri Lanka Rupee
LRD-Liberian Dollar
LSL-Lesotho Loti
LTL-Lithuanian Lita
LVL-Latvian Lat
LYD-Libyan Dinar
MAD-Moroccan Dirham
MDL-Moldovan Leu
MGF-Malagasy Franc
MKD-Macedonian Denar
MMK-Myanmar Kyat
MNT-Mongolian Tugrik
MOP-Macau Pataca
MRO-Mauritania Ougulya
MTL-Maltese Lira
MUR-Mauritius Rupee
MVR-Maldives Rufiyaa
MWK-Malawi Kwacha
MXN-Mexican Peso
MYR-Malaysian Ringgit
MZM-Mozambique Metical
NAD-Namibian Dollar
NGN-Nigerian Naira
NIO-Nicaragua Cordoba
NOK-Norwegian Krone
NPR-Nepalese Rupee
NZD-New Zealand Dollar
OMR-Omani Rial
PAB-Panama Balboa
PEN-Peruvian Nuevo Sol
PGK-Papua New Guinea Kina
PHP-Philippine Peso
PKR-Pakistani Rupee
PLN-Polish Zloty
PYG-Paraguayan Guarani
QAR-Qatar Rial
ROL-Romanian Leu
RUB-Russian Rouble
SAR-Saudi Arabian Riyal
SBD-Solomon Islands Dollar
SCR-Seychelles Rupee
SDD-Sudanese Dinar
SEK-Swedish Krona
SGD-Singapore Dollar
SHP-St Helena Pound
SIT-Slovenian Tolar
SKK-Slovak Koruna
SLL-Sierra Leone Leone
SOS-Somali Shilling
SRG-Surinam Guilder
STD-Sao Tome Dobra
SVC-El Salvador Colon
SYP-Syrian Pound
SZL-Swaziland Lilageni
THB-Thai Baht
TND-Tunisian Dinar
TOP-Tonga Pa'anga
TRL-Turkish Lira
TRY-Turkey Lira
TTD-Trinidad&Tobago Dollar
TWD-Taiwan Dollar
TZS-Tanzanian Shilling
UAH-Ukraine Hryvnia
UGX-Ugandan Shilling
USD-U.S. Dollar
UYU-Uruguayan New Peso
VEB-Venezuelan Bolivar
VND-Vietnam Dong
VUV-Vanuatu Vatu
WST-Samoa Tala
XAF-CFA Franc (BEAC)
XAG-Silver Ounces
XAU-Gold Ounces
XCD-East Caribbean Dollar
XOF-CFA Franc (BCEAO)
XPD-Palladium Ounces
XPF-Pacific Franc
XPT-Platinum Ounces
YER-Yemen Riyal
YUM-Yugoslav Dinar
ZAR-South African Rand
ZMK-Zambian Kwacha
ZWD-Zimbabwe Dollar


***********************************************************************************

E. CONFIGURATION SETTINGS
=================

NONE


F. DATABASE TABLES MODIFIED
===========================

NONE

***********************************************************************************

G. LANGUAGE SETTINGS CHANGED
============================

NONE

***********************************************************************************

H. CHANGE LOGS
============================

2015.11.27 - update new currency converter provider
2016.03.04 - XML: To support TLS1.2
2016.04.13 - fixed variables declaration issue
2016.05.03 - Updated new provider URL
2017.11.08 - Update new provider URL
2018.03.23 - Fine tuning on code how to communicate with new provider
2018.05.02 - Compatible with v9

***********************************************************************************

I. TROUBLESHOOTING
============================

If you are experiencing an error, chance that the 3rd party server providing the currency conversion service is down or under maintenance.
Please perform the update again in a later time.

If you are still experiencing issues, please submit a ticket to our helpdesk at https://helpdesk.vpasp.com and our support team will assist you.


***********************************************************************************

J. FAQ
============================

NONE

***********************************************************************************
K. COPYRIGHT NOTICE
============================

Copyright (c) 1999-2023 Rocksalt International Pty. Ltd.
All rights reserved.

This software and documentation constitute a published work and
contains valuable trade secrets and proprietary information
belonging to Rocksalt International Pty. Ltd. .
None of the foregoing material may be copied,
duplicated or disclosed without the express written permission
of Rocksalt International Pty. Ltd. .

LICENSEE ACCEPTS VP-ASP Shopping Cart "AS IS" "WITH ALL FAULTS",
Rocksalt International Pty. Ltd. accepts no responsibility for the
operation or performance of the VP-ASP Shopping Cart.
The entire risk of use and consequences of use of the
VP-ASP Shopping Cart falls completely on the Licensee
and Rocksalt International Pty. Ltd. shall not be liable in any respect
for any claims, loss or injury alleged to have resulted
from use of or in reliance on VP-ASP Shopping Cart.

Licensee acknowledges that it has read the foregoing
disclaimers of warranty and limitation of liability
and understands that Licensee assumes
the entire risk of using VP-ASP Shopping Cart.


***********************************************************************************

L. TERMS AND CONDITIONS
============================
ROCKSALT INTERNATIONAL GRANTS TO THE LICENSEE A NON-EXCLUSIVE,
NON-SUB LICENSABLE, NONTRANSFERABLE LICENSE
TO INSTALL AND USE THIS APPLICATION ON A SINGLE DOMAIN FOR
A SINGLE SHOP.

THE CODE IN THE APPLICATION MAY BE MODIFIED FOR USE IN
SETTING UP A SINGLE SHOPPING SITE ON THE WORLD WIDE WEB.

LICENSEE MAY MAKE A COPY OF THE APPLICATION FOR
BACK-UP AND ARCHIVAL PURPOSES, PROVIDED THAT ANY COPY
MUST CONTAIN ALL PROPRIETARY NOTICES INCLUDED
WITH THE APPLICATION.

LICENSEE IS PROHIBITED FROM SELLING OR DISTRIBUTING
THE APPLICATION IN ANY MANNER.

LIMITATION OF LIABILITY.

ROCKSALT INTERNATIONAL AND ITS LICENSORS SHALL
NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE OR ANY
THIRD PARTY AS A RESULT OF USING OR DISTRIBUTING THIS
APPLICATION.

IN NO EVENT WILL ROCKSALT INTERNATIONAL OR ITS LICENSORS
BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA,
OR FOR DIRECT, INDIRECT, SPECIAL,
CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES,
HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LI
ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE,
EVEN IF ROCKSALT INTERNATIONAL HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.