Setup the Site as Multilingual

To set up a multilingual website, before starting the translations you have to perform several steps that are described below:

  • Step 1. Create or update mandatory items in language *.

Access to the page to create the mandatory items in language '*' is achieved by clicking on the 'Set the site as Multilingual' link in any of the KMFasTrans views. When you click on that link, the following page will be displayed


 

These items are necessary for the Joomla multi-language native mode and consists of the following:

    • A default home menu assigned to language 'All'.
      • This process creates a menu with title "Menu-All", menu type "defaultallmenu" and type "Category List".
    • A root category assigned to language 'All', required for "Menu Item-All".
      • This process creates a category with title "Root Category-All-Articles".
    • A default home menu item assigned to language 'All' as the default Home page for language "All".
      • This process creates a menu item with title "Menu Item-All" in the menu "Menu-All" .
    • A menu-type module linked to menu "Menu-All" and unpublished.
      • This process creates a menu-type module with title "Menu Module-All" in the position "default_all_menu_module_position" (a fictitious one) .

Each time the Create button is pressed, KM FasTrans will try to create these four items and will create only those that do not exist yet. You will be informed of the items that already existed and those just created. You can also know at any moment the status of these items on this page and also in the Control Panel window.

If in any of the elements, instead of the OK state you see the text Not found or not properly configured!, then that element does not exist or is in the trash or archived. Pressing the Create button again will create the element or it will be published if it was archived or in the trash.

You don't have to use these items for anything ( and is better if you don't use them at all as if problems arise you could delete them and recreate pressing this button. An exception to this might be the category, which may be used freely if needed). If you need a menu, menu item and menu module assigned to language 'All' you can create as many as you need without changing anything of those four items that were created in this step.

If you already had these items in place before installing KMFasTrans, you can just ignore the warning messages, or you can click on the button anyway because it will not affect what you had previosly, the only change will be that the default home page for language 'All' will be the new automatically created menu item with title "Menu Item-All". You also can use the proper option in KMFasTrans configuration to disable the warning message.

  • Step 2. Change language of items from * to site default language.

Access to the page to change the language of items in language 'All' is achieved by clicking on the 'Set the site as Multilingual' link in any of the KMFasTrans views. When you click on that link, the following  page will be displayed:

 

To change the language of the elements you want, from '*' to the site default language or to the language you choose you must do the following:

1. In the 'Change Language to' drop-down below, the site default language is pre-selected. If it is not correct, select the one that is.

2. In the 'Select Items' drop-down, select the mode you want. You have an explanation of what each mode does when hovering the mouse over the label.

3. The 'Select Components' drop-down is only visible if you selected 'All items' or 'All except those selected below' in the 'Select Items' drop-down. If it is visible you have to select the components for which you want the change to be applied. If you do not select any, no changes will be made.

4. Select, in the table of components below (if it is visible), the elements that you want to change or not to change depending on the mode you have selected. If you selected 'All items' in the 'Select Items' drop-down, the table will not be displayed and all the items of the components selected in 'Select Components' drop-down will be modified.

5. Finally click on the 'Change Language' button to change the language.

As with any major changes to the website, it is advisable that you make a backup before taking this action.

  • Step 3. Assign language to menus.

When installing the extension, KMFasTrans will add the language field as a required field for menus, so you can easily control the language of the menu-items assigned to a menu.

The installation process tries to assign the language to each menu based on the language of the menu items assigned to that menu. Sometimes it does not get it and assigns the Default Site Language.
In all cases it is necessary to perform a revision of the assigned language and in cases where the installation failed to assign the language there will be menus that have been assigned the Default Site Language incorrectly and the correct one must be assigned manually.

To do this, KMFasTrans has included a 'Batch' function on the page that lists all the menus to be able to change the language to several menus simultaneously.



You just have to select all the menus that must have a new language and click on the 'Batch' button to obtain the following window:



Select the appropriate language in 'Set Language' dropdown and click on 'Process' to make the change.

  • Step 4. Create Sets of Translations.

If in your Joomla installation there are elements that are translation of other elements before the installation of KMFasTrans, it is necessary to manually create some translation sets. KMFasTrans will create the translation sets from the Joomla associations found during installation, but it cannot create them for the elements for which Joomla associations are not supported.

Thus it is necessary to manually create translation sets for Menus, Banners, Modules, Fields Groups, Fields, Tags and Web links and third party extensions.


The most efficient way to do this is by using the Multiple Manual Associations functionality. In the Multiple Manual Associations online help of this page you have all the necessary information to perform this step.

  • Step 5. Publish the Language Filter plugin.

You have to publish the Language Filter plugin.

You can access the plugin from Extensions->Plugins and then search por the Language Filter. You will have the following screen:

You have several options. It is important that if you want to have translated content switching when switching languages you have to set the value 'YES' for the option "Associations". If you forget to do it at first then you will have to create associations manually re-editing the items.

  • Step 6. Publish the Language Switcher module.

 

If you want to switch content at the article, contact or newsfeed level, you have to publish the KMFT Language Switcher module and assign the position and pages as you want. Remember that this module requires menu associations to be in place to work properly.

Otherwise you can publish the Joomla standard Language Switcher module