Download IV. Multi-currency setting
Transcript
“IP checker” User Manual Version: Website: Support: 1.1 http://www.mage-world.com/ http://www.mage-world.com/contacts/ Table and contents I. OVERVIEW ............................................................................................. 3 II. FEATURES ............................................................................................. 3 III. CONFIGURATION .................................................................................. 3 Enable IP Checker................................................................................. 3 Manage IPchecker Rules ...................................................................... 4 Manage URL Exception......................................................................... 4 Manage IP Exception ............................................................................ 5 User Agent List ...................................................................................... 6 Switch Mode .......................................................................................... 6 Hide Store view Switchbox .................................................................... 7 Hide Currency Switchbox ...................................................................... 7 IV. Multi-currency setting ........................................................................... 7 V. Multi-language setting .......................................................................... 9 VI. APPENDIX ............................................................................................ 11 I. OVERVIEW IPchecker first checks IP address of client's computer and bases on the result to define right country or area of this client, then automatically change language and currency on your site to the own ones of this client. NOTE THAT: - IPchecker checks IP address only one time at client's first access and store information of this client's language and currency in cookie. So, IPchecker does not affect on load speed of website. - This module also offers two switch boxes to allow clients changing to other language and currency by themselves. II. FEATURES - Auto-set language and currency for website, basing on analyzing IP address of client's computer. - Allow client change default language and currency to other ones. - Two switch boxes can be displayed or hidden at front-end. - Allow admin to manage URL and IP exception. - Limit its own activity with the purpose of not affecting on site's load speed. - Flexible change for switch box (only change language, on change currency or change both) - Not react with any auto-activities of browsers, search-engines spiders and crawlers, web-directories, download managers, link checkers, proxy servers, web filtering tools, harvesters, spam bots, bad bots. III. CONFIGURATION Enable IP Checker Go to System/Configuration/IP Checker to enable IPchecker first. - Choose Yes to enable IPchecker. - Choose No to disable. In configuration, you have to set rule to help IPchecker work properly. Manage IPchecker Rules - Click on the <Add Rule> button to add new rule - Please insert value in three columns: country, default store view, default currency + Country: insert country code. Ex: DE, CA, US... (View code of all countries at Appendix part or check online at http://www.aurora.se/dialing-codes.htm) Note: - You can insert more than one country code (countries use same language and currency) in one box, comma separated and no space (Ex: DE, CA, US). - To set same language and currency for all countries, instead of country code, please use "*" + Default store view: insert store view code/ID (language as well) + Default currency: insert currency code. Ex: USD, EUR, CAD... (Check online at http://www.aurora.se/dialing-codes.htm) ***Important Note: If you want your website to display any currency, firstly please check at the tab <Currency setup> (Setting/Configuration/Currency Setup) to sure that these currencies was chosen in the field <allow currencies>. You must set currency rate for chosen currencies, too). View detail instruction at Multi-currency setting. Manage URL Exception >> Using this feature if you want to set default language and currency for any URL of your site. - Click on the <Add URLs> button to add new row - Insert right value into the following columns: + URL: copy any URL at URL location and paste into this column Ex: http://test14.good-demo.com/furniture/living-room.html + Description: insert a description here Note that: If client click on any URL exceptions, IP Checker will not run, then currency and language on site will not be changed (it remembers currency and language of latest access/latest session or apply default language and currency with first access.) Manage IP Exception >> Using this feature if you want to set default language and currency for any specific IP address or IP range. - Click on the <Add IPs> button to add new row. - Insert right value into the following columns: + IP: insert a specific IP address (for example: 103.45.68.79) or IP range(format X.X.X.X-X, for example: 103.45.68.79-222). + Description: insert a description here Note that: If client's IP address matches any IP exception, IP Checker will not run, then currency and language on site will not be changed (it remembers currency and language of latest access/latest session or apply default language and currency with first access.) User Agent List >> Using this feature to manage IPchecker's reaction with any information analyst engines (browsers, search-engines spiders and crawlers, web-directories, download managers, link checkers, proxy servers, web filtering tools, harvesters, spam bots, bad bots). IpChecker will have not any reaction when meet these machine's activities (aims to limit its action which can make site reach low speed), basing on their string that you insert. - Click on the button <Add agents> to add new row. - Insert right value to the following columns: + User-Agents String & ID: insert user-agents string + Description: description of the inserted string - You can find user-agents list on internet (Google it or try this link http://www.useragents.org/ ) Switch Mode >> There are three available options: - Switch both currency & language automatically - Only switch currency automatically - Only switch language automatically Hide Store view Switchbox - Choose NO to display the box <Your language> at front-end - Choose Yes to unhide. >> Although you unhide it, IPchecker still work properly. Hide Currency Switchbox - Choose NO to display the box <Your currency> at front-end - Choose Yes to unhide. >> Although you unhide it, IPchecker still work properly. Note: - This box appears when you choose more than one currency at the field <allow currencies> (in Setting/configuration/currency setup). - Must sure that you changed right currency rate at Setting/Manage Currency Rates if use multi-currencies. (View detail at Multi-currency setting) IV. Multi-currency setting 1. Select countries In back-end, go to Setting/Configuration/General/Currency Setup Select the languages that you want to use at the field Allowed Countries. 2. Manage currency rate Go to System/ Manage Currency Rate and insert converting rate for each currency that you have chosen. 3. Display on front-end Go to Setting/Configuration/IP checker and set the field Hide Currency Switchbox to NO. After three steps above, the currency switch box will appear at front-end, and then client can change currency on site by hand. V. Multi-language setting To setup multi-language for your site, you must create a number of stores corresponding to how many languages you want to display (because one store can display one language). 1. Create new store at Setting/Manage Stores 2. Define language for each store at Setting/Configuration/GENERAL/General 3. Insert language translation folder for each language into app/locale For example: fr_FR for France, de_DE for Germany… You can find language translation package of almost countries at http://www.magentocommerce.com/translations 4. See how it works at front-end When the customer change store, they also change language that corresponding to the defined language for this store. VI. APPENDIX Country Code Currency Code AD Andorra AFN Afghanistan, Afghanis AE United Arab Emirates ALL AF Afghanistan DZD Algeria, Dinars AG Antigua & Barbuda AI Anguilla Albania, Leke USD America (United States of America), Dollars USD American Samoa, United States Dollars AL Albania AM Armenia USD American Virgin Islands, United States Dollars AN Netherlands Antilles EUR Andorra, Euro AO Angola AOA Angola, Kwanza AQ Antarctica XCD Anguilla, East Caribbean Dollars AR Argentina XCD AS American Samoa AT Austria AU Australia Antigua and Barbuda, East Caribbean Dollars ARS Argentina, Pesos AW Aruba AMD Armenia, Drams AZ Azerbaijan AWG Aruba, Guilders (also called Florins) BA Bosnia and Herzegovina AUD Australia, Dollars BB Barbados BD Bangladesh EUR Austria, Euro AZN Azerbaijan, New Manats BE Belgium EUR Azores, Euro BF Burkina Faso BSD Bahamas, Dollars BG Bulgaria BHD Bahrain, Dinars BH Bahrain BI Burundi BJ Benin EUR Baleares (Balearic Islands), Euro BDT Bangladesh, Taka BM Bermuda BBD Barbados, Dollars BN Brunei Darussalam XCD Barbuda and Antigua, East Caribbean Dollars BO Bolivia BYR Belarus, Rubles BR Brazil EUR Belgium, Euro BS Bahama BZD Belize, Dollars BT Bhutan Benin, Communauté Financière Africaine Francs (BCEAO) BU Burma (no longer exists) XOF BV Bouvet Island BMD Bermuda, Dollars BW Botswana BY Belarus BTN Bhutan, Ngultrum INR Bhutan, India Rupees BZ Belize BOB Bolivia, Bolivianos CA Canada CC Cocos (Keeling) Islands ANG Bonaire, Netherlands Antilles Guilders (also called Florins) CF Central African Republic BAM Bosnia and Herzegovina, Convertible Marka CG Congo BWP Botswana, Pulas CH Switzerland NOK Bouvet Island, Norway Kroner CI Côte D'ivoire (Ivory Coast) BRL CK Cook Iislands GBP Britain (United Kingdom), Pounds CL Chile USD CM Cameroon Brazil, Real British Indian Ocean Territory, United States Dollars CN China USD British Virgin Islands, United States Dollars CO Colombia BND Brunei Darussalam, Dollars CR Costa Rica BGN Bulgaria, Leva CS Czechoslovakia (no longer exists) XOF Burkina Faso, Communauté Financière Africaine Francs (BCEAO) CU Cuba MMK Burma (Myanmar), Kyats CV Cape Verde CX Christmas Island CY Cyprus BIF Burundi, Francs XOF Côte D'Ivoire, Communauté Financière Africaine Francs (BCEAO) USD Caicos and Turks Islands, United States Dollars CZ Czech Republic DD German Democratic Republic (no longer exists) KHR Cambodia, Riels DE Germany XAF DJ Djibouti Cameroon, Communauté Financière Africaine Francs (BEAC) DK Denmark CAD Canada, Dollars DM Dominica EUR Canary Islands, Euro DO Dominican Republic CVE Cape Verde, Escudos DZ Algeria KYD Cayman Islands, Dollars EC Ecuador XAF Central African Republic, Communauté Financière Africaine Francs(BEAC) XAF Chad, Communauté Financière Africaine Francs (BEAC) EE Estonia EG Egypt EH Western Sahara ER Eritrea CLP Chile, Pesos ES Spain CNY China, Yuan Renminbi ET Ethiopia AUD Christmas Island, Australia Dollars FI Finland AUD Cocos (Keeling) Islands, Australia Dollars FJ Fiji COP Colombia, Pesos FK Falkland Islands (Malvinas) XAF FM Micronesia Communauté Financière Africaine (CFA), Francs FO Faroe Islands KMF Comoros, Francs FR France XPF Comptoirs Français du Pacifique (CFP), Francs GA Gabon XAF Congo/Brazzaville, Communauté Financière Africaine Francs (BEAC) GB United Kingdom (Great Britain) CDF Congo/Kinshasa, Francs GD Grenada NZD Cook Islands, New Zealand Dollars FX France, Metropolitan GE Georgia GF French Guiana CRC Costa Rica, Colones HRK Croatia, Kuna GH Ghana CUP Cuba, Pesos GI Gibraltar GL Greenland ANG Curaço, Netherlands Antilles Guilders (also called Florins) GM Gambia EUR Cyprus, Euro GN Guinea CYP Cyprus, Pounds (expires 2008-Jan-31) GP Guadeloupe CZK Czech Republic, Koruny GQ Equatorial Guinea GR Greece DKK Denmark, Kroner DJF Djibouti, Francs GS South Georgia and the South Sandwich Islands XCD Dominica, East Caribbean Dollars GT Guatemala DOP Dominican Republic, Pesos GU Guam EUR Dutch (Netherlands) Euro GW Guinea-Bissau GY Guyana XCD East Caribbean Dollars HK Hong Kong IDR HM Heard & McDonald Islands USD Ecuador, United States Dollars HN Honduras HR Croatia East Timor, Indonesia Rupiahs EGP Egypt, Pounds EUR Eire (Ireland), Euro HT Haiti SVC El Salvador, Colones HU Hungary USD El Salvador, United States Dollars ID Indonesia GBP England (United Kingdom), Pounds IE Ireland IL Israel XAF Equatorial Guinea, Communauté Financière Africaine Francs (BEAC) IN India ETB Eritrea, Ethiopia Birr IO British Indian Ocean Territory IQ Iraq ERN Eritrea, Nakfa EUR Estonia, Euro IR Islamic Republic of Iran ETB Ethiopia, Birr IS Iceland EUR Euro Member Countries, Euro IT Italy FKP Falkland Islands (Malvinas), Pounds JM Jamaica JO Jordan JP Japan DKK Faroe Islands, Denmark Kroner FJD Fiji, Dollars KE Kenya EUR Finland, Euro KG Kyrgyzstan EUR France, Euro KH Cambodia EUR French Guiana, Euro KI Kiribati XPF French Pacific Islands (French Polynesia), Comptoirs Français du Pacifique Francs KN St. Kitts and Nevis XPF French Polynesia (French Pacific Islands), Comptoirs Français du Pacifique Francs KP Korea, Democratic People's Republic of EUR French Southern Territories, Euro KM Comoros KR Korea, Republic of XPF Futuna and Wallis Islands, Comptoirs Français du Pacifique Francs KY Cayman Islands XAF Gabon, Communauté Financière Africaine Francs (BEAC) KZ Kazakhstan GMD Gambia, Dalasi KW Kuwait LA Lao People's Democratic Republic LB Lebanon GEL Georgia, Lari EUR Germany, Euro LC Saint Lucia GHS Ghana, Cedis LI Liechtenstein GIP Gibraltar, Pounds LK Sri Lanka XAU Gold, Ounces LR Liberia GBP Great Britain (United Kingdom), Pounds LS Lesotho LT Lithuania LU Luxembourg EUR Greece, Euro DKK Greenland, Denmark Kroner LV Latvia XCD Grenada, East Caribbean Dollars LY Libyan Arab Jamahiriya XCD Grenadines (The) and Saint Vincent, East Caribbean Dollars MA Morocco EUR Guadeloupe, Euro ME Republic Of Montenegro USD Guam, United States Dollars MC Monaco MD Moldova, Republic of MG Madagascar GTQ Guatemala, Quetzales GGP Guernsey, Pounds MH Marshall Islands GNF Guinea, Francs ML Mali XOF Guinea-Bissau, Communauté Financière Africaine Francs (BCEAO) MN Mongolia GYD Guyana, Dollars MM Myanmar HTG Haiti, Gourdes MO Macau USD Haiti, United States Dollars MP Northern Mariana Islands MQ Martinique AUD Heard Island and McDonald Islands, Australia Dollars MR Mauritania BAM Herzegovina and Bosnia, Convertible Marka MS Monserrat MT Malta MU Mauritius EUR Holland (Netherlands), Euro EUR Holy See, (Vatican City), Euro MV Maldives HNL Honduras, Lempiras MW Malawi HKD Hong Kong, Dollars MX Mexico HUF Hungary, Forint MY Malaysia ISK Iceland, Kronur MZ Mozambique INR India, Rupees NA Namibia IDR Indonesia, Rupiahs XDR International Monetary Fund (IMF), Special Drawing Rights NF Norfolk Island IRR Iran, Rials NG Nigeria IQD Iraq, Dinars NI Nicaragua EUR Ireland (Eire), Euro NL Netherlands IMP Isle of Man, Pounds NO Norway ILS Israel, New Shekels NP Nepal EUR Italy, Euro NC New Caledonia NE Niger NR Nauru NT Neutral Zone (no longer exists) JMD Jamaica, Dollars NOK Jan Mayen and Svalbard, Norway Kroner NU Niue JPY Japan, Yen JEP Jersey, Pounds NZ New Zealand OM Oman JOD Jordan, Dinars PA Panama PE Peru KZT Kazakhstan, Tenge PF French Polynesia AUD Keeling (Cocos) Islands, Australia Dollars PG Papua New Guinea KES Kenya, Shillings PH Philippines AUD Kiribati, Australia Dollars PK Pakistan PL Poland KPW Korea (North), Won KRW Korea (South), Won PM St. Pierre & Miquelon KWD Kuwait, Dinars PN Pitcairn KGS Kyrgyzstan, Soms PR Puerto Rico LAK Laos, Kips LVL Latvia, Lati LBP Lebanon, Pounds QA Qatar LSL Lesotho, Maloti RE Réunion ZAR Lesotho, South Africa Rand RO Romania LRD Liberia, Dollars RS Republic Of Serbia LYD RU Russian Federation CHF Liechtenstein, Switzerland Francs RW Rwanda LTL PT Portugal PW Palau PY Paraguay SA Saudi Arabia SB Solomon Islands Libya, Dinars Lithuania, Litai EUR Luxembourg, Euro MOP Macau, Patacas SC Seychelles MKD Macedonia, Denars SD Sudan MGA Madagascar, Ariary SE Sweden EUR Madeira Islands, Euro SG Singapore SH St. Helena SI Slovenia SJ Svalbard & Jan Mayen Islands MWK Malawi, Kwachas MYR Malaysia, Ringgits MVR Maldives (Maldive Islands), Rufiyaa SK Slovakia XOF Mali, Communauté Financière Africaine Francs (BCEAO) SL Sierra Leone EUR Malta, Euro SM San Marino SN Senegal SO Somalia SR Suriname MTL Malta, Liri (expires 2008-Jan-31) FKP Malvinas (Falkland Islands), Pounds USD Mariana Islands (Northern), United States Dollars ST Sao Tome & Principe USD Marshall Islands, United States Dollars SU Union of Soviet Socialist Republics (no longer exists) EUR Martinique, Euro SV El Salvador MRO Mauritania, Ouguiyas SY Syrian Arab Republic MUR Mauritius, Rupees SZ Swaziland EUR Mayotte, Euro TC Turks & Caicos Islands AUD TD Chad TF French Southern Territories TG Togo TH Thailand McDonald Islands and Heard Island, Australia Dollars MXN Mexico, Pesos USD Micronesia (Federated States of), United States Dollars USD Midway Islands, United States Dollars TJ Tajikistan EUR Miquelon and Saint Pierre, Euro TK Tokelau MDL Moldova, Lei TM Turkmenistan EUR Monaco, Euro TN Tunisia TO Tonga TP East Timor MNT Mongolia, Tugriks EUR Montenegro, Euro TR Turkey XCD Montserrat, East Caribbean Dollars TT Trinidad & Tobago MAD Morocco, Dirhams TV Tuvalu MZN Mozambique, Meticais TW Taiwan, Province of China TZ Tanzania, United Republic of MMK Myanmar (Burma), Kyats UA Ukraine NAD Namibia, Dollars UG Uganda ZAR Namibia, South Africa Rand UM United States Minor Outlying Islands US United States of America AUD Nauru, Australia Dollars NPR Nepal, Rupees UY Uruguay UZ Uzbekistan VA Vatican City State (Holy See) VC St. Vincent & the Grenadines ANG Netherlands Antilles, Guilders (also called Florins) EUR Netherlands, Euro XCD Nevis and Saint Kitts, East Caribbean Dollars VG British Virgin Islands XPF New Caledonia, Comptoirs Français du Pacifique Francs VI United States Virgin Islands NZD New Zealand, Dollars VE Venezuela VN Viet Nam NIO Nicaragua, Cordobas XOF Niger, Communauté Financière Africaine Francs (BCEAO) VU Vanuatu WF Wallis & Futuna Islands WS Samoa NGN Nigeria, Nairas YD Democratic Yemen (no longer exists) NZD Niue, New Zealand Dollars YE Yemen AUD Norfolk Island, Australia Dollars YT Mayotte USD Northern Mariana Islands, United States Dollars ZA South Africa ZM Zambia ZR Zaire NOK Norway, Kroner OMR Oman, Rials ZW Zimbabwe PKR Pakistan, Rupees ZZ Unknown or unspecified country USD Palau, United States Dollars XPD Palladium, Ounces PAB Panama, Balboa USD Panama, United States Dollars PGK Papua New Guinea, Kina PYG Paraguay, Guarani PEN Peru, Nuevos Soles PHP Philippines, Pesos NZD Pitcairn Islands, New Zealand Dollars XPT Platinum, Ounces PLN Poland, Zlotych EUR Portugal, Euro STD Principe and São Tome, Dobras USD Puerto Rico, United States Dollars QAR Qatar, Rials EUR Réunion, Euro RON Romania, New Lei RUB Russia, Rubles RWF Rwanda, Francs STD São Tome and Principe, Dobras ANG Saba, Netherlands Antilles Guilders (also called Florins) MAD Sahara (Western), Morocco Dirhams XCD Saint Christopher, East Caribbean Dollars SHP Saint Helena, Pounds XCD Saint Kitts and Nevis, East Caribbean Dollars XCD Saint Lucia, East Caribbean Dollars EUR Saint Pierre and Miquelon, Euro XCD Saint Vincent and The Grenadines, East Caribbean Dollars EUR Saint-Martin, Euro USD Samoa (American), United States Dollars WST Samoa, Tala EUR San Marino, Euro SAR Saudi Arabia, Riyals SPL Seborga, Luigini XOF Senegal, Communauté Financière Africaine Francs (BCEAO) RSD Serbia, Dinars SCR Seychelles, Rupees SLL Sierra Leone, Leones XAG Silver, Ounces SGD Singapore, Dollars ANG Sint Eustatius, Netherlands Antilles Guilders (also called Florins) ANG Sint Maarten, Netherlands Antilles Guilders (also called Florins) EUR Slovakia, Euro EUR Slovenia, Euro SBD Solomon Islands, Dollars SOS Somalia, Shillings ZAR South Africa, Rand GBP South Georgia, United Kingdom Pounds GBP South Sandwich Islands, United Kingdom Pounds EUR Spain, Euro XDR Special Drawing Rights LKR Sri Lanka, Rupees SDG Sudan, Pounds SRD Suriname, Dollars NOK Svalbard and Jan Mayen, Norway Kroner SZL Swaziland, Emalangeni SEK Sweden, Kronor CHF Switzerland, Francs SYP Syria, Pounds TWD Taiwan, New Dollars RUB Tajikistan, Russia Rubles TJS Tajikistan, Somoni TZS Tanzania, Shillings THB Thailand, Baht IDR Timor (East), Indonesia Rupiahs TTD Tobago and Trinidad, Dollars XOF Togo, Communauté Financière Africaine Francs (BCEAO) NZD Tokelau, New Zealand Dollars TOP Tonga, Pa'anga TTD Trinidad and Tobago, Dollars TND Tunisia, Dinars TRY Turkey, Lira TMM Turkmenistan, Manats USD Turks and Caicos Islands, United States Dollars TVD Tuvalu, Tuvalu Dollars UGX Uganda, Shillings UAH Ukraine, Hryvnia AED United Arab Emirates, Dirhams GBP United Kingdom, Pounds USD United States Minor Outlying Islands, United States Dollars USD United States of America, Dollars UYU Uruguay, Pesos USD US Virgin Islands, United States Dollars UZS Uzbekistan, Sums VUV Vanuatu, Vatu EUR Vatican City (The Holy See), Euro VEB Venezuela, Bolivares (expires 2008-Jun-30) VEF Venezuela, Bolivares Fuertes VND Viet Nam, Dong USD Virgin Islands (American), United States Dollars USD Virgin Islands (British), United States Dollars USD Wake Island, United States Dollars XPF Wallis and Futuna Islands, Comptoirs Français du Pacifique Francs MAD Western Sahara, Morocco Dirhams YER Yemen, Rials ZMK Zambia, Kwacha ZWD Zimbabwe, Zimbabwe Dollars