Puntos de extensión admitidos y reglas de compatibilidad
Una extensión POM admitida usa las API de WordPress y los helpers, hooks, etiquetas de combinación, shortcodes o comandos documentados en este capítulo. Que una función sea simplemente invocable no convierte cada argumento interno o estructura de almacenamiento en algo público.
Elige el límite de la extensión
Utiliza, en orden de preferencia:
- un helper POM documentado para una decisión de presentación específica de POM;
- una acción o un filtro de WordPress para el comportamiento normal de la plataforma;
- un shortcode para una salida reutilizable propiedad del código dentro del contenido de plantilla admitido;
- las API de registro estándar de WordPress para los tipos de contenido y metadatos propiedad del plugin.
No requieras archivos del tema, no instancies clases no documentadas, no edites los assets generados ni escribas directamente en el almacenamiento de ajustes de POM.
Carga después de las dependencias
Registra las integraciones desde un hook normal de WordPress y protege las funciones opcionales:
add_action(
'init',
static function (): void {
if ( ! function_exists( 'pom_get_icon' ) ) {
return;
}
// Register integration behavior.
}
);
Para WooCommerce u otro producto opcional, comprueba tanto el helper de detección semántica de POM como la clase o función exacta de terceros que vayas a llamar.
Identificadores propios y alternativas
Añade prefijo a los tipos de contenido, taxonomías, metadatos, shortcodes, claves de caché, rutas REST y manejadores de scripts que sean propiedad del plugin. No reutilices nunca un identificador de POM para sustituir a su propietario.
Define qué ocurre cuando POM Theme está inactivo o una funcionalidad está desactivada. Un renderizado WordPress neutro, un mensaje de no disponibilidad o ninguna salida es más seguro que un error fatal.
Revisión de compatibilidad
Antes del lanzamiento, verifica la integración estando conectado y desconectado, en cada blog multisitio relevante, con las dependencias opcionales tanto activadas como desactivadas. Confirma que desinstalar o desactivar la integración no elimina de forma inesperada contenido propiedad del sitio.