Découverte Drupal – Path Filter
Path Filter est un module qui est méconnu ou simplement sous-estimé. Ce module vous permet d’ajouter des liens dans votre contenu sans avoir besoin d’écrire un chemin absolu à la main ou un chemin relatif en vous croisant les doigts que ce contenu ne sera pas réutilisé à un niveau plus bas dans le site.
Ce module est ce qu’on appelle dans le jargon un « input filter ». Lors de l’affichage du contenu, il traduira les liens en liens absolus. Il suffit de suivre une syntaxe simple : ajouter « internal: » devant le lien et mettre le tout entre guillemets.
Par exemple, si je veux faire un lien à ma node 30, j’écrirais dans mon contenu : <a href= »internal:node/30″ title= »Parce que les bons programmeurs spécifient toujours un titre intelligent et utile »>Exemple de Path Filter</a>. Path Filter va toujours me retourner http://www.quiboweb.com/drupal/exemple/path-filter, peu importe que le lien soit affiché dans la page http://www.quiboweb.com/equipe/la-meilleure-au-quebec ou à la racine du site.
Selon votre manière de travailler, en suivant cette technique vous pouvez laisser le client entrer son contenu sur un site de développement et faire une mise en ligne complète sans avoir besoin de passer la soirée (ou la nuit) à vérifier tous les liens et faire les modifications à la main.
L’exemple que j’ai donné plus haut ce sert du ID de la node, mais l’alias url peut aussi être utilisé. Exemple : « internal:drupal/exemples/path-filter » et le tout fonctionnera de la même façon. Le module fonctionne aussi avec les fichiers et les sites multilingues, en mode sous domaine (http://fr.quiboweb.com) ou même en mode sous dossier (http://quiboweb.com/fr/).
Maintenant que vous êtes accrochés et palpitez de joie d’avoir la solution à tous vos problèmes, voici les instructions pour l’installation :
- On télécharge le module
- On extrait le module dans notre dossier /sites/all/modules/ (contrib/ pour ceux qui aiment séparer les modules venant du site drupal.org et ceux faits maison.)
- On active le module via notre interface d’administration
- Dernière étape, la plus compliquée, il faut activer le filter. Sous la page Administration du site (« Administer » en anglais), vous devriez y trouver la page Format d’entrée (Input format). Choissisez un des formats et cliquez sur configurer. Activer le filter « Internal Path Filter ».
Lorsque vous ajoutez votre contenu, n’oubliez pas de choisir le bon mode d’entrée si vous n’avez pas activé le filtre pour tous les types d’entrée. C’était un exemple assez simple parce que je n’avais pas de wysiwyg d’activé, mais en résumé, il suffit de spécifier l’ordre dans lequel les filtres sont appliqués. N’hésitez pas à laisser un commentaire si vous avez une question, des problèmes avec votre wysiwyg ou si une étape manque de clarté.