Was bringt die gettext-Syntax?

__ (doppelter Unterstrich)ist die Basisübersetzungsfunktion. Es übersetzteine Zeichenfolge undgibt sie als Zeichenfolge zurück.

_emacht dasselbe wie __,aber das Ergebnis wird sofort wiedergegeben.

_xist die kontextbezogene Übersetzungsfunktion. Esgibt eine zweite Option,um den Personen,die die Übersetzung durchführen,einen Kontextbereitzustellen.

_exist dasselbe wie _x,aber Echoist das Ergebnis.

Beispielfür die Verwendung von _x:

 $string = _x( 'Buffalo', 'an animal', 'plugin-domain' );
$string = _x( 'Buffalo', 'a city in New York', 'plugin-domain' );
$string = _x( 'Buffalo', 'a verb meaning to confuse somebody', 'plugin-domain' );
 

Manchmal kann dieselbe Zeichenfolgein anderen Sprachen unterschiedlich sein. Durch die Bereitstellung von Kontextfür die Übersetzer können sie die richtigen Wörter auswählen.

Verknüpfungsfunktionen:

• esc_attr__: Entspricht __,führt das Ergebnisjedoch auch über esc_attr aus.
• esc_html__: Entspricht __,führt das Ergebnisjedoch auch über esc_html aus.
• esc_attr_e: Entspricht _e,führt das Ergebnisjedoch auch über esc_attr aus.
• esc_html_e: Entspricht _e,führt das Ergebnisjedoch auch über esc_html aus.
• esc_attr_x: Entspricht _x,führt das Ergebnisjedoch auch über esc_attr aus.
• esc_html_x: Entspricht _x,führt das Ergebnisjedoch auch über esc_html aus.

_nist der Pluralisierungshandler. Beispiel:

 $string = sprintf( _n(
        'You have %d taco.', 
        'You have %d tacos.', 
        $number, 
        'plugin-domain'), 
    $number );
 

In diesem Beispielgibt es zwei Möglichkeiten,die Anzahl der Tacos zubestimmen,je nachdem,ob sie singulär sind odernicht. Dieerste Verwendung von $numberteilt der Funktion _nmit,welche Version verwendet werden soll. Die zweite Verwendung von $numbererfolgtim Sprintf,um% d durch dietatsächliche Zahlin der Zeichenfolge zuersetzen.

Esgibt keine Echofunktion,diefür _n äquivalentist,aberesgibt eine Funktionnamens _nx. Esisteine Kombination aus _n und _x. Pluralisierung und Kontext.

_n_noopistetwas Besonderes. Es wird zum Übersetzenpluralisierter Zeichenfolgen verwendet,führt die Übersetzungjedochnicht sofort durch. Diesistnützlich,wenn Sie die Zeichenfolgen zentralisierenmöchten,die Arbeitjedoch aneiner anderen Stelle ausführenmöchten. Die Funktion,die die Arbeittatsächlich an anderer Stelleerledigt,ist translate_nooped_plural.

Beispiel:

 $holder = _n_noop('You have %d taco.', 'You have %d tacos.', 'plugin-domain');
// ... later ...
$string = sprintf( translate_nooped_plural( $holder, $count ), $count );
 

Dies wirdnicht oft verwendet,kann aberfür die Organisationnützlich sein. Wenn Siebeispielsweise alle Ihre Zeichenfolgenin einer Datei ablegen und dann an anderer Stelle referenzieren,ist diesmit _nnichtmöglich. Dazubenötigen Siebeispielsweise _n_noop .

_nx_noopist dasselbe wie _n_noop,kann aber aucheinen Kontextfür die Übersetzer annehmen,wie _x.

Beachten Sie,dass Sie die Domäneentwederin den Funktionsaufrufnoop oderin den Funktionsaufruftranslate_nooped_pluraleinfügen können. Wasfür Ihr Unternehmen sinnvollerist. Wennbeideeine Domain haben,gewinnt die an den Noop-Anruf übergebene.

number_format_i18nentspricht demin PHPintegrierten number_format ,aberesfügt die Behandlungfür Dinge wie Dezimalstellen usw. hinzu,die sichin anderen Gebietsschemas unterscheiden.

date_i18nentspricht demin PHPintegrierten Datum ,mit all dereinschlägigen Handhabung dort auch. Monatsnamen,Tagesnamen usw.

Auch verstößtniemalsgegen die Gesetze . Nureine Erinnerung. :)

__ (double underscore) is the base translate function. It translates a string and returns it as a string.

_e does the same as __, but echo's the result immediately.

_x is the contextual translate function. It has a second option to provide context to people doing the translation.

_ex is the same as _x, but echo's the result.

Example of using _x:

$string = _x( 'Buffalo', 'an animal', 'plugin-domain' );
$string = _x( 'Buffalo', 'a city in New York', 'plugin-domain' );
$string = _x( 'Buffalo', 'a verb meaning to confuse somebody', 'plugin-domain' );

Sometimes the same string can be different in other languages. Providing context to the translators can help them pick the right words.

Shortcut functions:

• esc_attr__ : Equivalent to __ but also runs the result through esc_attr.
• esc_html__ : Equivalent to __ but also runs the result through esc_html.
• esc_attr_e : Equivalent to _e but also runs the result through esc_attr.
• esc_html_e : Equivalent to _e but also runs the result through esc_html.
• esc_attr_x : Equivalent to _x but also runs the result through esc_attr.
• esc_html_x : Equivalent to _x but also runs the result through esc_html.

_n is the pluralization handler. Example:

$string = sprintf( _n(
        'You have %d taco.', 
        'You have %d tacos.', 
        $number, 
        'plugin-domain'), 
    $number );

In that example, there's two ways to say the number of tacos, depending on if it's singular or not. The first use of $number tells the _n function which version to use. The second use of $number happens in the sprintf, to replace the %d with the actual number in the string.

There is no echo function equivalent for _n, but there is a function named _nx. It's a combination of _n and _x. Pluralization and context.

_n_noop is a special one. It's used for translating pluralized strings, but not actually performing the translation immediately. This is useful if you want to make the strings centralized but actually do the work elsewhere. The function that actually does the work elsewhere is translate_nooped_plural.

Example:

$holder = _n_noop('You have %d taco.', 'You have %d tacos.', 'plugin-domain');
// ... later ...
$string = sprintf( translate_nooped_plural( $holder, $count ), $count );

This isn't used much, but can be handy for organization. If you put all your strings in one file, for example, then reference them elsewhere, this wouldn't be possible with just _n, you need something like _n_noop to do that.

_nx_noop is the same as _n_noop, but also can take a context for the translators, same as _x.

Note that you can put the domain into either the noop function call, or into the translate_nooped_plural function call. Whichever makes more sense for your organization. If both have a domain, then the one passed to the noop call wins.

number_format_i18n is the equivalent to PHP's built-in number_format, but it adds in the handling for things like decimals and so on, which are different in other locales.

date_i18n is the equivalent to PHP's built-in date, with all the pertinent handling there as well. Month names, day names, etc.

Also, never break the laws. Just a reminder. :)

__ (),_e () und _x (),_ex ()

__() und _e() sindim Wesentlichenbeideein Wrapper von translate() (nicht direkt verwenden) undfastgleich.

Der Unterschiedbesteht darin,dass __() das Übersetzte zurückgibt Zeichenfolge und _e() geben es wieder. Beidenmusseine Zeichenfolge alserforderlicher Parameter undnormalerweise,obwohl optional,aucheine Textdomäne zugeführt werden.

Analoggibt es _x() und _ex() ,mit dem Sieeinen Kontext angeben können,derbeschreiben kann,wo die Zeichenfolge angezeigt wird. Wenn Ihr Projektmehr alsein paar zehn übersetzbare Zeichenfolgenenthält,ist die Verwendung des Kontexts sehr sinnvoll.

Beachten Sie auch das Vorhandensein von _n() und < a href="http://codex.wordpress.org/Function_Reference/_nx" rel="nofollow"> _nx() für Pluralformen.

Beispielfür die allgemeine Verwendung

 $output = '<label for="some_field">' .
        _x( 'Some Information.', 'Some Form Field', 'your-text-domain' ) .
    '</label>' .
    '<input type="text" name="some_field" value="" />' .
    '<p class="description">' .
        _x( 'Here you can enter some info.', 'Some Form Field', 'your-text-domain' ) .
    '</p>';

return $output;
 

Parameter

 __( $text, $domain )
_e( $text, $domain )
_x( $text, $context, $domain )
_ex( $text, $context, $domain )
_n( $single, $plural, $number $domain )
_nx( $single, $plural, $number, $context, $domain )
 

Alle Parameter außer $number sind Zeichenfolgen. Alle außer $domain sinderforderlich.

Weitere Flexibilitätmit Variablen und sprintf ()

Wenn Ihre Zeichenfolgen variable Zahlen oder Wörterenthalten,verwenden Sie sprintf() :

 $stars = get_post_meta( $post->ID, 'rating', true );
$title = get_the_title( $post->ID );

$output = '<p>' .
        sprintf(
            _x(
                'The movie titled %2$s received a %1$d star rating.',
                'Movie Description',
                'your-text-domain'
            ),
            $stars,
            $title
        ) .
    '</p>';

return $output;
 

Zusätzliche Ressourcen

Einige zusätzliche Ressourcenfür das kommende WordPress I18n Ninja:

• WordPress übersetzen