Joomla! Documentation™

This Page Needs Your Help

GSoC 2018
Creating Multilingual Associations Automatically
Documentation

Joomla! 

4.x

Introduction

To make multilingual associations easier and more quickly, a tool can be used so that users can batch create associations according to content languages. The Create Associations button in the Multilingual Associations Component can raise a modal for selecting the languages and parameters of new associations. Existing associations will also be displayed.

Environment Setup

You can find the Create Associations button in the backend Multilingual Associations Manager. Select Components → Multilingual Associations.

If you have not yet set up a multilingual site, follow the Setup a Multilingual Site tutorial.

After selecting a specific Item Type and Language, you will find the Create Associations button in the Associations column.

Creating Missing Associations

Selecting the Create Associations button of a specific item will raise a modal. You can select languages for creating associations of this item. You can see the following header columns:

• Status (Published/Unpublished) Status of the content language.
• Language The language code of a content language.
• Parameters The necessary parameters (categories/menu) of associations.
• Titles The title and alias of an existing associations.

You cannot select a language in which an association already exists.

For Articles, Contacts and News Feeds, you must select a category as a parameter. For Menu Items, you must select a menu as the parameter. If not, this will cause an error.

After selecting a language and a category/menu, you can click on Create to create associations as you wish.

• The names of newly created associations are in the following form: Original Name [Language Name]
• The alias of newly created associations are in the following form: Original-Alias-Language-Name

Closing this modal will automatically refresh this page and the language buttons that have associations now turn green.