La configurazione di aWiki avviene attraverso un unico file PHP: ./includes/config.php. Questo file è piuttosto lungo da leggere, ma è diviso un sezioni e voci che dovrebberlo renderlo agevole. Questa pagina, voce per voce, elenca le possibili configurazioni, ovvero i possibili valori che è possibile attribuire ad ogni chiave.
Prima di iniziare ecco la struttura delle voci:
define("CHIAVE","VALORE");
La chiave non è mai da cambiare, quello che si deve cambiare è invece il valore. I valori possono essere booleani, ovvero yes|no, oppure delle stringhe arbitrarie.
Indice dei contenuti
Queste chiavi indicano dove si trovano sistema (i file necessari all'esecuzione di aWiki) e i dati.
// syspath config
define("conf_sys_path","./sys/");
define("conf_data_path","./data/");
Indicano il percorso ove sono memorizzate le pagine di aWiki, la history, le immagini e i documenti caricati sul server. Ricordati di indicare la slash / finale.
// Files path, final slash is required!
define("conf_file_path",conf_data_path."text/");
define("conf_history_path",conf_data_path."history/");
define("conf_images_path",conf_data_path."images/");
define("conf_docs_path",conf_data_path."docs/");
Rispettivamente permessi, proprietario e gruppo. Lasciare bianco per usare le impostazioni di default del server.
// File permission (leave blank for server deafut)
define("conf_chmod","600");
define("conf_chown","");
define("conf_chgrp","");
Questa chiave indica l'estensione dei file contenuti in conf_file_path, potete cambiarla a piacimento, ma attenzione: se viene cambiata è necessario rinominare tutti i file.
// File extension, .txt is default
define("conf_file_ext",".txt");
Indica il nome del file che contiene i contenuti della home page del vostro aWiki, quella che è raggiunta attraveso il link "MainPage" in alto a sx.
// File home
define("conf_file_home","mainpage");
Questa sezione permette di abilitare, o disabilitare, le funzioni di upload e manipolazione dei file (testi, immagini, documenti). Di default sono abilitate, per disabilitarne una inserire no al posto di yes.
// Allow upload and manage...
define("conf_allow_upload_text","yes");
define("conf_allow_upload_images","yes");
define("conf_allow_upload_docs","yes");
Questa sezione indica l'aspetto delle vostre URL. Di default questo è simile a:
http://www.vostrosito.it/awiki/?qq=page
mentre settando la chiave conf_rewrite_link su yes ed una estensione arbitraria su conf_link_ext potrete avere una URL simile a
http://www.vostrosito.ut/awiki/page.do
// Rewrite link (.htaccess is required)
define("conf_rewrite_link","no");
define("conf_link_ext",".do");
Per fare questo avete bisogno di configurare la direttiva AllowOverride di Apache e del modulo mod_rewrite, oltre che di un file .htaccess nella root directory di aWiki fatto in questo modo:
<IfModule mod_rewrite.c> Options +FollowSymlinks RewriteEngine on RewriteRule ^(.*).do$ ?qq=$1 [nc] </IfModule>
Quando seguendo un link il contenuto non è disponibile, vi viene presentata una pagina di editing con alcune informazioni di default. Per decidere quali non vi rimane che editare i valori di queste chiavi. Alcune di queste, inoltre, sono utilizzare per creare gli headers delle pagine in cui i dati sono omessi (ad esempio se omettere |
// Default value for new contents
define("conf_default_author","Your name");
define("conf_default_copyright","(c)".date("Y")." Your name");
define("conf_default_date",date("Y-m-d H:i:s"));
define("conf_default_phrase","La documentazione per questo argomento non è ancora disponibile");
// Default keywords and description
define("conf_default_keywords","your, keywords");
define("conf_default_description","your short description");
aWiki possiede alcune funzionalità aggiuntive basate su javascript. Ovvero il menù contestuale in alto a dx e l'editor (textarea) basata su XmlHttpRequest. Se odiate javascript o avete un altro motivo potete disabilitarle con il valore no.
// Display contextual TOC
define("conf_display_main_toc","yes");
// Use XmlHttpRequest for save?
define("conf_xmlhttprequest","yes");
aWiki possiede un basilare sistema di password, per altro non sicuro. Questa funzione non è intesa come sistema di protezione dei dati, ma come semplice controllo degli errori. Per abilitare l'uso delle pwd settate su yes, o no se non le volete. Le funzioni "protette" da pwd sono la scrittura e modifica di contenuti, l'upload e la ricostruzione dell'indice per le ricerche full text.
define("conf_pwd_required","yes");
Potete settare più d'una pwd, per dare ad ogni "utente" la propria, basta duplicare la riga:
$conf_user_pwd[]="YourPassWord1"; $conf_user_pwd[]="YourPassWord2"; $conf_user_pwd[]="YourPassWordN";
Per la ricerca FullText è necessario disporre di un database MySql e settare le seguenti chiavi su yes. La chiave conf_allow_buildindex permette di ricostruire la base dati.
// Allow search and BuildIndex
define("conf_allow_search","yes");
define("conf_allow_buildindex","yes");
Se conf_allow_search o conf_allow_buildindex sono settate su yes dovete configurare il database; per questo in fondo al file di configurazione trovate queste variabili.
$db_host = "localhost"; $db_name = "database"; $db_user = "username"; $db_password = "password"; $db_table = "unitag"