====== Installer Drupal sur Gandi AI ======

===== Créer une base de données dédiée à Drupal =====
Il est prudent d'avoir une base de donnée (avec utilisateur et mot de passe) dédiée au Drupal. Nous appellerons cette base... **drupal**.

Je vous invite à consulter ce **[[fr:hosting:gandi-ai:create-database|tutorial]]**, si vous ne savez pas (encore) créer une base de données.




===== Prévoir un espace dédié au Drupal  =====

L'endroit où mettre vos fichier va dépendre de l'URL que vous choisirez :

Si vous voulez que le site soit directement accessible par exemple via une URL de type www.exemple.com, mettez le dans /exemple.com/htdocs/

Pour une url de la forme www.exemple.com/drupal, mettez le dans un sous dossier /exemple.com/htdocs/drupal/


==== Si vous préférez simplement placer Drupal un répertoire: ====

Facile! Créez un répertoire dédié dans l'emplacement souhaité (dans **htdocs**  par exemple, pour obtenir %%www.exemple.com/drupal%%)



==== Si vous voulez attribuer un sous-domaine spécifique à Drupal du type drupal.exemple.com: ====

Deux opérations à faire:
  * Configurer votre serveur pour ce sous-domaine, comme vous l'explique [[:fr/hosting/gandi-ai/configure-virtualhosts|ce tutorial]]
  * Configurer votre sous-domaine pour pointer vers le serveur que vous venez de configurer, comme vous l'explique [[fr:hosting:manage-quota:attach-domain-screencast|ce tutorial]]
  
...c'est cette deuxième option que nous allons suivre dans ce tutorial.




===== Téléchargement de Drupal =====

Pour commencer, nous allons le télécharger. la dernière version disponible au moment de l'écriture de ce tutorial est la 5.6.\\

Rien ne vaut le site officiel pour trouver le fichier compressé initial. Je conseille donc **[[http://ftp.drupal.org/files/projects/drupal-5.6.tar.gz|ce lien]]**.\\

Maintenant que le fichier est sur votre disque dur préféré, décompressez-le. Vous voici avec un répertoire (renommons-le **drupal**, pour être toujours aussi original) contenant tout les fichiers Drupal.\\

Lancez votre client FTP préféré (Ah, vous aussi c'est [[http://www.filezilla.fr/|FileZilla]] ?), connectez-vous en temps qu'**admin** sur votre GandiAI, et rendez vous dans le répertoire correspondant au VirtualHost que vous aviez défini initialement.\\

Dans l'exemple en cours, le chemin de mon FTP correspondra à ceci :
  /srv/d_ma-gandi-ai/www/drupal.exemple.com/htdocs/
...a moins que vous n'ayez changé la configuration initiale des fichiers web, mais si vous l'avez fait, j'assume que vous saviez ce que vous faisiez :)\\

A ce stade, nous allons donc pouvoir mettre les fichiers Drupal sur notre Gandi AI.\\
  * Si vous avez créé un VirtualHost de type **drupal.exemple.com**, vous allez vouloir que Drupal démarre dés la première page : vous allez donc **uploader le contenu** (et non pas le répertoire en lui-même) du répertoire **drupal** dans le répertoire **htdocs** de votre sous-domaine.\\
  * Si vous n'avez que faire du sous-domaine et que vous préférez un bon vieux lien en **mondomaine.com/drupal** alors il ne vous reste plus qu'à **uploader le répertoire complet** dans **htdocs** (ou dans un autre dossier si vous en avez décidé ainsi). 


===== Installation de Drupal =====

Avec votre navigateur internet, rendez-vous dans le répertoire où se trouvent les fichiers Drupal (par exemple, drupal.exemple.com).

==== 1. Database configuration ====

Vous aurez alors quelques champs à remplir:

**Database type**: Choisissez **mysql**

**Database name**:  Indiquez le nom de la base de données créée au début du tutorial. Dans notre cas, elle s'appelle **drupal**.

**Database username**: Le nom d'utilisateur associé à cette base...

**Database password**: ...et son mot de passe.

Cliquez alors sur **Advanced Options** pour compléter quelques champs supplémentaires:

**Database host**: **localhost**

**Database port**: Vous pouvez laisser ce champ vide

**Table prefix**: Il est toujours préférable de mettre un préfixe aux tables créées, afin d'éviter un accident où de nouvelles tables écrasent des tables existantes. Vous pouvez mettre le préfixe que vous voulez, du moment qu'il se termine par un "_". Personnellement, je vais choisir "**dp_**"



===== Configuration de Drupal =====

Pour finir, nous allons **vous créer un compte administrateur**. Ouvrez le répertoire de Drupal avec votre navigateur internet et cliquez sur "**Create new account**" dans la colonne de gauche. Etant donné que vous êtes le premier utilisateur créé, vous allez obtenir les droits d'administrateur de fait :)

Changez le mot de passe que Drupal vous a généré automatiquement (à moins qu'il ne vous plaise), et confirmez.

C'est fini, vous êtes maintenant l'administrateur d'un Drupal tout neuf! Je vous invite à consulter la [[http://drupalfr.org/documentation|documentation officielle]] pour en savoir plus sur cette application.

Il existe également une introduction à Drupal sur ce site : [[http://www.atelierdrupal.net/demarrage|Atelier Drupal]].

----


===== Optionnel: Installation du français =====

<note>
Un petit téléchargement vous permettra d'utiliser Drupal en français. Cependant, la traduction n'est pas complète et vous aurez un certain nombre de champs à traduire vous même par le biais de la console d'administration.
</note>

==== 1. ====

Tout d'abord, nous allons [[http://drupal.org/files/projects/fr-cvs.tar.gz|télécharger le fichier]] sur le site de Drupal, puis l'extraire. Gardez-le au chaud sur votre disque dur, nous allons bientôt l'importer sur votre serveur. 

==== 2. ====

Rendez vous dans le répertoire de Drupal sur votre site, enregistrez-vous avec votre compte bénéficiant des droits d'administrateur, puis cliquez sur "**Administer**" dans la colonne de gauche.

Ensuite, dans la sous-partie **Site building**, cliquez sur **Modules**.

Dans la liste des Modules qui apparaitra, il faudra que vous cochiez le module **Locale** - il vous permettra d'installer des modules de langue supplémentaires.

==== 3. ====

Ensuite, rendez-vous sur la page **Administer > Site configuration > Localization**, puis dans la section **Manage languages > Import** au sein de cette page.

Vous devriez alors voir ceci:

{{ fr:hosting:using-linux:tutorials:gandiai:drupal-lang.gif }}

Comme vous voyez, il faut importer le fichier **fr.po** que vous venez de télécharger et d'extraire, puis que vous choisissiez **French** dans le menu déroulant **Import into**.

Ce fichier peut prendre plusieurs secondes à se charger sur votre serveur.

Une fois que c'est fait, vous devriez voir un message de confirmation (en français), et vous pourrez alors cliquer sur "Enregistrer la configuration", puis choisir le français comme la langue par défaut de Drupal!
----