Le Plugin
Bienvenue sur la page d’accueil du plugin CGML.
Voici l’URL du plugin : http://wordpress.org/extend/plugins/cgml/
Journal de modification
v0.6 : Ajout d’un widget de sélection des langues
v0.5 : Ajout du numéro de version dans la page d’admin
v0.4 : Ajout d’un système d’activation dans la page d’admin
v0.3 : Ajout suffixe et préfixe pour cgml_languages pour un maximum de flexibilité.
v0.2 : Fix dans le pied de page.
v0.1 : Version de lancement. Permet de lier plusieurs blogs ensemble et d’afficher un drapeau dans les articles où on a indiqué une traduction.
Fonctionnement
Récupérez le fichier ZIP sur le site de Wordpress (url plus haut).
Décompressez le dans « wp-content/plugins ».
Rendez vous dans l’écran « Extensions ».
Activez l’extension.
Un nouveau menu apparaîtra dans la partie « Réglages » : CGML.
Vous pouvez cliquer sur « Réglages » directement dans l’écran des plugins pour vous y rendre.
Vous devez activer l’extension CGML dans sa page de « Réglage » une fois la configuration effectuée.
Cliquez pour agrandir :
Une fois dans l’écran de réglages, vous aurez la possibilité d’ajouter autant de langues souhaitées. Chaque langue sera identifiée par une clef et une URL. Vous pouvez donc aussi sur un même blog, héberger plusieurs langues. Il est cependant préférable d’utiliser plusieurs installations de Wordpress. Ainsi tous les menus seront dans la langue souhaitée.
Remplissez donc les champs du formulaire d’ajout d’une langue.
Drapeau : Ce sera l’icône qui apparaîtra dans chaque article.
Clef personnalisée : Clef utilisée pour indiquer qu’il y a une traduction dans cette langue.
Libellé de la langue : Titre qui sera afficher quand vous survolerez le drapeau.
URL : Lien vers le blog.
Exemple pour mon blog :
Drapeau : Anglais
Clef : en
Libellé : English
URL : http://blog.celogeek.com/
Dans mon blog anglais j’aurais :
Drapeau : Français
Clef : fr
Libellé : Français
URL : http://blog.celogeek.fr/
Voilà pour son utilisation au sein d’un article. C’est simple, créer une clef personalisé « cgml » et mettez comme valeur :
clef personalisée:id du post
Exemple :
en:1071
Cela va créer un drapeau anglais (celui avec la clef « en »), avec comme titre « English » et comme url « http://blog.celogeek.com?p=1071″.
Si vous voulez mettre d’autres langues, ajouter de nouveau une clef « cgml » avec la fameuse clef.
Exemple :
it:1010
Vous aurez par exemple ici, 2 clefs « cgml », une avec comme valeur « en:1071″ et une autre avec comme valeur « it:1010″.
Bien, ceci est parfait mais il manque quand même quelque chose. Il faut modifier légèrement votre thème afin d’inscrire le système de drapeaux dans vos pages et vos articles.
En général vous aurez 3 fichiers à modifier, « index.php », « page.php » et « single.php », en gros partout où vous avec un « Edit this ».
Repérer l’endroit où l’on affiche les articles. Il y a généralement un « while (have_posts()): the_posts() ». Chercher l’entête de l’article. Généralement c’est le bloc où il y a « edit_post_link(‘Edit This’) », juste avant la fin du div « </div> » mettez ceci :
<?php if (function_exists(‘cgml_languages’)) cgml_languages(get_the_ID(), ‘ — <span class="cgml_languages">’.__(‘Other Languages’,'cgml’).’: ’,'</span>’) ?>
Cela appelle la fonction qui gère les drapeaux avec comme paramètre le numéro de votre article, un préfixe et un suffixe. Dans mon cas un tiret long, les drapeaux sont dans un span avec une classe adaptée et le texte « Autres langues » déjà traduit dans le plugin cgml.
Si vous aimez les « widgets », alors vous pouvez activer celui de CGML :
Vous aurez accès à un certain nombre d’options pour personnaliser le sélecteur de langues de CGML.
Une fois fait, vous voilà prêt !
Celogeek
