Table des matières
Le formatage d'url sur Drupal - Pathauto
Ce tuto sera constitué en plusieurs étapes, elles même divisées en deux parties : la théorie et un exemple.
Pendant tout ce tuto je vais prendre comme exemple thedra :
Ce que l'on veut mettre en place : chaque contenu de type “Page de base” à un URL de type 'thedra.cmantika.com/node/45' et on veut transformer ça en 'thedra.cmantika.com/nom-de-la-page'
1 - accéder au module pathauto
Pour accéder à la page de pathauto, se connecter à l'admin drupal (en accédant au lien example.com/user) puis aller dans le menu
Configuration > Recherche et Metadonnées > Alias d'URL
Et enfin cliquer sur l'onglet “Motifs”
Exemple: accéder à thedra.cmantika.com/user, se connecter puis naviguer jusqu'au bon menu pour au final arriver sur cette page :
http://thedra.cmantika.com/admin/config/search/path/patterns
2 - Créer un motif
Cliquer sur le bouton “ajouter un motif pathauto” et choisir ensuite le type de contenu à qui l'on veut formatter les URL
Pour l'exemple il faut choisir “Content” car les “Page de base” sont un type de “Content”
Choisir le type de contenu que l'on veut si il y en à plusieurs, pour l'exemple cocher la case “Page de base”
Choisir une etiquette, celle ci permet juste, comme indiqué, de se retrouver dans les motifs. Par exemple “Motif page de base”
Puis vient ensuite la partie plus compliqué, créer le path pattern.
Ce path pattern est l'url qui va remplacer celle de tout les contenu que l'on a choisis auparavent via la liste déroulante et les cases à cocher.
2.1 - Découper l'url en deux parties
Pour pathauto url est composée de trois partie : le site, une partie statique et une partie dynamique
Le site est juste la première partie (www.)monsite.fr/com/… sans le / final, La statique est celle qui ne change pas tandis que la partie dynamique est celle qui change en fonction de la page.
Il faut donc cerner ces trois parties dans l'url finale que nous voulons :
Par exemple sur le site wikipedia voici deux articles :
https://fr.wikipedia.org/wiki/Giovanna_(Anna_Voggi)
https://fr.wikipedia.org/wiki/Masaharu_Yamada
Le site est https://fr.wikipedia.org, la partie statique est le /wiki/ et la partie dynamique est le reste de l'url qui est le titre de l'article.
Pour notre exemple nous voulons au final que les url ressemble à thedra.cmantika.com/nom-de-la-page
thedra.cmantika.com est le nom du site
/ est la partie statique et
nom-de-la-page est la partie dynamique
2.2 - utiliser cette url découpé
Cette url divisée en 3 va nous permettre de remplir la case “path pattern” du motifs que nous créons.
Pathauto connait déjà le njom du site donc pas besoin de le lui redonner.
La partie statique ne change jamais donc on peut la mettre directement dans la case, pour notre exemple cela veut dire que l'on peut mettre un / dans la case
Puis vient la partie dynamique, pour gérer cette dernière Drupal utilise ce qui s'appelle des Jetons (Tokens en anglais) qui sont des bouts de texte entre crochet reconnaissable par Drupal ([site:email] par exemple). Il faut donc réussir à créer toute notre partie dynamique en utilisant ces Jetons de Drupal.
Pour que cela soit plus simple drupal met à disposition un petit glossaire des jetons disponibles en cliquant sur le lien “Explorer les jetons disponibles.” sous la case “path pattern” .
En cliquant sur ce lien un petit tableau apparait avec tout les jetons disponible. Il est possible de cliquer sur les petites flèeches pour aller chercher des infos en profondeur et donc de plus en plus précise.
Pour avoir les les jetons liés aux information concernant les pages sur lesquelles nous nous trouvons (titre de la page, date de creation, type, etc..) il faut aller chercher dans le sous menu Noeuds (Node en anglais), c'est là ou se situe 90% des informations que l'on utilise généralement dans la pathauto.
Par exemple pour la partie dynamique de notre URL qui est nom-de-la-page nous allons chercher le Jeton correspondant au nom de la page. Celui ci se trouve dans le menu Noeud, se nomme Title et est égal à : [node:title]
Notre “path pattern” final ressemble donc à
/[node:title]
Il suffit ensuite de sauvegarder le motif avec le bouton enregistrer
3 - Générer tout les alias d'URL
Après avoir créer le motif d'url il faut demander à Drupal de faire passer tout les URL que l'on veut dans cette moulinette pour mettre à jour touts les URL sur le site. Pour cela se rendre dans l'onglet “Générer en masse” dans la page d'option des alias d'URL.
Il suffit ensuite de cocher les contenu dont nous voulons regénérer l'URL pour notre exemple il sagit de Content.
De choisir ensuite les alias à regénérer : Pour les chemins qui n'ont pas encore d'alias, pour ceux qui en ont, pour tous les contenus. Cela dépend de ce que l'on veut faire.
Puis cliquer sur Mettre à jour.
Et hop, toutes les URL sont générés
4 - Pour être sûr : vider le cache
Pour voir tout les changements d'URL il suffit ensuite le vider le cache de drupal, pour cela passer la suris par dessus le logo de Drupal 8 dans la barre de menu d'administrateur et cliquer sur le menu “Vider tout les caches”
Tout devrait êre bon.
Optionel : 5 - Surcharger l'alias pour une seule page
Il est possible sur Drupal de surcharger l'alias pour en mettre un customisé.
Il suffit pour cela de se rendre sur la page d'édition du contenu voulu, dans le menu à droite, sous la partie “Alias d'URL”, de décocher la case “Générer une URL automatiquement”.
Décocher cette case aura pour but de dévérouiller la zone de texte en dessous ou vous pouvez rentrer l'RUL customisée voulue.