COME-FARE-LA-LAND---LEGGIMI!.txt

################## Blancks Presents #####################
#                                                       #
#           GDRCD 5.x - Users Manual                    #
#                                                       #
#########################################################

------------------------------------------------------
VERSIONE STABILE
------------------------------------------------------

Le corrente versione e' stabile, ma ancora soggetta ed ampliamenti,
tuttavia dalla fase di testing della release beta è stata
comprovato il corretto funzionamento del software.
Le eventuali correzioni saranno rilasciare come nuove versioni 
dei file correnti e sarà poissibile applicarle su un sito già pubblicato
semplicemente sostituendo i file con i corrispettivi aggiornati.

Saranno auspicabilmente anche introdotte nuove funzioni ed
ampliate le correnti su suggerimento dell'utenza.

-------------------------------------------------------
COMMUNITY DI SVILUPPO
-------------------------------------------------------

GDRCD 5.x e' un progetto Open Source e come tale e' aperto ai contributi.
Mi riservo di vagliare personalmente eventuali modifiche da
inserire direttamente nel core ufficiale del programma, ma nulla
vieta di rilasciarle come MODs o di produrre release alternative.

Rispetto alle precedenti versioni di GDRCD e' introdotta la
possibilità di rilasciare skin grafiche per il prodotto, che,
senza andare ad alterare il codice PHP o l'HTML, possono essere
installate sul proprio sito ed attivate cambiando immediatamente
tutta la veste grafica, senza ulteriori interventi.

Invito quanti desiderino cimentarsi nello sviluppo di MODs di
rispettare la struttura base del sistema, che prevede l'utilizzo
del file di vocabolario (IT-it.vocabulary.php) per contenere le
i messaggi di output, piuttosto che inserirli direttamente nel codice, 
l'utilizzo dei css per la formattazione della pagina, e che il mod sia
un frammento di codice da includere in fase di load della pagina
in uno dei div preposti di main.php come le pagine contenute nella
cartella pages/. Le modifiche proposte al core che non rispettino
questi standard non verranno prese in considerazione.

-------------------------------------------------------
VENIAMO AL DUNQUE, COME LA FACCIO STA LAND?
-------------------------------------------------------

1) Scaricare il file gdrcd.zip e decomprimerlo (ma questo l'hai gia' 
fatto).

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

2) Prendere tutti i file e tutte le cartelle contenute nell'archivio 
(gdrcd.zip)

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

3) Fare l'upload di tutti i file e tutte le cartelle sul tuo spazio 
web. Potresti aver bisogno di un programma come Filezilla.
ATTENZIONE: Ogni file deve essere all'interno della stessa cartella 
dove l'hai trovato in gdrcd5.zip, una volta terminato l'upload, 
altrimenti il sito non funzionera'.

La struttira delle cartelle e' la seguente:

ROOT

|- docs
|- imgs
|   |--- avatars
|   |--- icons
|   |--- pegi
|	|--- images
|	|--- locations
|- includes
|- pages
|- layouts
|- sounds
|- themes
|   |--- advanced
|	|	  |---- home
|   |     |---- imgs
|   |            |--- guilds
|   |	         |--- items
|   |	         |--- locations
|   |	         |--- maps
|   |	         |--- menus
|   |	   	 	 |--- races
|   |--- basic
|	|	  |---- home
|   |     |---- imgs
|   |            |--- guilds
|   |	         |--- items
|   |	         |--- locations
|   |	         |--- maps
|   |	         |--- menus
|   |	   	 	 |--- races
|- vocabulary

imgs: La cartella contiene alcune immagini utilizzate dal sistema, in
particolare icone di sistrma. Se si desidera modificarle è possibile 
agire sul contenuto di questa cartella anche se non è parte dei temi.
La cartella pegi contiene i simboli pegi per la homepage, la cartella
avatar contiene l'immagine base dell'avatar nelle schede e la figura
su cui vengono ubicati gli oggetti indossati.

includes: La cartella includes contiene file essenziali al funzionamento
del programma, che vengono inclusi ad ogni visualizzazione delle pagine.

pages: La cartella pages contiene i blocchi di codice da richiamare
nella finestra principale con le singole funzioni. Vengono richiamati
da main.php attraverso il parametro page, nella barra degli indirizzi.
Ad esempio, l'indirizzo http://www.sito.it/main.php?page=uffici richiama
i servizi della pagina uffici.inc.php presente in pages.
Per aggiungee nuove funzioni al sito è consigliabile produrre nuovi
blocchi di codice richiamabili con questo meccanismo da posizione in
questa cartella. A prescindere dal contenuto, tali file dovranno avere
l'estensione .inc.php.

themes: La cartella themes contiene i temi per la grafica del sito.
Ciascun tema ha il proprio nome che corrisponde al nome della cartella
relativa, che contiene i file css con le impostazioni e la cartella imgs.
Nella cartella imgs sono posizionati, solitamente gli sfondi del sito,
mentre, nelle sue sottocartelle sono posizionati, risperttivamente, le
icone di gilda (guilds), le immagini degli oggetti (items), le immagini
dei luoghi (locations), le immagini delle mappe (maps) e le immagini e
iconde di razza (races). Il programma cerca automaticamente le immagini
specificate per queste aree del sito in tali cartelle del tema 
selezionato. Ad esempio, se specifichiamo l'immagine razza01.jpg come
icona per una razza e abbiamo selezionato il tema "sfumature_blu" ogni
volta che visualizziamo nel sito l'icona di tale razza, l'immagine
verrà automaticamente cercata in 
http://www.sito.it/themes/sfumature_blu/imgs/races.

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

4) Modificare il file config.inc.php. Questo passo è cruciale. A 
prima vista il file e' lungo e complicato, ma in realta' e' molto 
semplice. E' soltanto un elenco di parametri che puoi impostare a tuo 
piacimento per modificare le impostazioni del tuo gioco e per attivare 
o disattivare funzioni che ti interessano o che non vuoi.

Assicurati di aver letto attentamente tutto il testo di help che il file 
contiene perche' ti spieghera', parametro per parametro, la sua funzione.

ATTENZIONE: Modificare le pagine php non ti dovrebbe essere necessario.
Probabilmente la modifica che vuoi ottenere può essere fatta modificando 
il file config.inc.php, oppure il file IT-it.vocabulary.php (se vuoi 
cambiare un testo all'interno del sito), oppure mediante i file css della 
cartella themes/nome-tema, se e' una modifica di tipo grafico.

IMPORTANTE: La prima cosa che devi modificare sono i parametri di 
connessione, essenziali perche' il sito funzioni:

$PARAMETERS['database']['username'] = 'username'; 
$PARAMETERS['database']['password'] = 'password'; 
$PARAMETERS['database']['database_name'] = 'nomedatabase'; 
$PARAMETERS['database']['url'] = 'indirizzo';

Al posto di username, password, nomedatabase e indirizzo, tra le virgolette, 
devi scrivere i parametri che ti sono stati comunicati quando hai registrato
il tuo spazio web.

Subito sotto ci sono le informazioni sul sito e sullo webmaster. Ti invito
a compilarli interamente riportando il tuo nome e cognome reali per 
correttezza.

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

5) A questo punto prova a visitare il tuo sito. Dovrebbe apparirti un 
messaggio di errore. Se ti dice che il database e' vuoto e che dovresti fare
l'installazione tutto ok, clicca sul link o visita la pagina 
http:// [miosito.ext] /installer.php. Questo dovrebbe installare il database.
Se invece il messaggio ti informa che non e' possibile trovare il database
allora qualcosa e' andato storto. Probabilmente non hai scritto correttamente
i parametri di connessione. Sono corretti? Sicuro di avere un database
attivato nel tuo spazio web?

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

6) Adesso dovresti avere il database installato. Prova ad accedere di nuovo
alla homepage. Se si visualizza la homepage con il form di login e tutto 
allora l'installazione e' completa. Prova ad effettuare il login come
amministratore del sito:

user: Super
password: super

Se il login viene effettuato tutto è andato liscio, altrimenti c'e' qualcosa
che non va. Prova ad installare manualmente il database con il servizio di
phpmyadmin offerto dal tuo spazio web, scegliendo l'opzione "importa" e caricando
il file gdrcd5.sql. Se nel database sono gia' presenti alcune, ma non tutte, 
tabelle di gdrcd5 allora eliminale prima di importare il file.

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

7) Finalmente dovresti essere loggato nel tuo sito. Sei l'amministratore ed
hai accesso al pannello di gestione. Adesso dovresti creare il tuo mondo,
compilando un regolamento, un ambientazione, creando razze, luoghi, mappe, 
oggetti, ecc. Tutto questo e' possibile farlo dal menu' "Gestione". Dovrebbe
essere abbastanza intuitivo ed in questa breve quida non trattero' le sue voci.

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

8) Adesso manca soltanto la grafica e qui ti è richiesta almeno un poco di 
competenza con il CSS. Non ce l'hai? Non allarmarti, c'e' una scorciatoia.
Seleziona prima di tutto la skin basic dal relativo parametro in config.inc.php.
A questo punto, avrai visto che tutta la grafica dell'homepage e quella interna 
di questa skin sono ottenute con due immagini singole. 
Sostituiscile, rispettando i riquadri, con immagini create da te, e avrai gia' cosi' 
una grafica tua originale per il sito. 
Altrimenti potresti scaricare e installare skin realizzate da altri utenti, 
semplicemente facendo l'upload della cartella della skin nella cartella
themes ed andando ad attivarla nel file config.inc.php alla voce "Temi".
Se invece hai più esperienza col CSS ti invito a provare a dare un occhio alla skin
"advanced" che presenta questa nuova versione con un interfaccia grafica più accattivante
e magari può tornarti utile per darti idea di come fare un lavoro ancora più personalizzato.


----------------------------------------------------------
BUON LAVORO E BUON DIVERTIMENTO
----------------------------------------------------------

Stavolta dovrebbe essere davvero facile fare la tua land, confido che
ne verrai a capo. Buon Divertimento!


Fabrizio Pedani.
Files aggiornato e revisionato da Salvatore Rotondo.
Files aggiornato e revisionato successivamente da Breaker.