¿Qué sentido tiene la sintaxis gettext?

__ (doble subrayado)es lafunción detraducciónbásica. Traduce una cadena y la devuelve como una cadena.

_e hace lomismo que __,peroechoesel resultado deinmediato.

_xes lafunción detraducción contextual. Tiene una segunda opciónparaproporcionar contexto a laspersonas que realizan latraducción.

_exes lomismo que _x,peroechoesel resultado.

Ejemplo de uso de _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' );
 

A veces,lamisma cadenapuede ser diferenteen otrosidiomas. Brindar contexto a lostraductorespuede ayudarlos aelegir laspalabras adecuadas.

Funciones de acceso directo:

• esc_attr__: Equivalente a __perotambiénejecutael resultado através de esc_attr.
• esc_html__: Equivalente a __perotambiénejecutael resultado através de esc_html.
• esc_attr_e: Equivalente a _eperotambiénejecutael resultado através de esc_attr.
• esc_html_e: Equivalente a _eperotambiénejecutael resultado através de esc_html.
• esc_attr_x: Equivalente a _xperotambiénejecutael resultado através de esc_attr.
• esc_html_x: Equivalente a _xperotambiénejecutael resultado através de esc_html.

_nesel controlador depluralización. Ejemplo:

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

Eneseejemplo,hay dosformas de decir la cantidad detacos,dependiendo de sies singular ono. Elprimer uso de $number le dice a lafunción _n qué versión usar. El segundo uso de $number ocurreen el sprintf,para reemplazar% d conelnúmero realen la cadena.

No hay unafunción deecoequivalentepara _n,pero hay unafunción llamada _nx. Es una combinación de _n y _x. Pluralización y contexto.

_n_noopesespecial. Se utilizaparatraducir cadenaspluralizadas,peroen realidadno realiza latraducción deinmediato. Estoes útil si desea centralizar las cadenasperoen realidad hacereltrabajoen otro lugar. Lafunción que realmente haceeltrabajoen otros lugareses translate_nooped_plural.

Ejemplo:

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

No se utilizamucho,peropuede resultar útilpara la organización. Siponestodastus cadenasen un archivo,porejemplo,luego las haces referenciaen otro lugar,estono seríaposible con solo _n,necesitas algo como _n_nooppara hacereso .

_nx_noopes lomismo que _n_noop,perotambiénpuedetomar un contextopara lostraductores,igual que _x.

Tengaen cuenta quepuedeponerel dominioen la llamada a lafunciónnoop oen la llamada a lafuncióntranslate_nooped_plural. El quetengamás sentidopara su organización. Si ambostienen un dominio,ganael que sepasa a la llamadanoop.

number_format_i18neselequivalente al number_format integrado de PHP,pero agregaelmanejo de cosas como decimales y demás,que son diferentesen otras configuraciones regionales.

date_i18neselequivalente a la fecha incorporada de PHP,contodoelmanejopertinente allítambién. Nombres demeses,nombres de días,etc.

Además,nuncainfrinja las leyes . Simplemente un recordatorio. :)

__ (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 () y _x (),_ex ()

__() y _e() sonesencialmente un contenedor de translate() (no usar directamente) y casi lomismo.

La diferencia radicaen que __() devuelveel string y _e() lo repite. Ambos deben recibir una cadena comoparámetro obligatorio y,por logeneral,aunque opcional,también un dominio detexto.

Demanera análoga,hay _x() y _ex() ,que lepermiteespecificar un contexto quepuede describir dónde aparece la cadena. Si suproyectoincluyemás de unaspocas decenas de cadenastraducibles,usarel contextotiene mucho sentido.

Además,tengaen cuenta laexistencia de _n() y < a href="http://codex.wordpress.org/Function_Reference/_nx" rel="nofollow"> _nx() paraplurales.

Ejemplo de uso común

 $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;
 

Parámetros

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

Todos losparámetrosexcepto $number son cadenas. Todosmenos $domain son obligatorios.

Mayorflexibilidad con variables y sprintf ()

Si sus cadenas van a contenernúmeros opalabras variables,use 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;
 

Recursos adicionales

Algunos recursos adicionalesparaelpróximo WordPress I18n Ninja:

• Traducción de WordPress
• I18npara desarrolladores de WordPress
• Descripcióngeneral de referencia de lafunción de localización
• Codestyling Localization (complementofantástico)
• Poedit

__(), _e() and _x(), _ex()

__() and _e() are essentially both a wrapper of translate() (do not use directly) and almost the same.

The difference lies in that __() returns the translated string and _e() echoes it. Both need to be fed a string as a required parameter and usually, though optional, also a textdomain.

Analogously, there's _x() and _ex(), which let you specify a context that can describe where the string appears. If your project includes more than a few tens of translatable strings, using context makes a lot of sense.

Also, note the existence of _n() and _nx() for plurals.

Example of common usage

$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;

Parameters

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

All parameters but $number are strings. All but $domain are required.

Further flexibility with variables and sprintf()

If your strings will contain variable numbers or words, use 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;

Additional resources

Some additional resources for the upcoming WordPress I18n Ninja:

• Translating WordPress
• I18n for WordPress Developers
• Localization function reference overview
• Codestyling Localization (fantastic plugin!)
• Poedit

No soy unexpertoen traducciones,pero lapágina del Codex de WordPresstiene buena documentación yexplica la razónpara usar cadainstancia.

De laspáginas del códice:

__()

Se usa cuandoelmensaje sepasa como argumento a otrafunción; _e() se utilizaparaescribirelmensaje directamenteen lapágina. Más detalles sobreestas dosfunciones:

__('message')

Buscaen elmódulo de localización latraducción de 'mensaje' ypasa latraducción a la declaración de retorno de PHP. Sino seencuentraningunatraducciónpara 'mensaje',solo devuelve 'mensaje'.

_e('message')

Buscaen elmódulo de localización latraducción de 'mensaje' ypasa latraducción a la declaración deeco de PHP. Sino seencuentraningunatraducciónpara 'mensaje',simplemente se haceeco de 'mensaje'.

Tengaen cuenta que siestáinternacionalizando untema o complemento,debe utilizar un "Text Domain".

Elmarcogettext seencarga de lamayorparte de WordPress. Sinembargo,hay algunos lugaresen la distribución de WordPress dondeno sepuede usargettext:

• El archivo READMEprincipal de WordPress:es un archivo HTMLestático,no un archivo PHP,por lo queno sepuedeejecutar através de lasfuncionesgettext.
• Segeneran algunosmensajes deerrormuytempranoen el ciclo de carga de WordPress,antes de que se carguegettext.

Enlace a lapágina del Codex

Información adicional sobre cuandogettextnofunciona

Con suerte,eso responde a supregunta,sino,avísenos ytal vez alguienmáspueda ayudar opuedoinvestigar unpocomás.

I'm not an expert on translations, but the WordPress Codex Page has good documentation and explains the reason to use each instance.

From the codex pages:

__()

Is used when the message is passed as an argument to another function; _e() is used to write the message directly to the page. More detail on these two functions:

__('message')

Searches the localization module for the translation of 'message', and passes the translation to the PHP return statement. If no translation is found for 'message', it just returns 'message'.

_e('message')

Searches the localization module for the translation of 'message', and passes the translation to the PHP echo statement. If no translation is found for 'message', it just echoes 'message'.

Note that if you are internationalizing a Theme or Plugin, you should use a "Text Domain".

The gettext framework takes care of most of WordPress. However, there are a few places in the WordPress distribution where gettext cannot be used:

• The main WordPress README file -- it's a static HTML file, not a PHP file, so it cannot be run through the gettext functions.
• A few error messages are generated very early in the WordPress loading cycle, before gettext is loaded.

Link to the Codex Page

Additional info regarding when gettext doesn't work

Hopefully that answers your question, if not let us know and maybe someone else can help or I can do some more research.