Le manuel du débutant

From Ineation wiki

Jump to: navigation, search

03-09-2008 : Attention, l'édition du manuel des débutants est gelée définitivement. La première version est maintenant suffisante pour être intégrée dans http://drupalfr.org. Cela doit être fait dans les tous prochains jours. En attendant vous pouvez trouver un pdf provisoire ici : http://www.ineation.com/node/70. Alex

Ce qui suit est conservé pour mémoire mais est bien moins complet que la version courante.



Contents

Avant de commencer

"La philosophie de Drupal" ou "Comment fonctionne Drupal?"

Qu'est-ce que Drupal ?

Drupal est un CMS<ref>Système de gestion de contenu (Content Management System)</ref> (1) libre et open source écrit en PHP. Mais la qualité de son code et son API (2) font qu'il peut aussi être présenté comme un framework (3). On parle alors de CMF (6).
Du point de vue du développement, un des grands avantages de Drupal est qu'il est construit sur une architecture modulaire : même le "core" (4) est en fait un ensemble de modules.
Drupal a su séduire de nombreux webmestres, car il permet d'obtenir un site fonctionnel et évolutif sans connaissances techniques (ou très peu) en quelques clics.

Si l'on souhaite étendre ses possibilités, de très nombreux modules sont proposés par la communauté et il est possible d'ajouter ses propres fonctionnalités avec quelques connaissances php et un apprentissage de sa logique (comme avec tout CMS ou framework).

Pour la plupart des sites standards, Drupal propose une ou plusieurs solutions :
le plus dur est quelque fois de trouver LE plugin qui vous correspond parmis tous ceux proposés.

Un autre aspect bien sympathique de Drupal est que tout ou presque est paramétrable directement par l'interface d'administration.

Comme tout est paramétrable et évolutif, Drupal est pour les non-développeurs un outil "magique" de pilotage et d'animation de communauté. Il replace l'internaute au "centre" du fonctionnement de votre site. Un avantage incomparable par rapport aux autres CMS php, car NATIF.

Comment fonctionne Drupal ?

Drupal étant constitué de modules plus ou moins indépendants les uns des autres, le workflow (5) n'est pas linéaire.
Chaque module est en quelque sorte une bibliothèque de fonctions.
Le core et par extention les modules définissent des points d'entrées qui permettent de modifier leur comportement.

Un autre point qui distingue Drupal d'autres CMS est que le front et le back-office sont intimement liés :
On édite son contenu dans le même contexte ou presque que l'utilisateur le voit.

L'élément central de Drupal est le "node" (un noeud en français). Tout contenu ou presque est node.

Pour des définitions plus détaillées, "google est ton ami"... ou encore wikipedia ou ... ou ...

(1) CMS : "Content Management System", un système de gestion de contenu.
(2) API : "Application programming interface", une interface de programmation.
(3) framework : "cadre de travail", une bibliothèque de fonctions, ...
(4) core : le noyau, le coeur de l'application.
(5) workflow : processus opérationnel, en quelque sorte le déroulement de l'application.
(6) CMF : Content Management Framework.

Concepts

(nodes, nodes types, catégories, blocks, menus, etc. > juste l'explication des concepts) Note de ineation : je pense que l'on est bcp trop détaillé pour le manuel du débutant. On ne devrait garder que les concepts de base ici et coller les concepts plus avancés (les hooks par exemple) dans le manuel de l'administrateur.

rôles et droits basiques

La gestion des droits utilisateur dans Drupal se base sur les "rôles".
[Il est également possible d'obtenir une gestion plus complexe en utilisant d'autres modules]

Les rôles peuvent être par exemple "administrateur", "webmasteur", "rédacteur", "utilisateur autentifié", ...
Aucune limite là encore, vous pouvez créer autant de rôle vous le souhaitez.
Chaque utilisateur Drupal est associé à un ou plusieurs rôles, les droits se cumulant.

Chaque module implémente une liste de permissions. En se rendant sur la page de gestion des droits dans le back office, vous avez accès à un tableau listant les différentes permissions et proposant pour chacune d'elles une case à cocher par rôle. Vous n'avez qu'à cocher ou décocher une case pour permettre aux utilisateurs ayant ce rôle d'effectuer l'action.

Par exemple : 

Nom de la permission | rédacteur | utilisateur authentifié | utilisateur anonyme
--------------------------------------------------------------------------------
Accéder au contenus  |     X     |            X            |          X
Editer le contenu    |     X     |            0            |          0
Poster un commentaire|     X     |            X            |          0

Signifie que tout le monde peut voir les contenus du site mais que seul les utilisateurs du groupe "rédacteur" pourront les éditer. Pour ajouter un commentaire, il faut être inscrit.

TODO : mettre en forme wiki le tableau exemple...

nodes

Le node est l'élément central du système de gestion des contenus dans Drupal.

Dans sa version la plus simple (celle que vous trouverez avec une installation classique), le node est un objet générique permettant d'insérer du contenu de type texte et de l'afficher dans votre site.

"Quoi !!! Drupal ne me permettra que de publier du contenu texte ?".
Pas du tout. Par l'intermédiaire des modules et notamment ceux classés dans la catégorie CCK (lien description cck), vous pouvez étendre les capacité des nodes et y ajouter des pièces de contenus multimédias (images et vidéos par exemple).


Il faut concevoir le node comme la "fondation" des types de contenu que vous utiliserez. En effet, même si la distribution de base vient avec deux types de contenu (story et page), vous aurez certainement très vite besoin d'autres type de contenu. Drupal vous permet de les créer en quelques clics.

Un exemple est peut-être plus parlant.
Je veux créer un site qui permettra aux internautes de laisser un témoignage sur leur vie de merde. Ça pourrait être drôle (http://www.viedemerde.fr/).

  1. J'installe mon Drupal
  2. J'observe vite dans admin/content/types que je n'ai que "story" et "page" comme types de contenu disponibles.
  3. Comme j'aime que ma chambre soit bien rangée, je créé un nouveau type de contenu, que j'appellerai prosaïquement : "Vie de merde".
  4. Les utilisateurs de mon site, selon leurs droits, peuvent désormais poster des "Vie de merde".

Dans Drupal, quasiment toutes les pages visibles s'appuient sur les nodes ou en prennent le chemin. Par exemple, les blogs, les discussions de forum sont des types de contenu.
Vous remarquerez très vite, à jouer avec Drupal, que l'installation d'un module déclenche fréquemment la création d'un nouveau type de contenu.

En complément de cette approche (node comme fondation des types de contenu), c'est que la présentation visuelle peut différer d'un type de contenu à l'autre via le système de theming de Drupal. En effet, chaque type de contenu peut avoir son fichier template séparé. Une fois maitrisé, cet aspect est assez pratique mais il peut dérouter plus d'un designer / intégrateur.
Une page dans votre navigateur n'est pas constituée d'un seul gabarit mais de plusieurs petits.

Reprenons l'exemple ci-dessus :
Sur mon site, en plus des "Vie de merde", mes utilisateurs peuvent poster des "actualité".
Par contre, j'aimerais que les internautes, sur les pages présentant les "vie de merde", voient un peu la vie en rose, ce qui n'est pas nécessaire sur le reste du site. Grâce au système de theming de Drupal, vous pourrez remonter le moral des internautes !

Node - Pour aller plus loin
Les nodes sont stockés dans la base de données et affichés selon les besoins des utilisateurs. En autre chose, tous les nodes possèdent :
- un ID unique (nid)
- au moins un ID de version (vid) - Et oui, Drupal gère très bien le versionning
- Une date de création ou de modification
- l'identification de l'auteur du node
- Le statut de publication du node (publié / en page d'accueil / en haut de liste)
- encore plein d'autres données
- et tout ce que vous lui ajouterez

nodes types

Les types de noeuds servent à définir un "comportement" par defaut dans l'affichage et dans la gestion du contenu des éléments qui seront écris sur le site.

Les types de noeuds par défaut de Drupal sont :


Article

Contenu court et/ou traitant d'un point précis (sans lien direct avec d'autres articles) qui sera regroupé par un terme d'une catégorie Définition de Drupal : "Les articles sont des pages dans leur forme la plus simple : ils comportent un titre, un chapeau et un corps, mais peuvent être étendus par d'autres modules. L'accroche fait également partie du corps. Les articles peuvent être utilisés comme un blogue personnel ou pour des articles d'actualité."


Page

Contenu plutôt long, page plutôt statique ou page orpheline (typiquement la page de crédit du site, une page de présentation). Définition de Drupal  : "Si vous voulez ajouter une page statique, comme une page de contact ou une page "à propos", utilisez une page."


Livre

Ensemble de "pages de livre" liées entre elles par des liens "avant-après" et avec un sommaire autogénéré. Comme son nom l'indique, ce contenu est adapté à un contenu structuré en chapitre, un contenu organisé autour d'une progression logique. Définition de Drupal : "Un livre est un effort collectif d'écriture : les utilisateurs peuvent collaborer à l'écriture des pages du livre, positionner les pages dans le bon ordre, et passer en revue ou modifier les pages écrites précédemment. Donc quand vous avez certaines informations à partager ou quand vous avez lu une page du livre et que vous ne l'avez pas aimée, ou si vous pensez qu'une certaine page aurait pu être mieux écrite, vous pouvez y faire quelque chose."


Sujet de discussion

Un sujet de forum Définition de Drupal : "Créer un nouveau sujet de discussion dans les forums."


Quelle est la difference réelle entre une "page" et une "story" ?

Pour faire court : aucune. En réalité, il y en a une, mais c'est uniquement au niveau de l'affichage par défaut de ces pages sur le site. En effet, une page n'affiche par les informations de l'auteur, la date de publication et les commentaires sont désactivés par défaut. Une "story" affiche les informations de l'auteur, la date de publication et autorise par défaut les commentaires. Sachant cela, il est tout à fait possible de faire en sorte que les "page" se comporte exactement de la même façon qu'une "story".

Et si j'ai besoin d'autres types de contenu ?

Il est tout à fait possible dans Drupal de rajouter autant de type de contenu qu'on le souhaite.
Il faut néanmoins utiliser un module qui n'est pas livré avec le core : CCK

Son utilisation est intuitive et ne nécessite pas de connaissances en programmation :
Il suffit de donner un nom (et quelques autres options) à un nouveau type de contenu pour qu'il soit directement exploitable. On peut lui ajouter autant de champs que nécessaire presque aussi simplement.

Commentaires

Les commentaires ont pour particularité de ne pas être des nodes.
Concrètement, cela signifie qu'ils en seront pas exploitables de la même façon que les autres contenus, mais on peut tout de même les personnaliser comme on le souhaite.

Tout node Drupal peut recevoir des commentaires et on peut paramétrer la manière dont ceux-ci fonctionneront indépendamment pour chaque type de node ou même chaque node :

  • pas de commentaires possibles
  • commentaires en lecture seule (c'est à dire non modifiables)
  • commentaires en lecture / écriture (il est alors possible d'éditer ses propres commentaires)

Le paramétrage global des commentaires permet de les trier du plus récent au plus ancien ou l'inverse, de définir s'ils doivent être linéaires ou s'il est possible de répondre spécifiquement à l'un d'entre eux. On peut également choisir si l'aperçu est obligatoire ou non.

catégories

Les catégories au sens Drupal sont d'une part l'équivalent des rubriques mais peuvent également servir de tags, de hierarchisation, ...
Le module gérant la catégorisation est "taxonomy".

Tout noeud peut recevoir un ou plusieur "vocabulaire" de taxonomy : simple, multiple ou libre :

  • simple : un seul choix possible
  • multiple : plusieurs choix possibles
  • libre : l'équivalent des tags : on peut écrire ce que l'on veut

Dans le cas d'une taxonomie libre (free tags), les nouveaux termes sont automatiquement ajoutés au vocabulaire.

'Qu'est-ce qu'un vocabulaire ?'

On nomme vocabulaire un ensemble de termes de taxonomie. On peut par exemple on peut avoir le vocabulaire "catégorie" regroupant "high tech", "musique", "politique", ... et un autre vocabulaire "public visé" contient lui "débutant", "expert", "intermédiaire", ...

blocks

Les blocs sont comme leur nom l'indique des blocs de contenu.
Certains modules définissent leurs propres blocs que vous pouvez ou non activer à votre guise.
Vous pouvez également créer de nouveaux blocs dans votre propre modules ou via l'interface du back office.

Chaque bloc possède une page de configuration qui vous permet de régler sa visibilité :
par page(s), par groupe d'utilisateur ou encore par un code php.

Le bloc peut être placer dans la région que vous voulez sur votre page.
Les régions sont fonctions du thème utilisé, par exemple Garland définie les régions suivantes :
haut de page, gauche, droite, contenu, pied de page.

menus

Dans Drupal, on peut définir autant de menus qu'on le souhaite.
Un menu est simplement un groupement de liens vers des pages que l'on peut placer où on le souhaite.
(Lorsque l'on créé un menu, celui-ci génère un bloc).

Themes

Les thèmes Drupal sont des ensembles de fichiers modifiant l'affichage de votre site.
Il est tout à fait possible de faire cohabiter plusieurs thèmes dans une même installation et de laisser le choix du thème aux utilisateurs.
(Mon compte > Editer)
Vous pouvez trouver des thèmes tout fait sur cette page : http://drupal.org/project/Themes
ou créer le votre (il faudra alors quelques compétences sur Drupal).

Drupal permet d'utiliser plusieurs moteurs de template (engines), par défaut c'est le moteur PHPtemplate qui est utilisé.
La thème employé par défaut est "Garland", pour le changer il suffit de se rendre dans la section
Administrer > Configuration du site > Thèmes.
Il faut alors cocher / décocher le(s) thème(s) que vous souhaitez voir proposer à l'utilisateur ou non.
Le bouton radio "par défaut" règle celui qui sera utilisé si l'utilisateur n'a pas fait de choix dans son profil.
Bien évidemment, si un seul thème est activé, le choix est masqué dans le profil.

Pour réaliser son propre thème, se reporter au manuel du designer.

File layout

Core

Core est un terme anglophone désignant le coeur, l'élément central...
Dans Drupal, le core est en fait le package officiel de modules et de thèmes.
Parmis les modules livrés dans le core, tous ne sont pas activés par défaut.
Vous pouvez donc avec une même version du core obtenir des sites totalement différents.

Modules

On pourrait comparer le concept de modules à celui de plugins / greffons.
Un module est une brique logicielle s'ajoutant à votre application pour étendre ses fonctionnalités ou modifier celles existantes.
Il est très simple d'activer ou non un module dans Drupal : une simple case à cocher / décocher suffit.

En pratique, un module est une bibliothèque de fonctions php qui s'interfacent avec les modules déjà présents par le biais des hooks.

Hooks

Dans le jargon Drupal, un "hook" (en français hameçon ou crochet), est un point d'entrée dans le fonctionnement de votre site.
Ces fameux hooks permettent de modifier le fonctionnement des modules installés sans avoir à toucher aux fichiers existants.
Cela présente un énorme avantage : lorsque la mise à jour d'un module est disponible, vous pouvez sans crainte l'installer,
Vos adaptations sont conservées.

Formulaires

Il y a plusieurs types de formulaires dans Drupal :

  • formulaires de saisie de contenu
  • formulaires de réglage des modules
  • Les formulaires personnalisés

Pour la saisie de contenu, le formulaire est généré automatiquement lorsque vous créez un type de node.
Pour les formulaires de réglage des modules, ils sont fournis avec le module en lui-même.
Les formulaires personnalisés nécessitent des connaissances plus poussées.

Un cas particulier est celui des "webforms" (http://drupal.org/project/webform) qui permet de créer des questionnaires très simplement.

Tout formulaire Drupal peut être étendu / modifié par d'autres modules et également avoir son propre gabarit.

Views

Bien que ce concept ne fait pas partie du core Drupal mais soit un module à part : views, vous aurez très certainement rapidement besoin de celui-ci pour votre site.

Une "view", en français "vue" est ce qui permet de faire des listes de contenu répondant à certains critères.
Par exemple "les derniers articles" ou "les derniers inscrits".

Là encore, l'interface est claire et intuitive et permet rapidement d'obtenir sa "vue" très rapidement.
On peut en quelques clics choisir les critères de sélection et de tris mis à disposition par les modules installés et choisir la présentation de ceux-ci. Par défaut, les modes de présentations disponibles sont :

  • teaser list : Le début du contenu est affiché, permettant ensuite d'accéder au contenu entier d'un simple clic (on trouve souvent ça sur les sites : "lire la suite").
  • full nodes : Le contenu est affiché entièrement (comme dans un blog classique)
  • table views : Les contenus sont représentés dans des cellules d'un tableau

Une même view peut fournir un bloc de contenu, une page complète ou les 2.

Panels

Comme pour views, il s'agit là encore d'un module à part : panels mais qui fait parti des "must have" Drupal.

Avec ce module il est possible de définir des mises en page avancées avec plusieurs colonnes, plusieurs lignes... Bref, vous pouvez faire une homepage complexe comme sur les sites portails en quelques clics.
On parle alors d'un "panel page" qui elle même peut contenir des "mini panels" offrant à peu de chose près les mêmes caractéristiques.
La seule limite est votre imagination : vous pouvez y intégrer des blocs, des views, ...


Weight

Concept très simple à comprendre mais que l'on retrouve à de nombreux endroits dans Drupal, simples comme avancés : blocs, menus, taxonomy, table system...

Le "weight", poids en français est un chiffre qui peut être positif comme négatif indiquant l'ordre dans lequel sera affiché l'élément.
Plus le poids est petit, plus l'élément sera placé "haut".

Par exemple, prenons ce menu simple :
- Page machin (weight : 0)
- Page bidule (weight : 5)
- Le blog de toto (weight : 1)
- Contactez nous (weight : 10)
- Accueil (weight : -10)

Il s'affichera sur votre site comme ceci :
- Accueil
- Page machin
- Le blog de toto
- Page bidule
- Contactez nous

Configuration requise

(php, mysql, apache, etc.)

Drupal 5.x supporte à la fois php 4 et php 5.
Drupal 6 ne fonctionne qu'avec php 5.

TODO : à compléter.
note de webastien : Est-ce utile de mettre ça dans le manuel du débutant ? Il y a le manuel de l'administrateur...

Ressources

(liens vers différentes docs, forums, etc.)

Principales APIs

Drupal 5 :
- API
- API formulaire

Drupal 6 :
- API
- API formulaire

Sécurité :
- Annonces de sécurité

lullabot
qqs tutos Drupal, des screencasts, en français... un design sympa

Première installation

Etape par étape

(depuis la création de la BD jusqu'à la création du s.root)
Note de webastien : Est-ce utile d'expliquer ici la création d'une base de données ?
Est-ce que ça ne fait pas doublon avec le manuel de l'administrateur ?

Récupérer la dernière version de Drupal

La première chose à faire est bien évidemment de télécharger la dernière release de Drupal.
Pour se faire, il suffit de se rendre sur la page d'accueil du site drupal.org :
Vous y trouverez un bloc sur la droite intitulé "Download".
Un clic sur le nom de la dernière version vous amène sur une page détaillant les informations relatives à celles-ci.
Un encart vous propose donc de télécharger l'archive au format tar.gz (Download Drupal X.X) : Il s'agit d'un fichier compressé.

Décompresser l'archive

Une fois le fichier téléchargé, vous devrez donc utiliser un logiciel permettant d'en extraire les sources.
Vous en trouverez facilement un (si vous n'en avez pas encore un sur votre système d'exploitation) en faisant une petite recherche sur le net.
Certains sont gratuits, d'autres payants, à vous de faire le choix en fonction de votre portefeuille :)

(note de webastien : doit-on citer des logiciels de décompression ?)

Contenu de l'archive

Pour simplifier l'écriture, "[+]" représente un dossier, "-" un fichier.

[+] includes : contient des bibliothèques de fonctions utiles à Drupal
[+] misc : diverses ressources (images, feuilles de styles et fichiers javascript notamment)
[+] modules : les modules faisant partie du core
[+] profiles : contient les profiles d'installation (par défaut, il n'y en a qu'un)
[+] scripts : différents scripts "shell" (utilisables depuis la ligne de commande)
[+] sites : c'est ici que seront paramétrés vos/votre site(s)
[+] themes : les thèmes livrés en standard
- .htacess : fichier de configuration serveur Apache
- CHANGELOG.txt : liste les principales modifications au cours des différentes versions
- COPYRIGHT.txt : informations sur le cadre d'utilisation légal de Drupal
- cron.php : script php permettant de lancer les tâches planifiées de Drupal
- index.php : le "front", c'est à dire le script php principal
- INSTALL.mysql.txt : explications sur l'installation de la base de données MySQL
- INSTALL.pgsql.txt : explications sur l'installation de la base de données postgreSQL
- install.php : le script d'installation de votre instance Drupal
- INSTALL.txt : explications sur l'installation de votre instance Drupal
- LICENSE.txt : la licence GNU GPL
- MAINTAINERS.txt : la liste des principaux responsables des modules du core
- robots.txt : fichier expliquant aux moteurs de recherche comment indexer votre site
- update.php : script de mise à jour de la base de données (pour les mises à jour modules)
- UPGRADE.txt : explications sur la mise à jour du core (par exemple pour passer de Drupal 5 à Drupal 6)
- xmlrpc.php : script pour gérer les appels utilisant le protocole XML-RPC

Préparer le terrain

On part du principe que vous avez déjà un environnement utilisable :
- Un serveur HTTP avec le module php
- Un système de gestion de base de données (SGBD)
- Une base de données accessible (c'est à dire dont vous avez le login et mot de passe)
(voir le manuel de l'administrateur pour plus de détails)

Pour démarrer votre installation, copiez simplement l'intégralité de l'archive dans votre dossier web.
Le dossier web est l'emplacement, sur votre serveur HTTP, où sont stocké les sites web que vous hébergés.

Pour simplifier l'écriture de l'aide, nous utiliseront les notations suivantes :
- **dossier web** : pour indiquer le répertoire en question
- **url web** : l'adresse internet associée à votre site Drupal

Démarrer l'installation

Maintenant que vos fichiers sont placés dans votre **dossier web**, vous pouvez dès à présent lancer votre navigateur internet préféré (Firefox, Internet Explorer, Safari, ...) et saisir **url web** dans la barre d'adresse.

Drupal est intelligent : Il détecte automatiquement que votre installation n'est pas configurée
Vous êtes donc redirigé automatiquement sur sur **url web**/install.php?profile=default.

Une fois sur cette page, vous retrouvez le logo Drupal, et 2 choses :
- sur la gauche, la liste des opérations à traiter (les étapes d'installation)
- sur la droite, "Choose language" suivi de 2 liens.

Vous ne pouvez interagir qu'avec la partie de droite pour le moment.
"Choose language" signifie "Choisissez la langue" (de votre installation).

2 possibilités s'offrent à vous :
- "Install Drupal in english" : installer Drupal en anglais
- "Learn how to install Drupal in other languages" : apprendre comment installer Drupal dans d'autres langages

Si vous choisissez la première option, sautez le paragraphe suivant.
(la suite de cette aide utilisera les termes français, mais si vous choisissez anglais, vous saurez traduire)

Drupal en français

Ok, vous avez donc cliqué sur le second lien...

Une page, toujours en anglais vous explique comment obtenir les traductions dans votre langue.
Cliquez alors sur le lien "Determine if a translation of this Drupal version".

Une nouvelle page s'ouvre sur l'adresse http://drupal.org/project/translations.
Recherchez la version de votre choix (français donc, qui est ici nommée "French translation")
Cliquez sur le lien "Download" à côté de la version Drupal que vous vous apprêtez à mettre en place.

Ici encore, il s'agit d'une archive compressée. Décompressez la et placez les fichiers qu'elle contient au même endroit que ceux du core.
Si une alerte vous indique que des dossiers / fichiers existent déjà, ce n'est pas grave (et même normal)
(Au besoin, autorisez le remplacement des fichiers)

Retournez sur votre page d'installation et actualisez la (touche F5 ou CTRL-R)...
Magie !!! Vous avez maintenant le choix entre :
- English (built-in) : installer en anglais
- French (Français) : je vous laisse deviner ;)

Cochez donc la seconde option et appuyez sur le bouton "Select language" (choisissez la langue).

Vous remarquerez que la liste des étapes passe en français... cool ! vous savez où vous allez :)

Configuration de la base de données

2 groupes de questions sont affichés :
- Options de base (fieldset affiché)
- Options avancées (fieldset fermé)

Options de base :

- Nom de la base de données : Comme son nom l'indique, il s'agit du nom de votre base de données.
Attention : Il ne s'agit pas de "MySQL" ou "PostgreSQL",
mais bien du nom de la base (aussi appelé "schéma" ou "shema")
dans laquelle seront placé les tables de données.

- Nom d'utilisateur : le login d'accès à cette base de données.
- Mot de passe : le "password" d'accès à cette base de données.

Options avancées :

Pour afficher ces options, cliquez sur le lien "Options avancées" : le fieldset se déroule en affichant de nouvelles questions :
- Serveur de base de données :
Par défaut "localhost" (le SGBD se trouve sur la même machine que le serveur HTTP),
Si votre base se situe sur un autre serveur, indiquez son adresse IP ou le nom fournit par votre administrateur

- Port : Par défaut vide (équivalent à 3306),
Si votre administrateur vous a indiquez un port différent de 3306, indiquez le ici.

- Préfixe de table : Cette option (vide par défaut) est utile dans le cas où vous ne disposez que d'une seule base de données pour vos différents sites.
Dans ce cas, indiquez par exemple le nom de votre site (sans espaces ni caractères spéciaux)
ou tout autre appellation qui vous permettra de ne pas mélanger les tables de données
des différentes applications utilisant cette base de données.

Astuce : Si vous avez un doute, mettez un préfixe ("drupal_" par exemple) :
ça ne perturbera en rien votre installation et vous serez sûr de ne pas abîmer vos autres sites.

Validez la configuration de votre base de données en cliquant sur le bouton "Sauvegardez et poursuivre".

Patientez :) (une barre de progression vous indique l'avancement)

Configuration du site

Ici encore, plusieurs sections (fieldset) s'affichent :
- Informations
- Compte administrateur
- Paramètres du serveur

Informations :

- Nom du site : Indiquez ce que vous voulez "Mon premier site Drupal" par exemple.
(Vous pourrez de toute façon le changer par la suite)
- Adresse email du site : Cette adresse email sera utilisée comme provenance ("de la part de")
pour tous les emails envoyés par le site (par exemple lorsque quelqu'un reçoit son mot de passe)
Ici encore, vous pourrez le changer par la suite.

Remarque :
Si vous n'avez pas de serveur de mail, des "warning" s'afficheront à chaque fois qu'un email est censé être envoyé.
C'est généralement le cas si vous êtes sous windows avec un serveur de type EasyPhp.
Dans ce cas, ce n'est pas gênant car votre site n'est pas accessible depuis internet mais seulement par vous.
Par contre, si vous rencontrez ce problème avec un site en ligne, contactez votre administrateur système !

Compte administrateur :
- Il s'agit du compte "super administrateur" : celui qui a accès à tout... (l'utilisateur "root")
Vous pouvez indiquer ce que vous voulez, "admin" ou même "toto".
- Adresse email : Saisissez l'adresse qui recevra tous les messages "système" de Drupal.
C'est également celle associée au compte super administrateur (par exemple pour récupérer son mot de passe).
- Mot de passe : S'il est demandé 2 fois, c'est pour vous éviter une faute de frappe.
Il servira à vous connecter à votre site avec le compte super administrateur.

Remarque :
Drupal vous indique "sécurité du mot de passe" (faible / moyen / haute), ce n'est qu'informatif,
mais si votre site est en ligne, pensez qu'un mot de passe trop facile à retenir peut amener une personne mal intentionnée à le deviner et ainsi prendre le contrôle de votre site.

Paramètres du serveur :
- Fuseau horaire par défaut : Logiquement Drupal a déjà sélectionné le bon mais si l'heure ne coïncide pas à votre heure locale, choisissez la bonne option.
- Urls simplifiées : Les urls simplifiées sont aussi appelées "clean url",
elles permettent un meilleur référencement de votre site mais sont également plus agréables à lire.
Concrètement, si elles ne sont pas activées, vous aurez un chemin (dans la barre d'adresse) du type
"http://www.votresite.com/index.php?q=mapage", alors que si elles le sont, vous verrez "http://www.votresite.com/mapage".

Remarque :
Drupal vous indiquez si vous pouvez les activer ou non.
Si vous ne pouvez pas les activer, ce n'est pas gênant, vous pourrez le faire plus tard,
une fois votre serveur HTTP paramétré pour accepter celles-ci.
Ce n'est pas le propos du manuel débutant (voir le manuel de l'administrateur),
Mais vous pouvez lire les sujets associés dans le forum
ou encore demandez à votre administrateur de vous les activer.

- Notification des mises à jour : IL EST TRES CONSEILLE DE LAISSER CETTE CASE COCHEE !!!
Si vous activez cette option, votre site vérifiera périodiquement s'il existe des mises à jour pour vos modules et vous en informera.
C'est relativement important car vous serez tenu au courant des failles de sécurité découvertes.

Validez le formulaire en cliquant sur "Sauvegarder et poursuivre".

Votre premier site Drupal est en place !!!

Ca y est, vous avez une installation de Drupal toute fraiche, prête à être personnalisée.
Un lien "votre nouveau site" vous redirige vers la page d'accueil de celui-ci.

Alors, pas si compliqué d'installer Drupal n'est-ce pas ? :)

Problèmes courants

(il faudra puiser dans le forum drupalfr.org)

Le multilinguisme

Voir ce screencast de robin, en français : http://biboo.net/traduire-en-francais-drupal-6

La page d'accueil de votre site

Traduction de l'interface et des modules

(automatisation pour drupal 6)

Gérer son site et créer ses premiers contenus

Ce chapitre va vous expliquer comment accomplir les tâches d'administration de base votre site Drupal et comment créer vos premiers contenus.

L'interface d'administration de Drupal

Avec une interface d'administration intégrée à la partie publique de votre site Drupal se différentie de nombreux autres CMS. Le contenu de l'interface d'administration sera toujours le même mais son apparence pourra varier en fonction du thème que vous avez sélectionné pour votre site.

Lorsque vous êtes identifié en tant qu'administrateur apparait un menu de navigation (qui est affiché sur la partie gauche du thème par défaut). Ce menu vous permet de vous diriger vers les différents pages d'administration de Drupal.

Configurer votre site

Dans un premier temps choisissez "Administrer", cela vous permet d'afficher toutes les sections liées à la gestion du site. Image:Panneauadminister.png

Par défaut cette page est divisée en cinq zones administratives :

  • Content management. Permet de gérer tous les contenus de votre site : modification et suppression des noeuds, gestion de la taxonomie, des commentaires, ...
  • User management. Gére les utilisateurs du site, les groupes et les modalités d'accès aux fonctionnalités du site. Le système d'autorisation de Drupal sont progressives vous pouvez donc gérer les comptes, les utilisateurs, les rôles et les paramètres par défauts des inscruptions.
  • Reports. Visualise les rapports de logs et d'autres informations qui vous renseigne sur l'état de votre site.
  • Site building. Ici vous paramétrez l'interface de votre site, les blocs, les menus, les thèmes etc...
  • Site configuration. Configure les paramètres basiques de votre site : son comportement, son nom, les emails, le cache, la date, etc.

Il se peut que vous ayez du mal a retrouver la page d'administration que vous recherchez. Pour vous aidez vous avez un autre mode de visualisation qui regroupe les liens vers les pages d'administration par module. Pour cela il vous suffit de cliquer sur l'onglet "by module". Après avoir essayé cette option revenez à la visualisation "by task".

Pour commencer nous allons changer quelques informations basiques relatives à votre site. Allez donc dans Site configuration>> Site information. Dans l'écran qui suit vous pouvez modifier votre adresse email et ajouter un slogan à votre site. Modifiez les informations nécessaires puis sauvegardez.

Créer vos premiers contenus

Utilisez maintenant le menu pour aller dans "Créer un contenu". Drupal vous propose alors de choisir le type de contenu que vous allez choisir. Par défaut vous avez la possibilité de créer trois type de contenu : un article, une page ou un livre.

Pour commencer nous allons écrire notre premier article pour célébrer la création de votre site. Cliquez donc sur "article" cela vous permet d'accéder au formulaire de création d'un article.

Remplissez le titre puis le corps de votre article

(expliquer ici les principales options mais rester succint)

puis sauvegardez. Et, voilà, votre premier article est crée.

Explorer les différents contenus

Changer l'apparence du site

Les thèmes 'natifs'

Dans le menu "Site building" le menu thème vous permet de changer le thème que votre site utilise ou ceux qu'il rend disponible à vos utilisateurs. Drupal 6 est livré avec six thèmes. Deux de ces thèmes, Garland et Minelli, peuvent avoir leurs couleurs modifiées facilement grâce au module "Color".

A côté de l'onglet "list", qui liste tous les thèmes installés, sélectionnez "Configure". Ce panneau de configuration vous permet de modifier les paramètre communs à tous les thèmes : logo du site, nom, slogan, mission et bien plus encore.

Puis vous trouverez un panneau de configuration par thème installé. Sélectionnez l'onglet Garland par exemple. Pour démarrez explorez les possibilités de modifier les différentes couleurs du thème. Drupal 6 est livré avec 15s jeu de couleur pré-configurés. Vous pouvez bien sur créer les votres. Expérimentez différents réglages et suavegardez les résultat.

De nouveaux thèmes 'publics'

Bien entendu vous pouvez trouver de nombreux thèmes sur internet. Tout d'abord, rendez vous sur la page d'accueil de drupal.org et cliquez sur le lien "themes". vous aurez ainsi accès à une longue liste de thèmes.

Bien entendu, une simple recherche sur google "theme drupal" vous permettra de découvrir de nombreux autres thèmes gratuits ou payants. Note : méfiez vous des sites généralistes qui proposent des thèmes Drupal payants. Même si le graphisme est attrayant vous courrez le risque d'acheter un thème qui n'a pas été optimisé pour Drupal. Il rst préférable de se renseigner sur la qualité d'un site au préalable : allez sur le forum de drupalfr.org par exemple.

Installer un nouveau thème

L'installation d'un nouveau thème est relativement simple.
1) Pour commencer téléchargez l'archive du thème là ou vous l'avez trouvé.
2) Puis, placez le thème dans un sous-répertoire themes que vous créerez dans le répertoire sites/all de votre serveur. Cet emplacement est conseillé, d'autres sont possible mais cette discussion dépasse le cadre du manuel du débutant.
3) Enfin, rendez vous sur votre site, identifiez vous et allez sur le panneau de configuration "site building" >> "themes".
4) Retrouvez votre nouveau thème dans la liste et choisissez le comme site par défaut.
5) Sauvegardez, et, miracle, votre site à complètement changé d'apparence...

Création de thèmes personnalisés

Drupal 6 a simplifié et amélioré la création de thèmes personnalisés. Par contre, en fonction de ce que vous souhaitez faire la difficulté et l'expertise nécessaire pour créer son propre thème sera extrêmement variable.

Pour en savoir plus rendez vous sur le 'Manuel du Designer'

Retrieved from "http://wiki.ineation.com/index.php/Le_manuel_du_d%C3%A9butant"
Personal tools