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

Références officielles

Bouton retour en haut de la page