Skip to Content
ReferenceHooks de acción y filtro de WordPress

Hooks de acción y filtro de WordPress

Una referencia legible por máquina de los hooks públicos del plugin Structura está prevista pero todavía no publicada. Esta página es un marcador — una vez que el generador esté cableado en CI, se renderizará aquí automáticamente desde los bloques hookdoc en plugin/includes/.

Mientras tanto

Si necesitas integrarte con Structura desde PHP hoy:

  • Greppea el código fuente del plugin en busca de hooks activos:
    grep -rn "do_action( 'structura/" plugin/includes/ grep -rn "apply_filters( 'structura/" plugin/includes/
  • Cada sitio de llamada tiene un docblock precedente marcado con @since describiendo el payload; mira AGENTS.md §7 en el repositorio para el estilo de la casa.
  • Los nombres de hook siguen el patrón structura/{domain}/{event}, donde las acciones están en pasado (inserted, failed, scheduled) y los filtros tienen forma de sustantivo (context, payload, body).

Hooks usados habitualmente hoy

Como referencia rápida, un puñado de los hooks más estables:

  • structura/post/inserted — se dispara después de que una ejecución de campaña ha insertado una entrada en WordPress y aplicado los metadatos de la campaña. El payload incluye post_id, campaign_id, status, post_title, post_url, edit_url, published_at, locale.
  • structura/campaign/run_started — el planificador empezó a procesar una campaña.
  • structura/campaign/run_completed — la ejecución terminó (éxito o fallo, mira el payload).
  • structura/channels/dispatch_succeeded / _failed — resultados por canal.

Estas firmas pueden cambiar antes de 1.0; fija a un rango de versión menor del plugin si estás enviando código de producción contra ellas.

Cuándo será útil esta página

Una vez cableada, esta página incluirá:

  • Cada hook público con una descripción, versión @since y forma completa del parámetro.
  • Buscable, agrupado por dominio (post, campaign, channels, scheduler, images, settings, license).
  • Generado a partir de los mismos bloques hookdoc en el código fuente, así que se mantiene en sincronía con el plugin.

Páginas relacionadas

Last updated on