Grazie per aver scelto MJGUEST!
Ecco una guida veloce per partire subito con il vostro nuovo Libro degli Ospiti.
Per ogni problema o difficoltà che doveste incontrare durante l'installazione o l'utilizzo del guestbook, chiedete aiuto nel forum di discussione del sito ufficiale.
Al fine di aiutarci a migliorare il servizio, segnalateci ogni problema.

Indice dei Contenuti

§ 1.0 - INSTALLAZIONE

1.2) Cancellate i files non necessari (saltate questo passo se state RE-installando)

Se siete un nuovo cliente, potete cancellare:

CARTELLA interface/emoticons6.0/
CARTELLA interface/emoticons6.1/


Inoltre, se non avete una connessione internet veloce per caricare il programma sul server (vedi passo successivo) o non vi interessa la funzione di riconoscimento automatico del Paese di provenienza degli ospiti, allora potete eliminare questo file:

FILE resources/ip-to-country.db (circa 1.6 MegaBytes)

Se poi deciderete successivamente di ripristinare la funzione, basta che caricate sul server questo file (vedi § 2.4).


Infine, se sapete già da ora quale database userete, potete cancellare le cartelle contenenti le cartelle relative agli altri database, tutte dentro:

CARTELLA database/

Esempio: se sapete di usare MySQL3, potete cancellare le cartelle "mysql4", "pgsql8", "sqlite2", ecc...

1.2) Caricate il Programma sul Server (saltate questo passo se state RE-installando)

Caricate lo script sul vostro server web usando un programma FTP (ad es. CuteFTP).

NOTA:
I files di lingua, è molto importante che vengano caricati tutti, perchè il riconoscimento della lingua avviene in base alla provenienza dei vostri visitatori!

1.3) Usate la "Setup Utility"

Passate al § 5.0 per sapere come eseguire la "Setup Utility", quindi proseguite qui nella lettura.

Usate il tasto "Install" e seguite la procedura passo-passo (in inglese).

Una volta fatto, con il tasto "Usage Tutorials", vi verrà suggerito il codice più idoneo al vostro tipo di sito web per aprire il guestbook dal vostro sito.

Chiudete la "Setup Utility".

1.4) Come entrare nel Programma la prima volta

Potete accedere al guestbook attraverso il link che avete creato al passo precedente.
Per entrare nel pannello di amministrazione del guestbook per la prima volta, usate "password" come parola chiave.

§ 2.0 - AMMINISTRAZIONE DEL PROGRAMMA

2.1) Operazioni di base

Per poter amministrare il programma, dovete prima aver effettuato il riconoscimento tramite parola chiave, alla pagina "Admin".
Se non ricordate la parola chiave, potete riceverla via email cliccando sul tasto " ? " nella schermata di riconoscimento.

Quando siete connessi come Amministratore:

Modificare la configurazione:

Andate alla pagina di riconoscimento/amministrazione ("Admin") ed una volta collegati potete facilmente gestire le opzioni del programma.
Da questa schermata potete tra l'altro cancellare tutti i messaggi in una sola volta e ripristinare la configurazione originaria.

Leggere i messaggi privati:

Quando siete collegati come Amministratore i messaggi privati appariranno insieme agli altri, nella schermata di lettura e saranno riconoscibili dal titoletto "Privato".

Gestire i singoli messaggi:

Quando siete collegati come Amministratore e siete alla pagina di lettura, appariranno icone speciali per ogni messaggio. Queste icone vi permetteranno di compiere operazioni di amministrazione sui singoli messaggi:

2.2) Temi Grafici

A) Temi ufficiali

Scaricate dal sito ufficiale il tema grafico che preferite, verificando che sia tra quelli compatibili con la versione del vostro guestbook.

Scompattate l'archivio ZIP e troverete:

CARTELLA nomeTema.pak

Caricate l'intera cartella sul vostro server, qui dentro:

CARTELLA interface/

Il tema grafico sarà immediatamente disponibile all'interno del pannello di amministrazione del libro degli ospiti.

NOTA PER I WEB DESIGNER:
Dal sito ufficiale si può anche scaricare un pacchetto speciale con la cartella "nomeTema.SDK" che contiene tutti i file vettoriali PNG per i grafici web che intendono personalizzare il tema.
Questa cartella NON va caricata sul server.

B) Temi personalizzati

Se avete conoscenze di CSS e grafica, potete creare voi stessi un tema.
In questo caso suggerisco di creare una cartella apposita partendo da quella di default e poi rinominandola (e.g. "miotema.pak"), così in caso di problemi potete sempre ripristinare il tema originale.
Nel personalizzare l'aspetto, modificate SOLO i files dentro la cartella del tema grafico!

2.3) Smileys (faccine)

Aggiungere e rimuovere gli smileys non è mai stato così facile!
Aprite la cartella:

CARTELLA interface/emoticons/

Semplicemente aggiungete, cancellate, rinominate i file all'interno. I cambiamenti saranno effettivi immediatamente.

2.4) Altri Add-ons

Sul sito ufficiale, potete trovare altre componenti per mantenere il programma aggiornato.

Filtro parolacce:

FILE resources/swearwords.db
Dovreste mantenere aggiornato questo file, cosicché il programma possa intercettare più parolacce possibili.

IP-to-Country Database:

FILE resources/ip-to-country.db
Questo grosso file permette al programma di riconoscere il paese di provenienza di un ospite, partendo dal suo indirizzo IP. Se vi interessa questa funzionalità, dovreste mantenere il file aggiornato (lo trovate sul sito di MJGUEST).

§ 3.0 - AGGIORNAMENTO

3.1) Caricate il Programma sul Server

Utilizzate il programma FTP per sovrascrivere il vecchio guestbook con il nuovo che avete scaricato.

NOTA TEMPORANEA 1:
Con la versione 6.2 i nomi degli smileys forniti sono cambiati. Per mantenere la compatibilità con il vostro vecchio guestbook, fare quanto segue:

1) Se avete smileys personalizzati spostateli
da:
CARTELLA _interface/_emoticons/
a:
CARTELLA interface/emoticons_6.0/ (or 6.1)

2) Rinominate:
CARTELLA interface/emoticons_6.0/ (or 6.1) --> interface/emoticons/

NOTA TEMPORANEA 2:
A partire dalla versione 6.3 tutte le cartelle precedute dal carattere underscore (" _ ") non sono più necessarie e possono essere cancellate.

NOTA TEMPORANEA 3:
A partire dalla versione 6.3, i nomi dei files template sono cambiati:

TEMPLATE.tpl.php --> TEMPLATE.htm.php

Cancellate i vecchi files in:
CARTELLA interface/

3.2) Usate la "Setup Utility"

Passate al § 5.0 per sapere come eseguire la "Setup Utility", quindi procedete nella lettura.

Selezionerete la versione del programma che avevate ed userete il tasto "Upgrade", quindi, a procedura terminata con successo, il tasto "Usage Tutorials", per copiare il codice necessario ad aprire il guestbook dal vostro sito.

§ 4.0 - RIMOZIONE

4.1) Usate la "Setup Utility"

Passate al § 5.0 per sapere come eseguire la "Setup Utility", quindi procedete nella lettura.

Per cancellare definitivamente, usate il tasto "Remove". Perderete tutti i dati!

Se ora volete Re-installare, passate al § 1.0.

4.2) Cancellate i files

Dopo aver eliminato i dati memorizzati, usate un programma FTP per cancellare manualmente files cartelle.

§ 5.0 - APPENDICE: Come usare la "Setup Utility" (in inglese)

1) Aprite il vostro browser alla pagina:

www.VostroSito.it/CartellaMjguest/install/index.htm

2) Cliccate sul collegamento "Open Setup Utility" ed in una finestra popup si aprirà la Setup Utility.

3) Seguite le istruzioni passo-passo (in inglese).

NOTA:
Se il programma è già installato, per ragioni di sicurezza vi verrà richiesta la parola chiave dell'Amministratore. Se avete appena installato il programma, la parola chiave predefinita (che non avete ancora cambiato) sarà la parola "password".
Le operazioni protette sono: Install, Upgrade, Remove. Non è necessaria parola chiave per: Usage Tutorials.

§ 6.0 - APPENDICE 2: Come rimuovere il copyright sulla barra del titolo (su richiesta)

Perchè?

Sebbene il programma sia gratuito al 100% per ogni tipo di utilizzo, se per caso voleste nascondere agli occhi dei vostri visitatori la provenienza del vostro libro degli ospiti, potete acquisire il diritto di nascondere la nota di copyright sulla barra del titolo, senza violare il contratto, pagando una tariffa simbolica una tantum.

Come?

Semplicemente visitate la sezione dedicata sul sito ufficiale mdsjack web site e leggete attentamente le condizioni (che trovate anche in italiano in fondo al contratto).

§ 7.0 - APPENDCE 3: Come aiutarci a risolvere gli errori

Prima di chiedere supporto tecnico sul forum ufficiale sarebbe di grande aiuto se procedeste come segue:

Ora il guestbook opera in modalità debug, non adatta all'uso, ma utile per rivelare informazioni che ci aiuteranno ad individuare il problema.

FINE DELLA GUIDA