YourShop comes multilingual out of the box: there is one default language (the one you used to install it), and many more are available to download.
The “Languages” page manages the languages you will see in your back office and YourShop.
The page displays the languages already installed on YourShop, along with some information: ISO code, language code, date format (short and full). You can enable or disable a language by clicking on the icon in the “Enabled” column.
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
In order to create 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 language code, in the form
xxbeing the language ISO code (same as above), and
yythe 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, whenYourShop 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 format (full). Same as the date format above, but including the hour-minute format.
- Flag. Upload an image of the flag which best matches the language you want to add. It should be 16*11 pixels. 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/ldirectory of your YourShop 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 YourShop 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.
- Shop association. You can make the language only available to a selection of YourShop, for instance shops that target a specific locale.
Once your language is saved and enabled, you can import its language pack. This is done in the “Translations” page, under the “Localization” menu. Use the “Import a language pack manually” tool.
Finally, make sure everything works: go to YourShop front-office and click on the flags at the top. Similarly, customers can now select an additional language by using these icons.