Rewrite Rules

Définition : Rewrite Rules sont les règles de réécriture utilisées par WordPress pour interpréter des URL lisibles et les convertir en paramètres de requête. Elles associent des motifs, souvent des expressions régulières, à des cibles internes.

Terminologie

Appellation officielle : Rewrite Rules

Autres appellations : Règles Rewrite, Règles de routage WordPress

Comprendre le fonctionnement

Le système WordPress de permaliens permet de présenter des adresses lisibles plutôt que des URL reposant seulement sur des paramètres numériques. Les règles de réécriture font le lien entre une structure d’URL et les variables que WP puis WP_Query peuvent comprendre. Leur ordre importe, car un motif trop général peut masquer une règle plus précise.

Les extensions ajoutent habituellement des règles avec add_rewrite_rule(), après avoir défini les variables nécessaires. Une modification exige souvent de rafraîchir ponctuellement les règles enregistrées ; il ne faut pas effectuer cette opération à chaque visite. Une règle active ne garantit ni l’existence de la ressource ni l’autorisation d’accéder à son contenu.

Exemple concret

Une adresse /ressources/guide/ est transformée en paramètres permettant à WordPress de retrouver une ressource particulière.

Exemple de code commenté

<?php
// Exemple de déclaration dans un plugin ; nécessite une logique de rendu.
add_action( 'init', function () {
    add_rewrite_rule( '^ressource/([^/]+)/?$', 'index.php?name=$matches[1]', 'top' );
} );
// Attention : collision possible avec des slugs existants.
// Actualiser ponctuellement les règles après installation.