Publié le Samedi 6 décembre 2008 à 21h50.

Documentation sur Drupal

Soumis par Sylvain31 le sam 06/12/2008 - 21:50

Quelques docs concernant Drupal

Site officiel : http://drupal.org/

Toujours passer par le site officiel pour trouver les modules. Par exemple pour le module Node Blocks, on trouvera à l'adresse http://drupal.org/projec… : - au milieu en haut, une présentation de ce que fait le module - ensuite, les liens de téléchargement des différentes versions du module - en bas, le lien vers la documentation - dans la colonne de gauche, les liens "all issues" et "bug reports" pour consulter les problèmes qui ont déjà été signalés (et peut-être résolus) sur ce module

2 sites très intéressants en Français, qui expliquent les principes de base sur les modules, la taxonomie, les blocs, les menus...A la découverte de Drupal : http://www.atelierdrupal… du webmestre débutant sous Drupal : http://drupalfr.org/docu…

Autres sites : Site en Français : http://drupalfr.org/ Wikipedia : http://fr.wikipedia.org/… Documentation des modules : http://drupal.org/handbo… Doc en Anglais sur comment écraser les fonctions et les templates avec des versions personnalisées : http://drupal.org/node/1… Mieux comprendre le système de taxonomie de Drupal (classement des articles en sections et avec les tags) : http://www.ineation.com/…

Accès à la base CVS des modules Drupal (pour lire le README ou d'autres fichiers dans les dernières versions des modules) : http://cvs.drupal.org/vi…

 

Gestion des domaines

On a 2 instances de Drupal qui tournent en parallèle : l'instance de production et l'instance de test. Ces 2 instances ont un contenu et une configuration différente. Chaque instance correspond à un VirtualHost différent au niveau de la conf Apache.

Instance de prod :Arborescence sur le disque dur : /var/www/npa2009.orgBase de données MySQL : npa2009Fichier de configuration Apache : /etc/apache2/sites-enabled/npa2009.orgSert les domaines :  www.npa2009.org, npa2009.org (redirige automatiquement sur www.npa2009.org), cpossible.npa2009.org, npa-regionales2010.org, www.npa-regionales2010.o… (redirigera bientôt automatiquement sur npa-regionales2010.org)

Instance de test : Arborescence sur le disque dur : /var/www/test.npa2009.org Base de données MySQL : npa2009test Fichier de configuration Apache : /etc/apache2/sites-enabled/test.npa2009.org Sert les domaines :  test.npa2009.org, cpossible.test.npa2009.org, npa-regionales2010.test.npa2009.org

Chacune des 2 instances sert plusieurs domaines, c'est géré par le module "domain access" de Drupal. Voir la configuration ici pour le site de prod, et ici pour le site de test.

 

Pages utiles pour la maintenance du site sous Drupal

La page "rapports" du site Pour vérifier que le cron tourne correctement : aller dans entrées récentes du journal, cliquer sur filtrer les messages du journal, puis sur cron, et enfin sur le bouton filtre. Sont aussi accessibles via cette page, le tableau de bord (pour voir si il y a des problèmes dans la conf Drupal, voir la version de Drupal installée, etc.), et la page sur les mises-à-jour disponibles.

La page "modules" Permet de vérifier les dépendances entre modules, voir les modules installés, désactiver ou désinstaller des modules...

Recherche d'articles ou autres contenusCes menus sont accessibles via le menu "gestion du contenu > contenu" : contenus rédactionnels, contenus comités, tous les contenus.

Vidage des cachesAccessible par la petite icône de mégaphone tout en haut à gauche > "flush all caches" (à ne lancer qu'en cas de réel besoin car ça ralentit le site).

Passage du site en mode maintenanceEn cas de problème...

 

Modification des menus

Il faut bien distinguer plusieurs types de menus :

  • Le menu qui se trouve tout en haut du site et qui est réservé aux administrateurs, ce menu est géré par le module Drupal "administration menu" et son contenu est généré automatiquement en fonction des modules installés sur le site
  • Le menu qui se trouve sur la droite et qui peut être plié et déplié (il faut cliquer sur l'icône représentant un outil pour le déplier), ce menu est géré par le module Drupal "admin" et est accessible aux administrateurs, mais aussi aux contributeurs du site. Sur la page de configuration du module "admin", on peut choisir les blocs qui vont s'afficher ou pas dans le menu.
  • Les menus présentés aux visiteurs, par exemple le menu qui affiche les gros titres "qui sommes-nous", "librairie la brèche", etc. (menu "secondary links" de Drupal) et le menu de navigation du site, qui présente les titres "accueil", "comités", "actualités", etc. (menu "primary links" de Drupal)

Pour modifier un élément de menu pour les visiteurs, il faut passer par : http://www.npa2009.org/a… et modifier le menu concerné.Pour réordonner les liens d'un menu, une fois qu'on est sur la page d'édition du menu on a à gauche en face de chaque item une icône qu'on peut déplacer pour déplacer cet item.Si on a une page (un article) qu'on veut ajouter dans un menu, il faut éditer cette page, en bas on trouve un encart "paramètres de menu", là il faut renseigner le champ "titre du lien dans le menu" et le champ "élément parent", par exemple <secondary links> = les onglets "qui sommes-nous" et autres, <primary links> = accueil et autres...

Si on veut modifier le menu de droite, il faut vérifier sur la page de configuration du module "admin" que le menu correspondant est affiché dans le menu "admin", et modifier le menu sur http://www.npa2009.org/a… comme pour n'importe quel menu.

 

Modification des vues

Les vues définissent l'affichage des différents éléments sur le site : articles sur la page d'accueil, évènements dans l'agenda, etc. Faire très attention quand on y touche, et dans le doute, s'abstenir !

Les vues correspondent à un certain contexte.

Par exemple, pour modifier l'ordre des évènements dans l'agenda :
  • Aller dans le menu Construction du site > Context
  • Cliquer sur "modifier" en face de "agenda"
  • Dans la section "conditions", on voit que ce contexte est activé quand on clique sur le menu "agenda" et correspond à la vue "agenda"
  • Aller dans le menu Construction du site > Vues
  • Cliquer sur le bouton modifier en face de la vue "agenda"
  • Dans la colonne qui est tout à gauche (sur fond grisé), faire attention de bien choisir la vue qui nous intéresse. Par exemple, pour l'agenda, on a 5 vues : "defaults", "bloc", "page", "bloc : liés", "bloc : promus"
  • Modifier ce qu'on veut. Par exemple, si on veut changer l'ordre d'affichage des éléments : Sort Criteria > Contenu : date - du (asc).
  • L'option à modifier apparaît en bas, par exemple on a le choix entre "sort order" : ascending, ou descending.
  • Quand les options sont en italique et en gris, ça signifie qu'on est sur une vue qui reprend les paramètres de la vue "defaults". Par exemple, pour modifier l'ordre d'affichage de toutes les vues différentes de l'agenda, il suffit de le modifier sur la vue Agenda / Defaults, et le paramétrage sera repris pour les autres vues de l'agenda.
  • Après avoir fait les changements, cliquer sur "mise à jour"
  • ATTENTION : Il faut ensuite valider la modification de la vue en cliquant sur le bouton "enregistrer" qui se trouve en-dessous
Autre exemple, pour ajouter un lien dans le bloc "NPA TV" qui s'affiche sur la page d'accueil du site :
  • Aller dans le menu Construction du site > Context
  • Cliquer sur "éditer" en face de "front"
  • Dans la section "conditions", on voit que ce contexte est activé quand on est dans le chemin <front> c'est-à-dire sur l'accueil du site
  • Sur cette page, on voit que le bloc "NPA TV" sera affiché dans ce contexte, dans la position "sidebar top"
  • Aller dans le menu Construction du site > Vues
  • On voit que la vue "npatv" porte le titre "NPA TV", ce qui correspond au nom du bloc repéré précédemment
  • Cliquer sur le bouton éditer en face de la vue "npatv"
  • Dans la colonne qui est tout à gauche (sur fond grisé), faire attention de bien choisir la vue qui nous intéresse. Dans notre cas, il s'agit du bloc affiché sur la page d'accueil, donc cliquer sur "bloc : accueil"
  • Modifier ce qu'on veut. Par exemple, dans ce cas on veut modifier l'en-tête donc on clique sur "en-tête : aucun".
  • On a "status : using default options" donc on clique sur "override", sinon on va modifier l'option par défaut (qui s'applique aux vues de la web tv quel que soit le contexte) alors qu'on ne veut modifier qu'un contexte particulier
  • Ensuite, on met notre lien dans la boîte d'édition qui se trouve en dessous
  • Cliquer sur "mettre à jour"
  • On peut vérifier le rendu avec la "live prview" en bas de page
  • Quand on est satisfait du résultat, cliquer sur "enregistrer" pour sauvegarder la vue
  • Si on veut faire la même chose pour un autre affichage de la vue, suivre la même procédure en sélectionnant un autre contexte dans la colonne grise de gauche, par exemple "page" pour modifier la page "NPA TV" qui se trouve à l'adresse http://www.npa2009.org/n…

 

Pour avoir l'aperçu du résultat d'une vue :
  • Noter le nodeid du node en question. C'est le numéro qui est dans l'URL quand on clique sur "éditer" pour un article, une vidéo, la page d'un groupe, ou n'importe quel contenu
  • Quand on est en train de modifier la vue, dans "Live preview", choisir pour le champ "Affichage" la bonne valeur
  • Entrer dans "arguments" le nodeid
  • Cliquer sur "aperçu"

 

Modification d'un bloc

Modification du texte pour la boutique (mentions légales) :

 

Ajout d'un bloc sur la page d'accueil

Exemple pour rajouter une vignette "régionales" dans le style des blocs cpossible et souscription :

 

Ajout de liens dans un bloc pour voir les pages suivantes

Exemple pour ajouter un lien pour afficher les pages d'actus suivantes sur la page d'une région :

  • Aller dans le menu Construction du site > Context
  • Cliquer sur "override" en face de "front_region"
  • Dans la section "conditions", on voit que ce contexte est activé quand on est sur le node d'une région
  • Dans la liste des blocs (en bas), dans la position "content bottom", on voit qu'il y a le bloc "Actualités: Accueil: Régionales"
  • Aller dans le menu Construction du site > Vues
  • Cliquer sur le bouton éditer en face de la vue "news" qui porte le tire "Actualités" (correspondant au nom du bloc "Actualités: Accueil: Régionales")
  • Dans la colonne qui est tout à gauche (sur fond grisé), faire attention de bien choisir la vue qui nous intéresse. Dans notre cas, c'est "Bloc: Accueil: Régionales" (cf. le nom du bloc repéré juste avant)
  • Cliquer sur "use pager" dans "basic settings"
  • Cliquer sur "override" pour lui dire qu'on ne prend pas les valeurs par défaut de la vue, mais on veut une config particulière pour le cas où on est sur la page d'accueil des régionales
  • Choisir "mini" et valider + sauvegarder la vue

La même chose, mais pour l'affichage des vidéos suivantes (en AJAX) :

http://npa-regionales2010.org/admin/build/views/edit/npatv > Bloc : Accueil Groupe Use AJAX: Override > Oui Use pager: Override > Mini

 

Gestion de la publication d'articles sur plusieurs domaines

 

Pour un article publié par un admin national sur le site npa2009.org, qu'on veut publier aussi sur le site des régionales :
  • bloc "Options du module Domain Access" : cocher "NPA Régionales 2010" en plus de "NPA"
  • "domain source" : doit être "NPA Régionales 2010" (cf. explications plus bas)
  • bloc "groupes" : si l'article concerne une région, la région doit être sélectionnée
  • cocher la case "Promouvoir en page d'accueil sur le groupe" si l'article concerne une région (sinon, il ne sera accessibles que par des chemins détournés : recherche par tag ou autre)
  • cocher la case "Promouvoir en page d'accueil sur le domaine" si l'article est à mettre en page d'accueil du site des régionales

 

Pour un article publié par un admin de région sur le site des régionales, qu'on veut publier aussi sur le site npa20090org :
  • bloc "Options du module Domain Access" : cocher "NPA" en plus de "NPA régionales 2010"
  • vérifier que les catégories, tags, etc. sont bons (attention, penser que ça s'appliquera aussi à l'article du site des régionales, ce qui pourrait faire changer l'article de page)
  • cocher si besoin les cases "bandeau de une" ou "promu en page d'accueil" dans l'onglet "options de publication"

 

Pour un article publié par un admin de région, qu'on veut mettre en page d'accueil du site des régionales :
  • cocher la case "Promouvoir en page d'accueil sur le domaine"

 

Cas général :
  • bloc "Options du module Domain Access" : cocher "NPA" pour npa2009.org et/ou "NPA Régionales 2010" pour npa-regionales2010.org
  • "domaine source" : doit être "NPA Régionales 2010" si l'article est publié sur le site des régionales, ou sur les 2 sites (cf. explications plus bas)
  • bloc "groupes" : si l'article concerne une région, la région doit être sélectionnée (de même pour les articles de comité, le comité doit être sélectionné). la case "public" doit être cochée.
  • case à cocher "bandeau de une" : pour mettre dans le bandeau de une du site npa2009.org (les 5 articles qui défilent)
  • case à cocher "Promouvoir en page d'accueil sur le groupe" : pour mettre en page d'accueil de la région, à l'adresse npa-regionales2010.org/region
  • case à cocher "Promouvoir en page d'accueil sur le domaine" : pour mettre en page d'accueil du site des régionales  : npa-regionales2010.org
  • case à cocher "promu en page d'accueil" dans l'onglet "options de publication" : pour mettre dans les 8 articles de page d'accueil du site national npa2009.org

 

Fonctionnement du "domaine source" :

Par défaut, le domaine source est le domaine courant, donc lorsque les administrateurs région créent un article, il a pour valeur "npa régionales".

Lorsque les administrateurs du site national modifieront l'article pour le publier sur npa2009.org, il restera affilié au site des régionales.

Du coup, quand on cliquera sur un article depuis la une du site national, on arrivera sur le site des régionales.

 

Sitemaps pour Google et Google News

Elles sont générées respectivement par les 2 modules "XML sitemap" et "Google News sitemap".

A surveiller :

  • XML sitemap n'est pas encore compatible avec Domain Access (génère une sitemap valable seulement pour le domaine npa2009.org) - cf. http://drupal.org/node/534170
  • Google News sitemap doit à l'avenir être intégré à XML sitemap - cf. http://drupal.org/node/451234
  • XML sitemap est configuré pour l'instant pour ne générer dans la sitemap que des liens vers les contenus de type article, audio, comité, et vidéo. A étendre pour la suite à d'autres contenus (articles comités notamment) mais il vaudrait mieux finir de configurer les URLs propres sans accent et sans contenu dupliqué, avant de tout mettre dans la sitemap
  • Voir aussi ce qu'on fait du module "site menu" qui est activé (sert à créer un plan du site pour les visiteurs) mais pas bien configuré, et son résultat n'est pas utilisé pour l'instant

 

URLs simplifiées (clean URLs) et redirections

Pour éliminer les URLs à caractères accentuées qui posent divers soucis, et éliminer le problème des URLs dupliquées (une URL avec /node/numéro et une URL avec /content/titre-article qui pointent vers le même contenu), le plan est le suivant :

  • install du module "redirect" qui permet à pathauto de mettre en place des redirect HTTP 301 des anciens alias vers les nouveaux => fait
  •  màj de pathauto en v1.3 qui gère ça => fait
  • modification du paramétrage de pathauto pour utiliser la "transliteration" (pour supprimer les accents dans les URLs) => fait
  • install du module "global redirect" pour rediriger automatiquement (301) les URLs de type "node" vers les URLs "alias" => fait
  • regénération de tous les chemins avec les nouveaux réglages (donc sans accents) => gros impact, à tester d'abord sur le site de test

 

Paramétrage de la boutique (Ubercart)

Paramétrage des infos à entrer par l'utilisateur (adresse, ville...) : http://www.npa2009.org/a…

Fichier modifié : /var/www/npa2009.org/sites/all/modules/ubercart/uc_cart/uc_cart_checkout_pane.inc (cf. http://drupal.org/node/3… )

Paramétrage des mails de confirmation : sur le serveur, fichier /var/www/npa2009.org/sites/all/modules/ubercart/uc_order/templates/admin.itpl.php pour l'admin, et npa.itpl.php pour l'utilisateur (voir la signification des champs sur http://www.npa2009.org/a… )

Configuration de la boutique (nom, adresse mail...) : http://www.npa2009.org/a…

 

Infos OG dans la base de données

Pour savoir si un node est public : dans la table og_access_post :

nid     og_public15518   1

Pour savoir les groupes d'affiliation : dans la table og_ancestry (je ne sais pas pourquoi certains nodes sont affiliés au groupe 0 et d'autres non) :

nid     group_nid15518   015518   1239

Pour vérifier que les pages de doc ne sont pas publiques :

SELECT * FROM og_access_post where nid=1243 or nid=1245 or nid=1290 or nid=2493 or nid=8827 or nid=15518 or nid=15520

En cas de modif, il faut ensuite vider le cache "nodeaccess" pour que la modif des droits soit prise en compte par Drupal.