Child pages
  • Understanding Local Settings

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Adding a new language is simply a question of important 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.

Adding A New Language

Warning

Creating a new language means you will have to translate all of the text for PrestaShop's front-end, back-end, modules, etc., or risk using the default English strings. Translation is made using the tool in the "Translations" page, under the "Localization" tab.

You can also create a new language in order to cater for a language pack that you would have downloaded from the PrestaShop site.

In order to add a new language, you must fill as many of the form's field as possible:

  • Name. The name is public. If you are creating that language for regional purpose, you may indicate that in the name: "French (Quebec)", for instance.
  • ISO code. Enter the adequate 2-letter ISO 639-1 code. See http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes for more information.
    If you are importing a language pack, this code should exactly match the one for the pack.
  • Language code. Enter the adequate 4-letter languages code, in the form xx-yy, xx being the language ISO code (same as above), and yy the country ISO code, using ISO 3166-1 alpha-2 (http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). See http://en.wikipedia.org/wiki/IETF_language_tag for more information.
  • Date format. Countries do not always share the same date representation (See http://en.wikipedia.org/wiki/Date_format_by_country). Hence, when your shop display 02/08/12, a customer from France will understand "August 2nd, 2012" whereas one from the US will understand "February 8th, 2012" – and a japan customer might even read it as "August 12th, 2002". This is why it is important to indicate the date format tied to your language. The letters used should be that of PHP's date() function: http://php.net/manual/en/function.date.php.
  • Date format. Same as the date format above, but including the hour-minute format.
  • Flag. Enter Upload an image of the flag of the language you want to add: upload a very small sized picture that does not exceed the resolution of . It should be 16*11 pixels. )
  • Then upload an image that will appear when an image is missing from your store, in the new language. In French, this image contains the words "Aucune image", for example.
  • Click "Save".
  • Go to the "Translations" sub-tab to finalize the installation of the new language.
  • In that sub-tab's "Import a language pack" section, click on "Browse" to select the language pack that was already
    downloaded to your computer.
  • Select it, and click on "Import". The "Translations added" notification then tells you that the import was successful.

...

  • You recommend you use the free FamFamFam Flags image set: http://www.famfamfam.com/lab/icons/flags/.
  • No-picture" image. Upload an image which will be displayed when a product does not yet have a picture. That image is simply a blank image, with "No image" or "No image available" in this language. The picture should be 250*250 pixels. You can find existing "No-picture" images in the \img\l directory of your PrestaShop installation.
  • Is RTL language. Some languages are written from right to left, most notably those using Arabic script or the Hebrew alphabet (http://en.wikipedia.org/wiki/Right-to-left). When a PrestaShop theme is well coded, it is able to handle RTL languages - provided it is clearly set as such.
  • Status. You may disable a new language until you are ready to translate everything.

Once your language is saved and enabled, you can import its language pack. This is done in the "Translations" page, under the "Localization" tab. Use the "Import a language pack manually" tool.

Finally, make sure everything works: go to your shop's front-office and click on the flags at the top. Similarly, customers can now select an additional language by using the icons at the top of the pagethese icons.

Zones

PrestaShop's zones are a list of the world's subregions. It helps categorize countries.

...

  • Front Office translations. Text visible to your customers about your shop.
  • Back Office translations. The texts accessible from your store's admin administration panel
  • Error message translations. The error message translations that may appear.
  • Fields Names translations. The name of the fields in the front office or back office.
  • Module translations. The terms used by the installed and activated modules.
  • PDF translations. The terms used in the generated PDF files.
  • E-mail template Translations. The terms used in default e-mail templates.
    Once done, click the flag of the language that you wish to edit that translation in.

...