Hook Priority

Définition : Hook Priority désigne le niveau de priorité affecté à un callback WordPress pour déterminer son ordre d’exécution sur un hook. Une valeur numérique plus faible est traitée avant une valeur plus élevée.

Terminologie

Terme : Hook Priority

Autres appellations : Priorité de hook, Ordre de priorité

À quoi cela sert

La priorité vaut 10 par défaut pour add_action() et add_filter(). Sur un même hook, les callbacks à priorité 5 passent avant ceux à priorité 20. Lorsque plusieurs callbacks partagent la même priorité, leur ordre d’inscription détermine généralement leur succession.

Dans quel contexte l’utiliser

Adapter la priorité lorsqu’un traitement doit intervenir avant ou après une transformation précise : filtrage d’un titre, ajout de contenu ou génération de métadonnées. Documenter la dépendance et éviter de compter sur une priorité extrêmement élevée sans raison.

Exemple concret

Deux filtres d’un plugin produisent une étiquette : le premier met le texte en majuscules, le second ajoute un préfixe.

Exemple de code commenté

<?php
add_filter( 'atoolpha_demo_etiquette', 'strtoupper', 5 );
add_filter( 'atoolpha_demo_etiquette', function ( $texte ) {
    return 'ATOOLPHA : ' . $texte;
}, 20 );
$etiquette = apply_filters( 'atoolpha_demo_etiquette', 'guide' );
// Résultat : ATOOLPHA : GUIDE

Explication de l’exemple

Le traitement à priorité 5 agit d’abord sur la valeur, puis celui à priorité 20 reçoit son résultat. Une inversion de ces priorités peut changer le rendu final.

Précautions et limites

Une priorité ne garantit pas qu’un autre plugin ne modifiera pas les registrations. La priorité concerne l’ordre de callbacks d’un hook donné, pas un ordre global entre hooks différents.