Source: http://johsun.100webcustomers.com/mjguest/UserGuide_it.htm
Timestamp: 2020-08-03 12:12:04+00:00

Document:
MJGUEST Guida per l'utente
MJGUEST ============================================================= Copyright (c) 2002-2008 www.mdsjack.bo.it Agreement: http://www.mdsjack.bo.it/files/agreement.htm ============================================================= Official website: http://www.mdsjack.bo.it Script email: mjguest (AT) mdsjack.bo.it Agreement info: agreement (AT) mdsjack.bo.it
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.
§ 1.0 - Installazione
§ 2.0 - Amministrazione del programma
2.1) Panoramica
2.1.1) Effettuare l'acesso
2.1.2) Smarrimento della parola chiave
2.1.3) Modificare la configurazione
2.2) Gestire i messaggi
2.3) Temi Grafici
2.4) Smileys (faccine)
2.5) Altri Add-ons
2.6) Impostazioni avanzate
2.7) Feed RSS
§ 3.0 - Aggiornamento
§ 4.0 - Rimozione
§ 5.0 - Appendice 1: Come usare la "Setup Utility"
§ 6.0 - Appendice 2: Rimuovere il copyright sulla barra del titolo (su richiesta)
§ 7.0 - Appendice 3: Richiedere il supporto tecnico
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
Caricate per intero lo script sul vostro server web usando un programma FTP (ad es. CuteFTP).
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.
Esistono due livelli di autorizzazione: Moderatore and Amministratore.
Il livello di Moderatore deve essere attivato dall'Amministratore tramite il pannello di controllo.
Speciali abilità
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.
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:
= Approva il messaggio in attesa di verifica: fino ad allora non appare agli ospiti, ad eccezione dell'autore del messaggio, del Moderatore ed dell'Amministratore
= Modifica il messaggio
= Cancella il messaggio
= Bandisci l'ospite e cancellane i messaggi: non può essere bandito né il Moderatore né l'Amministratore
= Ottieni info sui dati di connessione dell'ospite (IP/Provider)
Rispondere ai messaggi:
Potete inserire facilmente una vostra risposta al messaggio, cliccando su questa icona speciale:
= Inserisci/Modifica la tua risposta al messaggio
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... "
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!
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.
Sul sito ufficiale, potete trovare altre componenti per mantenere il programma aggiornato.
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).
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.
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 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.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
A partire dalla versione 6.3 tutte le cartelle precedute dal carattere underscore "_" non sono più necessarie e possono essere cancellate.
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.1) Usate la "Setup Utility"
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).
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)
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.
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:
1) Controllate di aver installato l'ultima versione del guestbook e dei files aggiuntivi (visitate il sito web)
2) Controllate che ogni file e cartella siano stati integralmente caricati sul server. Se non siete sicuri ripetete l'operazione.
3) Se l'installazione ha avuto successo, aprite il file "setup.ini.php" con un programma di testo ed impostate mjguest_debugmode a true. Salvate e caricate il file online.
4) Quando chiederete supporto, indicate l'indirizzo web dove è situato il guestbook.
5) Leggete questa discussione nel forum, su Domande frequenti + Trucchetti utili.

References: § 1

§ 2

§ 3

§ 4

§ 5

§ 6

§ 7
 § 2
 § 5
 § 5
 § 1

§ 5

§ 6

§ 7