Table of content

...

Understanding Local Settings

...

Adding a new language is simply a question of importing the localization pack from a country which uses that language (in the "Localization" page). If it turns out this does not work, or that you need something customized, you can add a new language manually, using the form behind the "Add new" button.

Creating

...

a New Language

...

At the bottom of the list, the "Country options" section to only display on your front-office the countries that your carriers cover. We recommend that you enable this setting, as it prevents customers from having to scroll through all the country names to find their own.

Adding

...

a New Country

Normally, PrestaShop comes with all current countries in the database. But in the case new ones are created, you would need to add a new country.

...

Adding

...

a New State

Let's create a new state. Click the "Add New" button to get to the creation form.

...

The two sections at the bottom of the "Currencies" page are very simple yet essential, as relate to your currencies exchange rates (or "conversion rates"). To quote Wikipedia, "In finance, an exchange rate between two currencies is the rate at which one currency will be exchanged for another. It is also regarded as the value of one country’s currency in terms of another currency." Rates change daily, sometimes drastically depending on current events, and your shop should always be updated to the latest values.

...

Updating the Currency Rates

In PrestaShop, there are two ways to update your conversion rates:

...

Adding

...

a New Currency

The easiest way to add a country's currency is to import its localization package. This is done in the "Localization" page, under the "Localization" menu. Once import, you must go the "Currencies" page to enable it.

...

• Currency. The name of the currency, preferably in English that as many customers as possible can read it.
• ISO code. The currency's three-letter ISO 4217 code. See this Wikipedia page: http://en.wikipedia.org/wiki/ISO_4217.
• Numeric ISO code. Its three-digit code ISO 4217 code. Same Wikipedia page as above.
• Symbol. The currency's symbol, if any. See this Wikipedia page: http://en.wikipedia.org/wiki/Currency_sign.
• Exchange rate (or Conversion rate in earlier version). This rate is to be defined according to your shop's default currency. For example, if the default currency is the Euro and this currency is dollars, type "1.2931", since 1€ usually is worth $1.29 31 (at the time of this writing). Use the converter here for help: http://www.xe.com/ucc/.
• Formatting. Set up how you want your price to be displayed. The X corresponds to the currency's symbol. You have five possibilities.
• Decimals. You can indicate whether your shop should display decimals. While you may choose to have all your prices be a round number, discounts and other price variations might warrant decimals. You can prevent them with this option.
• Spacing. Once you have chosen the currency's formatting, you can choose whether to have a space character between the symbol and the price itself. Some languages require this. For instance, Spanish people would use "50€" whereas French people would use "50 €". Choose whichever you feel is best.
• Enable. Any currency can be disabled at any time, both from its own edit page, and the currencies table on the "Currencies" page.
• Shop association. You can make the currency only available to a selection of your shops, for instance shops that target a specific locale.

...

...

If you decide to enable the ecotax after having added products, you will have to edit them all in order to set the tax properly for each product.
Note that if you have set ecotaxes for your products already, and that you choose to disable ecotax, then all your products will lose their ecotax settings. Re-enabling the ecotaxe will mean having to set all your products' ecotaxes again.
The ecotax will also appear to the customer, on the product's page.

Adding

...

a New Tax

Adding a new tax is very easy, because tax rules take out all the burden of having to specify the countries where the tax applies. The tax creation form is therefore very short:

...

A few sample taxes rules are already in place, which depend on the country you chose for your shop during the installation of PrestaShop. The tax rules are set for each tax: the rules actually serve as a kind of country filter, limiting the use of that tax to a specific set of countries.
You should edit a couple of the presented rules in order to get a better grasp of how tax rules can be set.

Adding

...

a New Tax Rule

You can add as many tax rules as needed to your PrestaShop installation. Not only that, but you should make sure that all of the needed tax rules are registered in your shop.

...

1. Create the tax rule:
   • Click on the "Add new" button.
   • In the form that appears, name the rule. Use a telling name: use the tax rule's country code, its name, maybe even its rate, so as to find it again easily. If PrestaShop already has tax rules for the target country, use their name as inspiration so as to have some consistency.
   • Select whether the rule should be enabled from the get-go or not. You can enable it later if needed.
   • Click the "Save and stay" button. The page reloads, with a table header at the bottom.
2. Specify the country and behaviors:
   • Click on the "Add new tax rule" button.
     • A new form appears. Fill in the fields:
     • Country. The target country for the rule you are creating.
       • State. Some countries have federal states registered in PrestaShop (see the "States" page, under the "Localization" menu). In that case, you can make the tax even more specific, or choose to have it applied to the whole country. You can select more than one state by pressing the Ctrl key when clicking on state names.
     • Zip Code range. Whether the country has registered states or not, you can further specify the tax application using the customer's zip code. This field enables you to define zip codes in which the tax should be applied: either enter a single zip code, or define a range using the dash. For instance, use "75000-75012" to create a range for all zip codes between these two.
     • Behavior. Some customers might have an address that matches more than one of your tax rules. In that case, you can choose how this tax rule should behave:
       • This Tax Only. Will apply only this tax, not any of the other matching taxes.
       • Combine. Combine taxes. For instance: 100€ + (10% + 5% => 15%) => 115€.
       • One After Another. Apply taxes one after another. For instance: 100€ + 10% => 110€ + 5% => 115.5€.
     • Tax. The tax to be used for this tax rule. That tax must already be registered in PrestaShop. If not: choose "Not tax", disable the tax rule, save it, go create a tax in the "Taxes" page, then come back to edit the tax rule.
     • Description. You may add a short text as a reminder of why this tax rule exists for this country.
   • Click "Save and stay". The country is added to the table below, and you can start adding another country using the new-empty fields.

...

Modifying

...

a Translation

The most important tool of the "Translation" page is in the "Modify translations" section. This is where you can choose to edit a translation, and completely customize each and every sentence if you wish so.

...

Some categories have a second drop-down list, which lists the available themes. PrestaShop themes have their own strings, but can also have their own modules, PDF templates and e-mail templates. The drop-down list therefore enable enables you to choose which theme you want to work with.

...

• Error messages. Strings are not group into many fieldset, they are all presented together.
• PDF templates. There is only one fieldset, "PDF".
• E-mail templates. Strings are split into fieldsets, but they are not simple text fields anymore. Each e-mail has two templates: a HTML one, which is styled and colored, and a text one, when is plain and simple. While the plain text one can be edited directly in the textfield, the HTML one can only be edited by clicking on the "Edit this e-mail template" button at the bottom of the preview. That click turns the preview into a WYSIWYG textfield (what you see is what you get), with a complete editor at the top (based on TinyMCE: http://www.tinymce.com/). In addition to editing the text, you can change the design as you see fit, for instance you can change the colors in order to adhere to your shop's design.
  Note that the e-mail templates feature placeholders, such as {lastname} or {shop_name}, which PrestaShop replaces with the actual values when sending the e-mail. Make sure to keep them in both your translation.

Add / Update

...

a Language

PrestaShop translations are available in packs, which combine all the different translation categories into a zip file. Many language packs are available freely for you to download and install, directly from the PrestaShop.com servers. PrestaShop will take care of downloading the language pack, unpacking it and creating the correct sub-folder in your installation's /translation folder.

...

You can also update the currently installed languages, likewise directly from the PrestaShop.com servers, but be reminded that any change that you might have made to your own translations will be lost once you update it.

Import

...

a Language Pack Manually

In the case where you do not want to use an official PrestaShop translation pack, but rather a custom one (either provided by someone you know, or one that you exported from another PrestaShop installation), then this tool is for you.

...

Export

...

a Language

You can create your own language pack using this tool, either as a way of making a backup of your customizations, or in order to share your translations with other PrestaShop installation – your own or someone else's.

...