Table des matières
Exigences techniques Magento
La traduction automatique neuronale à utiliser avec Magento nécessitera l'utilisation du script PHP (téléchargeable ci-dessous). Pour installer le Linguise , vous aurez besoin des conditions suivantes :
- Exécutez PHP 7+
- Serveur Apache, LiteSpeed, NGINX, IIS
- Activer la réécriture d'URL via la configuration Magento
- Magento 2+
- Le dossier racine de Magento /pub », assurez-vous d'installer Linguise dans ce dossier
Générer la clé API
La clé API est ce qui est nécessaire pour activer la traduction sur votre site web Magento . En gros, la clé API vérifiera quelle langue est activée sur quel domaine et permettra de générer les pages de traduction neuronale.
Copiez la clé API et conservez-la dans votre presse-papiers.
Puis en cliquant sur l'onglet « Script PHP » vous obtiendrez les instructions d'installation que nous suivrons ici en détail.
Télécharger et connecter le script de traduction Linguise
Le script de traduction Linguise doit être téléchargé sur votre serveur sur lequel Magento 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 au niveau racine de votre site Web (là où se trouvent vos fichiers Magento /pub )
- Assurez-vous que le dossier garde son nom par défaut « linguise »
La Linguise devra être copiée dans le Configuration.php que vous avez téléchargé sur votre serveur, modifiez le fichier et copiez votre clé API entre les guillemets simples, remplacez le texte REPLACE_BY_TOUR TOKEN.
Configuration supplémentaire Magento
Dans la barre latérale d'administration, accédez à Magasins > Paramètres > Configuration > Général > Web > Options d'URL et définissez l' option Ajouter le code de magasin aux URL Non ».
Accédez au code de votre site Web et ouvrez app/etc/env.php . Définissez 'document_root_is_pub' sur true.
Assurez-vous d'avoir défini ces deux étapes et continuez avec la configuration de la réécriture d'URL pour vous assurer que Linguise peut fonctionner correctement sur votre site web Magento sans problème.
Configurer la réécriture des URL
Dans la barre latérale d'administration, accédez à Magasins > Paramètres > Configuration > Général > Web > Optimisation des moteurs de recherche et activez l' Utiliser la réécriture du serveur Web . Plus d'informations dans la documentation officielle Magento
L'URL par langue doit être configurée dans le .htaccess. Copiez simplement ce code après le code « RewriteEngine on » disponible dans le .htaccess par défaut Magento 2 :
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,END]
Enfin, votre .htaccess Magento devrait ressembler à ceci :
Activer le sélecteur de langue
Charger le script Linguise JS
Vous pouvez désormais charger toutes vos pages traduites à l'aide de l'URL, par exemple : www.shop.com /fr/
Le sélecteur de langue est la fenêtre contextuelle du drapeau permettant de sélectionner la langue souhaitée. Pour le charger, vous devrez copier le code donné à la fin de la configuration du site web dans l'en-tête de votre page HTML. Le sélecteur de langue du drapeau sera alors chargé automatiquement.
Le code à copier et charger dans l'en-tête de votre site web est disponible dans votre Linguise > Votre domaine > Paramètre > Onglet : Script PHP
Il doit être chargé dans l’en-tête de votre page. Magento 2 vous offre la possibilité d'ajouter du contenu dans l'en-tête de votre page via la configuration.
Dans le panneau d'administration, accédez à Contenu > Configuration , modifiez la vue du thème de votre boutique par défaut, puis cliquez sur la section HTML Head et ajoutez le script copié à l' entrée Scripts et feuilles de style. Enfin, enregistrez la configuration.
Installez le module de sécurité Magento
Depuis Magento 2.3.5, vous devez ajouter un module de sécurité pour permettre Magento de charger des fichiers depuis le domaine Linguise . Si vous connaissez Magento cela ne posera pas de problème, sinon voici un guide étape par étape :
- Téléchargez le module à partir de ce lien
- Décompressez le contenu du zip dans votre installation Magento dans le répertoire app/code/
- Exécutez ensuite les commandes :
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
Le sélecteur de langue sera affiché par défaut dans une position flottante en bas à droite sur votre site web. Vous pouvez le personnaliser à partir du tableau de bord Linguise .
Remarque importante sur le référencement : le nombre de langues que vous configurez a un impact important sur le référencement. Lorsque vous configurez vos langues de traduction, si vous avez une grande quantité de pages indexées (> 500), le moteur de recherche peut prendre beaucoup de temps pour les traiter. Cela peut avoir un impact sur votre référencement dans votre langue d'origine. C'est pourquoi nous vous conseillons d'ajouter dans un premier temps un maximum de 5 langues, puis lorsque c'est indexé, vous pourrez ajouter des langues par lot de 3 par mois.
Configurer le sélecteur de langue
Le sélecteur de langue peut être personnalisé à partir du tableau de bord Linguise > Paramètres > Affichage des indicateurs de langue. Chaque modification ici sera reflétée sur le site web.
Sur le côté droit de l'écran, vous avez l'aperçu du sélecteur de langue. Voici les éléments que vous pouvez paramétrer :
- 3 mises en page : côte à côte, déroulante ou popup
- La position du sélecteur de langue
- Le contenu du sélecteur de langue
- Noms de langue en anglais ou en langue maternelle
- Formes et taille des drapeaux
- Couleurs et ombre de boîte
Charger le sélecteur de langue dans le contenu Magento
Pour afficher le sélecteur de langue à un endroit spécifique, dans le Magento , vous devez définir la position sur « En place ».
Une fois que vous avez défini la position dans le Linguise , vous pouvez ajouter le shortcode ci-dessous pour l'inclure. Cliquez sur le code ci-dessous pour le mettre dans votre presse-papier.
Une fois ajouté, sur le frontend, le drapeau et les noms de langue seront affichés dans la zone HTML dans laquelle vous avez ajouté le code.
Activer le système de cache local
En option, vous pouvez activer un système de cache local qui stocke les URL et son contenu multilingue associé pour servir les pages plus rapidement. Le cache local permettra d'économiser une partie du transfert 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 retenu en priorité sera le cache des pages multilingues les plus consultées.
En option, 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 :
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte