  $Id: INSTALL_fr.txt,v 1.4 2005/03/10 14:53:18 mdruilhe Exp $
 
  ======================================================================
                      
	Guide d'installation  de w-agora 4.2

  ======================================================================


                             PRE-REQUIS
                             ==========


Avant toute chose, nous vous conseillons de vérifier que vous disposez 
de tous les éléments nécessaires à l'installation de w-agora.


I. PHP installé et configuré
----------------------------

  1. Assurez vous d'abord que PHP et correctement installé et configuré. Vous 
pouvez le vérifier par vous même à l'aide du script ci-dessous.
  Copiez-collez les lignes suivantes dans votre éditeur de texte et sauvegardez 
dans un fichier appelé info.php ou info.php3.
  
<html>
<?echo "Ca marche !!<br>"; phpinfo(); exit ?>
<STRONG>PHP n'est pas installé ou n'est pas configuré pour cette extension de 
fichier </STRONG>
</html>

  Ensuite, transférer cette page sur votre serveur et appelez là dans votre 
navigateur. Si PHP est correctement installé, vous devriez obtenir une page 
affichant la configuration de PHP. Dans le cas contraire. Le message "PHP 
n'est pas installé ou n'est pas configuré pour cette extension de fichier" 
devrait s'afficher.

  2. Si PHP est installé avec l'option "SAFE MODE"  activée, veuillez consulter 
le paragraphe SAFE MODE à la fin de la section II. Si vous n'êtes pas responsable 
de l'administration de votre serveur WEB, demandez à votre fournisseur d'accès si 
PHP est installé en Safe mode ou non.

Vous trouverez également cette information dans le résultat du script cité plus 
haut.

II. Un accès à une base de données
----------------------------------

--> Si vous administrez vous même votre serveur :

  1. Vous devez avoir accès à un de ces serveurs de base de données :
     - mysql
     - postgres (6 ou 7)
     - Oracle 8
     - Microsoft SQL server 7 ou 2000

  2. Vous pouvez utiliser une base existante ou créer une base de données 
spécifique: 
     Ex: avec mysql, vous pouvez utiliser la commande:

    mysqladmin -uuser -ppaswword create agora

    (Utilisez le nom que vous souhaitez, 'agora' est juste un exemple)
  
  3. Assurez-vous que cette base est accessible par un utilisateur ayant tous les 
droits sur les tables de cette base (select, insert, update, delete, create, 
alter et drop). Vous pouvez par exemple utiliser la commande:

    GRANT
      select, insert, update, create, alter, delete, drop
    ON 
      database.*
    TO 
      utilisateur@localhost
    IDENTIFIED BY
      'motdepasse';

--> Si vous n'administrez pas vous même le serveur, vous devez posséder un accès
à une base de données (cf. 1.). Dans ce cas votre hébergeur doit vous fournir 
l'accès à une base et vous communiquer tous les paramètres (nom de la base, 
identifiant, etc) vous permettant d'y accéder.



                             INSTALLATION
                             ============


 L'installation de w-agora dépend légèrement du type de serveur WEB et de base 
de données.



                    Instructions rapides d'installation
                    ===================================

   1. Extraire l'archive (tar/gunzip ou winzip) dans votre répertoire WEB

   2. Positionnez les droits en lecture/écriture sur les répertoires conf/ et 
forums/

   3. Ouvrez la page setup.php[3] dans votre navigateur et suivez les 
instructions.
   


                    Instructions détaillées d'installation
                    ======================================


I. COPIE SUR LE SERVEUR
-----------------------

  1. Si vous disposez d'un accès shell sur votre serveur, vous pouvez 
télécharger le fichier archive (en mode binaire) et l'extraire directement 
dans un répertoire sur votre serveur.
  
     o Sous Linux, utilisez par exemple la commande suivante:
       (en supposant que le fichier compressé à été téléchargé sous /tmp)
          $ cd /var/www/html/
          $ tar -xzvf /tmp/w-agora-4.1.x.tar.gz

       Cette commande décompactera l'ensemble dans le répertoire 
/var/www/html/w-agora

     o Sous windows, utilisez la commande winzip (ou autre).

  2. Si vous ne possédez pas d'accès "shell" sur votre serveur, vous devez 
     - décompresser l'archive sur votre poste en local à l'aide de la commande 
unzip ou tar (selon le fichier téléchargé)
     - Si vous avez téléchargé w-agora sur un poste sous Windows, il suffit 
d'extraire le fichier .zip ou.tar.gz à l'aide de winzip dans un répertoire 
temporaire (ex: c:\temp ou c:\w-agora)
     - transférer par FTP l'ensemble des fichiers et répertoires dans un 
répertoire approprié sur votre serveur (ex: html/w-agora). Veillez à 
transférer TOUS les fichiers et répertoires et à respecter la structure des 
répertoires.
     - Les fichiers .php, .php3, .inc et .txt et .htm doivent être transférés en 
mode ASCII, les fichiers gif et jpeg en mode binaire. Si vous n'êtes pas 
familier avec ces techniques, ce n'est pas très grave, la plupart des 
logiciels de transfert FTP gèrent tout cela très bien à votre place.


II. VERIFIER LES PERMISSIONS SUR LES FICHIERS
---------------------------------------------
  
  w-agora est livré au départ 3 répertoires vides:

      "w-agora/conf"
      "w-agora/forums"
      "w-agora/forums/agora"
 
 En réalité, ces répertoires contiennent au départ un fichier ".htaccess" utilisé 
par certains serveurs WEB (apache notamment) pour protéger ou modifier les 
propriétés d'un répertoire.

 w-agora utilise par la suite ces répertoires pour y stocker différents fichiers 
(configurations, modèles, pièces jointes, ...) 
 Si pour une raison quelconque, ces répertoires n'ont pas été créés dans l'étape 
précédente (FTP) w-agora tente de les créer dans le processus d'installation. 
Néanmoins il est conseillé de les créer manuellement (cas du safe mode 
notamment). Pour cela vous pouvez utiliser votre client FTP (ou ssh/telnet).

 Vous devez vous assurer que le serveur WEB (utilisateur nobody, httpd ou autre) 
est autorisé à écrire dans ces répertoires :

  o  Sous linux, utilisez la commande (en supposant que nobody est l'utilisateur 
pour le compte duquel le serveur WEB s'exécute)
     # chown -R nobody ./w-agora
         ou
     # chgrp -R nobody w-agora; chmod -R g+w w-agora"
         ou encore (si vous n'avez pas le privilège "root"
     $ chmod -R a+w conf forums forums/agora
   
  o Si vous ne possédez pas un accès shell, utilisez la commande FTP::

     $ ftp ftp.votresiteftp.com
     ftp> cd w-agora
     ftp> mkdir conf
     ftp> quote site chmod 707 conf
     ftp> mkdir forums
     ftp> quote site chmod 707 forums
     ftp> cd forums
     ftp> mkdir agora
     ftp> quote site chmod 707 agora

  o Sur une plate-forme Windows/IIS positionnez les permissions en 
lecture/écriture

  o !!! Attention: Si vous utilisez PHP en Safe Mode, Veuillez consulter les 
instructions suivantes.!!!


SAFE MODE 
---------

Le "SAFE MODE" (mode sécurisé) de PHP autorise l'accès en écriture uniquement 
aux répertoires appartenant au même utilisateur que le propriétaire du script.

Par exemple, si le script "cree_fichier.php" appartient à l'utilisateur 'toto', 
ce script ne pourra créer des fichiers que dans les répertoires appartenant à 
'toto'.

Par contre, tout fichier ou répertoire créé par un script PHP appartient à celui 
qui exécute le script, à savoir : le serveur HTTP. Par exemple si le script 
"cree_fichier.php" (appartenant à l'utilisateur 'toto') créé le répertoire 
'mon_repertoire', et que le serveur WEB s'exécute en tant qu'utilisateur 
'nobody', alors 'mon_repertoire' aura comme propriétaire: 'nobody'

Par conséquent, en safe mode, ce même script ne pourra pas créer un fichier dans 
le répertoire 'mon_repertoire' car 'mon_repertoire' et 'cree_fichier.php' n'ont 
pas le même propriétaire.

La solution consiste à créer manuellement au préalable tous les répertoires. Les 
répertoires concernés sont:

  - forums/agora
    
    Pour chaque site '<sitename>' :
    - forums/<sitename>
    - forums/<sitename>/default

    Pour chaque forum '<forumname>' dans '<sitename>'
    - forums/<sitename>/<forumname>
    - forums/<sitename>/<forumname>/notes

Les permissions doivent être positionnées à "777" ou 707


III. INSTALLATION
-----------------

Dans votre navigateur, ouvrez la page setup.php3 (or setup.php) afin d'installer 
et configurer le programme.

    http://localhost/w-agora/setup.php3
or
    http://www.My_Domain.net/w-agora/setup.php

Remplissez les champs demandés dans le formulaire d'installation:


  1. Paramètres de la base de données 
  -----------------------------------  
  - Le type de base : actuellement sont supportés: mySQL, Oracle8, PostgreSQL et 
Microsoft SQL server.

  - Le nom de la base de données (dans le cas d'Oracle il s'agit de 
l'identifiant (SID) ou de l'alias). Cette base doit exister au préalable (voir 
section I - pré-requis). Le nom proposé est agora, mais vous pouvez indiquer le 
nom que vous souhaitez. 

  - Le nom et le mot de passe de l'utilisateur utilisé par W-Agora pour accéder 
à la base de données. Il s'agit de l'utilisateur au sens de la base de 
données. Celui ci doit être préalablement créé.

  - Eventuellement le nom et le mot de passe de l'administrateur de la base de 
données, utilisé par w-Agora pour les tâches d'administration (doit avoir 
droit de DELETE et CREATE). Si ces champs ne sont pas renseignés, w-Agora 
utilise l'utilisateur défini à la ligne précédente pour toutes les tâches.
  
  - Eventuellement, les paramètres d'accès au serveur hébergeant la base de 
données : 
	- son nom ou adresse IP (laisser vide si le serveur de base de données 
se trouve sur la même machine que le serveur WEB)
	- éventuellement le port de connexion (laisser en blanc si le port n'est 
pas à renseigner). Ce paramètre n'est généralement pas utilisé et n'a de 
sens que pour mysql et postgres.

  Si vous ne connaissez pas les paramètres d'accès a votre base, contactez 
votre fournisseur d'accès, votre administrateur système ou votre 
administrateur de base de données.

2. Paramètres par défaut pour les configuration de sites
--------------------------------------------------------

Il s'agit des paramètres par défaut qui seront utilisés au moment de la 
création des sites:

  - Le nom du répertoire dans lequel les fichiers relatifs aux différents forums 
seront copiés. Ce répertoire sera créé sous la racine de W-Agora si vous 
indiquez un nom relatif. Vous pouvez également préciser un répertoire situé 
endehors de l'arborescence du serveur WEB pour sécuriser l'accès à vos 
données.  
  Si le nom par défaut vous convient, passez directement a la suite. 

  -->  Attention: veuillez consulter le paragraphe SAFE MODE à la fin de la 
section II.

  
  - Le moteur de recherche que vous souhaitez utiliser, si celui-ci est installé 
et supporté par w-agora. Par défaut, les recherches seront effectuées 
directement par w-agora dans la base de données


3. Données utilisateur pour l'administrateur système
----------------------------------------------------
  w-agora enregistre au départ un utilisateur ayant tous les droits 
(administrateur système). Il s'agit de l'utilisateur "admin". Vous pourrez par 
la suite créer d'autres administrateurs ayant les mêmes privilèges. Par contre 
cet utilisateur ne pourra pas être supprimé.

  - Le nom de l'administrateur (celui qui apparaîtra dans toute correspondance). 
Attention: Il s'agit du nom et non de l'identifiant. L'identifiant de 
l'administrateur principal est "admin".

  - L'adresse e-mail de l'administrateur. Indiquez une adresse valide (vous
pourrez toutefois la changer plus tard)
  
  - Le mot de passe de l'administrateur (deux fois pour confirmation).


Les renseignements nécessaires à l'initialisation de W-Agora ont maintenant été 
fournis, vous pouvez cliquer sur " install ". W-Agora est installé ! Vous devez 
maintenant créer un ou plusieurs sites. Se reporter au paragraphe Création d'un 
site.


IV. CREATION D'UN SITE :
------------------------

  Un site est un ensemble de forums accédés par un ensemble d'utilisateurs.
  Chaque site peut être installé dans sa propre base de données et peut être 
accédé par un ensemble d'utilisateurs différents. La création d'un site est 
effectuée par le script: create_site.php.

  1. Paramètres généraux
  ----------------------
  
  Vous devez tout d'abord indiquer :
   - Le nom du site: Il s'agit du nom symbolique utilisé par w-agora pour 
accéder au site. Il n'apparaît que dans les URL, gardez si possible un nom 
aussi court que possible.
   - le titre : description brève du site
   - la description détaillée

  2. Paramètres de la base de données 
  -----------------------------------  
  Chaque site pouvant utiliser sa propre base de données, w-agora vous redemande 
à nouveau les paramètres de la base de données. Vous pouvez indiquer les mêmes 
paramètres que précédemment ou choisir une nouvelle base de données (et même 
un autre moteur de base de données). Reportez vous au chapitre III - 
Installation 

  3. Configuration des forums
  ---------------------------
 
   - Le nom du répertoire dans lequel les fichiers relatifs aux différents 
forums seront copiés. Ce répertoire sera créé sous la racine de W-Agora si 
vous indiquez un nom relatif. Vous pouvez également préciser un répertoire 
situé en dehors de l'arborescence du serveur WEB pour sécuriser l'accès à vos 
données.  w-agora créera par la suite dans ce répertoire un répertoire pour 
chaque forum.
-->  Attention: veuillez consulter le paragraphe SAFE MODE à la fin de la 
section II.
  
  - Le moteur de recherche que vous souhaitez utiliser, si celui-ci est installé 
et supporté par w-agora. Par défaut, les recherches seront effectuées 
directement dans la base de données

  - Le thème par défaut utilisé par les forums que vous créerez par la suite

	
  Une fois le site créé, w-agora vous propose un menu vous permettant de créer 
un autre site, administrer (configurer) ce site ou bien : créer votre premier 
forum.


V. CREATION D'UN FORUM :
------------------------

  La création d'un forum est effectuée par le script: 
  http://localhost/w-agora/create_forum.php3?site=nomdusite

  Suivez les instructions sur cette page.

  Vous pouvez/devez configurer notamment: :

   - Le nom du forum: Il s'agit du nom symbolique utilisé par w-agora pour 
accéder au forum. Il n'apparaît que dans les URL, gardez si possible un nom 
aussi court que possible.
   
   - le titre : description brève du forum

   - la description détaillée de votre forum

   - Le thème utilisé pour ce forum: Vous pouvez sélectionner le thème par 
défaut choisi au moment de la création du site (étape IV) ou bien choir un 
thème spécifique.


   Vous avez franchi toutes les étapes nécessaires à l'utilisation de votre 
premier forum.


VI. UTILISEZ VOTRE FORUM
------------------------
  
  A ce stade, vous pouvez maintenant poster votre premier message dans le forum

  Vous pourrez par la suite créer d'autres sites, catégories et forums, modifier 
l'aspect graphique de vos forums, gérer vos utilisateurs, etc...

  Pour accéder à l'interface d'administration, utiliser le script admin.php, 
c'est à dire, ouvrez par exemple la page 
http://votre_site.com/w-agora/admin.php



  Merci d'utiliser w-agora. 
  
  o  Vous trouverez les dernières mises à jour sur le site de w-agora
  http://www.w-agora.net

  o Pour tout problème d'installation vous pouvez consulter le forum:
  http://www.w-agora.net/current/index.php?bn=support_install

  o Nous fournissons également des services d'installation et de personnalisation. 
  N'hésitez pas à nous contacter : services@w-agora.net
