Lorsque vous créez un site web multilingue, vous pourriez parfois avoir besoin d'un contrôle plus poussé sur le contenu qui apparaît dans différentes langues. Par exemple, vous pourriez vouloir afficher une promotion, un texte juridique différent selon la langue, ou masquer complètement du contenu dans des traductions spécifiques.
TranslatePress rend cela possible grâce à des codes courts dédiés qui vous permettent de inclure ou exclure Contenu basé sur la langue active.
Comment utiliser les codes courts conditionnels TranslatePress pour afficher du contenu en fonction de la langue
Il existe deux codes courts disponibles pour restreindre le contenu par langue :
- [language-include] – displays content only in the selected languages.
[language-include lang="fr_FR"] Bonjour [/language-include]- [language-exclude] – hides content in the selected languages.
[language-exclude lang="fr_FR"] Hello [/language-exclude]These shortcodes give you full control over when and where specific content should appear, and whether it should be translatable or displayed exactly as written.
This can also be done with PHP:
<?php
$current_language = get_locale();
if( $current_language == 'en_EN' ){
echo 'text in language en_EN';
}
if( $current_language == 'fr_FR' ){
echo 'text in language fr_FR';
}
?>[language-include]
The [language-include] shortcode displays the content inside it only for the languages you specify.
[language-include lang="en_US, fr_FR, es_ES"]
Your content here
[/language-include]Attributes:
- lang – A comma-separated list of language codes where the content should be displayed.
Example: lang=”en_US, fr_FR, es_ES”
The language codes can be found in General tab, within the Code column associated with each language.
[language-exclude]
The [language-exclude] shortcode hides the content inside it for the specified languages.
[language-exclude lang="en_US, es_ES"]
Your content here
[/language-exclude]Attributes:
- lang – A comma-separated list of language codes where the content should be hidden.
Example: lang=”en_US, es_ES”
The language codes can be found in General tab, within the Code column associated with each language.
It is also possible to use the conditional shortcode to display Gutenberg blocks only in the desired language.
To do this, you will have to wrap the Gutenberg block between two shortcode blocks. The first shortcode block will contain the start of our conditional shortcode (eg. [language-include]) and the second block will contain the end of our conditional shortcode (eg. [/language-include]).
Le résultat peut être vu dans les images suivantes. La première page est la version anglaise par défaut et la seconde est la version espagnole de la même page.
Afficher des vidéos par langue
Vous pouvez utiliser des shortcodes conditionnels pour afficher un contenu vidéo différent pour chaque langue sur votre site web.
Pour ce faire, il suffit d'encapsuler chaque bloc vidéo entre deux blocs de shortcode pour la langue cible. Le premier bloc de shortcode contiendra le début de notre shortcode conditionnel (par exemple, ).
Les résultats peuvent être vus dans les images suivantes. La première page affiche la vidéo dans sa version anglaise par défaut, et la deuxième page affiche la vidéo dans la version espagnole de la même page.
[trp_language] shortcode (!DEPRECATED)
The [trp_language] shortcode was originally used to display content only for a specific language. For example:
[trp_language language="en_US"] English content only [/trp_language]Starting with TranslatePress version 2.9.21, this shortcode is considered deprecated. While it will continue to work and will not be removed, we encourage you to use the new [language-include] et [language-exclude] shortcodes instead.
The new shortcodes provide more flexibility, give you control over whether the content should be translatable or not, and are the recommended way to manage conditional content going forward.
If you are already using [trp_language], there is no need to update your site immediately. Everything will still function as before, but for future projects we suggest switching to the new shortcodes.
Display images based on language with the conditional shortcode
Another use case of the conditional shortcode is for translating images, basically displaying different images for different languages.
[trp_language language="en_US"]
<img src="https://example.com/image_en.png" />
[/trp_language]
[trp_language language="fr_FR"]
<img src="https://example.com/image_fr.png" />
[/trp_language]However, this can now be easily achieved directly from the front-end using the built-in Traduction d'image functionality.
It is also possible to use the conditional shortcode to display Blocs Gutenberg only in the desired language.
To do this, you will have to wrap the Gutenberg block between two shortcode blocks. The first shortcode block will contain the start of our conditional shortcode ([trp_language language="en_US"] and the second block will contain the end of our conditional shortcode [/trp_language]).
Le résultat peut être vu dans les images suivantes. La première page est la version anglaise par défaut et la seconde est la version espagnole de la même page.
Une autre alternative au code court conditionnel TranslatePress est le Chaîne de traduction interface où vous pouvez accéder aux chaînes gettext (telles que les e-mails) et les traduire facilement à partir d'une liste.