JoomlafacebookChat+Plus tutorial

Транскрипт

1 JoomlafacebookChat+Plus tutorial Componente scritto da: Marco Biagioni -- Doc. redatto da: Jacopo Sagramoso 07/01/12 Verificato da: Marco Biagioni 07/02/12 Rilascio versione: '1.0 03/02/11

2 Indice generale INTRODUZIONE...3 INSTALLAZIONE...5 PANNELLO DI CONFIGURAZIONE...5 Preferenze...6 Integrazioni...6 Avanzate...7 CREAZIONE FILE PERSONALIZZATI LINGUA...7 FRONT END...8 SUPPORTO...9

3 INTRODUZIONE La versione JoomlafacebookChat+Plus della ormai popolare JoomlafacebookChat è una chat Facebook like per il CMS Joomla! evoluta sulla base delle numerose richieste ricevute nel Il componente è rilasciato in release native per le versioni di Joomla 1.5 e 2.5 dove la versione 2.5 è compatibile e installabile sulle verioni 1.6 e 1.7. Per ogni esigenza basterà utilizzare la funzionalità di tiketing e saranno date tempestive risposte! L'assistenza dura un mese dall'acquisto. Il componente JoomlafbChat+ è, nelle funzionalità, totalmente analogo per le versioni 1.5, 1.6, 1.7 e 2.5 di Joomla!. Per il front end è possibile scegliere differenti lingue (Italiano, inglese, francese, tedesco, spagnolo, dutch, ungherese e greco) esplicitamente dalla configurazione del componente, mentre il back end è tradotto dal language pack selezionato in Joomla! in: italiano, inglese, spagnolo e tedesco. Funzionalità JoomlafbChat+ integrazione Jomsocial, integrazione Community Builder, gestione avatar integrata con Jomsocial e CB, link a profili Jomsocial e CB, possibilità di limitare la visualizzazione degli utenti in chat solo agli utenti aggiunti come amici (Jomsocial e CB), Emoticons con possibilità di selezione immagine direttamente da pop up o con scrittura dello shortcut (restando con il puntatore del mouse sulle immagini delle emoticons viene visualizzato il titolo corrispondente alla battitura dello shortcut), possibilità di richiedere l'installazione di nuovi set di emoticons, ottimizzazione performance scambio messaggi, gestione evoluta della chat multiutente e multitabs con memorizzazione in sessione dei messaggi non ancora letti per il mantenimento tra refresh di pagina, no advertising,

4 eliminati problemi di configurazione percorsi per installazioni di Joomla in sottocartelle (non necessita più la configurazione di tag base), parametrizzazione stato utente online (led verde/grigio), migliorata la gestione dei conflitti con altre librerie javascript. Funzionalità JoomlafbChat free version 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. La versione Plus include tutte le funzionalità della versione Free riviste e migliorate in ogni parte con una particolare attenzione all'ottimizzazione del componente e del suo funzionamento.

5 INSTALLAZIONE L'installazione del componente è easy plug & play e prevede: entrare nel pannello di controllo dell'amministrazione di Joomla! cliccare nel menu della header su 'estensioni'/'installa/disinstalla' per Joomla 1.5 oppure 'Estensioni/gestione estensioni' su Joomla , cliccare su 'Sfoglia' e caricare il pacchetto zippato 'jfbc_plus15_v1.0.zip' per Joomla! 1.5 o jfbc_plus25_v1.0.zip' per Joomla! 1.6, 1.7, 2.5 scaricato dal sito di 2 punti, se la procedura di installazione si concluderà senza errori il componente visualizzerà il messaggio di esito positivo e sarà subito attivo e visibile come una barra applicativa nella parte inferiore della pagina in front end. Il componente sarà così attivo su tutto il tuo sito Joomla! grazie ad un plugin di sistema che non necessita ulteriori configurazioni e rende immediato l utilizzo del componente. Tuttavia si consiglia di prestare attenzione al fatto che se si inseriscono degli iframe interni al sito si può visualizzare la barra della chat sia nel frame esterno che in quello interno. NOTA: Il componente NON DEVE essere linkato da nessun menu. PANNELLO DI CONFIGURAZIONE Per accedere al componente da back end cliccare su Componenti JoomlafbChat+

6 Preferenze Le funzionalità riportate nello screen sopra relative alle preferenze indicano: File lingua selezione file lingua front end da select list, Chat templates selezione di eventuali template tra quelli disponibili. Per rendere disponibile automaticamente nella select list un eventuale nuovo template sarà sufficiente caricare via FTP il file CSS nella cartella components/com_jfbchat/css. Le immagini usate dal file CSS dovrebbero essere posizionate in una sottocartella di components/com_jfbchat/images denominata, consigliamo, secondo il nome dato al template. In alternativa si può inserire nel file.zip del componente i file del template prima di installarlo nelle cartelle site/css e site/images e il componente sarà installato con i nuovi templates inseriti. Aggiornamento Chat consente di definire i parametri di aggiornamento dei messaggi in secondi, Intervallo aggiornamento lista utenti consente di definire l'aggiornamento (secondi) della lista utenti, Intervallo per considerare un utente offline consente di definire l'intervallo di tempo dall'ultimo messaggio inviato per cui considerare un utente offline, è possibile inoltre disattivare questa modalità facendo in modo che il sistema consideri gli utenti loggati sempre in stato online nella chat tramite il parametro Disattiva intervallo utenti offline, Apertura popup chat permette di definire se cliccando su un utente si apre in automatico o meno la lista messaggi, Audio On/Off. Integrazioni Il sistema identifica in automatico se su Joomla sono installati i componenti con cui interfacciarsi per l'integrazione (Jomsocial e CB attualmente supportati).

7 NOTA BENE: Si deve sempre ABILITARE esplicitamente se si vuole che la chat sia integrata con il Jomsocial, con il CB. La funzionalità Mostra solo amici permette di settare la chat in modo tale che un utente veda o meno SOLO la lista degli utenti che ha confermato come 'amici'. Avanzate 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.

8 CREAZIONE FILE PERSONALIZZATI LINGUA La creazione di un nuovo file della lingua è estremamente semplice infatti basta: accedere al file della lingua via ftp o caricarlo nel pacchetto.zip come nel caso dei templates, il file della lingua si trova in:.../httpdocs/components/com_jfbchat/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 jfbc_chionline = 'Utenti Online'; IMPORTANTE: NON cancellare o modificare nessun nome di variabile! Salvare il file in formato UTF-8 e estensione.js. Chiediamo a chi procedesse nel tradurre il file in altre lingue di inviarlo a [email protected] per poterlo mettere a disposizione. Per cortesia inviare il file rinominato con la lingua tradotta. 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.

9 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: Nota Bene: il supporto è garantito SOLO per chi acquista il prodotto e per un mese dall'acquisto. Per ricevere supporto è necessario essere loggati al sito di