Implementando i18n en nuestro tema<\/h2>\n
Ya hicimos la primera parte en el paso anterior<\/a> de esta serie de tutoriales de temas, donde agregamos El primer argumento es el identificador, esta es una cadena \u00fanica que usar\u00e1 para agrupar todos los textos que pertenecen a su tema. Repetir\u00e1 este identificador cada vez que haga que un texto sea traducible. El segundo argumento le dice a WordPress d\u00f3nde est\u00e1n los archivos de traducci\u00f3n. Los definimos para residir en una subcarpeta ‘ No se preocupe si esta carpeta no existe o no contiene ning\u00fan archivo; nada fallar\u00e1. Si WordPress no encuentra la carpeta ni los archivos de traducci\u00f3n correctos, volver\u00e1 por defecto a los textos que tenemos en el tema.<\/p>\n El siguiente paso es revisar todo nuestro c\u00f3digo y encontrar cualquier resultado de texto que deba ser traducible. Es una buena pr\u00e1ctica asegurarse de cubrir absolutamente todos los textos. Nada es m\u00e1s molesto que usar un tema o un complemento en el que el autor codific\u00f3 textos que hacen que sea imposible traducirlos o cambiarlos de alguna manera.<\/p>\n Lo que hacemos con todos los textos es ponerlos dentro de una de las funciones gettext de WordPress, que normalmente son WordPress tiene m\u00e1s funciones gettext que sirven para prop\u00f3sitos m\u00e1s espec\u00edficos, por ejemplo, Las funciones gettext toman dos par\u00e1metros; primero el texto en s\u00ed, y segundo el identificador que definiste en Por ejemplo, si tienes algo como esto:<\/p>\n Tendr\u00e1s que reemplazarlo con:<\/p>\n Y de manera similar para almacenar en una variable;<\/p>\n Tiene que ser escrito as\u00ed:<\/p>\n \u00a1Ahora necesitamos encontrar todos los textos en nuestras plantillas! Si has seguido este tutorial al pie de la letra, no son muchos. Tenemos algunas cadenas en Comencemos Debido a que us\u00f3 Tenemos este mismo texto en nuestro A partir de ahora, todos los textos que agreguemos en nuestro tema nos aseguraremos de envolverlos dentro Hay dos formas de proporcionar archivos de traducci\u00f3n a su tema;<\/p>\n Se Los archivos La desventaja de los archivos Necesitas un programa para editar Descarga e instala PoEdit para seguir el resto del tutorial.<\/p>\n Hacer un archivo de traducci\u00f3n para ingl\u00e9s generalmente no tiene ning\u00fan sentido cuando todos los textos en nuestro tema est\u00e1n en ingl\u00e9s de todos modos, pero para los prop\u00f3sitos de este tutorial, crear\u00e9 un archivo de traducci\u00f3n al ingl\u00e9s.<\/p>\n 1 Abra PoEdit y haga clic en Archivo > Nuevo\u2026<\/p>\n 2 Se le pedir\u00e1 que elija un idioma. Elija el idioma que desee, por ejemplo, ingl\u00e9s.<\/p>\n 3 Pulse Guardar (Ctrl+S). Localice la carpeta de su tema e ingrese la 4 En el men\u00fa, haga clic en Cat\u00e1logo > Propiedades\u2026<\/p>\n 5 En la primera pesta\u00f1a, puede completar cierta informaci\u00f3n, como el nombre de su proyecto (tema), o cambiar el idioma, pero no es necesario. Le recomiendo que mantenga el juego de caracteres en UTF-8 ya que esto es lo que escribimos para WordPress.<\/p>\n 6 Haga clic en la pesta\u00f1a Rutas de origen. Aqu\u00ed deber\u00e1 definir en qu\u00e9 carpetas debe buscar el archivo para los textos traducibles. Las rutas son relativas y, como ya lo guardamos en una subcarpeta de nuestro tema, sabemos que debe subir un directorio. Presione el bot\u00f3n + debajo del cuadro Rutas y elija Agregar carpetas. Elija su directorio de temas. Esto deber\u00eda agregar un elemento de ruta "." (sube una carpeta). Vuelva a verificar que "Ruta base" se refiere a su directorio de tema ra\u00edz.<\/p>\n 7 Haga clic en la siguiente pesta\u00f1a, "Palabras clave de fuentes". Aqu\u00ed debe decirle a PoEdit qu\u00e9 funciones ha utilizado para los textos traducibles (por ejemplo load_theme_textdomain<\/code>la funci\u00f3n de configuraci\u00f3n de nuestro tema. En caso de que lo hayas olvidado, esto es lo que agregamos:<\/p>\nload_theme_textdomain('wptutorial', get_stylesheet_directory(). '\/lang');<\/code><\/pre>\nlang<\/code>‘ en nuestro directorio de temas.<\/p>\nC\u00f3mo hacer que los textos sean traducibles<\/h2>\n
_e()<\/code>o __()<\/code>. El primero es un gui\u00f3n bajo con "e" que se usa cuando desea repetir el texto al mismo tiempo. El segundo tiene dos guiones bajos y se usa cuando no desea reproducirlo sino almacenarlo o usarlo en una variable.<\/p>\nesc_html__()<\/code>y m\u00e1s. Sin embargo, no entraremos en detalles para aquellos en este tutorial._n()``_x()<\/code><\/p>\nload_theme_textdomain<\/code>. En este caso es ‘ wptutorial<\/code>‘.<\/p>\necho 'Read more';<\/code><\/pre>\n_e('Read more', 'wptutorial');<\/code><\/pre>\n$myvariable = 'Read more';<\/code><\/pre>\n$myvariable = __('Read more', 'wptutorial');<\/code><\/pre>\nindex.php<\/code>y algunas en single.php<\/code>.<\/p>\nAgregar soporte de traducci\u00f3n en nuestro tema<\/h2>\n
index.php<\/code>y ubiquemos el mensaje "No hay publicaciones, lo siento" que agregamos si el bucle no conten\u00eda ninguna publicaci\u00f3n. Envolvemos este texto dentro _e()<\/code>porque todav\u00eda queremos repetirlo. As\u00ed que esto es lo que obtenemos:<\/p>\n...\n} else {\n ?><p><?php _e('No posts, sorry.', 'wptutorial'); ?><\/p><?php\n}\n...<\/code><\/pre>\n_e()<\/code>, no deber\u00eda ver ning\u00fan cambio cuando presiona actualizar en la p\u00e1gina principal o en el archivo. Pero bajo el cap\u00f3, \u00a1este texto ahora es traducible!<\/p>\nsingle.php<\/code>y page.php<\/code>. Actual\u00edcelos de la misma manera que lo hicimos en index.php<\/code>. Agregamos algunos textos m\u00e1s en single.php<\/code>, as\u00ed que as\u00ed es como se ve despu\u00e9s de hacer que todos los textos sean traducibles:<\/p>\n...\n <?php the_category(); ?>\n <p><?php _e('Posted', 'wptutorial'); ?>: <?php the_date(); ?> <?php _e('at', 'wptutorial'); ?> <?php the_time(); ?><\/p>\n <p><?php _e('Author', 'wptutorial'); ?>: <?php the_author(); ?><\/p>\n <\/article>\n <?php endwhile;\n} else {\n ?><p><?php _e('No posts, sorry.', 'wptutorial'); ?><\/p><?php\n}\n\u00a0\n...<\/code><\/pre>\n__()<\/code>o _e()<\/code>.<\/p>\nArchivos de traducci\u00f3n<\/h2>\n
\n
.pot<\/code>archivo<\/li>\n.po<\/code>y .mo<\/code>archivos.<\/li>\n<\/ul>\n.pot<\/code>recomienda el archivo -para un tema que vende o regala a otros usuarios, porque con este archivo es muy f\u00e1cil generar un archivo de traducci\u00f3n para un nuevo idioma. Sin embargo, no es f\u00e1cil (ni gratis) crear uno de esos archivos. Si est\u00e1 familiarizado con WP-CLI (l\u00ednea de comandos de WordPress) o Grunt, puede seguir las pautas en la documentaci\u00f3n de WordPress aqu\u00ed<\/a>. Si no, la otra alternativa podr\u00eda ser para ti.<\/p>\n.po<\/code>y .mo<\/code>trabajan juntos. WordPress requiere una .mo<\/code>traducci\u00f3n de textos, pero este archivo no es legible por humanos. Por lo tanto, tenemos el .po<\/code>archivo que es legible para nosotros. Con el software adecuado, genera el .mo<\/code>archivo cada vez que realiza cambios.<\/p>\n.po<\/code>y .mo<\/code>es que necesita generar un par para cada idioma, y \u200b\u200buna vez que lo haya traducido a un idioma, no hay una manera f\u00e1cil de vaciar todas las traducciones para hacer otro idioma nuevo.<\/p>\n.pot<\/code>y .po<\/code>archivar. El m\u00e1s com\u00fan es PoEdit<\/a>. PoEdit es gratuito y funciona tanto para iOS como para Windows. Pero algunas funciones avanzadas (como generar un .pot<\/code>archivo) desafortunadamente requieren una versi\u00f3n paga. Usaremos la versi\u00f3n gratuita para crear un .po<\/code>archivo para nuestro tema.<\/p>\nCreando un archivo .po para nuestro tema con PoEdit<\/h2>\n
\/lang\/<\/code>subcarpeta. (Si no lo cre\u00f3 en el \u00faltimo paso, cr\u00e9elo ahora). El nombre de su archivo es fundamental. Para los temas, debe nombrarse solo su c\u00f3digo de idioma. Para ingl\u00e9s americano ser\u00eda en_US<\/code>, para noruego es nb_NO<\/code>. B\u00fascalo en Google o consulta esta descripci\u00f3n general<\/a> para encontrar el c\u00f3digo de tu idioma. Lo nombraremos en_US.po<\/code>.<\/p>\n![\"Tutorial](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152370-61e4d69a10501.png\")
<\/a><\/p>\n![\"Tutorial](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152370-61e4d69b261fd.png\")
<\/a><\/p>\n__<\/code>, _e<\/code>, esc_html_e<\/code>etc.). Haga clic en el bot\u00f3n + para agregar cada funci\u00f3n y escr\u00edbalas sin "()". Depende de usted si desea cubrir todas sus bases y agregar todas las funciones gettext de WordPress, pero en este tutorial sabemos que solo hemos usado dos. Entonces agregamos dos elementos; __()<\/code>y _e()<\/code>. Suma las funciones sin ning\u00fan par\u00e9ntesis.<\/p>\n
![\"Tutorial](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152370-61e4d69c29a5b.png\")
<\/a><\/p>\n![\"Tutorial](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152370-61e4d69d34b4a.png\")
<\/a><\/p>\n