URL propres en arborescence virtuelle

Problématique

Une belle arborescence de rubriques devrait toujours être représentée par une belle url synthétisant cette arborescence. Et pourtant, même avec les urls propres, il était difficile d’obtenir plus qu’un titre et un identifiant peu parlants dans une barre d’adresse.

Avec un site décomposé de la forme suivante :

/ (Racine)
+ Télé-achat (Secteur)
| + Catégorie cuisine (Rubrique)
|   + Le plus beau presse-agrumes du monde (Article)

Il paraît logique d’avoir des adresses du type
-  http://monsite.exemple/
-  http://monsite.exemple/tele-achat/
-  http://monsite.exemple/tele-achat/categorie-informatique/
-  http://monsite.exemple/tele-achat/categorie-cuisine/le-plus-beau-presse-agrumes-du-monde.html

et bien c’est exactement ce qui vous est proposé ici !

Mais alors, Pierre, comment ça marche ?

C’est très simple Maryse ! Le système se base sur le même principe que les url_propres fournies dans la version officielle de Spip, sauf qu’au lieu de ne stocker que le titre dans le champ url_propre de la base de données, nous allons dorénavant stocker toute l’arborescence « propre ».

Il faudra aussi mettre en place une redirection d’adresse, puisque le répertoire tele-achat n’existe pas sur notre serveur web.

Allez, même pas peur, on va installer et paramétrer d’un coup !

Téléchargez et décompressez l’archive :

C’est fait ? Alors c’est parti !

Le fichier propres-arbo.php est à placer dans le répertoire
{monDossierSpip}/ecrire/urls/.

Dans sa configuration par défaut, les urls ne sont pas limitées en longueur, et tous les caractères sont convertis en minuscules.
Si ces règles ne vous conviennent pas, vous pouvez changer la configuration du script via les constantes suivantes :
-  _taille_min_url_propre : la longueur minimale de la totalité de l’url (0 pour ne pas limiter). Si la taille de l’url calculée est plus petite, celle-ci sera remplacée par son type suivi de son identifiant (exemples : rubrique1, article42,...)
-  _taille_max_url_propre : la longueur maximale de la totalité de l’url (0 pour ne pas limiter)
-  _taille_max_champ_url_propre : la longueur maximale d’un niveau de l’url (0 pour ne pas limiter)
-  _mIxEdCaSe : booléen indiquant si les majuscules sont autorisées dans l’url (0 pour interdire, 1 pour autoriser)

Pour basculer sur ces url propres, la seule chose à faire est d’éditer votre fichier
mes_options.php
afin de positionner la variable
$type_urls = "propres-arbo";

Attention, le fichier mes_options.php n’est pas placé au même endroit selon les versions de Spip :
-  {monDossierSpip}/ecrire/mes_options.php pour SPIP 1.9.1
-  {monDossierSpip}/config/mes_options.php pour SPIP 1.9.2 et ultérieures

Du bon usage des redirections

C’est bien joli de patcher notre SPIP, mais il faut aussi que les requêtes passées au serveur web lui parviennent.

Pour cela, deux solutions :
-  le mod_rewrite d’Apache : la solution la plus propre lorsque le module est disponible sur votre serveur
-  l’utilisation des ErrorDocument : une solution moins élégante techniquement mais toute aussi efficace pour les serveurs les plus démunis (n’hésitez pas à envoyer vos dons pour les aider).

Redirection avec le mod_rewrite

Pas grand chose à faire, il suffit de prendre le fichier mod_rewrite/htaccess.txt et de le placer à la racine de votre site SPIP après l’avoir renommé en .htaccess [1].
Il vous faudra peut-être décommenter et modifier la directive RewriteBase de ce fichier si SPIP est installé dans un sous-répertoire sur le serveur web.
Par exemple, si SPIP est installé dans http://monsite.exemple/spip/ il faut définir RewriteBase /spip/.

Redirection avec la directive ErrorDocument

Ici, ça va vite aussi, il vous faut deux fichiers :

- ErrorDocument/spip-rewrite-with-404.php qu’il faut placer à la racine de votre site SPIP.
Il vous faudra dans tous les cas créer ou définir une page d’erreur 404. Vous en trouverez une dans ErrorDocument/404.html que je vous recommande de placer dans votre dossier de squelettes. Si toutefois vous la placiez ailleurs ou sous un autre nom, il vous faudra modifier la ligne $this->pagedestination="squelettes/nom/de/votre/page/404.html"

Il vous faudra peut-être aussi modifier la variable $this->installdir de ce fichier si SPIP est installé dans un sous-répertoire sur le serveur web.
Par exemple, si SPIP est installé dans http://monsite.exemple/spip/ il faut définir $this->installdir=",^/spip/,"; (la chaîne utilisée est un filtre pour expression rationnelle, il faut donc laisser les virgules l’encadrant ainsi que le ’^’ qui indique que l’on travaille uniquement depuis le début de la chaîne de caractères).

-  ErrorDocument/htaccess.txt qu’il faut aussi placer à la racine de votre site SPIP après l’avoir renommé en .htaccess [1].
Il vous faudra peut-être modifier la ligne ErrorDocument 404 /spip-rewrite-with-404.php de ce fichier si SPIP est installé dans un sous-répertoire sur le serveur web.
Par exemple, si SPIP est installé dans http://monsite.exemple/spip/ il faut adapter la ligne en ErrorDocument 404 /spip/spip-rewrite-with-404.php";

Modifications à apporter à vos squelettes

Ça n’est pas encore terminé ! Puisque l’on crée une arborescence virtuelle, le navigateur et le serveur web ne vont pas s’y retrouver lors des inclusions d’images, scripts, feuilles de styles, etc.

La solution est très simple : ajouter la balise <base href="#URL_SITE_SPIP/" /> dans l’en-tête de votre site.

Au secours, les boutons d’administration ne fonctionnent plus !

Mais non Maryse, inutile d’appeler Jack Bauer, il y a toujours une solution, par contre ça implique de mettre les mains dans le cambouis, et comme Jack est occupé avec les chinois du FBI, il va falloir se débrouiller !

Tout d’abord, recopiez la fonction suivante dans le fichier mes_fonctions.php se trouvant dans votre dossier de squelettes :

<?php

	function url_a_la_racine ( $url ) {
		if ( $url == '' )
			return '';
		
		$racine = $GLOBALS['meta']['adresse_site'];
		$suffixe = preg_replace(',^.*(ecrire/|spip.php)?([^/]*)$,U', "\\1\\2", $url);
		
		return "$racine/$suffixe";
	}

?>

Ensuite, recopiez simplement le fichier bonus/administation.html dans le dossier {monDossierSpip}/squelettes/formulaires/.
ATTENTION ! si vous utilisez une version antérieure à la 1.9.2, il vous faut renommer administration.html en formulaire_admin.html.

Allez, encore un effort, on y est presque, il reste la modification la moins propre selon moi (si quelqu’un a mieux, lachez vos comms !) :

Recherchez la chaîne

<link rel='stylesheet' href='".url_absolue(find_in_path('spip_admin.css'))

dans les fichiers
-  monDossierSpip/ecrire/public/admin.php
-  monDossierSpip/ecrire/public/debug.php
puis remplacez la par

<link rel='stylesheet' href='".find_in_path('spip_admin.css')

Problèmes connus

RealET a dit :

« Une implémentation foireuse commune à Internet Explorer 6 et FireFox 1.5 fait que sur ces navigateur, le base href est pris en compte pour toutes les ancres de la page, ce qui a pour effet de faire planter toutes les ancres et notes de bas de page. »

Je n’ai malheureusement pas de solution à proposer à ce sujet, si quelqu’un connaît un hack, qu’il parle maintenant ou se taise à jamais...

Jean-Kevin, pirate-kiddie des temps modernes a dit :

« C’est nul cette modification : je viens de changer un nom d’article ou de rubrique, mais l’url ne change pas ! »

Mais non Jean-Kevin, c’est normal ! SPIP est partisan du moindre effort, et ce pour le bien de nos serveurs web. Ainsi il ne recalcule pas les urls propres tout seul. Mais n’aie pas peur, il existe un splendide plugin pour lui dire de le faire.

Une autre question ?