WP_Rewrite::add_permastruct()

Définition : WP_Rewrite::add_permastruct() est une méthode qui enregistre une structure personnalisée de permaliens dans le moteur de réécriture WordPress. Cette structure sert à générer des règles correspondant à des URL lisibles.

Terminologie

Appellation officielle : WP_Rewrite::add_permastruct()

Autres appellations : Structure de permalien, Permastruct

Comprendre le fonctionnement

Une permastruct est un modèle contenant des segments et éventuellement des marqueurs comme %postname%. WP_Rewrite l’utilise pour produire des règles de reconnaissance de chemins. Des options déterminent par exemple l’emploi d’un préfixe, de la pagination, des flux et des endpoints. Une structure enregistrée doit être associée à une logique capable de traiter la requête.

La fonction publique add_permastruct() est généralement préférable à l’appel direct de cette méthode dans une extension. L’enregistrement des structures doit se faire à un moment prévu du cycle de chargement. Une modification réelle des structures peut nécessiter un rafraîchissement des règles, mais cette opération doit rester ponctuelle pour des raisons de performance.