Etiquetas de combinación del selector de idioma
POM Translate construye una etiqueta para cada idioma en una navegación, un shortcode o un selector flotante. Una plantilla de marcado combina texto literal, HTML permitido y etiquetas de combinación escritas como {%tag_name%}.
Elige los datos de la etiqueta
| Etiqueta de combinación | Salida | ¿Puede estar vacía? |
|---|---|---|
local_label |
Nombre del idioma en ese idioma | No; usa como alternativa el código del idioma |
label_english |
Nombre del idioma en inglés | No; usa como alternativa local_label |
custom_label |
Etiqueta introducida en los ajustes de POM Translate | Sí, para un idioma adicional |
local_country |
Nombre del país en el propio idioma | Sí |
country_label_english |
Nombre del país en inglés | Sí |
code |
Código de definición de la configuración regional | No |
slug |
Slug de definición de la configuración regional | No |
country_iso |
Identificador de país en mayúsculas | No, pero su alternativa derivada puede no describir un país |
flag_image |
SVG local preparado <img> |
Sí |
flag_html |
Emoji dentro de un aria-hidden <span> |
Sí |
flag_emoji |
Entidades numéricas de emoji sin un contenedor | Sí |
Comprende el procesamiento de la plantilla
POM Translate sanea la plantilla con la política de HTML de publicaciones de WordPress, escapa los valores de texto y, a continuación, sustituye las etiquetas admitidas. Las etiquetas de combinación desconocidas se eliminan. Una etiqueta renderizada completamente vacía usa como alternativa el código del idioma en un elemento <strong>.
Los separadores literales no son condicionales. Por ejemplo, ({%local_country%}) deja () cuando una configuración regional no tiene nombre de país local. Utiliza valores opcionales solo después de comprobar cada idioma habilitado.
La salida de la bandera se prepara únicamente cuando la plantilla seleccionada solicita una etiqueta de bandera. La plantilla controla el interior de cada enlace de idioma; no controla la URL de destino, la estructura de la lista, el botón desplegable ni otros contenedores del selector.
Construye y verifica una plantilla
Empieza con Combina etiquetas de combinación de forma segura y, a continuación, elige un patrón de Recetas de etiquetas de selector. Configúralo en Settings → POM Translate → Language switcher, en el campo de marcado de la superficie del selector prevista.
Inspecciona cada configuración regional habilitada después de guardar. Confirma que el texto visible tenga sentido, que los datos opcionales no dejen signos de puntuación, que la etiqueta más larga encaje en su diseño y que cada enlace siga llegando a la ruta localizada esperada.