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.

Joomla Installer depuis l'onglet Web avec ConveyThis dans les résultats de recherche

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

Page d'extension ConveyThis dans Joomla avec le bouton Installer

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

Joomla message : L'installation du package a réussi

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.

Joomla Menu des composants avec 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.

ConveyThis écran de configuration dans Joomla avec le bouton Obtenir une clé API

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.

ConveyThis page d'inscription

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.

ConveyThis configuration dans Joomla : clé API vérifiée, langues confirmées, enregistrer et commencer la traduction

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.

ConveyThis configuration principale dans Joomla

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.

Joomla Configuration globale, section SEO avec utilisation de la réécriture d'URL définie sur Oui

Selon votre hébergement :

  • Apache et LiteSpeed : changez le nom du fichier de htaccess.txt à .htaccess dans 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.

Site Web Joomla traduit en chinois avec le commutateur de langue ConveyThis ouvert

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 !