  $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 segents 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 pgina amb tots els parmetres de configuraci
de la instal.laci de PHP, i no veurs 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 forar aquesta opci per w-agora creant el segent arxiu .htaccess:

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


II. Accs 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. Reemplaa 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';

    (Reemplaa '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 accs 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 rpida
                      ================================

   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 pgina 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 obtindrs l'arxiu en una carpeta "w-agora".

     El prxim 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 segent)

  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 accs 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 segent 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'accs 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 segnts parmetres 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'adrea 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 prxima 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 segnts parmetres. 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, ttol 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 ttol 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 podrs 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

  