Table des matières
Exigences techniques OpenCart
La traduction automatique neuronale à utiliser avec OpenCart nécessite l'utilisation du script PHP (téléchargeable ci-dessous). Pour installer le Linguise , vous aurez besoin des éléments suivants :
- Exécuter PHP 7+
- Serveur Apache, LiteSpeed, NGINX, IIS
- Activez la réécriture d'URL via la configuration PrestaShop
Comment installer la traduction OpenCart
1. Générez la clé API pour activer la traduction
Une fois connecté à votre tableau de bord Linguise , vous devrez d'abord configurer un nouveau domaine et enregistrer ses paramètres pour obtenir la clé API.
La clé API est indispensable pour activer la traduction sur votre OpenCart . Concrètement, elle permet de vérifier quelle langue est activée sur quel domaine et autorise ainsi la génération des pages de traduction automatique.
Copiez la clé API et conservez-la dans votre presse-papiers.
Ensuite, en cliquant sur l'onglet « Script PHP », vous obtiendrez les instructions d'installation que nous suivrons ici en détail.
2. Téléchargez et connectez le script Linguise à OpenCart
Le script de traduction Linguise doit être téléchargé sur votre serveur où OpenCart est installé :
Une fois le script téléchargé, décompressez-le et téléchargez-le dans le dossier racine où le CMS est installé.
- Assurez-vous qu'il se trouve à la racine de votre site web (là où se trouvent vos fichiers OpenCart
- Veillez à ce que le dossier conserve son nom par défaut « linguise ».
Comment accéder à l'interface de script Linguise ?
Linguise terminée
linguise adresse suivante : https://www.domain.com/linguise
Modifiez l'adresse de 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 aurez accédé à l'interface du script, un écran de configuration s'affichera vous permettant de créer un mot de passe et de vous connecter à votre base de données préférée.
Tu peux:
- Définissez un mot de passe, qui sera requis pour accéder ultérieurement à cette interface.
- Choisissez votre type de base de données — MySQL ou SQLite, selon votre configuration et vos préférences.
Cette configuration initiale garantit un accès sécurisé et vous permet de configurer le script en fonction de votre environnement.
Connexion à la base de données MySQL
Si vous choisissez MySQL, une interface différente apparaîtra et vous demandera les informations de connexion suivantes, issues des champs de configuration MySQL ci-dessous :
Veuillez vous assurer 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 deux 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 des différences importantes :
| Fonctionnalité | SQLite | MySQL |
|---|---|---|
| Installation | Très facile (installation de SQLite requise) | Configuration du serveur requise |
| Stockage | Fichier unique | Géré par un serveur MySQL |
| Performance | Idéal pour les applications à petite échelle | Meilleur 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, est désormais compatible avec PHP et d'autres plateformes. Cette mise à jour permet aux utilisateurs de configurer facilement les paramètres linguistiques (options d'affichage, styles de drapeaux et personnalisation de l'apparence) directement depuis une interface unifiée, quel que soit leur CMS ou framework.
Les administrateurs peuvent gérer plus efficacement les paramètres Linguise grâce à des fonctionnalités cohérentes telles que les fenêtres contextuelles de sélection de la langue, les effets d'ombre et les variantes de drapeaux spécifiques à chaque région. Le tableau de bord conserve son interface conviviale tout en offrant une compatibilité étendue avec divers environnements web.
3. Configurez les URL de langue dans OpenCart
La réécriture d'URL est généralement activée à des fins de référencement (SEO) sur OpenCart. Elle s'effectue via un fichier .htaccess situé à la racine de votre serveur.
Dans les OpenCart , vérifiez que la réécriture d'URL est activée. Utilisez le menu d'administration OpenCart
Système > Paramètres > Par défaut > Serveur
L'URL par langue doit être configurée dans le fichier .htaccess. Copiez simplement ce code après la ligne « RewriteBase / » présente dans le fichier .htaccess par défaut OpenCart .
<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>
Assurez-vous que le chemin linguise/linguiseest identique sur votre serveur ; /linguise/ est le nom par défaut lorsque vous décompressez le script.
4. Activez le sélecteur de langue
Vous pouvez désormais charger toutes vos pages traduites en utilisant l'URL, par exemple : www.domain.com/fr/
Le sélecteur de langue est une fenêtre contextuelle permettant de choisir la langue souhaitée. Pour l'activer, copiez le lien vers le script Linguise OpenCart de toutes vos pages. Le sélecteur de langue sera alors chargé automatiquement. Voici le lien vers le script :
tableau delinguise> Paramètres
Pour l'ajouter ensuite à votre installation OpenCart Design > Éditeur de thème et modifiez l'en-tête/le modèle par défaut.
Le sélecteur de langue s'affichera par défaut en haut à droite de votre site web. Vous pourrez le personnaliser depuis le tableau de bord Linguise à l'étape suivante.
Note importante concernant le référencement : Le nombre de langues configurées a un impact considérable sur votre référencement. Si vous avez un grand nombre de pages indexées (> 500), les moteurs de recherche peuvent mettre beaucoup de temps à les traiter, ce qui peut nuire à votre référencement dans votre langue d'origine. C'est pourquoi nous vous recommandons d'ajouter initialement un maximum de 5 langues, puis, une fois votre site indexé, d'en ajouter par lots de 3 par mois.
Configurer le sélecteur de langue
Le sélecteur de langue est personnalisable depuis le Linguise > Paramètres > Affichage des drapeaux de langue. Toute modification effectuée ici sera répercuté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 dispositions : côte à côte, menu déroulant ou popup
- La position du sélecteur de langue
- Le contenu du sélecteur de langue
- Noms de la langue en anglais ou dans la langue maternelle
- Formes et taille des drapeaux
- Couleurs et ombre portée
Charger le sélecteur de langue dans le contenu OpenCart
Pour afficher le sélecteur de langue à un emplacement précis dans le contenu du CMS, définissez sa position sur « In situ ».
Une fois la position définie dans le Linguise , vous pouvez ajouter le code court ci-dessous pour l'intégrer. Cliquez sur le code ci-dessous pour le copier dans votre presse-papiers.
<div>[linguise]</div>
Une fois ajouté, le drapeau et le nom de la langue s'afficheront sur l'interface publique dans la zone HTML où vous avez ajouté le code.
Activer le système de cache local de traduction
Vous pouvez activer, en option, un système de cache local qui stocke les URL et leur contenu multilingue associé afin d'accélérer le chargement des pages. Ce cache local réduit les transferts de données entre le serveur Linguise et votre serveur web. Il est utilisé uniquement pour les pages déjà traduites et non mises à jour. La priorité est donnée au cache des pages multilingues les plus consultées.
Vous pouvez définir, en option, la taille du cache stocké en Mo. Dans l'exemple suivant, le cache est activé et sa taille est de 500 Mo :
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Paramètres spécifiques pour OpenCart CMS
Le fichier Configuration.php contient également une option permettant de configurer le CMS. Par défaut, cette configuration est automatique, mais l'équipe d'assistance peut vous demander de la personnaliser pour utiliser des paramètres spécifiques.
Voici le code à ajouter pour OpenCart , il s'agit du nom du CMS en minuscules :
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'opencart';
De SQLite à MySQL
Toujours dans le fichier Configuration.php, il existe un paramètre permettant de forcer l'utilisation de MySQL au lieu de SQLite, au cas où SQLite ne serait pas installé sur le serveur.
Dans ce cas, vous devrez renseigner les informations MySQL dans cette partie du fichier Configuration.php :
/** Advanced database configuration **/
/*
* In case you don't want to use Sqlite, you can use MySQL
* To do so, you need to fill the following variables
* Linguise will create the tables for you
*/
public static $db_host = '';
public static $db_user = '';
public static $db_password = '';
public static $db_name = '';
public static $db_prefix = '';
Traduction automatique sur les serveurs Windows IIS
Ajoutez la ligne correspondant à votre outil de création de site web dans votre fichier Web.config.
Elle doit être placée avant toute autre redirection, et notamment celle vers votre fichier PHP principal :
<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>
Traduction automatique sur les serveurs NGINX
rewrite ^/(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 last;