Skip to main content

Multilingual online store

The new Ceres online store

As of now, online store projects are based on the new online store plugin Ceres. The Ceres store uses the latest and future-proof plugin technology. Ceres can be customised easily and extended by additional plugins from the plentyMarketplace.

Online stores that have been created on the basis of the old CMS will be maintained during the transition period. However, no new features will be developed for the old CMS. We recommend to use the new Ceres online store for all future online store projects.

1. Creating a multilingual online store

Setting up a multilingual online store requires you to carry out several different steps in various menus of your plentymarkets system. These steps are explained here systematically. The different sections of this page correspond to the settings that need to be carried out in order to set up a multilingual online store. You are free to carry out these steps in a different order. However, make sure that you carry out all of the steps.

2. Your system’s default language

Every plentymarkets system is given a default language when it is installed. This language will be selected by default in all of the areas of your system where information can be saved in multiple languages. This includes the areas for editing the web design, categories and items.

After having saved information in another language, the system will return back to its default language. This means that you will need to reselect the language that you were just working with if you decide to change some of the information.

3. Transferring the design to another language

You can copy your online store’s design in the default language and apply this design to a different language. This is done in the CMS menu. Since the default language’s design is copied, you will only need to make changes to the text in the target language.

EN Settings Client Best Practice Multilingual Store 01 SI
Figure 1. applying a design

Applying a design:

  1. Go to CMS » Web design.

  2. Click on Apply design (Figure 1).

  3. Use the Source drop-down list to select which design and language the characteristics should be transferred from.

  4. Use the Destination drop-down list to select which design and language the characteristics should be applied to.

  5. Select which areas should be transferred from the source to the destination (place check marks).

  6. Click on Apply design.

In doing so, a design that you use in one language can create templates for several languages. The text will then need to be modified for the new languages. Now the second language’s design is exactly the same as the first language’s design.

Editing the layout

You can make changes directly to the individual language versions of the template by going to CMS » Web design » Layout. Select the desired language from the upper menu bar and then select the layout that you want to edit from the directory on the left.

4. Activating other languages

You can select multiple languages for your online store and decide whether you want the entire store or only the order process to be multilingual. You may decide that you would rather copy or activate the design and its languages at a later time, e.g. once you have finished creating items and categories for this language. But if you choose to activate the languages at the very beginning, then you will be able to check your progress in the online store after having made changes.

EN Settings Client Best Practice Multilingual Store 02 SI
Figure 2. activating languages

Activating other languages for the online store:

  1. Go to System » Client » Select client » Online store » Multilingualism.

  2. Mark all of the languages that you want to activate (multiple selection using Ctrl or CMD + mouse click).

  3. Use the Section drop-down list to decide how much of the store should be multilingual. The setting Items & layout & content pages & order process will make the entire online store multilingual. The Order process setting will only make the order process multilingual.

  4. Save the settings.
    → Your online store is now available in multiple languages.

You can make sure that this is true by entering your store’s URL into a browser and then adding on the ISO code for the languages that you just created e.g. *www.NAME_OF_YOUR_SHOP.com/de/* for German or *www.NAME_OF_YOUR_SHOP.com/fr/* for French.

If you were to select your online store’s default language, e.g. along with the order process, then this would have no effect on the default language. In such a case, the online store would remain completely available in this language.

5. Multilingual categories

This section explains how to create multilingual categories of the types Content, Item and Container. This is assuming that you have already created categories in one language (your online store’s default language).

+ There are two different ways to edit categories. You can either use the multilingual editor or the monolingual editor. The multilingual editor makes it possible to edit a content page in two different languages at the same time. In other words, to see the content in one language (e.g. the default language) while editing another language.

Visibility in the menu Item » Categories

In order for a category to appear within the directory tree in the Item » Categories menu, you must have already created this category in your system’s default language. In other words, you must have at least entered a page name in the default language.

5.1. Monolingual editor

Proceed as described below to create a language version of an existing category.

EN Settings Client Best Practice Multilingual Store 03 SI
Figure 3. opening a language

Creating language versions of an existing category (monolingual):

  1. Go to Item » Categories.

  2. Click on the desired category in the directory tree.
    → The category will open.

  3. Use the Language drop-down list (Figure 3, red arrow) to select which language you want to create the content page in (e.g. German).
    → The category will reload in the selected language.

  4. In the Settings tab, enter a name for the page under Name.

  5. Select the desired settings under Template page, Template list, Template product and Full text search. Pay attention to the settings that were saved for the category in the default language.

  6. Click on the save icon.
    → The entries will be saved and the path of the page will be created. It is visible in the URL line.

  7. Insert the content in the respective language.

  8. Save the settings.

5.2. Multilingual editor

Proceed as described below in order to create a language version of an existing category in the multilingual editor.

EN Settings Client Best Practice Multilingual Store 04 SI
Figure 4. multilingualism icon

Creating language versions of an existing category (multilingual):

  1. Go to Item » Categories.

  2. Click on the desired category in the directory tree.
    → The category will open.

  3. Click on the multilingualism icon (Figure 4, red arrow).
    → The category will open in the multilingual editor.

  4. Select the desired languages in the drop-down lists on the left and right (Figure 5, red arrow).

  5. Enter the Name, URL name and Meta title.

  6. Enter the foreign-language text and content into the text field.

  7. Save the settings.

EN Settings Client Best Practice Multilingual Store 05 SI
Figure 5. multilingual editor; selecting the language

The homepage is now available in German. You can open the German homepage and take a look at the result, e.g. under *www.NAME_OF_YOUR_SHOP.com/de/*.

6. Creating language versions of an item

Your system’s default language plays a very important role here as well. This is because the items will only be displayed in the default language when listed in the overview of items. Furthermore, you will not be able to activate an item in the online store if it doesn’t already exist in your system’s default language. This means that every item always has to be created in the default language before it is translated into the other languages.

EN Settings Client Best Practice Multilingual Store 06 SI
Figure 6. language selection for an item

Creating language versions of an item:

  1. Go to Item » Edit item.

  2. Open the desired item.

  3. Click on the texts tab.

  4. Select the desired language from the open language drop-down list.

  5. In the field Name 1, enter the name (translation) that you want to use for this item in the particular language.

  6. Enter all of the necessary texts (Description, Technical data etc.).

  7. Save the settings.
    → The language version of the item will be created and will become visible in the online store.

If the item is not visible in the online store, then click on the Available tab and check whether the item was set to visible for the online store. Also check whether you activated the category that contains the item. These settings will go into effect for all of the languages versions that were created for a category or an item.

If you haven’t linked the item to a category yet, then you can do so in the item’s categories tab. For further information about linking items to categories, refer to the Categories page of the manual.

7. Creating language versions of an email template

All emails that are sent with plentymarkets are based on Email templates. Go to System » Client » Select client » Email » Templates to configure email templates. You can read and change the email templates there as well as create new templates. A plentymarkets system comes equipped with a variety of pre-configured email templates. Your customer will receive the language version of the email template that corresponds to the language they used to access the online store.

EN Settings Client Best Practice Multilingual Store 07 SI
Figure 7. language selection for an email template

Creating language versions of an existing email template:

  1. Go to System » Client » Select client » Email » Templates.

  2. Open the desired email template, e.g. Confirmation of a store order.

  3. Click on the Email message tab.

  4. Select the desired language from the Select a language drop-down list.

  5. Enter a subject, e.g. in German - "Eingangsbestätigung zu ihrer Bestellung."

  6. Enter the corresponding text into the Content field.

  7. Save the settings.
    → The language version of the email template will be created.

For further information about the different template functions and variables that you can use in the email templates, refer to the Templates page of the manual.

Create event procedures to automatically send your email templates when specific events occur. For further information about automatically sending emails, refer to the Automatic email and the Event procedures pages of the manual.

8. Creating language versions of a PDF document

Not only can the online store be displayed in multiple languages, but you can also create multilingual templates so that documents such as invoices, delivery notes, credit notes, etc are displayed to customers in the correct language.

EN Settings Client Best Practice Multilingual Store 08 SI
Figure 8. document template for German invoices

Creating language versions of an existing document template:

  1. Go to System » Orders » Documents.

  2. Select the desired document.

  3. In the language field, select the desired language for the document.

  4. Carry out all of the settings as desired.

  5. Save the settings.
    → The language version of the document template will be created.

Alternatively, you can copy the settings that were saved for a different language and/or document template and then edit them afterwards. This is useful if you already have a document template that was completely set up in one language. It ensures that the template will be set up the same way for the next language. For further information about these documents and their settings, refer to the Documents page of the manual.

9. Linking languages by inserting template functions into the design

Insert template functions into your layout so that your customers can quickly and easily switch from one language to another. Use the template functions Link_Lang("DE") %}, Link_Lang("EN") %}, Link_Lang("FR") %} etc. Once your online store is ready to be viewed in another language, you will have to insert the template function into the corresponding layout. In the following example, a link to the German store is inserted into the English layout PageDesignContent.

Linking languages by inserting template functions into the layout:

  1. Go to CMS » Web design.

  2. In the Language drop-down list, select the language of the layout that you want to edit, e.g. English.

  3. Select the layout PageDesignContent from the directory tree on the left.
    → The layout will open in the selected language.

  4. Insert the template function for the desired language into an appropriate place in the layout. For German, this link would be Link_Lang("DE") %}.

  5. Save the settings.
    → The link will appear in the English store. (Figure 9)

Click on the link to switch the language. For further information about switching the language in the online store, refer to the Language settings page of the manual.

To top