   ********************************************
   * Babili - The Open Source Forum Community *
   ********************************************

Versione: 2.0
Data: 31/08/2002
Autore: Vincenzo Buttazzo <selfesteem@virgilio.it>
Web: http://utenti.tripod.it/phorum1999/

- Indice -

0. Introduzione
1. Scompattare l'archivio
2. Configurazione
3. Creazione di una discussione
4. Completiamo l'installazione
5. Problemi e soluzioni

------------------------------------------------

0. Introduzione
L'installazione di Babili  realizzata in due fasi. Nella prima si
personalizza il forum in locale, nella seconda si copieranno i vari file
sul server.

Babili necessita di due cartelle: una in cui saranno sistemati i script
PHP e il file di configurazione ('cartella-script') e una in cui si
salveranno tutti i dati provenienti dall'uso del forum stesso
('cartella-dati') al cui interno si troveranno diverse 'cartelle-forum'.

1. Scompattare l'archivio

Scompattate l'archivio Zip sul vostro PC locale. Vi ritroverete una cartella
'forum' contenente i seguenti file:

/index.php
/topic.php
/startpost.php
/starttopic.php
/forum.php
/new.php
/logo.png
/licenza.txt
/readme.txt
/style.css
/config.txt
/data/index.txt
/data/alfa/index.txt
/data/alfa/order.txt

Questo  gi un forum perfettamente funzionante, ma con impostazioni di
base. Analizziamo il significato dei vari file.

Tutti i file con estensione PHP sono script PHP, il codice del forum. Se non
siete pratici di questo linguaggio  meglio lasciarli come sono, altrimenti
potete studiarveli ed eseguire modifiche a piacimento. Spiegazioni sul codice
sono disponibili nel forum del sito http://utenti.tripod.it/phorum1999/

Il file logo.png  il logo predefinito. Potete sostituirlo con il vostro
come illustrato in seguito.

licenza.txt  una copia della licenza GPL sotto la quale viene distribuito
questo materiale.

readme.txt  questo file, ovviamente ;-)

style.css  il foglio di stile che determina lo schema di colorazione degli
elementi del forum. Potete usare questo, scaricarne altri dal sito dalla
pagina 'Combinazioni Cromatiche' oppure modificarlo come pi vi piace. La
guida ai Fogli si Stile CSS  disponibile su http://www.w3c.org

2. Configurazione

Il file config.txt  il file pi importante perch contiene tutte le
impostazioni del vostro forum. E' un semplice file di testo e potete
modificarlo con un qualsiasi editor di testo come Notepad.

La prima riga  di fatto un link a una pagina appartenente al resto del
vostro sito. Potete inserire un indirizzo assoluto (del tipo
http://www.sito.mio/qualsiasi.html) o relativo alla posizione dei file PHP
(del tipo ../index.html).

La seconda  l'indirizzo alla cartella-dati. Anche qui  possibile usare
indirizzi assoluti (del tipo /usr/local/data) oppure relativi alla posizione
del file PHP (del tipo ../data). Di default  'data' visto che la
cartella-dati  una sottocartella della cartella-script.

Babili vi permette di suddividere le discussioni per argomento, le righe
seguenti impostano queste discussioni. Ogni riga  cos suddivisa:
numdir nomedir Nome_del_Forum Descrizione del forum

numdir  un numero univoco che effettivamente identifica il forum.
Modificando questo numero cambiate il puntatore nel database.

nomedir  il nome della cartella-forum che vedremo pi avanti, non deve
contenere spazi.

Nome_del_Forum  il titolo della discussione. Il nome non pu contenere
spazi, utilizzate invece il simbolo di underscore '_' che verr sostituito
durante la visualizzazione.

Descrizione del forum serve a fornire una breve indicazione all'utente,
pu contenere qualsiasi carattere e pu essere lunga a piacere.

3. Creazione di una discussione

Poniamo di voler creare una discussione e inseriamo la seguente riga:

1 altro Forum_d'Altro Questa  la discussione alternativa

A questo punto dobbiamo creare 1 directory e 2 file. Entrate nella
cartella-dati e create una directory di nome 'altro'. Entrate in questa
cartella-forum e create due file ex-novo di come index.txt e order.txt, fine
dell'operazione di creazione del forum. Cosa abbiamo fatto? La cifra '1'
identifica univocamente il nostro forum, 'altro' indica la cartella-forum
in cui questo forum risiede. Se lo riterrete necessario potete modificare
il nome della cartella in un momento successivo cambiando conseguentemente
questo secondo campo del file di configurazione senza dover far altro.

A questo punto il nostro file di configurazione  cos fatto:

../index.html
data
0 alfa Forum_Principale Discussione Generale
1 altro Forum_d'Altro Questa  la discussione alternativa

Nella pagina iniziale del forum le discussioni compariranno nell'ordine in
cui le vedete nel file di configurazione, se invece lo modifichiamo cos:

1 altro Forum_d'Altro Questa  la discussione alternativa
0 alfa Forum_Principale Discussione Generale

L'ordine di apparizione  invertito senza dover cambiare nulla altro.

4. Completiamo l'installazione

A questo punto non ci rimane che caricare il tutto sul nostro web server.
Poich i modi per uppare i file sono molti (FTP, Web, ...) dovete sapere
da soli come fare. In ogni caso caricate la cartella-script dove la
volevate mettere e la cartella-dati nella posizione indicata dalla seconda
riga del file di configurazione. Questa cartella deve avere i permessi
di lettura/scrittura per i script ovvero settati in questa configurazione
-rw-rw-rw- che equivale a un CHMOD 333. In caso non sappiate come fare
fate riferimento al vostro webmaster.

Complimenti il forum  installato!

5. Problemi e soluzioni

Per ogni problema potete consultare il forum del nostro sito
http://utenti.tripod.it/phorum1999/

6. Consigli da dare e modifiche 

Potete segnalare eventuali modifiche al codice o consigli per farne
sul nostro forum sul sito http://utenti.tripod.it/phorum1999/