Table of Contents
exigences techniques phpBB
La traduction automatique neuronale utilisée avec le forum phpBB nécessite l'installation d'un script PHP (téléchargeable ci-dessous). Pour installer le script Linguise , vous aurez besoin des éléments suivants :
- Exécutez PHP 7+
- Serveur Apache, LiteSpeed, NGINX, IIS
- Assurez-vous que la réécriture d'URL est activée sur votre serveur
- phpBB 3 et versions ultérieures
1. Générez la clé API
Après votre connexion ou votre inscription à votre tableau de bord Linguise , vous devrez d'abord configurer un nouveau domaine et enregistrer ses paramètres pour obtenir la clé API.
Vous pouvez sélectionner la plate-forme "Autre PHP" pour procéder à l'enregistrement du domaine Linguise , comme cette documentation et les langues source et de destination.
Vous obtiendrez ensuite :
- La clé API qui valide votre adhésion
- Le lien vers le script Linguise pour le sélecteur de langue
La clé API est indispensable pour activer la traduction sur votre forum phpBB . Concrètement, elle permet de vérifier la langue activée sur votre domaine et d'autoriser la traduction automatique du contenu.
Pour l'instant, vous pouvez copier la clé API et la conserver dans votre presse-papiers.
2. Téléchargez et connectez le script de traduction Linguise
Le script de traduction Linguise doit être téléchargé sur votre serveur où phpBB est installé :
Une fois le script téléchargé, décompressez-le et téléversez-le dans le dossier racine où phpBB est installé.
- Assurez-vous qu'il se trouve à la racine de votre site web (là où se trouvent vos fichiers phpBB
- Assurez-vous que le dossier garde son nom par défaut « linguise »
Comment accéder à l'interface de script Linguise ?
Après avoir terminé l' Linguise , vous pouvez accéder au tableau de bord en visitant votre site Web avec le format URL suivant:
https://www.domain.com/ linguise
Modifiez l'adresse de domaine en fonction de l'adresse de votre site Web *
Assurez-vous Linguise a une autorisation de lecture et d'écriture appropriée *
Configuration du mot de passe et de la connexion de la base de données
Une fois que vous aurez accédé à l'interface de 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.
Tu peux:
- Définissez un mot de passe, qui sera requis pour l'accès futur à cette interface.
- Choisissez votre type de base de données - MySQL ou SQLite, selon votre configuration et votre préférence.
Cette configuration initiale garantit un accès sécurisé et vous permet de configurer le script en fonction de votre environnement.
Connexion de la base de données MySQL
Si vous choisissez MySQL, une interface différente apparaîtra pour demander 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 base de données populaires utilisés pour stocker et gérer les données pour les sites Web et les applications. Cependant, ils sont conçus pour différents cas d'utilisation et ont des différences clés:
| Fonctionnalité | Sqlite | Mysql |
|---|---|---|
| Installation | Très facile (installation SQLite requise) | Nécessite la configuration du serveur |
| Stockage | Fichier unique | Géré par MySQL Server |
| Performance | Idéal pour les applications à petite échelle | 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 plate-forme PHP
Le tableau de bord de traduction Linguise , précédemment disponible uniquement pour Joomla et WordPress, étend désormais la prise en charge de PHP et des plates-formes supplémentaires. Cette mise à jour permet aux utilisateurs de configurer de manière transparente les paramètres du langage, tels que les options d'affichage, les styles de signalement et la personnalisation de l'apparence - directement à partir d'une interface unifiée, quel que soit leur CMS ou leur cadre.
Les administrateurs peuvent gérer plus efficacement les paramètres Linguise , avec des fonctionnalités cohérentes telles que les popups de sélection de langage, les effets d'ombre et les variantes de choix de drapeau spécifiques à la région. Le tableau de bord conserve sa conception conviviale tout en offrant une compatibilité plus large pour divers environnements Web.
3. Configurer la réécriture des URL phpBB
Pour charger votre langue sur les nouvelles URL (comme domain.com /es ), l'URL doit être configurée dans phpBB , Panneau de contrôle d'administration (ACP) > Général, puis sur le côté gauche > Paramètres du serveur.
Il existe deux options d'activation, qui sont d'ailleurs les meilleures pour le référencement naturel :
- Activer l'option de réécriture d'URL,
- Utiliser la réécriture d'URL (nécessite la modification d'un fichier pour fonctionner correctement)
Une fois que vous aurez activé la fonction « Activer la réécriture d’URL », vous devrez modifier le fichier .htaccess.
L'URL par langue doit être configurée dans le fichier .htaccess. Copiez simplement le code ci-dessous après le code « RewriteEngine on » présent dans la configuration par défaut phpBB .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 désormais charger toutes vos pages traduites à l'aide de l'URL, par exemple : www.shop.com /fr/
Chargeons maintenant le sélecteur de langue.
4. Activez le sélecteur de langue
4.1 Charger le script Linguise JS
Le lien vers le script Linguise JS doit être chargé sur toutes vos pages phpBB pour afficher le sélecteur de langue avec les drapeaux et les URL alternatives dans vos en-têtes HTML (à des fins de référencement).
Pour copier le lien du script, depuis le tableau de bord Linguise , accédez aux paramètres du domaine et copiez le lien du script.
La méthode la plus simple pour charger ce code dans phpBB est de l'ajouter dans l'en-tête de votre site web ou phpBB phpBB avec un environnement spécial et un fichier spécifique permettant d'ajouter un script à l'en-tête.
Il se trouve dans le overall_header.html , que vous pouvez trouver en naviguant jusqu'au dossier d'installation de votre CMS, à l'emplacement suivant :
/styles/prosilver/template/overall_header.html
Modifiez le fichier de script pour inclure le lien du script dans l'en-tête, comme ci-dessous. De plus, vous devrez vider le cache une fois le script inséré dans le fichier overall_header.html
Le sélecteur de langue s'affichera par défaut en bas à droite de votre site web. Vous pouvez le personnaliser comme expliqué dans le chapitre suivant.
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.
Configurez le sélecteur de langue dans phpBB
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 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 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 phpBB
Pour afficher le sélecteur de langue à un emplacement précis dans le phpBB , définissez sa position sur « À cet emplacement ».
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é, 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 l'option du 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.
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.
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
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;
Traduction automatique sur les serveurs Windows IIS
Ajoutez la ligne correspondant à votre constructeur de site Web dans votre fichier Web.config.
Il doit être défini avant toute autre redirection, notamment 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 Configuration.php, il existe 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 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 = '';