Ce pipeline permet d’utiliser des URLs standard de SPIP sur les objets indiqués et de calculer la correspondance entre une URL standard et l’objet correspondant. Ces URLs peuvent être de la forme :
-
spip.php?objetXX
(spip.php ?article12) -
?objetXX
(?article12) - pareil avec
.html
à la fin.
Avec le fichier .htaccess
fournit par SPIP et activé, les URL peuvent aussi être :
-
objetXX
(article12) -
objetXX.html
(article12.html)
L’URL calculée lorsqu’on utilise les fonctions de calcul d’URL de SPIP (balise #URL_
ou fonction generer_url_entite
) dépend du jeu d’URL sélectionné dans la configuration de SPIP.
Ce pipeline est appelé dans ecrire/inc/urls.php avec une liste d’objets prédéfinie. Il prend et retourne un tableau de la liste des objets pouvant servir d’URL :
$url_objets = pipeline('declarer_url_objets', array('article', 'breve', 'rubrique', 'mot', 'auteur', 'site', 'syndic'));
La balise #URL_nom
renvoie une URL pour un objet et un identifiant donnée (pas besoin de déclaration pour cela). Ce pipeline est utilisé pour décoder une URL standard et retrouver l’objet et l’identifiant de l’objet sur laquelle elle s’applique. Une fois déclaré un objet « nom », ?nomXX
dans l’URL permet à SPIP de calculer que l’objet est « nom » ; que l’identifiant « id_nom » vaut « XX » et que par conséquent, il doit essayer de charger le squelette nom.html
avec l’identifiant trouvé.
L’usage de ce pipeline peut aller de pair avec la déclaration de « table_titre » dans le pipeline declarer_tables_interfaces. Cela indique sur quelle colonne SQL de l’objet puiser pour créer une URL signifiante.