Skip to Content
ReferenceHooks d'action et de filtre WordPress

Hooks d’action et de filtre WordPress

Une référence lisible par machine des hooks publics de l’extension Structura est prévue mais pas encore publiée. Cette page est un marqueur — une fois le générateur câblé dans CI, il rendra ici automatiquement à partir des blocs hookdoc dans plugin/includes/.

En attendant

Si vous avez besoin de vous intégrer à Structura depuis PHP aujourd’hui :

  • Greppez le code source de l’extension pour les hooks actifs :
    grep -rn "do_action( 'structura/" plugin/includes/ grep -rn "apply_filters( 'structura/" plugin/includes/
  • Chaque site d’appel a un docblock précédent estampillé @since décrivant la charge utile ; voir AGENTS.md §7 dans le dépôt pour le style maison.
  • Les noms de hooks suivent le motif structura/{domain}/{event}, où les actions sont au passé (inserted, failed, scheduled) et les filtres ont une forme nominale (context, payload, body).

Hooks couramment utilisés aujourd’hui

Pour référence rapide, une poignée des hooks les plus stables :

  • structura/post/inserted — se déclenche après qu’une exécution de campagne a inséré un article dans WordPress et appliqué les métadonnées de la campagne. La charge utile inclut post_id, campaign_id, status, post_title, post_url, edit_url, published_at, locale.
  • structura/campaign/run_started — le planificateur a commencé à traiter une campagne.
  • structura/campaign/run_completed — l’exécution est terminée (succès ou échec, voir la charge utile).
  • structura/channels/dispatch_succeeded / _failed — résultats par canal.

Ces signatures peuvent encore changer avant 1.0 ; épinglez sur une plage de version mineure de l’extension si vous livrez du code de production qui en dépend.

Quand cette page sera utile

Une fois câblée, cette page inclura :

  • Chaque hook public avec une description, version @since et la forme complète du paramètre.
  • Recherchable, regroupé par domaine (post, campaign, channels, scheduler, images, settings, license).
  • Généré à partir des mêmes blocs hookdoc dans le code source, donc reste synchronisé avec l’extension.

Pages liées

Last updated on