Introduzione
Questo script che gestisce le FAQ è perfettamente integrabile nel proprio sito, infatti và richiamato da remoto e contiene molte funzioni interessanti come la suddivisione in categorie e progetti (o programmi). Dotato di una grafica gradevole dal lato utente, e di un'amministrazione completa ed intuitva. Lo script è di libero utilizzo e modifica a patto di non modificare il copyright originario.
Configurazione dello script
Dopo aver decompresso il file scaricato, andare a modificare il file config.php:
$dbhost = "localhost";
Indirizzo del server MySQL; può essere rappresentato in formato testuale (es. localhost) o numerico (127.0.0.1).
$dbname = "faq";
Nome del database MySQL da utilizzare per far funzionare lo script.
$dbuser = "root";
Nome utente di accesso al server MySQL; dato fornito dal proprio servizio di hosting.
$dbpasswd = "";
Password di accesso al server MySQL; dato fornito dal proprio servizio di hosting.
$tableprefix= "faq";
Prefisso delle tabelle all'interno del database. Serve per installare più di una copia dello script sullo stesso database.
$default_lang = "de";
Lingua di default da utilizzare per l'interfaccia utente (disponibile anche l'inglese - en).
$admin_lang = "de";
Lingua di default da utilizzare per l'interfaccia di amministrazione (disponibile anche l'inglese - en).
$url_faqengine = "/faq";
Directory (rispetto alla root) nella quale è installato lo script.
$cookiedomain ="";
Dominio di riferimento per il cookie (specificare solo se diverso da quello dove risiede lo script).
$cookiename = "faqengine";
Nome del cookie da usare.
Installazione sul server
A questo punto caricare tutti i file sul proprio server, senza dover settare alcun chmod.
Naturalmente deve essere richiamato il file per installare i dati nel database MySQL, puntando all'indirizzo del tipo http://www.tuosito.it/faq/admin/install.php.
Verranno richiesti pochi e semplici dati per completare l'installazione:
Username:
Nome utente da usare per identificare l'amministratore.
E-Mail:
Indirizzo email di riferimento dell'amministratore.
Password:
Digitare una password per l'amministrazione.
retype password:
Ridigitare la password dell'amministrazione.
Configurazione
Per richiamare lo script occore farlo con un link che può avere la seguente struttura:
http://www.tuosito.it/faq/faq.php?list=categories&prog=<progid>&lang=<lingua>
Serve per visualizzare la lista delle categorie per il "programma" (o progetto che dir si voglia) specificato.
http://your.host.com/installdir/faq.php?list=all&prog=<progid>&lang=<lingua>
Serve per visualizzare la lista dell'intestazione di tutte le FAQ in tutte le categorie del "programma".
http://your.host.com/installdir/faq.php?list=progs&lang=<language>
Serve per visualizzare la lista di tutti i "programmi".
Se non viene specificato un linguaggio da usare, verrà usato quello di default specificato nel file config.php.
Pannello di Controllo
Per accedere all'amministrazione puntare all'indirizzo del tipo http://www.tuosito.it/faq/admin ed inserire Username e Password specificate durante l'installazione. Qui di seguito riportiamo una descrizione delle funzioni principali dell'amministrazione:
- edit administrators - questa sezione permette di creare, modificare od eliminare un'amministratore.
- edit programms - questa sezione permette di creare, modificare od eliminare un programma.
- Kategorien bearbeiten - questa sezione permette di creare, modificare od eliminare le categorie.
- edit FAQ - questa sezione permette di creare, modificare od eliminare le FAQ.
- Treeview - visualizza la struttura ad albero dei dati inseriti.
- statistics - permette di visualizzare le statistiche relative alle FAQ più lette.
- edit layout - permette di modificare i colori, il testo ed il file css usato all'interno dell'interfaccia utente dello script.
- IP-Banlist - qui si possono inserire gli indirizzi IP che desideriamo bannare dall'utilizzo delle FAQ.
- clean sessiontable - elimina tutti i dati relativi alle sessioni; questa funzione porta al logout dell'amministratore.
- Shutdown FAQ-Engine - permette di "spegnere" il gestore di FAQ, inserendo anche il messaggio da visualizzare agli utenti.
- backup database - tramite questo link si possono scaricare o visualizzare i dati all'interno del database.
Considerazioni Finali
Lo script ha dalla sua molti pregi, come la grafica piacevole, l'amministrazione con molte funzioni, la quasi completa personalizzazione per adattarlo al proprio sito e un'installazione molto semplice. L'unica pecca è la disponibilità solo in tedesco o inglese, con la possibilità naturalmente di tradurre il tutto attraver i file di linguaggio; ma questa volta c'è un vantaggio per i webmaster, ovvero ci sono due file di linguaggio, uno per l'interfaccia di amministrazione ed uno per l'interfaccia utente e, quindi, basta modificare quest'ultimo per far visualizzare agli utenti lo script in lingua italiana. Personalmente consiglio di installare questo script che si colloca sopra la media.
