  $Id: INSTALL_ca.txt,v 1.2 2005/04/18 16:38:44 mdruilhe Exp $
 
  ======================================================================
                      
	Instruccions d'instal.lació per w-agora 4.2

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


                             PRE-INSTAL.LACIÓ
                             ================


Has de complir els següents pre-requisits per tal d'instal.lar w-agora:

I. PHP correctament configurat
------------------------------

  1. Estigues segur de que tens PHP instal.lat i que funciona correctament en el teu lloc.
Ho pots comprovar copiant les seguents linies de codi en un arxiu anomenat info.php o info.php3:

<html>
<?echo "Funciona!!<br>"; phpinfo(); exit ?>
<STRONG>PHP no funciona o no esta configurat per aquestes extensions </STRONG>
</html>

Despres mira aquesta pagina en el teu navegador. Si tot es correcte, et mostrara una pàgina amb tots els paràmetres de configuració
de la instal.lació de PHP, i no veuràs aquest missatge:
"PHP no funciona o no esta configurat per aquestes extensions"

  2. w-agora ha de funcionar amb versions de PHP 4.1 o superiors.

  3. Si estas utilitzant PHP en SAFE MODE (mode segur), llavors llegeix la secció dedicada a SAFE MODE
al final de la part II. Si no ets l'administrador del teu servidor, pregunta al teu 
proveidor de serveis de internet si PHP esta funcionant en SAFE MODE o no. Pots obtenir aquesta
informació executant l'arxiu "info.php" en el navegador com es deia abans. 

  4. Aquesta versió de w-agora necessita la opció "short_open_tag" activada en la configuració PHP.
Si no esta activada pel teu proveidor, pots forçar aquesta opció per w-agora creant el següent arxiu .htaccess:

# .htaccess example
# Enable '<?' tags in PHP configuration
php_flag short_open_tag on


II. Accès a base de dades 
-------------------------

--> Si ets l'administrador del teu servidor:

  1. Estigues segur de que tens alguna d'aquesta base de dades instal.lada :
     - mysql
     - postgres (6 and 7)
     - Oracle 8
     - Microsoft SQL server 7

  2. Si no tens cap arxiu de base de dades fes-ne un. 
     Ex: amb MySQL pots crear una base de dades utilitzant unes ordres com aquestes:

    mysqladmin -uuser -ppaswword create agora
    (pots utilitzar el nom que vulguis per la base de dades, 'agora' es tan sols un exemple. Reemplaça user i password amb els valors 
    que vulguis pel  nom d'usuari i password. 
  
  3. Estigues segur que l'usuari que crees te els permissos per selccionar, insertar, actualitzar, borrar, crear, alterar i borrar
    . Un ordre per aquest stament es mostrararia així:

    GRANT select, insert, update, create, alter, delete, drop
    ON agora.* TO user@localhost
    IDENTIFIED BY 'password';

    (Reemplaça 'agora' amb el nom que li hagis posat a la base de dades en el pas 2
    i user amb el nom d'usuari de la base de dades mysql)

--> Si no ets l'administrador del teu servidor / o servidor virtual:
    llavors necessites un accès a base de dades.

    En aquest cas, necessites el nom de la teva base de dades  (e. g. "la_meva_db") i el nom d'usuari 
    de la base de dades (e. g. "db_user_1"), aquesta informació te l'ha de donar el teu proveidor d'internet.
    No pots fer servir l'ordre grant, nomes l'administrardor la pot fer servir. 



                             INSTAL.LACIÓ
                             ============


  La instal.lació de w-agora variara en relació al teu servidor i a la base de dades.

                      Instruccions Instal.lació ràpida
                      ================================

   1. gunzip/Untar el paquet dintre el document root
   2. defineix els permissos d'execució/escritura pels directoris  conf/ i forums/  
   3. Obre amb el navegador la pàgina setup.php[3] i omple els camps necessaris



I. DESCOMPRIMEIX /CARREGA
-------------------------

  1. Si tens access shell  a la teva conta hauries de carregar sencer l'arxiu w-agora (en mode binari) a un 
     directori en el teu hospedatge i unzip o (gunzip/untar) dinre el servidor. 
  
     o sota Linux untar els arxius en el directori document_root 
     eg. (assumint que l'arixu ha estat carregat en el directori /tmp) 
          $ cd /var/www/html/
          $ tar -xzvf /tmp/w-agora-4.2.x.tar.gz

     Aixo instal.larà el arxiu sota el directory "w-agora"

     o An Windows, simplement descomprimeix els arxius utilitzant WinZip.

  2. Si no tens access shell o no vols seguir aquest camí necessites descomprimir els arxius previament abans
     de carregar-los al servidor. Despres amb un client de FTP has de carregar la carpeta "w-agora" amb tots els 
     arxius (es molt important mantenir la estructura de carpetes intacta).

     Si t'has descarregat W-Agora al teu PC sota Windows, llavors emmagtzema el programa en el teu disc dur i descomprimeix-lo
     llavors obtindràs l'arxiu en una carpeta "w-agora".

     El pròxim pas is pujar aquesta carpeta tal cual via client FTP o web FTP del teu proveidor d'hospedatge.

     Tots els arxius  .php, .inc i .htm han de ser carregats en mode ascii, mentres que tots els grafics han de fer servir mode binari. 
     Si no estas familiaritzat llegeix els manuals del client FTP. Avui la majoria de clients FTP ja detecten automaticament com s'ha 
     de carregar cada arxiu o sigui que no t'hi trenquis el cap i carrega-ho a sac.


II. REVISA ELS PERMISSOS 
------------------------
  
  Dintre del directori w-agora hi han 3 sub-directoris buits :

      "w-agora/conf"
      "w-agora/forums"
      "w-agora/forums/agora"
 
  (aquests directoris nomes han de contenir un arxiu anomenat ".htaccess". Que serveix
per protegir el directori a usuaris no autoritzats)

  w-agora utilitzara aquests directoris per emmagtzemmar diferents arxius ( configuració
, plantilles). Si aquest directoris no hi son s'han de crear i establir els permisso amb
el client FTP a "707" (veure següent)

  T'has d'assegurar que els directoris s'hi pot escriure sobre ells.

  Per fer això :
  o  en un sistema  linux/unix) fes un ordre com  :
     (assumint que nobody es l'usuari que fas servir el servidor WEB)
             "chown -R nobody ./w-agora"
              or 
             "chgrp -R nobody w-agora; chmod -R g+w w-agora"
     
     o (si no tens acces de root)
              chmod -R a+w conf forums forums/agora
   
  o Si no tens accès shell al teu servidor, pots utilitzar el teu client FTP:

     $ ftp your.ftp.site.name
     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 En plataforma Windows/IIS , defineix els permisos de escriptura/lectura

  o !!! Si estas utilitzant PHP en SAFE MODE llegeix la següent secció!!!


SAFE MODE SECCIÓ
-----------------

El mode safe permet el acces via php nomes a aquests directoris, que son creats pel mateix client
que fa servir l'aplicació.

Si la teva identificació d'usuari en el servidor es Ex."pato_donald", tu ets el propietari de tots
els directoris que han estat creats via ftp. W- agora necessita nous directoris per fer servir
els forums. Aquests nous directoris poden ser creats per W-Agora durant el procediment d'instal.lació.
Si invoques el script "setup.php", PHP executa aquest script. Aquest script es una tasca que te el seu 
nom Ex. PHPrunner. En aquest cas, el propietari sera "PHPrunner". Llavors si proves d'accedir (el teu
nom es pato_donald) el teu acces sera denegat. 

Llavors, has de crear tots els forums manualment via FTP. Aquests directoris son:

  - forums/agora
    
    for each site '<sitename>' :
    - forums/<sitename>
    - forums/<sitename>/default

    for each forum '<forumname>' in '<sitename>'
    - forums/<sitename>/<forumname>
    - forums/<sitename>/<forumname>/notes

Els permissos d'accès han de ser definits com a "707"


III. SETUP
----------

Obre l'arxiu  setup.php3 (or setup.php) desde el navegador per tal de configurar i instal.lar el programa . Ex:

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

Configura els segënts paràmetres en el formulari d'instal.lació

  1. Les informacions de la base de dades 
  ---------------------------------------  
  (backend, username, password, hostname and port).
     currently mySQL, Oracle8, PosgreSQL and MSSQL are supported.

     Aquesta base de dades primer ha ser creada, li pots donar el nom que vulguis

--> Si no pots crear una base de dades canvia d'hospedatge o pregunta a teu proveidor

  2. Opcionalment, pots especificar alguns parametres d'acces a base de dades:
  ---------------------------------------------------------------------------

        usuari
        password
        nom del host i numero de port 

  - El nom del host es el nom  (o l'adreça IP) del servidor on la base dades esta funcionant, normalment "localhost".

  - El port no s'utilitza generalment i nomes té algun significat per mysql i postgreSQL. 

  - El nom d'usuari es el nom d'usuari de la base de dades (ex: dbuser1) 
El password es el password associat amb la base de dades d'usuari normalment el teu propi password de quan has creat
la base de dades.

  3. El directori on w-agora creara tots els forums. w-agora creara
     un directori per cada forum que creeis mes tard:

        o Si el directori no existeix, w-agora probara de crear-lo
        o Si el directori existeix, has de donar permisso d'escriptura.
        o NB: No es pot modificar la estructura dels directoris

  4. El buscador per defecte utilitzar per w-agora per buscar en els missatges.
     Si no en defineixes cap, la busqueda es realitzara a la base de dades.

  5. El nom i el correu del principal administrador. El seu identificador d'acces o nom d'usuari sera 'admin'

--> El principal administrador es el superusuari del sistema w-agora, no confondre amb el root del sistema!!

  6. El password de l'administrador del sistema, password que s'ha de posar per usuari 'admin'

     Quan la inicialització esta acabada, w-agora et demana per crear el teu primer lloc ( veure la pròxima secció)


IV. CREA UN LLOC :
-----------------

  Un lloc es una serie de forums al que hi poden accedir els usuaris.
  Cada lloc te el seu propi acces i els seus usuaris
  La creacio del lloc es fa amb l'script : http://localhost/w-agora/create_site.php3

  Configura els segënts paràmetres. Si vols instal.lar el lloc en la mateixa base de dades
que has utilitzat per fer la configuració inicial, has d'utilitzar els mateixos parametres
que abans. 

  1. El nom, títol i descripció del lloc.

  2. Els parametres de la base de dades (username, password, hostname and port).
     Aquesta base de dades ha d'existir previament.

  3. El directori on w- agora crearà els forums, despres w-agora creara un directory per cada forum nou que fagis:

        o Si el directori no existeix, w-agora probarà de crear-lo 
        o Si el directori ja existeix, has de configurar els permissos
        o NB: Has de mantenir la estructura dels directoris.

  4. El buscador que s'utilitzar per buscar dintre el lloc. Si no en poses cap es buscara dintre
     la base de dades
 
  5. La plantilla per defecte que sera utilitzada en els forum que crearas mes tard.

  Una vegada s'ha creat el lloc, sorgira un menu que et permetrà crea un forum, administrar el lloc o crear un altre lloc. 


V. CREA UN FORUM :
-------------------

  La creació del forum be donada per l'script:  
     http://localhost/w-agora/create_forum.php3?site=sitename

  Segueix les instruccions:

  Has d'escollir:

     1. El nom el títol i la descripció del forum.
     2. La plantilla/tema: Pots triar la opció per defecte que has triat en la creació del lloc o un de nou.

  Un cop el forum ha estat creat, w-agora et mostrarà un menu on podràs editar, administrar o crear un altre usuari
o accedir-hi com a usuari.

VI. AIXÒ ÉS TOT
--------------------
  
  En aquest punt hauries de poder escriure el primer missatge en el forum. 

  Mes endevant pots crear mes llocs, categories, forums, edita els graphics i mes. 

  Per accedir a la administració del forum utilitza "admin.php" en el teu navegador.

  http://el.teu.forum.domini/w-agora/admin.php

  