pom_get_available_shortcodes: listar los shortcodes de POM
Qué shortcodes existen en este sitio. No es un vocabulario genérico de POM: es el catálogo real, que refleja qué módulos del tema están presentes y habilitados.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
scope |
No | available (predeterminado), layout o theme |
post_type |
No | Solo los shortcodes utilizables con ese tipo de contenido |
include_inactive |
No | Incluir los módulos del tema deshabilitados |
Permisos
mcp:read y wp:content:read, con la capacidad edit_posts.
Los tres ámbitos
available: todo lo utilizable. Es la opción predeterminada y la indicada para componer una página.
layout: solo los shortcodes de diseño: filas, columnas y sus variantes internas. Útil cuando la cuestión es puramente de estructura.
theme: solo los módulos del tema POM, la familia web_* que produce elementos visibles.
La distinción entre diseño y tema refleja cómo se construye una página de POM: los shortcodes de diseño crean la cuadrícula y los módulos del tema la rellenan.
Qué devuelve
Una lista items, un total y una breve lista rules. Cada elemento incluye:
| Campo | Significado |
|---|---|
shortcode |
La etiqueta, como web_button |
label |
Nombre legible |
description |
Qué hace |
source |
De dónde proviene: shortcode de diseño, módulo del tema, módulo anidado |
module |
El módulo propietario |
category |
Su agrupación |
is_container |
Si envuelve a otros shortcodes |
enabled |
Si está activo |
Los elementos se ordenan por etiqueta.
is_container es el campo que debes leer
Un shortcode contenedor envuelve a otros; uno que no es contenedor no lo hace. Equivocarse en esto produce un marcado que se analiza pero que anida de forma ilegal: un módulo colocado dentro de algo que no puede contenerlo, o un contenedor que queda vacío.
vc_row, vc_column y sus variantes internas son contenedores. La mayoría de los módulos web_* no lo son.
Filtrado por tipo de contenido
Pasar post_type elimina los shortcodes que se declaran inutilizables allí. En un sitio con tipos de contenido personalizados y módulos restringidos a algunos de ellos, esta es la diferencia entre ofrecer a un cliente una paleta utilizable y ofrecerle una que falla al escribir.
include_inactive
De forma predeterminada, los módulos del tema deshabilitados se excluyen: un cliente no debería componer con algo que el sitio ha desactivado.
Establece include_inactive en true solo cuando la pregunta sea «¿qué podría ofrecer este sitio si estuviera habilitado?», que es una pregunta de auditoría más que de creación. Componer con un módulo inactivo produce un shortcode que no muestra nada.
Cómo usarlo bien
Lista los shortcodes disponibles y muéstrame los contenedores por separado de los módulos.
¿Qué shortcodes de diseño hay disponibles en este sitio?
Para componer:
Lista los shortcodes disponibles y luego lee el esquema de cada uno que tengas previsto usar antes de escribir nada.
Esa segunda frase es el objetivo de esta herramienta. El listado le dice al cliente el vocabulario; solo el esquema le dice la gramática. Consulta pom_get_shortcode_schema.
Qué no te dice
- Qué atributos admite cada uno. Eso es la herramienta de esquema, un shortcode cada vez.
- Cómo anidan. Las reglas generales provienen del contexto de creación; las restricciones específicas entre elementos padre e hijo las aplica el validador.
- Si tu composición es válida. Eso es
pom_validate_builder_content.
El listado es un vocabulario, no una gramática ni una prueba.
Cómo interpretar un resultado inesperado
| Qué ves | Significa |
|---|---|
| Muy pocos elementos | El tema POM probablemente no está activo |
Ningún módulo web_* |
Los módulos del tema no están registrados aquí |
| Falta un módulo esperado | Está deshabilitado; compruébalo con include_inactive |
| Elementos que no reconoces | Otro plugin también registra shortcodes del creador |
Relacionado
pom_get_authoring_context: llámalo primeropom_get_shortcode_schema: la siguiente llamadapom_validate_builder_content
En los sitios POM Theme, el descubrimiento incluye solo las funciones de retorno registradas que pertenezcan al tema POM padre o hijo activo. Los nombres históricos de shortcodes siguen siendo válidos. Las entradas informan de registered y schema_status; registered_only significa que se encontró un registro sin un contrato de atributos completo. El descubrimiento predeterminado excluye los módulos deshabilitados.