Componente open source per la gestione contatti sviluppato per Joomla 1.5

Scarica QContacts

QContacts è un componente per la gestione dei contatti sviluppato nativamente per Joomla! 1.5 e derivato dal componente standard com_contact rispetto al quale offre le seguenti funzionalità aggiuntive

Più campi informativi sulla scheda contatto: Id Skype e Yahoo Messenger visualizzabili come link per facilitare l'invio di messaggi al contatto tramite questi servizi.
Possibilità di proteggere il modulo per l'invio di e-mail al contatto con un codice di verifica captcha per ostacolare l'abuso del modulo da parte di programmi creati per inviare automaticamnte messaggi spam (spambots).
Possibilità di aggiungere campi personalizzati al modulo per l'invio di e-mail al contatto.

Requisiti

Se si vuole attivare il codice anti-spam captcha devono essere presenti sul server le librerie grafiche GD (versione 2) con il supporto per i font TrueType. Potete verificarlo dall'area di amministrazione di Joomla, menu Aiuto -> Info sistema -> Informazioni PHP: nella schermata che viene presentata deve essere presente una sezione gd con i seguenti parametri:

GD Support enabled.
GD Version il numero di versione deve essere 2 o superiore
FreeType Support enabled

Come si usa

La configurazione del componente avviene in modo standard dall'area di amministrazione di Joomla!

Gestione categorie contatti

Menu QContacts -> Categorie

Ogni contatto deve essere assegnato ad una categoria. Si possono creare quante categorie contatti si vogliono esattamente come nel componente standard.

Sono disponibili sulla barra degli strumenti le funzioni per la creazione, modifica, cancellazione, pubblicazione e sospensione della pubblicazione di una categoria contatti.

Gestione contatti

Menu QContacts -> Contatti

L'elenco dei contatti è presentato nel formato standard. Sulla barra degli strumenti sono presenti i pulsanti per la creazione / modifica di un contatto e la cancellazione, pubblicazione e sospensione della pubblicazione di uno o più contatti con possibilità di selezione multipla.

Quando si effettuano le operazioni di creazione o modifica si accede alla schermata della scheda contatto. Il significato dei campi della scheda è in gran parte intuitivo, si riporta di seguito una breve spiegazione dove necessaria.

Nome contatto.
Categoria scelta dall'elenco delle categorie contatti
Collegato ad utente. Si può associare un contatto ad un utente presente in tabella utenti. In questo modo l'indirizzo e-mail può non essere specificato nella scheda perché sarà utilizzato quello dell'utente.
Ruolo contatto.
E-mail. Se non si specifica un indirizzo e-mail e non si associa il contatto ad un utente, il modulo per l'invio e-mail non potrà essere visualizzato.
Indirizzo con campi separati per via, città, provincia, CAP, nazione.
Numeri di telefono, cellulare e fax.
Sito internet. Se pubblicato, sarà mostrato sul sito come link attivo.
Id Skype.
Id Yahoo Messenger. Si ricava facilmente dall'indirizzo email Yahoo. Se l'email è This e-mail address is being protected from spambots. You need JavaScript enabled to view it l'id Yahoo Messenger è semplicemente tizio.
Altre informazioni. Campo libero che può contenere codice HTML.
Immagine contatto. Viene selezionata da una immagine inserite in images/stories.

Sulla parte destra della schermata per l'inserimento o modifica di un contatto è presente una lista di parametri.

Parametri Contatti

Per ogni campo della scheda è presente un'opzione che consente di mostrarne o nasconderne il contenuto sulla scheda contatto visualizzata nella parte pubblica del sito. Si può quindi decidere che alcune informazioni relative al contatto non siano accessibili ai visitatori del sito, ma siano solamente consultabili nell'area di amministrazione di Joomla! Per ogni opzione può essere scelto Usa globali, in questo caso il valore del parametro di configurazione sarà quello impostato nella configurazione globale del componente.

Parametri Avanzati

Non c'è molto da dire. Si può scegliere se visualizzare una descrizione testuale o un'icona per ogni campo della scheda contatto che viene reso visibile sul sito web.

Parametri E-mail

Form e-mail. Per mostrare o nascondere il modulo per l'invio di e-mail al contatto.
Copia e-mail. Per mostrare o nascondere la casella di selezione che consente di inviare copia del messaggio al mittente.
E-mail bloccate. I messaggi inviati con indirizzi e-mail che contengono una o più parole inserite in questo campo verranno bloccati: le singole parole vanno separate con punto e virgola.
Oggetti bloccati. I messaggi inviati con un oggetto che contiene una o più parole inserite in questo campo verranno bloccati: le singole parole vanno separate con punto e virgola.
Parole bloccate. I messaggi che contengono una o più parole inserite in questo campo verranno bloccati: le singole parole vanno separate con punto e virgola.
Mostra captcha. Per mostrare il codice di verifica anti-spam (captcha). L'invio del modulo sarà bloccato se il visitatore non inserisce il codice corretto mostrato nell'immagine.

Se si sceglie di mostrare il codice captcha è possibile controllarne l'aspetto tramite i seguenti parametri.

Lunghezza captcha. Lunghezza in caratteri del codice.
Larghezza captcha. Larghezza in pixel dell'immagine captcha.
Altezza captcha. Altezza in pixel dell'immagine captcha.
Font captcha. Selezionare dalla lista il font TrueType da utilizzare per il codice captcha.
Dimensione font captcha. Selezionare la dimensione del font da usare per il codice captcha.
Sfondo captcha. Colore di sfondo da usare per l'immagine captcha (usare un codice esadecimale. Esempio: #c0c0c0).
Colore testo captcha. Colore da usare per il codice captcha. Valori multipli separati da virgole sono consentiti qualora si voglia un codice multicolore (Esempio: #ff0000,#0a68dd,#f65c47,#8d32fd).
Traccia linee. Se impostato a Sì linee verticali sono tracciate sopra l'immagine captcha.
Colore linee. Colore delle linee verticali.
Distanza linee. Distanza tra le linee verticali in pixel.
Traccia linee curve. Se impostato a Sì linee curve sono tracciate sopra l'immagine captcha.
Colore linee curve. Usare un codice esadecimale.

Nella stessa sezione parametri per ognuno dei 6 campi personalizzati possono essere specificati

Mostra / Nascondi il campo personalizzato. Se si sceglie di mostrarlo, il campo può essere impostato come facoltativo od obbligatorio. In quest'ultimo caso l'invio del modulo sarà impedito fino a che il campo non sia stato riempito dall'utente.
Etichetta campo
Tipo campo. Testo, textarea, checkbox, radio, lista di selezione (drop down).
Dimensione campo. Se il campo è di tipo testo questo valore viene usato per l'attributo SIZE del tag html <INPUT>. Se il campo è di tipo Textarea si devono inserire due valori, separati da punto e virgola, che saranno utilizzati rispettivamente per gli atributi ROWS e COLS del tag html <TEXTAREA>. Se non si specifica alcun valore per la dimensione, il campo sarà creato di una dimensione più o meno standard.
Ordine campo. Inserire un valore numerico che rappresenta la posizione del campo sul modulo. Più basso il valore più in alto è la posizione del campo.
Valore campo. Per i campi testo e textarea è possibile inserire un valore predefinito. Per i campi radio e lista di selezione (drop down) inserire una lista di valori separati da punto e virgola che saranno usati per generare le opzioni selezionabili dall'utente. per i campi checkbox inserire un valore singolo che sarà ricevuto dal modulo quando la checkbox è selezionata.

I campi personalizzati saranno visualizzati nel modulo e il contenuto incluso nella e-mail inviata al contatto.

Configurazione globale

Con il pulsante Preferenze si accede alla configurazione globale del componente. I valori impostati in questa schermata sono quelli utilizzati quando sulla scheda contatto si sceglie Usa globali per il parametro.

Importare contatti e categorie da com_contact

Menu QContacts -> Strumenti

I contatti e le categorie contatti già inserite nel componente standard com_contact possono essere importati in QContacts. Questa funzione deve essere essguita una sola volta o saranno creati record duplicati.

Creazione link al componente

Dalla gestione menu di Joomla! (amministrazione Menu -> Gestione menu) possono essere creati due tipi di link al componente QContacts

Layout contatto: link diretto ad una scheda di un singolo contatto.
Layout categoria contatti: link ad una pagina che mostra un elenco di tutti i contatti di una categoria. Dai parametri standard nella schermata per l'inserimento della voce di menu possono essere controllati i campi da visualizzare nell'elenco (ruolo, e-mail, telefono, cellulare, fax, indirizzo, città, provincia, codice postale, nazione). Possono essere inoltre scelti larghezza (in valore fisso o percentuale) e ordine di ciascuna colonna.