pom://shortcodes: catálogo de shortcodes disponibles
Lee pom://shortcodes cuando una página del builder de POM necesite un componente y aún no conozcas su etiqueta de shortcode exacta. Es una lista compacta de disponibilidad, no la referencia completa de parámetros.
Qué devuelve el recurso
La carga JSON contiene:
items: shortcodes utilizables en el entorno de ejecución actual del sitio;total: el número de elementos devueltos;rules: reglas generales de creación para el catálogo.
Cada elemento identifica la shortcode, la label visible, la description, la source, la POM Theme module opcional, la categoría, el estado del contenedor y el estado de habilitación. El catálogo combina etiquetas estructurales del builder, shortcodes registrados de WordPress, mapas de componentes del builder y módulos POM Theme habilitados. Está ordenado por etiqueta para que los clientes puedan hacer selecciones deterministas.
La disponibilidad importa más que la memoria. Un shortcode documentado en otro sitio puede estar ausente porque su plugin o módulo POM Theme no está activo aquí.
Flujo de trabajo recomendado
- Lee
pom://site/authoring-contextpara comprender el editor de destino y el modelo de diseño. - Lee
pom://shortcodes. - Selecciona el componente más específico que cumpla el requisito de contenido.
- Lee
pom://shortcodes/{tag}para conocer los atributos en vivo de ese componente. - Redacta el marcado anidado completo.
- Llama a
pom_validate_builder_content. - Escribe solo después de que la validación no tenga errores.
Si el catálogo es demasiado amplio, usa la herramienta pom_get_available_shortcodes en su lugar. Esa herramienta puede filtrar por alcance, tipo de entrada de destino y estado inactivo; el recurso siempre devuelve el catálogo disponible predeterminado.
Qué no deducir
Una lista de atributos vacía significa que POM AI no pudo derivar los parámetros del builder para ese shortcode registrado; no significa que se admitan atributos arbitrarios. Del mismo modo, que un elemento esté presente no demuestra que sea apropiado en la raíz de una página. Las reglas de elementos padre-hijo y los componentes heredados desaconsejados los comprueban el validador del builder y el contexto de creación.
Guías relacionadas: recursos de shortcodes individuales, guía del builder de POM, y herramientas de creación de shortcodes.