Utiliser des URLs personnalisées

Par défaut, les pages générées par SPIP utilisent des adresses relatives ressemblant à article.php3?id_article=123, donnant des URLs du type http://www.minirezo.net/article.php3?id_article=123. Ce type de syntaxe, courant chez les sites « dynamiques », n’est cependant pas très joli ni très évocateur. Il y a possibilité d’avoir des adresses plus à votre goût - par exemple article123.html - , et SPIP vous aide en partie dans cette tâche.

Cette fonctionnalité fait appel à la distinction entre deux types d’URLs :

 l’URL apparente d’une page, c’est-à-dire telle qu’elle est tapée et/ou affichée dans la barre d’adresse du navigateur. Par exemple http://www.uzine.net/article765.html. Ce sont ces URLs qu’on cherche à rendre plus « jolies » ou plus « signifiantes » ;

 l’URL réelle de la page, c’est-à-dire l’URL qui est « vue » par SPIP lorsque la page est calculée sur le serveur. Par exemple http://www.uzine.net/article.php3?id_article=765 ; en général, cette URL peut aussi être tapée directement dans le navigateur (vous pouvez vérifier).

Choisir le type d’URLs apparentes

Le fichier inc-urls.php3 à la racine de SPIP, contient la déclaration d’une variable PHP contenant le type d’URLs à utiliser. Par défaut :

$type_urls = "standard";

Cette variable détermine le nom du fichier PHP qui est appelé pour gérer les URLs. Avec la déclaration par défaut ci-dessus, c’est inc-urls-standard.php3. Vous remarquerez qu’il y a aussi un fichier inc-urls-html.php3. Il permet de traiter des adresses du type de celles que nous avons prises comme exemple (« article123.html »). Vous pouvez donc décider d’utiliser plutôt ce fichier que le fichier « standard » en remplaçant la ligne sus-citée par la suivante :

$type_urls = "html";

Si vous voulez plutôt utiliser vos propres adresses (ce pour quoi vous devez savoir programmer en PHP), il est fortement conseillé de partir d’un des fichiers existants et de le recopier sous le nom que vous aurez choisi : inc-urls-XXX.php3.

Voyons maintenant les différents types de modifications à apporter.

Programmer la traduction des adresses apparentes en adresses réelles

Pour que l’adresse article123.html appelle bien en réalité le fichier PHP article.php3 avec comme paramètre id_article=123, il va falloir configurer le serveur Web qui héberge votre site, soit dans un fichier .htaccess (ça ne marche pas toujours), soit dans le fichier de configuration centrale du serveur si vous y avez accès. Cela utilise, sous le serveur Apache (le plus utilisé), ce qu’on appelle des Rewrite Rules : des règles de réécriture d’adresses Web.

Savoir écrire ces règles n’est pas simple pour les non-programmeurs, et nous ne pouvons pas vous donner de solutions infaillibles car cela dépend de votre configuration : cette partie est entièrement entre vos mains (ou celles de votre hébergeur).

Néanmoins et à titre d’exemple, voici les règles utilisées sur le site d’uZine :

(note si vous écrivez vos propres règles : utilisez toujours l’option [QSA] car l’adresse peut présenter des paramètres supplémentaires - comme lorsque vous appuyez sur le bouton « recalcul », affiché si vous placez le cookie d’administration ; l’option [L] signifie, quant à elle, que la réécriture s’arrête là si la règle est appliquée : Last)

Il est conseillé de tester la validité de ces adresses (en les essayant depuis votre navigateur) dès que vous avez mis en place la configuration correspondante, car sinon la suite ne servirait à rien.

Générer les URLs apparentes dans les pages SPIP

SPIP incorpore une fonctionnalité permettant de générer automatiquement les URLs du type que vous aurez choisi, à l’intérieur même des pages calculées par SPIP. Ainsi, les liens vers des articles seront par exemple générés sous la forme article123.html.

Les fichiers inc-urls-XXX.php3 sont là à cet effet. Si vous avez décidé de créer le vôtre propre, il va falloir programmer vous-mêmes la génération des URLs. Sinon, c’est déjà fait. Vous découvrirez qu’un certain nombre de fonctions PHP sont définies, dans le fichier, sous le nom generer_url_type d’objet (par exemple generer_url_article). Le rôle de ces fonctions devrait vous être évident pour peu que vous compreniez un minimum le PHP. A vous de les modifier à votre guise. A titre d’exemple, vous pouvez vous plonger dans le fichier inc-urls du Monde diplo.

Dans tous les cas, n’oubliez pas d’aller modifier le type choisi à l’intérieur de inc-urls.php3.

Enfin, dans vos squelettes, vérifiez que pour calculer les liens à l’intérieur des boucles, vous utilisez toujours les raccourcis #URL_ARTICLE, #URL_RUBRIQUE, #URL_BREVE, etc. Ce sont en effet eux qui déclenchent l’utilisation des fonctions évoquées ci-dessus, permettant la génération des « bonnes » URLs.