Como hacer un theme WordPress traducible

Cada vez es más grande la comunidad de desarrolladores de themes, incluso de habla hispana, y una funcionalidad que debería ser básica es ofrecer la internacionalización de los themes, algo vital para la difusión de los themes WordPress.

Pues bien, en este tutorial, que he traducido de una guía de Cats who code, tienes el proceso completo, para hacer un theme traducible, desde el principio.

1 – Añade las funciones necesarias

Para empezar con lo básico copia las líneas siguientes en el archivo functions.php de tu theme.

load_theme_textdomain( 'Nombre de mi theme', TEMPLATEPATH.'/languages' );
$locale = get_locale();
$locale_file = TEMPLATEPATH."/languages/$locale.php";
if ( is_readable($locale_file) )
	require_once($locale_file);

En la línea 1 verás la función load_theme_textdomain(). Esta función te permite cargar un Text Domain. Elige cualquier nombre, pero recuerda que tiene que ser único. Lo ideal sería usar el nombre de tu theme
.

2 – Internacionaliza tu theme

Para traducir nuestro theme WordPress usaremos las funciones PHP gettext.
GetText tiene dos funciones: _e y __ (ambas con guión bajo).
La función «_e» se usa para imprimir texto «simple», y la función __ se usa cuando el texto a mostrar ya está envuelto en tags PHP.

EJEMPLOS:

<?php _e("La página que buscas no existe", "Nombre de mi theme"); ?>

<?php the_content(__('Sigue leyendo...', "Nombre de mi theme")); ?>

Date cuenta de nuevo que el nombre del text domain (Nombre de mi theme). Recuerda que debe ser el mismo que en el fichero functions.php.

La parte aburrida es en la que tienes que reemplazar cada cadena simple por la función necesaria. Dependiendo e cuantas cadenas (strings) tenga tu theme esto puede ser una tarea realmente tediosa (de ahí que se internacionalicen tan pocos themes). Parece que hay algunas herramientas GNU que facilitan la tarea de extraer cadenas de los archivos de manera sencilla. Si quieres puedes buscar en Google por xgettext.

3 – Crea tu archivo .po

A partir de este momento tu theme WordPress ya puede traducirse fácilmente a cualquier idioma. Pero para mostrar los textos en un idioma distinto al tuyo tienes que añadir un archivo .po.

Los archivos .po significan Objeto Portátil (Portable Object). Básicamente, estos archivos contienen una cadena, y su traducción en otro idioma. Por ejemplo, si traduces la versión española de WordPress, tendrás un fichero es_ES.po dentro de la carpeta /wp-content/languages/. Este archivo contiene todas las traducciones para que tu theme «hable» Español, para que tu theme diga Bienvenido en vez de Welcome.

Pero hay buenas noticias, no tienes que buscar en los archivos de tu theme cada línea a traducir. Hay una herramienta online llamada icanlocalize.com que puede escanear archivos PHP y crear ficheros .po por ti. ICanLocalize extraerá todas las cadenas envueltas en llamadas __(«txt», «domain») y _e(«txt», «domain»). Las cadenas pueden cerrarse con comillas dobles(«) o comillas simples(‘) y con cualesquiera caracteres de codificación.

Luego, los archivos Po pueden editarse con PoEdit, un software gratuito especialmente diseñado para esta tarea:

Como ya habrás imaginado, tienes que traducir cada cadena. Una vez hayas traducido todo guarda el archivo .po. PoEdit también creará un archivo .mo, que es una versión compilada del fichero .po.

4 – Puesta en marcha

Ahora que ya has hecho la parte más «difícil» del trabajo lo único que queda es definir tu «locale» en WordPress.

Para conseguirlo, lo primero es hacerte con tu código de idioma y país. Por ejemplo, si tu idioma es el Español y vives en Argentina, tu código será es_AR. El manual de GNU gettext tiene páginas para ayudarte a encontrar los códigos de tu país y idioma.

Una vez tengas tus códigos, abre el archivo wp-config.php y busca la constante WPLANG. Si existe, simplemente reemplaza el código existente por el tuyo. Si no existe, pues pega la siguiente línea (con tu propio código de país e idioma, por supesto)

define ('WPLANG', 'es_AR');

Fuentes

En los siguientes artículos encontrarás la documentación empleada para la elaboración de este post.

• Artículo original en inglés
• Making it Translatable – Internationalize / Localize WP Themes
• Premium themes are translatable themes

¿Te gustó este artículo? ¡Ni te imaginas lo que te estás perdiendo en YouTube!

AVISO: Esta publicación es de hace 3 años o más. Si es un código o un plugin podría no funcionar en las últimas versiones de WordPress, y si es una noticia podría estar ya obsoleta. Luego no digas que no te hemos avisado. ¡Ah! ¿te funciona? pues entonces no he dicho nada :)