WP_Rewrite::add_rewrite_tag()
Définition : WP_Rewrite::add_rewrite_tag() est une méthode interne qui ajoute ou met à jour un marqueur utilisé dans les structures de permaliens WordPress. Elle associe ce marqueur à une expression régulière et à une variable de requête.
Terminologie
Appellation officielle : WP_Rewrite::add_rewrite_tag()
Autres appellations : Balise de réécriture, Rewrite Tag
Comprendre le fonctionnement
Les structures de permaliens comportent des marqueurs, par exemple %postname%, qui seront remplacés par des motifs lors de la construction des règles de réécriture. La méthode enregistre le marqueur, son expression régulière et le fragment de requête correspondant. Elle agit sur les structures utilisées par WP_Rewrite et n’affiche aucune page à elle seule.
La fonction publique add_rewrite_tag() constitue généralement le point d’entrée adapté pour une extension. Elle gère des détails supplémentaires de validation et d’enregistrement de variables. Une règle modifiée peut nécessiter une régénération de la configuration de réécriture ; cette opération n’est pas destinée à être répétée à chaque visite du site.
Exemple concret
Une extension définit le marqueur %ouvrage% pour reconnaître une valeur intégrée à une URL personnalisée.
Point technique à retenir
Un marqueur décrit une partie d’URL ; il ne vaut pas contrôle d’accès ni validation du contenu demandé.
Termes associés
- WP_Rewrite
- add_rewrite_tag()
- Rewrite Rules
