WP_Rewrite::add_rule()
Définition : WP_Rewrite::add_rule() est une méthode du Core qui enregistre une règle de réécriture associant un motif d’URL à des variables de requête. Elle participe à la gestion des permaliens personnalisés de WordPress.
Terminologie
Appellation / équivalent : WP_Rewrite::add_rule — ajout d’une règle de réécriture
Autres appellations : Ajout de règle Rewrite, Règle personnalisée d’URL
Comprendre le fonctionnement
Une règle combine généralement une expression régulière et une cible indiquant comment interpréter le chemin reçu. La méthode distingue différentes formes de règles, dont certaines nécessitent une prise en charge au niveau du serveur. L’ordre des règles est important lorsqu’un motif peut en recouvrir un autre.
Pour développer une extension, la fonction publique add_rewrite_rule() constitue habituellement l’interface la plus pratique. Les règles doivent être enregistrées au moment prévu, puis actualisées lors d’une activation ou d’un changement de structure. Un flush à chaque requête est coûteux et doit être évité.
Exemple concret
Une extension prévoit un chemin lisible pour afficher un type de contenu spécial et ajoute la règle de correspondance associée.
Point technique à retenir
La méthode de classe n’est pas un routeur complet et une règle enregistrée n’est pas forcément immédiatement active sans actualisation.
Termes associés
- WP_Rewrite
- add_rewrite_rule()
- Rewrite Rules
- flush_rewrite_rules()
