Table des matières
Exigences techniques du CMS ExpressionEngine
La traduction automatique neuronale à utiliser avec le CMS ExpressionEngine nécessitera l'utilisation du script PHP (téléchargeable ci-dessous). Pour installer le script Linguise, vous aurez besoin des exigences suivantes:
- Exécuter PHP 7+
- Apache, IIS ou NGINX
- Assurez-vous que la réécriture d’URL est activée sur votre serveur
- ExpressionEngine CMS 6 et supérieur
Générer la clé API
Après votre connexion ou inscription à votre Linguise dashboard, vous’devrez configurer un nouveau domaine d'abord et enregistrer ses paramètres pour obtenir la clé API.
Vous pouvez sélectionner “Other PHP” plateforme pour procéder à l’enregistrement du domaine Linguise, comme cette documentation et les langues source et de destination.
Après cela, vous’obtiendrez :
- La clé API qui valide votre adhésion
- Le lien vers le script Linguise pour le sélecteur de langue
La clé API est ce qui est nécessaire pour activer la traduction sur votre site web ExpressionEngine CMS. En gros, la clé API vérifiera quelle langue est activée sur votre domaine et permettra la traduction automatique du contenu.
Pour l'instant, vous pouvez copier la clé API et la garder dans votre presse‑papier.
Téléversez et connectez le script de traduction Linguise
Le script de traduction Linguise doit être téléchargé sur votre serveur où ExpressionEngine CMS est installé. Téléchargez-le ici.
Après le téléchargement du script, décompressez-le et téléversez-le dans le dossier racine où ExpressionEngine CMS est installé.
- Assurez‑vous qu’est placé à le niveau racine de votre site web (où se trouvent les fichiers ExpressionEngine CMS)
- Assurez‑vous que le dossier conserve son nom par défaut “linguise”
Comment accéder à l'interface du script Linguise ?
Après avoir terminé l'installation de Linguise, vous pouvez accéder au tableau de bord en visitant votre site Web avec le format d'URL suivant :
https://www.domain.com/linguise
Modifiez l'adresse du domaine en fonction de l'adresse de votre site Web*
Assurez-vous que Linguise dispose des autorisations de lecture et d'écriture appropriées*
Configurer le mot de passe et la connexion à la base de données
Une fois que vous accédez à l'interface du script, vous serez présenté avec un écran de configuration où vous pouvez créer un mot de passe et vous connecter à votre base de données préférée.
Vous pouvez :
- Définissez un mot de passe, qui sera requis pour un accès futur à cette interface.
- Choisissez votre type de base de données — MySQL ou SQLite, selon votre configuration et vos préférences.
Cette configuration initiale assure un accès sécurisé et vous permet de configurer le script selon votre environnement.
Connexion à la base de données MySQL
Si vous choisissez MySQL, une interface différente apparaîtra demandant les détails de connexion suivants des champs de configuration MySQL ci‑dessous :
Assurez-vous que les informations sont correctes pour établir une connexion réussie à votre base de données MySQL.
MySQL vs SQLite – Quelle est la différence ?
MySQL et SQLite sont tous deux des systèmes de bases de données populaires utilisés pour stocker et gérer les données des sites web et des applications. Cependant, ils sont conçus pour des cas d’utilisation différents et présentent quelques différences clés :
| Fonctionnalité | SQLite | MySQL |
|---|---|---|
| Configuration | Très facile (installation de SQLite requise) | Nécessite une configuration du serveur |
| Stockage | Fichier unique | Géré par le serveur MySQL |
| Performance | Idéal pour les applications de petite taille | Mieux pour les grands systèmes à fort trafic |
| Cas d'utilisation | Applications locales, tests, petits sites | Applications web, commerce électronique, systèmes d'entreprise |
Interface de script Linguise : configuration pour la plateforme PHP
Le tableau de bord de traduction Linguise, auparavant disponible uniquement pour Joomla et WordPress, prend désormais en charge PHP et d'autres plateformes. Cette mise à jour permet aux utilisateurs de configurer sans effort les paramètres de langue— tels que les options d'affichage, les styles de drapeau et la personnalisation de l'apparence— directement depuis une interface unifiée, quel que soit leur CMS ou leur framework.
Les administrateurs peuvent gérer les paramètres de Linguise plus efficacement, avec des fonctionnalités cohérentes telles que les fenêtres contextuelles de sélection de langue, les effets d'ombre et les variantes de choix de drapeaux spécifiques à chaque région. Le tableau de bord conserve son design convivial tout en offrant une compatibilité plus large pour des environnements web divers.
Configurer la réécriture des URL du CMS ExpressionEngine
Par défaut, la réécriture d’URL est active dans le CMS ExpressionEngine. Si ce n’est pas le cas, vous pouvez l’activer auprès de votre hébergeur.
L’URL par langue doit être configurée dans le .htaccess. Copiez simplement le code ci‑dessous après le code “RewriteEngine on” disponible dans le ExpressionEngine CMS .htaccess.
<IfModule mod_rewrite.c> RewriteEngine On RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA] </IfModule>
Vous pouvez maintenant charger toutes vos pages traduites en utilisant l'URL, par exemple : www.shop.com/fr/
Chargeons maintenant le sélecteur de langue.
Activez le sélecteur de langue
Chargez le JavaScript Linguise
Le lien Javascript Linguise doit être chargé sur toutes vos pages CMS ExpressionEngine afin d’afficher le sélecteur de langue avec les drapeaux et les URL alternatives dans les en-têtes HTML (à des fins de SEO).
Pour copier le lien du script, depuis le tableau de bord Linguise, allez aux paramètres du domaine et copiez le lien du script.
La façon la plus simple de charger ce code dans Concrete CMS est de l’ajouter à l’intérieur de votre site web header.php ou <head> code.
Vous pouvez configurer cela en suivant ces étapes : Accédez au panneau d'administration, puis, sur le côté gauche, allez à Modèles > Mises en page > _html-wrapper. Par défaut, vous pouvez utiliser cette méthode.
Modifiez le fichier script pour inclure le lien du script dans la section d'en-tête comme ci-dessous.
Le sélecteur de langue sera affiché par défaut dans une position flottante en haut à droite de votre site web. Vous êtes invité à le personnaliser comme expliqué dans le chapitre suivant.
Note importante SEO : Le nombre de langues que vous configurez a un impact important sur le SEO. Lorsque vous configurez vos langues de traduction, si vous avez un grand nombre de pages indexées (>500), le moteur de recherche peut prendre beaucoup de temps pour les traiter. Cela peut affecter votre SEO dans votre langue d'origine. C’est pourquoi nous recommandons d’ajouter d’abord un maximum de 5 langues, puis, une fois indexées, vous pouvez ajouter des langues par lot de 3 par mois.
Configurer le sélecteur de langue
Le sélecteur de langue peut être personnalisé depuis le tableau de bord Linguise > Paramètres > Affichage des drapeaux de langue. Chaque modification ici sera reflétée sur le site web.
Sur la droite de l'écran, vous trouverez un aperçu du sélecteur de langue. Voici les éléments que vous pouvez configurer :
- 3 mises en page : côte à côte, menu déroulant ou fenêtre contextuelle
- La position du changeur de langue
- Le contenu du sélecteur de langue
- Noms de la langue en anglais ou dans la langue maternelle
- Formes et dimensions des drapeaux
- Couleurs et ombre portée
Chargez le sélecteur de langue dans le contenu ExpressionEngine
Pour afficher le sélecteur de langue à l'endroit spécifique, dans le contenu du CMS, vous devez définir la position comme “En place”.
Une fois que vous avez défini la position dans le tableau de bord Linguise, vous pouvez ajouter le shortcode ci-dessous pour l'inclure. Cliquez sur le code ci-dessous pour le copier dans votre presse-papier.
<div>[linguise]</div>
Une fois qu’il est ajouté, sur le frontend vous verrez le drapeau et les noms des langues affichés dans la zone HTML où vous avez ajouté le code.
Activer l'option du système de cache local
En option, vous pouvez activer un système de cache local qui stocke les URL et leur contenu multilingue associé afin de servir les pages plus rapidement. Le cache local permettra d'économiser certains transferts de données entre le serveur Linguise et le serveur de votre site web. Le cache n'est utilisé que lorsqu'une page a déjà été traduite et n'a pas été mise à jour. Le cache prioritaire sera celui des pages multilingues les plus consultées.
Pour compléter cela, vous pouvez définir la quantité de cache stockée en Mo. Dans l'exemple suivant, le cache est activé et la quantité de cache à conserver est de 500 Mo.
/** Configuration de base **/ public $cache_enabled = true; public $cache_max_size = 500; // En mégaoctets
Traduction automatique sur les serveurs NGINX
réécrire ^/(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ /linguise/linguise.php?linguise_language=$1&original_url=$2 dernier;
Traduction automatique sur les serveurs Windows IIS
Ajoutez la ligne correspondant à votre constructeur de site Web dans votre fichier Web.config.
Elle doit être définie avant toute autre redirection, en particulier la redirection vers votre fichier principal PHP :
<rule name="Linguise" stopProcessing="true"> <match url="^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$" ignoreCase="false" /> <conditions logicalGrouping="MatchAll" trackAllCaptures="false" /> <action type="Rewrite" url="linguise/linguise.php?linguise_language={R:1}&original_url={R:2}" appendQueryString="true" /> </rule>
De SQLite à MySQL
Toujours dans le fichier Configuration.php, il y a un paramètre pour forcer l’utilisation de MySQL au lieu de SQLite, au cas où SQLite ne serait pas installé sur le serveur.
Dans ce cas, vous’ll devez remplir les informations MySQL dans cette partie du fichier Configuration.php :
/** Configuration avancée de la base de données **/ /* * Dans le cas où vous ne souhaitez pas utiliser Sqlite, vous pouvez utiliser MySQL * Pour ce faire, vous devez remplir les variables suivantes * Linguise créera les tables pour vous */ public static $db_host = ''; public static $db_user = ''; public static $db_password = ''; public static $db_name = ''; public static $db_prefix = '';