apply_filters( 'wpml_translate_single_string', string $original_value, string $domain, string $name, string $language_code )
- Typ
- filter
- Kategorie
- Abrufen lokalisierter Inhalte
- WPML-Version
- 3.2
Beschreibung
*Ruft die Übersetzung eines einzelnen Text-Strings ab (im Gegensatz zu einem String, der Teil eines Pakets** ist). Der Filter sucht nach einem String mit passender $domain und passendem $name. Wenn er ihn findet, sucht er nach einer Übersetzung in der aktuellen Sprache oder der Sprache, die Sie angeben. Wenn eine Übersetzung existiert, gibt er sie zurück. Andernfalls gibt er den Original-String zurück.
*Um einen String für die Übersetzung zu registrieren, siehe: wpml_register_single_string
**Für das Abrufen einer String-Übersetzung, die Teil eines Pakets ist, siehe: wpml_translate_string
Hinweis: Dieser Hook erfordert das Modul WPML String-Übersetzung
Argumente
- $original_value
- (string) (Erforderlich) Der ursprüngliche Wert des Strings
- $domain
- (string) (Erforderlich) Die registrierte Domain des Strings
- $name
- (string) (Erforderlich) Der registrierte Name des Strings
- $language_code
- (string) (Optional) Gibt die Übersetzung in dieser Sprache zurück. Der Standardwert ist NULL, was die aktuelle Sprache zurückgibt
Anwendungsbeispiel
Wir greifen dasselbe Beispiel des Widgets auf, das wir für den Action-Hook „wpml_register_single_string“ verwendet haben. Vielleicht möchten Sie dorthin zurückkehren, um Ihr Gedächtnis aufzufrischen. Wir verwenden den Filter „wpml_translate_single_string“ in der Ausgabefunktion des Widgets.
Beispiel
function widget($args, $instance){
extract($args);
$title = apply_filters('widget_title', $instance['title'] );
$custom_input = apply_filters('wpml_translate_single_string', $instance['custom_input'], 'Widgets', 'Custom Widget - input field' );
$custom_textarea = apply_filters('wpml_translate_single_string', $instance['custom_textarea'], 'Widgets', 'Custom Widget - textarea field' );
# Before the widget
echo $before_widget;
# The title
if ( $title )
echo $before_title . $title . $after_title;
# Output...
Verwandte Hooks
wpml_media_url, wpml_media_id, force_suppress_filters, wpml_get_translated_slug, wpml_home_url, wpml_translate_string, wpml_elements_without_translations, wpml_permalink, wpml_unfiltered_admin_string, wpml_element_link