Documentation AutoLingo pour Joomla

Version 1.1.37 · Joomla 4, 5 & 6 · PHP 8.0+

Installation, configuration et utilisation du plugin AutoLingo Translation : traduction automatique des articles, catégories, champs personnalisés et menus Joomla avec DeepL, Google Translate, Microsoft Translator, OpenAI ou DeepSeek.

Prérequis

Joomla 4.x, 5.x ou 6.x, PHP 8.0 ou plus.
Un site multilingue Joomla : au moins deux langues de contenu publiées (Système → Gérer → Langues de contenu) et le plugin Système - Filtre de langue activé.
Pour relier les traductions entre elles (sélecteur de langue), activez l’option Associations du plugin Filtre de langue.
L’administration du plugin est disponible en français, en anglais et en allemand, selon la langue de votre compte administrateur.
Une clé API chez l’un des fournisseurs : DeepL (Free ou Pro), Google Cloud Translation, Microsoft Translator, OpenAI ou DeepSeek. Vous payez le fournisseur directement, sans marge de notre part.

Installation

Téléchargez le fichier ZIP depuis le lien reçu après l’achat.
Dans l’administration Joomla : Système → Installer → Extensions, puis déposez le ZIP.
Allez dans Système → Gérer → Plugins, cherchez « AutoLingo » et activez le plugin « AutoLingo Translation » (groupe content).
Ouvrez le plugin pour le configurer (section suivante).

Mises à jour automatiques : votre clé de licence sert aussi de clé de téléchargement. Allez dans Système → Mise à jour → Sites de mise à jour, ouvrez « AutoLingo Updates », collez la clé dans le champ Download Key et enregistrez. Les nouvelles versions apparaissent ensuite dans Système → Mise à jour → Extensions.

Configuration

Tous les réglages se trouvent dans le plugin (Système → Gérer → Plugins → AutoLingo Translation), répartis en onglets.

Fournisseur de traduction

Choisissez le fournisseur et renseignez sa clé API. Si vous renseignez d’autres clés, AutoLingo les utilise quand le quota du fournisseur choisi est épuisé (option « Utiliser les autres fournisseurs quand un quota est épuisé », activée par défaut) : avec des comptes gratuits DeepL, Microsoft et Google, cela fait environ 3 000 000 de caractères gratuits par mois.

Fournisseur	Clé	Remarques
DeepL	Clé API DeepL	Free ou Pro détecté automatiquement (les clés Free se terminent par `:fx`). Seul fournisseur compatible glossaire et formalité.
Google Translate	Clé API Google Cloud Translation	Traduction HTML native, la plus large couverture de langues.
OpenAI	Clé `sk-…`	Modèle `gpt-4o-mini`, balises HTML préservées.
DeepSeek	Clé API DeepSeek	Modèle `deepseek-chat`.
Microsoft Translator	Clé Azure AI Translator + région (vide pour une ressource globale)	Offre gratuite : 2 000 000 de caractères par mois.

Langues

Langue source : la langue dans laquelle vous rédigez (ex. en-GB). La liste reprend vos langues de contenu publiées.
Langues cibles : cochez une ou plusieurs langues vers lesquelles traduire (ex. fr-FR, de-DE).

Comportement

Traduire automatiquement à l’enregistrement : activé par défaut. Désactivez-le pour ne traduire que via les boutons en masse.
Seuil d’alerte de crédit (DeepL) : après une traduction, un avertissement s’affiche dans l’administration quand il reste moins de caractères que ce seuil sur votre quota DeepL. 0 désactive la vérification.
Glossaire DeepL et Formalité DeepL : voir plus bas.

Fonctionnement

Quand vous enregistrez un article dont la langue est la langue source, AutoLingo le traduit dans chaque langue cible. Les articles en « Toutes les langues » et ceux rédigés dans une autre langue sont ignorés.

Ce qui est traduit

Titre, texte d’introduction, texte complet, méta-description et mots-clés.
Les champs personnalisés publiés de type Texte, Zone de texte et Éditeur.
La catégorie de l’article : si elle est dans la langue source, elle est traduite (avec ses catégories parentes) et associée. Les catégories en « Toutes les langues » sont partagées telles quelles.

L’article traduit

Il reprend l’état de publication, le niveau d’accès, l’auteur, les dates de publication, les images et les liens de l’original. Il n’est pas mis en vedette.
Son alias est dérivé du titre traduit, suffixé par la langue (ex. mon-article-frfr).
Il est relié à l’original dans les associations Joomla, donc le sélecteur de langue pointe vers la bonne page.

Enregistrements suivants

Si vous modifiez l’original, la traduction existante est mise à jour (pas de doublon).
Si le texte n’a pas changé, aucun appel API n’est fait.
Si vous avez modifié une traduction à la main, AutoLingo ne l’écrase pas : vos corrections sont conservées.

Retraduire une page corrigée à la main : supprimez définitivement la traduction (Corbeille → Vider), puis réenregistrez l’original. Une nouvelle traduction est créée.

La traduction se fait pendant l’enregistrement : sauvegarder un long article vers plusieurs langues peut prendre quelques secondes. Une erreur du fournisseur n’empêche jamais l’enregistrement de l’article.

Traduire les articles existants

Pour un site déjà en ligne, utilisez l’onglet Contenu existant du plugin :

Audit compte les articles en langue source et les traductions manquantes, sans aucun appel API.
Traduire tous les articles traite tous les articles en langue source (hors corbeille), par lots de 5. Laissez la page ouverte jusqu’à la fin.

Les articles inchangés et les traductions modifiées à la main sont ignorés : relancer l’opération ne coûte rien de plus.

Traductions sans lien (sites passés par la version 1.1.31 ou antérieure)

Jusqu’à la version 1.1.31, quand les Associations étaient activées, chaque enregistrement depuis l’éditeur créait une nouvelle traduction non reliée à l’original : le sélecteur de langue ne les reliait pas et les menus traduits pointaient vers l’original. Depuis la version 1.1.36 :

Audit indique combien de traductions manquantes sont en fait des traductions sans lien.
Réparer les liens relie à nouveau, pour chaque article, la dernière traduction écrite par AutoLingo, sans appel API. Les copies plus anciennes ne sont pas supprimées : chacune apparaît une fois dans l’onglet Journal comme doublon possible, à vérifier puis à mettre à la corbeille.
Un simple enregistrement de l’article source répare aussi son lien au lieu de créer une copie de plus.
Relancez ensuite Traduire tous les menus pour que les menus pointent vers les traductions.

Traduire les menus

L’onglet Menus de navigation propose Traduire tous les menus. Pour chaque menu du site et chaque langue cible, AutoLingo crée un menu {menu}-{langue} (ex. mainmenu-frfr) contenant les éléments traduits. Les liens vers des articles pointent vers leurs traductions.

Ensuite, dans Joomla :

Créez un module Menu pour chaque nouveau menu et assignez-lui la langue correspondante.
Définissez un élément Accueil par langue (exigence du multilingue Joomla) dans chaque menu traduit.

Attention : relancer la traduction des menus reconstruit entièrement les menus traduits. Les modifications manuelles faites dans ces menus sont perdues.

Traduisez vos articles avant vos menus, afin que les liens puissent être redirigés vers les articles traduits.

Garder des mots tels quels

Entourez un nom de marque, une référence ou tout passage à ne pas traduire :

[notranslate]Colibri Studio[/notranslate] : le texte est gardé tel quel dans chaque traduction, et les balises ne s’affichent pas sur le site.
<span translate="no">Colibri Studio</span> : HTML standard, invisible pour vos visiteurs.

Les textes alt et title des images de vos articles sont traduits avec le reste. AutoLingo indique aussi au fournisseur ce qu’il traduit (article, catégorie, élément de menu) : les textes courts sont mieux traduits.

Glossaire DeepL

Le glossaire impose une traduction pour certains termes (noms de marque, vocabulaire métier). Il nécessite le fournisseur DeepL.

Dans l’onglet Comportement, saisissez un terme par ligne au format Terme source | Terme cible. Les lignes commençant par # sont ignorées.
Enregistrez le plugin.
Cliquez sur Synchroniser avec DeepL. Un glossaire est créé pour chaque langue cible.

Resynchronisez après chaque modification de la liste de termes.

Formalité DeepL

Choisissez le registre de langue : Par défaut, Plus formel, Moins formel, ou Préférer formel / informel (retombe sur le défaut si la langue ne le prend pas en charge). Ce réglage s’applique uniquement avec DeepL, pour l’allemand, le français, l’italien, l’espagnol, le néerlandais, le polonais, le portugais, le russe et le japonais.

Dépannage

Rien ne se passe à l’enregistrement

Le plugin est-il activé ?
La langue de l’article est-elle exactement la langue source configurée (et non « Toutes ») ?
« Traduire automatiquement à l’enregistrement » est-il activé ?
La clé API du fournisseur sélectionné est-elle renseignée ?

Journal

L’onglet Journal du plugin affiche les 100 dernières traductions et erreurs (clé invalide, quota dépassé, erreur du fournisseur), avec la date, l’article concerné et la langue. Activez Erreurs uniquement pour ne voir que les problèmes. Les entrées de plus de 30 jours sont supprimées automatiquement. Joignez les dernières lignes à votre demande de support.

Limites de débit

Si DeepL répond « trop de requêtes » (HTTP 429), AutoLingo réessaie automatiquement jusqu’à 3 fois avec un délai croissant.

Désinstallation

La désinstallation supprime les tables du plugin (journal et état des traductions). Les articles, catégories et menus traduits restent en place.

Besoin d’aide ?

Une question, un bug ou une demande de fonctionnalité : nous répondons sous 24–48 h (jours ouvrés).

Contacter le support

Home / Joomla / Documentation

AutoLingo for Joomla documentation

Version 1.1.37 · Joomla 4, 5 & 6 · PHP 8.0+

How to install, configure and use the AutoLingo Translation plugin to translate Joomla articles, categories, custom fields and menus automatically with DeepL, Google Translate, Microsoft Translator, OpenAI or DeepSeek.

Requirements

Joomla 4.x, 5.x or 6.x, PHP 8.0 or later.
A multilingual Joomla site: at least two published content languages (System → Manage → Content Languages) and the System - Language Filter plugin enabled.
To link translations together (language switcher), turn on Item Associations in the Language Filter plugin.
The plugin’s administrator screens are available in English, French and German, following your administrator account’s language.
An API key from one provider: DeepL (Free or Pro), Google Cloud Translation, Microsoft Translator, OpenAI or DeepSeek. You pay the provider directly; we add no markup.

Installation

Download the ZIP from the link you received after purchase.
In the Joomla administrator, go to System → Install → Extensions and upload the ZIP.
Go to System → Manage → Plugins, search for “AutoLingo” and enable “AutoLingo Translation” (group content).
Open the plugin to configure it (next section).

Automatic updates: your licence key is also your download key. Go to System → Update → Update Sites, open “AutoLingo Updates”, paste the key into the Download Key field and save. New versions then appear under System → Update → Extensions.

Configuration

All settings live in the plugin (System → Manage → Plugins → AutoLingo Translation), split into tabs.

Translation provider

Pick a provider and enter its API key. If you fill in other keys, AutoLingo uses them when the selected provider runs out of quota (“Use the other providers when a quota runs out”, on by default): with free DeepL, Microsoft and Google accounts, that is about 3,000,000 free characters a month.

Provider	Key	Notes
DeepL	DeepL API key	Free or Pro detected automatically (Free keys end with `:fx`). The only provider that supports glossaries and formality.
Google Translate	Google Cloud Translation API key	Native HTML translation, widest language coverage.
OpenAI	`sk-…` key	Uses `gpt-4o-mini`; HTML tags are preserved.
DeepSeek	DeepSeek API key	Uses `deepseek-chat`.
Microsoft Translator	Azure AI Translator key + region (empty for a global resource)	Free tier: 2,000,000 characters a month.

Languages

Source language: the language you write in (e.g. en-GB). The list shows your published content languages.
Target languages: tick one or more languages to translate into (e.g. fr-FR, de-DE).

Behaviour

Auto-translate on save: on by default. Turn it off to translate only with the bulk buttons.
Credit alert threshold (DeepL): after a translation, a warning appears in the administrator when fewer characters than this are left on your DeepL quota. 0 turns the check off.
DeepL glossary and DeepL formality: see below.

How it works

When you save an article whose language is the source language, AutoLingo translates it into every target language. Articles set to “All” languages, and articles written in any other language, are left alone.

What gets translated

Title, intro text, full text, meta description and meta keywords.
Published custom fields of type Text, Textarea and Editor.
The article’s category: if it is in the source language, it is translated (along with its parent categories) and associated. Categories set to “All” languages are shared as they are.

The translated article

It copies the original’s publishing state, access level, author, publishing dates, images and links. It is not marked as featured.
Its alias comes from the translated title plus a language suffix (e.g. my-article-frfr).
It is linked to the original through Joomla associations, so the language switcher points to the right page.

Later saves

When you edit the original, the existing translation is updated (no duplicates).
If the text hasn’t changed, no API call is made.
If you edited a translation by hand, AutoLingo doesn’t overwrite it: your corrections are kept.

To re-translate a page you edited by hand: delete the translation permanently (Trash → Empty), then save the original again. A fresh translation is created.

Translation happens during the save, so saving a long article into several languages can take a few seconds. A provider error never stops the article from being saved.

Translating existing articles

For a site that already has content, use the plugin’s Existing Content tab:

Audit counts source-language articles and missing translations, without any API call.
Translate All Articles processes every source-language article that isn’t trashed, in batches of 5. Keep the page open until it finishes.

Unchanged articles and hand-edited translations are skipped, so running it again costs nothing extra.

Unlinked translations (sites that ran version 1.1.31 or earlier)

Up to version 1.1.31, when Item Associations was on, every save from the editor created a new translation that wasn’t linked to the original: the language switcher didn’t connect them and translated menus pointed to the original. Since version 1.1.36:

Audit tells you how many missing translations are really unlinked ones.
Repair Links re-links, for each article, the last translation AutoLingo wrote, without any API call. Older copies are not deleted: each appears once in the Log tab as a possible duplicate, for you to review and move to the trash.
Simply saving the source article also repairs its link instead of creating one more copy.
Then run Translate All Menus again so menus point to the translations.

Translating menus

The Navigation Menus tab has a Translate All Menus button. For each site menu and each target language, AutoLingo creates a {menu}-{language} menu (e.g. mainmenu-frfr) with translated items. Links to articles point to their translations.

Then, in Joomla:

Create a Menu module for each new menu and assign it the matching language.
Set one Home menu item per language (a Joomla multilingual requirement) in each translated menu.

Note: running menu translation again rebuilds the translated menus from scratch. Manual changes made in those menus are lost.

Translate your articles before your menus, so links can be pointed at the translated articles.

Keeping words untranslated

Wrap a brand name, a product code or any passage that must stay as written:

[notranslate]Colibri Studio[/notranslate]: the text is kept as it is in every translation, and the markers are not shown on the site.
<span translate="no">Colibri Studio</span>: standard HTML, invisible to your visitors.

Image alt and title text inside your articles is translated with the rest. AutoLingo also tells the provider what it translates (article, category, menu item), so short texts come out right.

DeepL glossary

A glossary forces a fixed translation for specific terms (brand names, industry vocabulary). It requires the DeepL provider.

In the Behaviour tab, enter one term per line as Source term | Target term. Lines starting with # are ignored.
Save the plugin.
Click Sync to DeepL. One glossary is created per target language.

Sync again whenever you change the term list.

DeepL formality

Choose the tone: Default, More formal, Less formal, or Prefer formal / informal (falls back to default when the language doesn’t support it). This setting only applies with DeepL, for German, French, Italian, Spanish, Dutch, Polish, Portuguese, Russian and Japanese.

Troubleshooting

Nothing happens on save

Is the plugin enabled?
Is the article’s language exactly the configured source language (not “All”)?
Is “Auto-translate on save” turned on?
Is the API key for the selected provider filled in?

Log

The plugin’s Log tab lists the 100 most recent translations and errors (invalid key, quota exceeded, provider error), with the date, the article and the language. Turn on Errors only to see just the problems. Entries older than 30 days are deleted automatically. Include the latest rows when you contact support.

Rate limits

If DeepL answers “too many requests” (HTTP 429), AutoLingo retries automatically up to 3 times with an increasing delay.

Uninstalling

Uninstalling removes the plugin’s tables (log and translation state). Translated articles, categories and menus stay in place.

Need help?

Questions, bugs or feature requests: we reply within 24–48 h (business days).

Contact support