English


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.1) Cancellate i files non necessari
(saltate questo passo se state RE-installando)

Se non avete una connessione internet veloce per caricare il programma sul server o non vi interessa la funzione di riconoscimento automatico del Paese di provenienza degli ospiti, allora potete eliminare evitare di caricare:

FILE resources/ip-to-country.db (circa 1.8 MegaByte)

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


Se non siete interessati alle bandiere dei paesi di provenienza degli ospiti, potete evitare di caricare anche:

CARTELLA interface/theme-NOMETEMA/flags/ (es. "theme-hera")


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 "pgsql", "sqlite", ecc...)

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

Caricate per intero 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) Panoramica

Esistono due livelli di autorizzazione: Moderatore and Amministratore.
Il livello di Moderatore deve essere attivato dall'Amministratore tramite il pannello di controllo.

Speciali abilitàMod.Ammin.
Modificare/ripristinare la configurazione-+
Attivare/disattivare il Moderatore-+
Azzerare i messaggi del Libro degli Ospiti-+
Bandire un ospite e cancellarne tutti i messaggi-+
Cambiare i propri dati (parola chiave, email)++
Leggere ed approvare i messaggi in attesa di verifica++
Modificare o cancellare singoli messaggi++
Rispondere ai messaggi++
Visualizzare i messaggi confidenziali++
Vedere attraverso le parolacce filtrate++
Accedere ai dati di connessione degli ospiti (IP/Host)++
Quando scrivete, il sistema di approvazione, il riconoscimento del paese, i sistemi di sicurezza ed i filtri sono per voi disabilitati++

Effettuare l'accesso:

Per poter amministrare il programma, dovete prima aver effettuato il riconoscimento tramite parola chiave, inserendola nell'apposito modulo a fianco del menù.
Una volta effettuato l'accesso, il rispettivo modulo sarà sostituito da dalla voce del menù "Pannello di controllo".

La parola chiave predefinita per l'Amministratore è "password".
La parola chiave predefinita per il Moderatore (se attivo) è "moderator".

Smarrimento della parola chiave:

Se non ricordate la parola chiave, potete riceverla via email utilizzando la SetupUtility (§ 5.0) utilizzando la funzione "Password reminder".

Modificare la configurazione:

Andate alla pagina "Pannello di controllo" 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.

2.2) Gestire i messaggi

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 "Confidenziale".

Tenete presente che ogni messaggio privato può essere letto anche dal rispettivo autore (ma non dagli altri ospiti)! Pertanto, potrete vedere il messaggio privato scritto da voi come Ospite, fin tanto che il vostro indirizzo IP rimane lo stesso.

Gestire i singoli messaggi:

Quando siete collegati come Moderatore o Amministratore e siete alla pagina di lettura, appariranno icone speciali per ogni messaggio.

Al Moderatore, tuttavia, non sarà consentito gestire i messaggi inseriti dall'Amministratore.

Queste icone vi permetteranno di compiere operazioni di amministrazione sui singoli messaggi:

Rispondere ai messaggi:

Potete inserire facilmente una vostra risposta al messaggio, cliccando su questa icona speciale:

Se javascript fosse disabilitato, verrete portati ad una schermata classica di scrittura, simile alla videata di modifica dei messaggi.

Se avete javascript abilitato, sarà attiva la modalità di scrittura veloce.

Per entrare nella modalità di scrittura, fate click sull'icona riportata qui sopra, oppure doppio click sul testo di una vostra risposta scritta precedentemente.
Il cursore sarà posizionato su un campo di testo dove potrete scrivere la vostra risposta.

Se volete rimuovere la vostra risposta, sarà sufficiente cancellarne il contenuto.

Per salvare la vostra risposta ed uscire dalla modalità di scrittura, semplicemente cliccate ovunque fuori del campo di testo.

A seconda del vostro livello di autorizzazione, le risposte saranno visualizzate in modo differente:

" Amministratore: la vostra replica qui... "

" Moderatore: la vostra replica qui... "

2.3) 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 theme-NOMETEMA (es. "theme-hera")

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. "theme-miotema"), 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.4) 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.5) Altri Add-ons

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

Filtro anti-SPAM:

FILE resources/spam.db
Dovreste mantenere aggiornato questo file, cosicché il programma possa bloccare lo spam in modo più accurato.

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).

2.6) Impostazioni avanzate

Potete trovare altre impostazioni nascoste, aprendo con un editor di testo, il file:

FILE mjguest.class.php

Per ogni impostazione è data una breve descrizione, in inglese.

Attenzione! Qui state modificando direttamente il codice sorgente. Ogni modifica è effettuata a vostro rischio e pericolo.

2.7) Feed RSS RSS Feed

I feed RSS sono una nuova tecnologia estremamente diffusa che permette di visualizzare gli ultimi messaggi inseriti nel guestbook attraverso programmi appositi o siti web che permettono la lettura di diverse fonti RSS in un'unica pagina, come ad esempio la home-page personalizzata di Google.

Per visualizzare la pagina contenente i feed RSS del vostro guestbook, cliccate sull'icona RSS Feed che appare nel menu principale ogni volta che siete collegati come Amministratore o Moderatore.

Potrete utilizzare l'indirizzo web di questa pagina per permettere ai programmi o siti web di lettura degli RSS di raggiungere il vostro guestbook e visualizzare gli ultimi messaggi inseriti.


§ 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 #7:
Nella versione 6.8, la gestione delle date è cambiata. Questo comporta che ora e data dei vecchi messaggi mostrerà l'ora errata, variabile a seconda della localizzazione geografica del vostro server web.

NOTA #6:
Nella versione 6.7, le cartelle dei temi hanno cambiato denominazione:

interface/NOMETEMA.pak -> interface/theme-NOMETEMA

Provvedete a rinominare tutte le cartelle presenti.

NOTA #5:
Nella versione 6.7, la cartella:

CARTELLA install/

E' stata sostituita da:
CARTELLA setup/

Potete cancellare la vecchia cartella non più in uso.

NOTA #4:
Dalla versione 6.5, i nomi dei files di lingua sono così cambiati:

FILE.lang.php -> FILE.utf8.php

Cancellate quelli vecchi da:
CARTELLA interface/language/

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

interface/FILE.tpl.php -> interface/FILE.htm.php

Cancellate quelli vecchi da:
CARTELLA interface/

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

NOTA #1:
Con la versione 6.2 i nomi degli smileys forniti sono cambiati, per cui l'aggiornamento potrebbe non permettere una corretta visualizzazione degli smileys nei vecchi messaggi.

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 1: Come usare la "Setup Utility" (in inglese)

1) Aprite il vostro browser alla pagina:

www.VostroSito.it/CartellaMjguest/setup/

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 e Password Reminder.

§ 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 - APPENDIX 3: Richiedere il supporto tecnico

Prima di chiedere supporto tecnico sul forum ufficiale , leggete procedete come segue:


FINE DELLA GUIDA