Comment ajouter ConveyThis à Joomla ?
Intégrer ConveyThis à votre site est rapide et facile, et Joomla ne fait pas exception. En quelques minutes, vous installez l'extension ConveyThis, la connectez à votre compte ConveyThis gratuit et publiez votre première langue traduite, sans écrire une seule ligne de code.
Exigences : Joomla 4, 5 ou 6 et PHP 8.1 ou plus récent. Joomla 3 n'est pas pris en charge.
1) Installez l'extension ConveyThis
Dans l'administration Joomla, allez dans System → Install → Extensions et ouvrez l'onglet Install from Web . Tapez ConveyThis dans le champ de recherche et cliquez sur le résultat ConveyThis.

Cliquez sur Installer, puis confirmez sur l'écran suivant.

Lorsque Joomla affiche Installation of the package was successful, l'extension est prête.

Vous préférez importer le fichier vous-même ? Téléchargez conveythis.zip et déposez-le dans l'onglet Upload Package File de la même page.
2) Ouvrez ConveyThis dans Joomla
Accédez à Components → ConveyThis.

La première fois que vous l'ouvrez, ConveyThis affiche une courte configuration : créez un compte, collez votre clé API, confirmez vos langues.

3) Créez votre compte ConveyThis gratuit
Cliquez sur Get an API key. La page d'inscription ConveyThis s'ouvre dans un nouvel onglet. Créez votre compte (aucune carte bancaire requise) et confirmez votre adresse e-mail.

Suivez ensuite la courte configuration : sélectionnez Joomla comme technologie de votre site si on vous le demande, confirmez votre domaine, choisissez la langue de votre site et les langues que vous voulez ajouter. Votre clé API s'affiche dans le tableau de bord une fois la configuration terminée. Elle ressemble à ceci : pub_xxxxxxxxxxxxxxxx.
4) Collez votre clé API et commencez à traduire
Revenez à l'onglet Joomla, collez la clé API et cliquez sur Check this key. ConveyThis reprend les langues choisies dans votre compte, vous n'avez donc pas à les choisir deux fois. Cliquez sur Save and start translating.

Vous arrivez sur les paramètres de ConveyThis. Vous pouvez y modifier les langues à tout moment, et personnaliser le sélecteur de langue dans Widget style.

5) Activez « URL Rewriting » dans Global Configuration
Chaque langue obtient sa propre URL, telle que /es/about. Pour que ces URL fonctionnent, allez dans System → Global Configuration, et dans la section SEO passez Use URL Rewriting à Oui, puis cliquez sur Enregistrer. Sans cela, les pages traduites peuvent renvoyer une erreur 404.

Selon votre hébergement :
- Apache et LiteSpeed : changez le nom du fichier de
htaccess.txtà.htaccessdans le dossier racine de Joomla. - IIS : changez le nom du fichier de
web.config.txtàweb.config. - NGINX : vous devez configurer votre serveur.
- Autres serveurs ou en cas de doute : contactez votre hébergeur.
Vous utilisez le Language Filter de Joomla ? Désactivez-le. Le plugin Joomla Language Filter utilise les mêmes préfixes de langue dans l'URL (/es/), et les deux entrent en conflit. ConveyThis le détecte et vous propose de le désactiver.
6) Vous avez terminé !
C'est tout. Ouvrez votre site web : le sélecteur de langue apparaît en bas à droite. La première fois, il peut mettre une minute ou deux à s'afficher.

Changez de langue et votre site Web est multilingue. Pour consulter ou modifier les traductions, cliquez sur Edit Translations dans votre tableau de bord ConveyThis et choisissez votre site Web ou utilisez l'éditeur visuel pour les modifier directement sur vos pages.
Félicitations, vous pouvez maintenant commencer à traduire votre site Web !
