Todas las funciones que se usan habitualmente en el API de WordPress se encuentran en el núcleo, se usan para crear temas, plugins, crear menús nuevos en el gestor, etc. Vamos a ver donde se encuentran algunas de las más utilizadas.
Archivo: l10n.php
En este fichero nos encontramos con el API de traducciones, es muy útil para poder tener nuestros temas preparados para posibles implementaciones de otros idiomas en el futuro.
El tema de las traducciones de WordPress es muy importante y por tanto lo trataremos más adelante, pero es necesario saber que lo primero es tener un tema que permita ser traducido, y para eso en la construcción del mismo es necesario conocer parte de las funciones de este fichero.
- __: Es e comando básico para generar una traducción. Le tenemos que indicar el texto a traducir, y un contexto, este contexto suele ser el nombre del tema, y es el que guía donde se encuentra la traducción mediante los ficheros .po, pero eso ya es otra historia.
__('Texto a tradurir','mi_tema');
- _e: Este comando es igual que el anterior solo que este imprime por pantalla directamente el texto traducido.
_e('Texto a tradurir', 'mi_tema');
- _x y _ex: El funcionamiento es el mismo, pero permite añadir un contesto, imaginemos que tenemos 2 palabras que se escriben igual pero dependiendo del contexto significan algo diferente.
_x('Texto a tradur', 'contexto', 'mi_tema');
- _n y _nx: Y que pasa si el texto se traduce en función de si hay un valor que indica si el texto es singular o plural, no es necesario crear 2 traducciones, podemos usar este comando de la siguiente forma.
_n('Texto singular','Texto Plural', $num, 'mi_tema');
Todas las funciones
Nuestra idea es ir comentando todas las funciones, de momento recogemos un listado, por si queremos ver todas las funciones del fichero de forma rápida.
get_locale
translate
before_last_bar
translate_with_gettext_context
__
esc_attr__
esc_html__
_e
esc_attr_e
esc_html_e
_x
_ex
esc_attr_x
esc_html_x
_n
_nx
_n_noop
_nx_noop
translate_nooped_plural
load_textdomain
unload_textdomain
load_default_textdomain
load_plugin_textdomain
load_muplugin_textdomain
load_theme_textdomain
load_child_theme_textdomain
get_translations_for_domain
is_textdomain_loaded
translate_user_role
get_available_languages
wp_get_installed_translations
wp_get_pomo_file_data
wp_dropdown_languages