Here is a quick Qtranslate tutorial for those who are a bit lost. I don't know if it's the best plugin for a multilanguage website, it depends on your needs, but for me, it was by far the best choice!
Pros
- Have the same URL for posts (write only one post, not several)
- Be able to translate everything: categories, templates, tags, etc.
- Clean URL: /en/postname for example
Cons
- The post URL is only in one language => this is fixed with qtranslate-slug plugin
Installation
Install Qtranslate and choose the languages you want to enable/disable or delete.
In the advanced options, you can choose the type of URL you want. I chose pre-path mode because it's prettier.
If you already have categories and tags, you will have to edit them to translate them. When you add new categories, don't forget their translations !
Usage
Note: I will use x1 and x2 instead of en and fr to not mess up my codes (since Qtranslate recognize them if I put en & fr).
How to change the blog title?
Just write
[:x1]English title[:x2]Titre français
directly in the blog title input on WordPress. x1 and x2 are your languages of course (en and fr for example). It should also work for widgets and some plugins like All in One SEO Pack.
How to insert multilanguages text in my theme ?
<?php _e('[:x1]English text[:x2]Texte en français'); ?>
You can use this code for almost everything. Let's use a different stylesheet for each language:
<link rel="stylesheet" type="text/css" href="<?php _e('[:x1]english.css[:x2]<francais.css'); ?>" />
How to translate WordPress template tags ?
Let's translate the_content() :
<?php the_content(__('[:x1]Lire la suite[:x2]Read more')); ?>
This code snippet will show the correct translation of the "Read more" text if you have decided to show only excerpts on your blog. An other example with edit_post_link() :
<?php edit_post_link(__('[:x1]Modifier[:x2]Edit'), '', ' | '); ?>
How to display a language chooser with flags ?
Insert this code wherever you want the language chooser to be:
<?php echo qtrans_generateLanguageSelectCode('image'); ?>
You can style it with CSS:
.qtrans_language_chooser { list-style-type:none; }
.qtrans_language_chooser li { float : left; margin-right: 20px; }
If you want to only display the flag of the inactive language, add this code to your CSS:
.qtrans_language_chooser li.active { display : none; }
If you don't want flags and simply text, use this code instead:
<?php echo qtrans_generateLanguageSelectCode('text'); ?>
Are you running WP3 with the qTranslate 2.5.7, just curious?
— Thomas June 30, 2010 13:43
Hello, that's right, I'm using qtranslate 2.5.7 with Wordpress 3.0 :) It worked without tweaks with some minor bugs, but I modified its code a bit !
— Karine June 30, 2010 19:12
Bonjour, merci pour votre tuto qui m'a beaucoup aidé sur l'utilisation de qTranslate pour WP :)
Je me retrouve actuellement dans le probleme du slug multilingue , j'ai bien installé mon plugin qTranslate Slug, mais toujours le même probleme de slug , uniquement dans la langue par défaut.
Pourriez vous me détailler quelque peu la maniere d'utiliser ce plugin , ou les eventuels points que j'aurais pu oublier ?
Merci beaucoup pour votre tuto , et pour la qualité de votre blog.
A bientot
— Mathieu July 2, 2010 8:04
Bonjour ! Contente que ça ait aidé quelqu'un ! :) Malheureusement pour l'histoire de fr/my-page, il n'y a pas encore de solution ! Je tenterai de tweaker le plugin quand j'aurai le temps mais ce n'est pas dans l'immédiat :)
— Karine July 2, 2010 17:00
Bonjour,
Désolé de me répondre tout seul sur votre blog , mais je suis arrivé a faire fonctionner ce cher plugin ! il me reste cependant encore un tâche a effectuer , qui ne fonctionne pas chez moi mais qui fonctionne chez vous.
Tout d'abord ma config , wordpress 2.9.2 , avec la dernière version de qTranslate. Mon probleme ,en clair , lorsque je suis sur une page du type http://mon.url/en/my-page et que je change de langue , il me redirige vers http://mon.url/fr/my-page alors que la logique voudrait qu'il m'emmene sur http://mon.url/fr/MA-page...
Cela fonctionne parfaitement pour les articles et non pas pour les pages... Auriez vous une idée ? ;)
— Mathieu July 2, 2010 14:16
Bonjour, merci de votre réponse , je vais donc tenter de me lancer dans une grosse séance de débugging pour tenter d'optimiser ce fonctionnement ! Si j'y repense , je repasserais par votre blog pour vous informer ! Encore merci ;)
— Mathieu July 5, 2010 11:08
Hi!
I have a problem with this plugin and wrote it to the offical forum but didn't got an answer so far. My problem is that the plugin doesn't add fields to the admin "edit" and "add new" site or article... There is just one field for example the title: Title
I think it should convert the into a new field but it doesn't
Thanks for the reply
— Cyberto October 9, 2010 16:07
Hi,
I am using the MM Forms plugin with Wordpress 2.8.5. How do use qtranslate to enable different languages from within my form definition?
I tried:
[text your-name class:regField "Name"][email* your-email class:regField "*Email"]<td title = "">[submit]
[text browser id:browser class:hiddenField][text version id:version class:hiddenField][text os id:os class:hiddenField][text param id:param class:hiddenField]
But the 'title' attribute of the just shows unparsed text containing the PHP statement.
Many thanks
Jeremy
— Jeremy November 9, 2010 8:56
salut essai cela!
pour buddypress , veuillez utilser ce hack :
//comment out next line, otherwise 404 page is displayed
//add_filter('clean_url', 'qtrans_convertURL');
//include language slug in all URL's
add_filter('bp_core_get_root_domain', 'qtrans_convertURL');
— megainfo February 10, 2011 9:19
Merci pour le tip :)
— Karine February 12, 2011 4:40
Hello.
Merci pour ce tutoriel qTranslate !
Mais après passé 10heures sans solutions, je me permets d'appeler à l'aide.... En effet, je souhaite mettre les drapeaux des langues en les intégrants dans la barre des Menus WP, ou alors à la suite, mais impossible. J'ai beau essayé d'insérer des div, je n'arrive pas à placer le code qtrans_generateLanguageSelectCode('image');
Si une personne a une petite, euh une grande idée, voici le code qui se trouve dans le header.php
— Mathieu March 8, 2011 17:18
Oups, le code ne s'est pas mis en entier et pas en format code... comment puis-je faire ?
— Mathieu March 8, 2011 17:20
Hi everyone!
Is possible to use the dropdown menu only with the flags images?
Thanks
— Miguel June 8, 2011 0:16
I'm having difficulties to only display the flag of the inactive language! Can anyone help me?
My css styles are: (every line works well, apart from the " li.active")
Thanks
.qtrans_language_chooser { list-style-type:none; }
.qtrans_language_chooser li { float: right; margin-left: 5px; display:inline; }
.qtrans_language_chooser li.active { display:none; }
.qtrans_flag { border:1px solid #ffffff;
-moz-border-radius: 2px;
-webkit-border-radius: 2px;
-khtml-border-radius: 2px;
border-radius: 2px;
}
— Miguel June 10, 2011 0:35
hello,
merci pour toutes ces astuces !
par contre, pour changer les titles des pages lorsque l'on utilise l'excellent plugin SEO (et donc le champ Custom Post Title). Là pour avoir un titre en plusieurs, comment fait-on ?
les [:x1]
ou Bonjour Hello ne sont pas gérés :
cela donne en title : Bonjour Hello
tu aurai une idée ?
merci encore pour tout,
Jean
— jean July 6, 2011 7:22
Hello tout le monde!
Ce blog à l'air très actif et je me tente d'appeler à l'aide.
J'ai installé la version de Wordpress 3.2.0 et mis en place la dernière version du plug-in de qTranlate 2.5.22, qui sont sensé à priori bien fonctionner ensemble.
Tout marche très bien jusqu'au moment où je souhaites me rendre sur la page "Catégories" où ma page est carrément "gelée", c'est à dire elle est affichée, mais le navigateur continue à essayer de la charger et on ne peut plus rien faire et plus cliquer sur aucun lien (et encore moins sélectionner une catégorie).
Qd le plug-in est désactivé la rubrique "Catégorie" fonctionne très bien.
J'ai déjà tenté de désactiver ts les autres plug-in et de réinstaller qTranslate, mais rien à faire.
Quelqu'un aurait-il une explication, ou encore mieux une esquisse de solution?
Merci d'avance
c.
— Caroline M. July 8, 2011 0:11
A embed code like [x1], [x2] isn't work on my theme.
— YeuHost August 22, 2011 12:54
Hello, how exactly are you using the code?
— Karine August 22, 2011 20:08
Hello,
Merci pour cette article, très très utile, cependant il une question qui n'a pas été soulevé (ou je ne l'ai pas trouvé).
Comment traduire les nouages de mots ????
Merci d'avance.
Heder
— Heder September 2, 2011 16:38
Salut Karine,
J'ai une question, j'ai installer qtranslate mais une fois que je vais
dans les Paramètres avancés, choisissez le mode de modification de l'URL que vous préférez, j'utilise le mode chemin car il correspond à la structure de permalien que j'ai choisi.
Une fois que j,ai fait ceci je sauvegarde mais il me revient encore pas défault, il me revien a USE QUERY MODE COMMENT ARRANGER CELA , EST LES PERMISSIONS?
— Patrice September 17, 2011 0:04
Hi Karine,
I'm running Wordpress 3.2.1 and Qtranslate 2.5.24
In my dashboard, I don't see the fields for translating tags (you have it shown at the end of the installation section)
I've got the posts to work fine with English and French. Now I need to get the other text elements to change language (ie. the text in side bar, comments, etc). Could you explain a bit further on how [:x1] and [:x2] works and where I should be inserting this code? Does it involve child themes?
Many thanks.
Elaine
— elaine September 21, 2011 19:23
After reading more articles, I know understand that you use [:x1] and [:x2] to substitute the actual language codes in order for them to read/render on the webpage.
I'm still trying to figure out how to translate the other items on the page.
Any guidance would be appreciated!
Elaine
— elaine September 21, 2011 23:50
Awesome, thank you very much!!!!
— Deva September 25, 2011 1:31
Hello there!
I hope you can help me with this. I'm using a premium WordPress theme called "Display" which has following code for "read more" link:
echo 'Read more';
Is it possible to change it somehow so it can work with qTranslate?
Thank you in advance!
— Deva October 3, 2011 3:37
I just realized that I wrote a code in a wrong way :)
"Read more" link code looks like this:
echo '<a href="'.get_permalink().'"class="more-link">Read more</a>';
— Deva October 4, 2011 21:50
Bonjour,
merci pour ce tuto. J'aimerai connaître pour le CSS : sur quel CSS travaillez-vous ? En ce qui me concerne, je travaille sur le CSS "Style.css", et je copie le code à la fin de mon fichier, mais il ne veut rien prendre en compte. Avez-vous une idée ?
Merci à tous.
— Jb October 20, 2011 6:03
Essayez d'ajouter !important avant chaque point virgule ?
— Karine November 12, 2011 20:00
Bonjour,
Une chose que je ne comprends pas et sur lequel, je ne trouve pas de solutions, ce sont les liens internes dans Wordpress 3.
Maintenant que Wordpress nous permet de faire des liens internes rapidement, je suis obligé d'aller transformer l'url à la main pour ne pas être redirigé vers la langue par défaut. J'ai vu des hacks pour le plugin link-to, mais j'aimerai autant ne pas hacker les fichiers de WP.
Une idée ?
Merci
— Eddy November 14, 2011 18:04
Bonjour,
Merci pour cet article, tu as un blog vraiment très intéressant.
J'aurai une question, j'ai cherché un peu partout sur le web, mais je ne trouve pas de réponse.
Je travaille avec qtranslate, tout fonctionne bien, sauf que je n'arrive pas à afficher les images des drapeaux. J'ai inséré le choix des langues via Widget, en cochant bien "Image et Texte" mais cela n'affiche que le texte.
J'ai essayé avec le bout de code :
toujours rien. (par contre même en essayant d'afficher le texte avec cette même ligne de code en prenant "text" en argument, ne m'affiche pas le texte non plus...)
Si vous avez une réponse, je suis preneuse ! Merci bien
— Claire November 18, 2011 0:42
i just dont get it - where are you supposed to put this line of code to make the language selector show up at the very top right of your WP site?
theme options - color & fonts?
style.css?
functions.php ???
— steven December 13, 2011 4:53
Hello, you need to put it in your theme files, like header.php for example
— Karine December 20, 2011 16:34
Thanks. Helped a lot.
— Robert Klein December 30, 2011 19:38
Bonjour,
Merci pour cet article très intéressant.
Quelqu'un utilise qtranslate avec les sous domaines ?
Pour moi cela ne fonctionne pas et je ne connais pas le paramétrage à mettre en place.
Merci d'avance pour votre aide
— Julie January 20, 2012 1:37
Bonjour Julie, j'ai testé sur un sous-domaine, ça devrait fonctionner de la même façon... Quels problèmes as-tu ?
— Karine January 29, 2012 19:32
Bonjour Karine, lorsque je mets en place les sous-domaines les pages sont bien redirigées vers fr.mondomaine.com mais à ce moment là je n’obtiens qu'une page blanche, aucun contenu.
Hormis la création des sous-domaines faut'il faire quelque chose de spécial ? Merci pour ton retour :)
— Julie January 30, 2012 1:46
Bonjour, et merci pour cet article...
j'ai une question concernant l'utilisation de ce plugin, mais je ne trouve nulle part la réponse.
Je voudrais qu'en cas de non traduction de l'article, celui-ci s'affiche automatiquement dans la langue par défaut (en gros la totalité de mon site est en francais mais certains contenus sont traduits en Anglais. Je voudrais que si les contenus n'existent pas en Anglais, ils s'affichent d'office en Francais).
D'avance, merci
— Jean February 20, 2012 2:50
Bonjour, il me semble que qtranslate fait ceci par défaut ?
— Karine March 12, 2012 0:41
salut, merci pour l'article, il ma's bien aide, j'ai juste un probleme que je n'arrive pas a regler avec QTranslate. Peux on mettre des variables?
j'ai des variables a traduire, par exemple dans mon formulaire de contact:
if(trim($_POST['contactName']) === '') {
$nameError = 'Please enter your name.';
...
j'ai essaye avec:
$nameError = '[:en]Please enter your name.[:fr]Entrez votre nom svp.';
mais ca ne marche pas....
avez vous une solution svp?
merci par avance
— myput March 11, 2012 12:17
Bonjour,
Es-tu obligé d'utiliser une variable ? Je ferais plutôt comme ça :
if(trim($_POST['contactName']) === '') {
_e('[:x1]Please enter your name.[:x2]Entrez votre nom svp.');
}
— Karine March 11, 2012 17:42
Merci pour la reponse rapide :) oui j'ai pu me debrouiller pour les variables simples du formulaire, mais j'ai encore en soucis avec les variables:
$empty = 'data-empty="'.__('No more posts available.', 'framework').'" ';
Peux on les traduires ?
Merci d'avance
— myput March 12, 2012 9:49
Hi i use WP 3.3.1 and qTransate 2.5.28 and maybe i've found a bug..
default language: IT , other language : EN.
if i insert the "more tag" in a post (both IN ITA-ENGLISH TAB),after i save the post and i want to see the english tab i loose the content in it, and i see only the tag more.. if i remove the "more tag" , all backs to normal and works fine.. how can i solve it?
thanks Maurizio
— maurizio April 2, 2012 3:52
question …
je vais devoir intégrer le plugin wpml ou qtranslate pour un site multilangue et j'ai du mal à choisir …
le prix n'est pas nécessairement un pb, mais si qtranslate est OK autant l'utiliser !
la question se situe surtout au niveau SEO, j'ai lu que WPML traduit automatiquement les postnam (texte des URL), est ce que qTranslate le permet directment ? par un plugin ?
Merci
Sebastien
— aem April 13, 2012 6:28
Bonjour, qTrranslate ne le fait pas automatiquement... Quelqu'un a fait un plugin pour ça, mais ce n'est pas complètement au point. Personnellement c'est ce que j'utilise sur le site pour transformer mes URLs en français. http://www.qianqin.de/qtranslate/forum/viewtopic.php?f=4&t=1049
— Karine April 16, 2012 6:04