Bei der Erstellung einer mehrsprachigen Website benötigen Sie möglicherweise mehr Kontrolle darüber, welche Inhalte in verschiedenen Sprachen angezeigt werden. Sie möchten zum Beispiel eine Werbeaktion anzeigen, unterschiedliche Rechtstexte je nach Sprache darstellen oder Inhalte in bestimmten Übersetzungen vollständig ausblenden.
TranslatePress macht dies mithilfe spezieller Shortcodes möglich, mit denen Sie einbeziehen oder ausschließen Inhalt basierend auf der aktiven Sprache.
So verwenden Sie die bedingten TranslatePress-Shortcodes, um Inhalte je nach Sprache anzuzeigen
Es gibt zwei Kurzcodes für die sprachbasierte Inhaltsbeschränkung:
- [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]).
Das Ergebnis ist in den folgenden Bildern zu sehen. Die erste Seite ist die standardmäßige englische Version und die zweite ist die spanische Version derselben Seite.
Videos nach Sprache anzeigen
Sie können bedingte Kurzcodes verwenden, um für jede Sprache unterschiedliche Videoinhalte auf Ihrer Website anzuzeigen.
Um dies zu tun, fassen Sie jeden Videoblock einfach in zwei Shortcode-Blöcke für die Zielsprache ein. Der erste Shortcode-Block enthält den Anfang unseres bedingten Shortcodes (z. B. ).
Die Ergebnisse sind in den folgenden Bildern zu sehen. Die erste Seite zeigt das Video in der standardmäßigen englischen Version und die zweite Seite zeigt das Video in der spanischen Version derselben Seite.
[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] und [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 Bildübersetzung functionality.
It is also possible to use the conditional shortcode to display Gutenberg-Blöcke 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]).
Das Ergebnis ist in den folgenden Bildern zu sehen. Die erste Seite ist die standardmäßige englische Version und die zweite ist die spanische Version derselben Seite.
Eine weitere Alternative zum bedingten Shortcode „TranslatePress“ ist der Zeichenfolgenübersetzung Oberfläche, über die Sie Gettext-Strings (wie z. B. E-Mails) abrufen und sie einfach aus einer Liste übersetzen können.