Difference between revisions of "X-Cart:States"

From X-Cart 4 Classic
Jump to: navigation, search
(Created page with 'Counties are territorial divisions smaller than a state but larger than a city or town. Use of counties in a store is optional. Usage of counties can be enabled/disabled with the…')
 
Line 1: Line 1:
Counties are territorial divisions smaller than a state but larger than a city or town. Use of counties in a store is optional. Usage of counties can be enabled/disabled with the option '<u>Use counties</u>' in <u>General settings->General options</u>.
+
For each of your store's 'active' countries that needs states, you must create a state list. State lists can be created and managed using the '<u>States Management</u>' section of the Admin area (<u>Settings menu->States</u>).
  
Counties in your store can be set up using the '<u>Counties Management</u>' section of the Admin area. This section is only available when use of counties is enabled in <u>General settings->General options</u>. To access the '<u>Counties Management</u>' section, do the following:
+
During X-Cart installation, you can import pre-configured state lists for some countries (For information about importing states, see the chapter [[X-Cart:Installing X-Cart |  Installing X-Cart]]). If, during X-Cart installation, you imported states for your 'active' countries, you can view the respective state lists in the '<u>States Management</u>' section: simply click on a country name link at the top of the '<u>States</u>' dialog box, and the state list for the selected country will be displayed below:
  
# Go to the '<u>States Management</u>' section (<u>Settings menu->States</u>).
 
# In the '<u>States</u>' table, find the name of the state whose counties you wish to access.
 
# Click on the link in the COUNTIES column opposite this state.
 
  
The dialog box '<u>Counties</u>', which you can find in the '<u>Counties Management</u>' section, will help you define counties for the selected state. Before you have created any counties, the dialog box will be empty:
+
<div align="center">[[Image:states1.gif|570px]]
 
 
<div align="center">[[Image:counties.gif|575px]]
 
 
</div>
 
</div>
  
After you create some counties, it will look something like this:
+
By looking at a state list, you can find out the following information for each state:
  
 +
* CODE: The state code (must be unique on a per-country basis). State codes are used for X-Cart's inner processes and also appear in customer addresses on the invoice.
 +
* STATE: The state name.
 +
* COUNTIES: The number of counties in the state ('n/a' is displayed if no counties are defined).
  
<div align="center">[[Image:counties1.gif|575px]]
+
{{Note1|COUNTIES column is displayed only when use of counties in the store is enabled. To enable use of counties, enable the option 'Use counties' in General settings->General options.}}
</div>
 
  
 +
'''Important:''' We cannot guarantee that X-Cart's pre-configured state lists are complete or correct. For example, we haven't been able to find a standard list of counties for the United Kingdom, so the list of UK counties shipped with X-Cart provides a combination of lists from [http://www.gbet.com/AtoZ_counties/ http://www.gbet.com/AtoZ_counties/] and [http://www.ons.gov.uk/about-statistics/geography/products/geog-products-area/names-codes/eurostat/index.html http://www.ons.gov.uk/about-statistics/geography/products/geog-products-area/names-codes/eurostat/index.html] with some corrections added by our clients residing in the UK. Before you use X-Cart's pre-configured state lists in your live store, please ensure they are adequate. You can edit any existing state list by adding, removing or editing the states contained in them as described below.
  
== Adding counties ==
 
  
To add a county for a state:
+
== Adding states ==
  
# Open the '<u>Counties Management</u>' section (Click on the link in the COUNTIES column opposite the name of the state for which you are going to add a county).
+
To add a new state to the list:
# In the '<u>Add new county</u>' section of the '<u>Counties</u>' dialog box, enter the desired county name into the field titled '<u>Enter county name</u>'.
 
# Click the '''Add '''button. The county should be added to the list above. You should see an Information box with a confirmation message.
 
  
 +
# Go to the '<u>States Management</u>' section (<u>Settings menu->States</u>).
 +
# In the '<u>States</u>' dialog box, scroll down to the '<u>Add new state</u>' section.
 +
# Provide the necessary information about the state being added: state code, state name and the country to which the state needs to be added.
 +
# Click the '''Add state''' button. The state should be added. You should see an Information box with a confirmation message. To view the state you have added, click on the name link of the country to which you have added it - the state should be in the list.
  
== Editing counties ==
 
  
You can edit names of existing counties.
+
== Editing states ==
  
To edit a county name:
+
To rename a state or to change a state's code:
  
# Open the '<u>Counties Management</u>' section (Click on the link in the COUNTIES column opposite the name of the state whose county you wish to edit).
+
# Go to the '<u>States Management</u>' section (<u>Settings menu->States</u>).
# In the '<u>Counties</u>' table, replace the existing name of the county with the desired name.
+
# In the '<u>States</u>' dialog box, find the state name or code that needs to be edited.
# Click the '''Update''' button. The county name should be updated. You should see an Information box with a confirmation message.
+
# Change the code and/or the name of the state.
 +
# Click the '''Update''' button to save the changes. The information should be updated. You should see an Information box with a confirmation message.
  
  
== Deleting counties ==
+
== Deleting states ==
  
To delete a county:
+
To delete one or more states:
  
# Open the '<u>Counties Management</u>' section (Click on the link in the COUNTIES column opposite the name of the state whose county you wish to delete).
+
# Go to the '<u>States Management</u>' section (<u>Settings menu->States</u>).
# In the '<u>Counties</u>' table, select the check box in the DELETE column opposite the name of the county that you wish to delete.
+
# In the '<u>States</u>' dialog box, find the states you wish to delete and select the DELETE check boxes opposite their names. You can use the Check all / Uncheck all links to select or unselect all the check boxes on the current  page.
# Click the '''Delete selected''' button. The county should be deleted. You should see an Information box with a confirmation message.
+
# Click the '''Delete selected''' button. The states selected for deletion should be removed. You should see an Information box with a confirmation message.
  
  
== Multilingual support for counties ==
+
== Multilanguage state names ==
  
Multilingual support for counties is currently not implemented in X-Cart.
+
Multilanguage state names are currently not implemented in X-Cart.
  
 
[[Category:X-Cart user manual]]
 
[[Category:X-Cart user manual]]

Revision as of 12:43, 21 January 2010

For each of your store's 'active' countries that needs states, you must create a state list. State lists can be created and managed using the 'States Management' section of the Admin area (Settings menu->States).

During X-Cart installation, you can import pre-configured state lists for some countries (For information about importing states, see the chapter Installing X-Cart). If, during X-Cart installation, you imported states for your 'active' countries, you can view the respective state lists in the 'States Management' section: simply click on a country name link at the top of the 'States' dialog box, and the state list for the selected country will be displayed below:


States1.gif

By looking at a state list, you can find out the following information for each state:

  • CODE: The state code (must be unique on a per-country basis). State codes are used for X-Cart's inner processes and also appear in customer addresses on the invoice.
  • STATE: The state name.
  • COUNTIES: The number of counties in the state ('n/a' is displayed if no counties are defined).
COUNTIES column is displayed only when use of counties in the store is enabled. To enable use of counties, enable the option 'Use counties' in General settings->General options.

Important: We cannot guarantee that X-Cart's pre-configured state lists are complete or correct. For example, we haven't been able to find a standard list of counties for the United Kingdom, so the list of UK counties shipped with X-Cart provides a combination of lists from http://www.gbet.com/AtoZ_counties/ and http://www.ons.gov.uk/about-statistics/geography/products/geog-products-area/names-codes/eurostat/index.html with some corrections added by our clients residing in the UK. Before you use X-Cart's pre-configured state lists in your live store, please ensure they are adequate. You can edit any existing state list by adding, removing or editing the states contained in them as described below.


Adding states

To add a new state to the list:

  1. Go to the 'States Management' section (Settings menu->States).
  2. In the 'States' dialog box, scroll down to the 'Add new state' section.
  3. Provide the necessary information about the state being added: state code, state name and the country to which the state needs to be added.
  4. Click the Add state button. The state should be added. You should see an Information box with a confirmation message. To view the state you have added, click on the name link of the country to which you have added it - the state should be in the list.


Editing states

To rename a state or to change a state's code:

  1. Go to the 'States Management' section (Settings menu->States).
  2. In the 'States' dialog box, find the state name or code that needs to be edited.
  3. Change the code and/or the name of the state.
  4. Click the Update button to save the changes. The information should be updated. You should see an Information box with a confirmation message.


Deleting states

To delete one or more states:

  1. Go to the 'States Management' section (Settings menu->States).
  2. In the 'States' dialog box, find the states you wish to delete and select the DELETE check boxes opposite their names. You can use the Check all / Uncheck all links to select or unselect all the check boxes on the current page.
  3. Click the Delete selected button. The states selected for deletion should be removed. You should see an Information box with a confirmation message.


Multilanguage state names

Multilanguage state names are currently not implemented in X-Cart.