Documentation

Localization

AddThis Social Bookmark Button

Information specific to your local area, including currencies, languages, wording for stock and order statuses, where you will sell, tax you will charge, whether to use inches, millimeters etc. in measurements and kilos or pounds in weights.

Languages

For advanced users.

Manual Install a language pack for languages other than English by first upload to your website at admin/languages/languagename and storefront/languages/languagename. For auto install use Extension Store.

Enter the Language information below from the README file contained in the zip file.

CAUTION: Be sure to download a language pack ONLY for your version of AbanteCart - in your Admin, check the footer to see your version number.

  • To add a new Language click the INSERT

Language Name: Name of the language.

Code: ISO Language code. Must be unique for each language.

Locale: Locale is used to auto detect the language a customers browser is using. You can view the the different browser codes here. Must be comma separated.

Example:

en_US.UTF-8,en_US,en-gb,english

Directory: The exact directory or folder where you uploaded the language files. Should be similar to public_html/storefront/language/languagename.

Sort Order: If your store uses multiple langagues, what order the languages are displayed in.

After you have made your changes, select the SAVE

You able to Load missing (not translated) language data from any other language installed in your store. Just select language to copy from and click Load button. This action will copy missed language data like Product's and Categories names, descriptions, Length & Weight classes, Order statuses, Tax classes ...etc.

 

Important

Each time you add a new language, you must do the following steps:

1. Install the language files.

2. Add the new language via admin.

3. Go over every multi-lingual page and translate:

Catalog > Products

Catalog > Categories

Catalog > Downloads

Catalog > Information

Admin > Configuration > Localisation > Stock Statuses

Admin > Configuration > Localisation > Order Statuses

Admin > Configuration > Localisation > Weight Classes

4. Go to the catalog and test each page.

Some pages may not appear if you have not translated everything.

 

Language Definitions

Use this to translate already defined Language Definition or to add new one for any language installed.

  • To add a new Definition click the INSERT button

Section: Select the section where definition appear.

Block: Block name.

Key: Must be unique.

Value: The value (your translation) of defined key.

  • To edut Definition click the Edit  button

dialog window will appear



Currencies

  • To add a new Currency click the INSERT

Currency Title: Name of the currency.

Code: Name of the currency. You can find a list of codes here. All currency codes must be in uppercase.

Symbol Left: The left currency symbol if the currency has one. An example would be the pound sign (£) for pound sterling.

Symbol Right: The right currency symbol if the currency has one. An example would be the euro sign (€).

Decimal Places: The number of decimal places used for a particular currency. Some currencies use more than 2 decimal places such as the Kuwaiti Dinar.

Value: The currency value compared to your default currency. If the currency you are entering is going to be your default currency you should set the value to 1.00000. The currency value will change automatically if you have auto update currency set to yes.

Status: Currency status will determine if the currency is displayed on the front of site.

After you have made your changes, select the SAVE .

If you add more than one currency, a select Currency drop-down will appear on the storefront pages, through which your customers can choose their preferred currency method.


Stock Statuses

Create or edit stock messages relating to a product's stock level. Default statuses are In Stock, Out of Stock (DEFAULT WHEN USING STOCK MODULE), and Pre-Order.

  • To add a new Stock Status click the INSERT

Stock Status Name: The wording you want to display.

A stock status is the status that will be displayed when a product runs out. You can assign a stock status to individual products. You might want to assign a stock status of 1 - 2 days if you have stock for a particular product arriving in the next 1 - 2 days.

After you have made your changes, click the SAVE

Orders Statuses

Set wording for the statuses that an order may hold as it is processed through your store. Allows you to sort orders by status (i.e. PENDING to see orders you need to fill today), and change the status to allow the customer to see their order has been processed, shipped, etc.

Default statuses are:

Cancelled - an order which was cancelled by a customer;

Cancelled Reversal;

Chargeback;

Complete - an already processed order (a seller got money and sent product to a customer);

Denied - an order which was denied by a seller;

Failed - a failed order;

Pending (DEFAULT);

Processing - a processed order (seller got money, but product is not sent yet);

Refunded;

Reversed;

Shipped.

You may edit any messages for language, spelling or even use different words.

  • To add a new Order Status click the INSERT

Order Status Name: The wording you want to display.

After you have made your changes, select the SAVE

Countries

To refuse orders from certain countries and remove them from the customer registration's drop-down list, select status to OFF.

  • To add a new Country click the INSERT

Country Name: Name of the country.

ISO Code (2): The 2 letter ISO country code. You can find out more about these here.

ISO Code (3): The 3 letter ISO country code. You can find out more about these here.

Address Format: You can define the address formatting for each country.

Example:

{firstname} {lastname}

{address_1}

{address_2}

{zone} {postcode}

{country}

Each part of the address format must contained within a curly bracket.

After you have made your changes, select the SAVE


Zones

For shipping and tax purposes, pre-defined areas of a country like provinces or states. Refuse to ship or sell to a zone by selecting Zone Status of OFF. TIP: to remove dozens or hundreds of Zones, use phpMyAdmin.

  • To add a new Zone click the INSERT

Zone Name: Name of the zone.

Zone Code: If a perticular zone has a code it should be placed here.

Country: The country the zone belongs to.

Status: Enabled to turn on or Disabled to turn off.

After you have made your changes, select the SAVE

Locations

Custom-defined groups or portions of a country. For example, create a custom Location to charge local, province, and federal tax, OR charge less for shipping to your province + the provinces that surround you.

To add a new Location click the INSERT

Location Name: Name of the location. You can define this as anything you like.

Description: Description of the location. You can define this as anything you like.

After you have made your changes, select the SAVE

The Location Zones Tab will appear. Adding Location Zone - click on insert  button.

Select Country and Country Zone.

Click Save button.

Note: You can add/remove several Location Zones to/from your Location with no limitations.

Locations can be set up for taxes, shipping methods and payment methods.

Example for the Royal Mail shipping zones:

Location Name - UK Royal Mail

Description - UK Royal Mail Shipping Zones

Country - United Kingdom

Zone - Aberdeen

Country - United Kingdom

Zone - Aberdeenshire

Country - United Kingdom

Zone - ..etc...

You might not want to include all zones as some UK zones may be offshore and require a higher shipping rate.

Tax Classes

First create a Location for each tax. See Locations for more help.

By default, AbanteCart will include one Product Tax Class: Taxable Goods. If you have different Tax Rules that will apply to storefront, you will want to create a new Product Tax Class. Click INSERT

Note: Be sure to make test purchases with a fake customer account from each Locations to be sure tax is set up correctly!!

Tax Class Title: Title of the tax class. This will be used when choosing the tax class for products and shipping.

*Description: Description of the tax class. This can be just "Taxed Stuff" or "Food Tax" etc..

After you have made your changes, select the SAVEbutton. Then go to Rates Tab and click + button.

Location: select Location (New Location can be added in the System-> Localization-> Locations)

Location's zone: select Location's zone or click on all location zones checkbox if you want to use All location zones of selected Location. (New Zones can be added in the System-> Localization-> Zones)

Description: Description of the Tax Rate. You can define this as anything you like.

*Tax Rate: The percentage tax rate. Example 17.50 is 17.5%.

*Priority: Set the priority of the tax rate. This will determine which tax rate will be used if tax rate location overlap each other.

After you have made your changes, select the SAVEbutton. Then all rates list will appear. Here You able to edit/delete or add new rate.


Length classes

Units of measure to use in product options and shipping by product dimensions OR add new lengths, for example, if you sell your products using meters yards. Centimeter is the default.

Set the DEFAULT in SYSTEM -> Settings -> Details Tab.

To add a new Length class click the INSERT

*Length Title: Name of the measure.

*Length Unit: Abbreviation for the measure.

Value: Set to 1.00000 if this is your base length.

After you have made your changes, select the SAVE

Weight classes

Units of measure to use in product options and shipping by product weight OR add new weights, for example, if you sell your products using ounces. Kilogram is the default.

Set the DEFAULT in SYSTEM -> Settings -> Details Tab.

To add a new Weight class click the INSERT

*Weight Title: Name of the measure.

*Weight Unit: Abbreviation for the measure.

Value: Set to 1.00000 if this is your base weight.

After you have made your changes, select the SAVE