Gabriella Ghermandi

:: Gabriella Ghermandi » Configurare aWiki ::

Configurare aWiki

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.


Path di sistema

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/");

Percorso dei dati

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/");

Permessi sui file

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","");

Estensione dei file

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");

Pagina di default (home page o main page)

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");

Upload e operazioni sui file

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");

Aspetto delle URL

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>

Dati per le pagine nuove

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 |




Funzionalità aggiuntive

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");

Password

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";

Database

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"

 

pagine interne: edit :: edit menu :: all pages :: upload :: profile :: help

 

Creative Commons License
Il testo è coperto dalla licenza Creative Commons
Attribuzione - Non commerciale - Non opere derivate 2.5 Italia
.
Tutti i diritti riservati sulle immagini.

 

Valid XHTML 1.0 Strict Valid CSS!