For the complete documentation index, see llms.txt. This page is also available as Markdown.

Recommended workflow and typical cases

The component currently translates content (articles and categories) automatically whenever content is saved in the source language or explicitly assigned to it.

The detection runs on menu item and category level. This means that only menu items that are assigned to the source language, or saved within that language, will be added to the translation queue and will be translated automatically.

The same applies to categories and articles: translations are only triggered for categories assigned to the source language, or for articles that belong to a category assigned to the source language.

Our goal is to create the most sensefull and reliable result possible for translations, category relationships, and menu assignments.

This is especially important for existing single-language Joomla setups that are being converted into multilingual websites.

If an article is assigned to the source language, but its category is not assigned to the source language, no translation process will be triggered.

Typical cases and behavior

Scenario
Result

Category is assigned to the source language

Category translation is created correctly

Article is assigned to the source language and category is also assigned to the source language

Article translation is created correctly

Article is assigned to the source language but category is not assigned to the source language

No translation is triggered

Menu item (assigned to source language) type Category Blog / Category List with category not assigned to source language

New menu item is created in target menu, but keeps the original category assignment

Menu item (assigned to source language) type Category Blog / Category List with category assigned to source language

New menu item is created in target language with correct translated category assignment (as the associated category has already been translated)

Menu item type Single Article with article in source language but category language set to All

Target menu item may still point to the untranslated source language article, causing incorrect assignments

Category Blog / Category List with correct source language category

If a menu item of type Category Blog or Category List is connected to a category that is assigned to the source language, the system can create a proper translation relationship.

A new menu item will be created in the target language and automatically create an assignment to the corresponding translated category.

This is the recommended and expected setup.

Category Blog / Category List menu items with assigned category missing language assignment

If a menu item of type Category Blog or Category List is connected to a category that is not assigned to the source language, the menu item will still be translated.

A new menu item will be created in the target menu, but it will keep the exact same category assignment as the source language version.

This means the translated menu item may still point to the original category instead of the translated one.

Single Article menu items

If a menu item of type Single Article points to an article in the source language, but the article belongs to a category with language set to All, the translated menu item may be created incorrectly.

In this case, the target language menu item may still point to the untranslated source language article.

Last updated