JoomlafacebookChat

tutorial

Componente scritto da: Marco Biagioni --

Doc. redatto da: Jacopo Sagramoso 07/01/11
Verificato da: Marco Biagioni 07/02/11
Rilascio versione: '1.0.6.1 03/02/11

1 di 7
Indice generale
INTRODUZIONE................................................................................................................................3
Funzionalità versione free...........................................................................................................3
INSTALLAZIONE...............................................................................................................................4
Avvertenze..................................................................................................................................4
Installazione chat siti residenti su sottocartelle ..........................................................................5
PANNELLO DI CONFIGURAZIONE...............................................................................................5
CREAZIONE FILE PERSONALIZZATI LINGUA...........................................................................6
FRONT END........................................................................................................................................6
SUPPORTO..........................................................................................................................................7

2 di 7
INTRODUZIONE

Il componente JoomlafacebookChat è una chat “Facebook like” per il CMS Joomla! Il componente è
rilasciato in versioni differenti e native per le versioni di Joomla 1.0, 1.5 e 1.6.

Il componente JoomlafacebookChat distribuito in modalità free è, nelle funzionalità, totalmente

analogo per le differenti versioni di Joomla!

Funzionalità versione free

• Tecnologia Ajax per l'aggiornamento della chat,

• Chat con gli utenti registrati e loggati al sito,
• Gestione utenti in finestre separate,
• Possibilità di impostare lo stato dell'utente (Available, Busy, Invisible)
• Possibilità di impostare un messaggio descrittivo dello stato dell'utente,
• Gestione dei parametri di configurazione per i tempi di aggiornamento dei messaggi e della
lista utenti,
• Gestione dei parametri di configurazione per la lingua (inglese, italiano),
• Possibilità di creare file per altre lingue in modo facile e veloce,
• Gestione dei settaggi per la cancellazione dei messaggi obsoleti mantenuti sul database,
• Funzionalità sonora per i messaggi in arrivo e per i nuovi client connessi,
• Possibilità di andare offline senza eseguire il logout dal sito,
• Test audio.

3 di 7
INSTALLAZIONE

L'installazione del componente è totalmente plug & play e prevede:

• entrare nell'area amministrativa del sito,
• dal menu “installazioni” cliccare su “Componenti”,
• cercare il pacchetto scaricato sul proprio PC dal bottone “Sfoglia”,
• cliccare il bottone “Carica file & Installa”.

Il componente sarà così attivo su tutto il sito Joomla! In un modulo nascosto.

Avvertenze

Il componente durante la fase di installazione crea un modulo nascosto che nella versione di Joomla
1.0 non comparre nella lista dei moduli mentre nelle versioni successive compare compare come un
modulo senza titolo. È importante non modificare mai il suddetto modulo direttamente dalla lista
dei moduli.

Il modulo di default viene assegnato a una posizione comune ai template delle varie versione di
Joomla! Nel caso in cui il template in uso non disponesse della posizione assegnata è possibile
variarla direttamente dal pannello di configurazione. Il modulo a prescindere della posizione
selezionata sarà sempre posizionato nel footer in modo statico.

NOTA: la modifica della posizione del modulo potrebbe rivelarsi utile anche nei casi in cui sul sito
sia già in uso un'altra libreria javascript che potrebbe generare conflitti (Mootools, Prototype).

4 di 7
Installazione chat siti residenti su sottocartelle

Con il rilascio della versione 1.0.6.1 è possibile utilizzare il componente anche su installazioni di
joomla situate in sottocartelle.

Requisito è che sia presente il tag <base href="www.miosito.it/sottocartella/" /> subito dopo il tag
<head> nel file del template in uso. Nel caso si utilizzi il SEF URL questo tag viene inserito
automaticamente da tutte le versioni di Joomla!, mentre nel caso in cui si imposti il sistema per
funzionare senza la riscrittura egli URL si rende necessario specificarlo a mano come descritto,
facendo attenzione allo slash finale che deve esserci.

PANNELLO DI CONFIGURAZIONE

Per accedere al pannello di controllo è necessario entrare nell'amministrazione di Joomla! -

Componenti – Fbchat.

NOTA: i settaggi di default di norma non necessitano di essere variati escludendo il file della lingua.

• Language translations → permette di settare la lingua dal primo menu a tendina

(attualmente, gennaio 2010, sono impostate solo due lingue: inglese – italiano),
• FBChat module position → permette di assegnare la posizione del modulo (vedi
“avvertenze” par. Installazione),
• Chat refresh → consente di definire i parametri di aggiornamento dei messaggi in secondi,
• Chat users list refresh → consente di definire l'aggiornamento (secondi) della lista utenti,
5 di 7
 • Time to consider user offline → consente di definire l'intervallo di tempo dall'ultimo
messaggio inviato per cui considerare un utente offline,
• Audio on/off → permette di attivare o disabilitare l'audio dei messaggi e dell'ingresso nuovi
utenti nella chat,
• Garbage on/off → permette di attivare o disabilitare la funzione di cancellazione dei
messaggi obsoleti dal data base,
• Max messages lifetime → definisce in secondi il tempo massimo di vita di un messaggio sul
data base, è ovviamente collegato al “Garbage”,
• Garbage probability → rappresenta la probabilità che ad ogni richiesta la cancellazione dei
messaggi venga avviata.
• Show backlink → permette di visualizzare o meno il backlink di 2 punti.

CREAZIONE FILE PERSONALIZZATI LINGUA

La creazione di un nuovo file della lingua è estremamente semplice infatti basta:

• accedere al file della lingua via ftp oppure tramite componenti quali il JoomlaXplorer,
• il file della lingua si trova in: .../httpdocs/components/com_fbchat/languages/
• si consiglia di effettuare una copia di un file language esistente e rinominare il nome del file
in accordo alla lingua,
• aprire il file e modificare i valori delle stringhe racchiuse tra le virgolette: var chionline =
'Utenti Online';

IMPORTANTE: NON cancellare o modificare nessun nome di variabile!

Chiediamo a chi procedesse nel tradurre il file in altre lingue di inviarlo a info@2punti.eu per
poterlo mettere a disposizione. Per cortesia inviare il file rinominato con la lingua tradotta.

6 di 7
FRONT END

In front end il componente è sempre visibile nel footer come una barra grigio chiara, cliccando su
“online users” è possibile visualizzare gli utenti collegati al sito e chattare cliccando sul nome.

L'ingranaggio che si trova a destra della barra apre le opzioni della chat:
• possibilità di impostare lo stato dell'utente cliccando sulle relative icone (disponibile,
occupato, invisibile),
• scrivere un messaggio nel campo di testo, è necessario cliccare su “Imposta” o premere
invio,
• effettuare un test dell'audio.

SUPPORTO

Per qualsiasi esigenza di supporto per:

• segnalazione bugs,
• richiesta di personalizzazioni,
• implementazione nuove funzionalità,
è possibile ricevere supporto tramite il sito di 2punti.eu dall'url:
http://www.2punti.eu/support.html

7 di 7