Filtros públicos de POM AI

Estos filtros son la forma admitida de adaptar el comportamiento público de POM AI. Devuelve el mismo tipo de valor que recibe el filtro.

Filtro Valor y argumentos adicionales
pom_ai_settings Matriz completa de ajustes de administración.
pom_shortcode_translation_schema Mapa compartido de etiquetas de shortcode a atributos traducibles, política de contenido interno y campos de texto de grupos de parámetros.
pom_ai_language_label_from_locale Etiqueta de idioma; también recibe la configuración regional, el nombre del idioma y el nombre de la región.
pom_ai_dictation_max_duration Segundos máximos de grabación; valor predeterminado 180.
pom_ai_dictation_max_file_size Bytes máximos de audio; valor predeterminado 4 MB.
pom_ai_dictation_allowed_mime_types Matriz de tipos MIME de audio/audio de vídeo aceptados.
pom_ai_dictation_bits_per_second Tasa de bits de grabación del navegador; valor predeterminado 24000.
pom_ai_dictation_defaults Matriz completa de configuración de dictado localizada.
pom_ai_prompt_template_context_labels Mapa de clave de contexto a etiqueta.
pom_ai_mcp_supported_protocol_versions Matriz ordenada de versiones de MCP admitidas.
pom_ai_mcp_allowed_origins Lista de orígenes permitidos de origen cruzado para solicitudes HTTP de MCP.
pom_ai_mcp_writable_options Limita las cinco escrituras de opciones de WordPress admitidas; las opciones adicionales se ignoran.
pom_ai_mcp_writable_pom_theme_settings Lista de permitidos de POM Theme setting.field; admite la coincidencia de comodines documentada del servidor.

Declaraciones de traducción de shortcode compartidas

Registra este filtro durante la carga normal del plugin o del tema, fuera de los hooks exclusivos del constructor. Así, POM AI y POM Translate pueden descubrir el mismo texto sin cargar WPBakery:

add_filter('pom_shortcode_translation_schema', static function (array $schema): array {
    $schema['acme_cards'] = [
        'attributes' => ['heading', 'button_label'],
        'content' => true,
        'groups' => ['items' => ['title', 'description']],
    ];
    return $schema;
});

Usa nombres en minúsculas. attributes enumera los atributos textuales; content permite prosa incluida y shortcodes anidados; groups enumera los miembros textuales de cada fila de una matriz JSON de objetos codificada como URL. Los valores predeterminados son una lista de atributos vacía, content: true y ningún grupo. Establece content en false para cuerpos de código u otros cuerpos técnicos. Una lista de atributos vacía excluye explícitamente todos los atributos. Mantén los ID, las URL, el CSS, las claves de enumeración y los ajustes numéricos fuera de las declaraciones de texto.

POM AI restaura cada cadena de grupo con codificación JSON y de URL, conservando los miembros no enumerados. Los grupos no válidos permanecen sin cambios. Una declaración compartida explícita tiene prioridad sobre las banderas heredadas de WPBakery; las banderas siguen siendo una alternativa para elementos de terceros sin declaración. Los filtros de atributos más antiguos de POM Translate se aplican únicamente a POM Translate.

Verifica una página traducida representativa con componentes anidados y repetidos, comillas en el texto, HTML sin procesar y valores agrupados. Las entradas traducidas existentes no se reescriben cuando cambia una declaración.

Ejemplo: reducir la duración del dictado

add_filter(
    'pom_ai_dictation_max_duration',
    static fn(): int => 120
);

Mantén coherentes los límites emparejados entre cliente y servidor. Por ejemplo, aumentar el límite local del archivo de dictado no hace que el servicio de cuenta acepte una carga mayor.

Los filtros de listas de permitidos no anulan las restricciones del servidor sobre campos protegidos, código fuente o administración de usuarios. El filtro de opciones de WordPress solo puede restringir su lista integrada. Las extensiones de campos del tema deben seguir cumpliendo los esquemas nativos y la política de seguridad estricta; verifica el comportamiento de vista previa, capacidad, puerta de acceso y valores aceptados.

No uses comodines amplios por comodidad. Las entradas de origen cruzado deben ser orígenes de confianza exactos.

Guías relacionadas: extensión de plantilla de prompt, seguridad y extensión de módulo de herramienta.