Sigue el contrato público de compatibilidad

Las integraciones compatibles usan helpers de procedimientos documentados, shortcodes, etiquetas de combinación y hooks de WordPress pom_translate_*. Las clases internas, tablas, opciones, claves de caché, controladores AJAX y detalles privados del servicio son parte de la implementación, incluso cuando se pueden descubrir en los archivos del plugin.

Integración defensiva

• Comprueba function_exists() antes de llamar a un helper.
• Registra los filtros en la inicialización normal de WordPress, no editando POM Translate.
• Acepta los argumentos documentados y devuelve el tipo documentado.
• Conserva las claves de array desconocidas para garantizar la compatibilidad futura.
• Valida los códigos de locale con respecto a los idiomas configurados.
• Escapa en el límite final de la salida.
• Evita las escrituras durante las solicitudes públicas de renderizado.

No des por hecho que una traducción inexistente devuelve un error. La mayoría de los helpers públicos de valores recurren deliberadamente a las alternativas del contenido original.

Versión y comportamiento ante fallos

Tu componente debería seguir funcionando en el idioma base cuando POM Translate esté inactivo. Elimina solo tus propios callbacks al desactivarlo y no borres registros de traducción compartidos.

Cuando un hook cambie el enrutamiento, el análisis o la salida en caché, prueba explícitamente el orden de activación y la prioridad. No dependas de la prioridad no documentada de otro callback.

Documenta la versión mínima de POM Translate que requiere tu integración y verifícala manualmente en las combinaciones pertinentes de WordPress, PHP, multisitio, REST/AJAX y WooCommerce para el componente.