Oggi vi presento un plugin per CMS Made Simple sviluppato per un mio progetto. L’unica funzione di questa estensione consiste nel fornire due metodi sicuri per inserire in chiaro indirizzi email nelle vostre pagine. Il primo utilizza un plugin di jQuery (jQuery.mailto) mentre il secondo è un pò più radicale e si limita a generare un immagine in PNG con l’indirizzo email inserito.
Questo plugin è utile quando volete mettere a disposizione dei vostri utenti la possibiilità di visualizzare in chiaro gli indirizzi di contatto magari collegando al template il plugin via smarty in questo modo:
{content block=’email’ oneline=’true’ assign=’email’}
{mailtoSecure mail=$email}
Come si installa?
Il plugin per funzionare utilizza anche jQuery (nel caso vogliate utilizzare il modo ‘js’) e un suo plugin quindi ho incluso anche la cartellina js che vede essere inserita sulla root del sito (o dove vi pare ma in questo caso dovrete cambiare i path con i quali richiamate i js nel template). Il plugin vero e proprio va copiato dentro la cartella plugin.
Come si usa?
È sufficiente inserire nella pagina/template:
[sniplet secure1]
Di default il plugin è in modalità js e per avere la visualizzazione corretta è necessario includere nel template il framework jQuery e il suo plugin jquery.mailto.
<script type=”text/javascript” src=”js/jquery-1.3.2.min.js”></script>
<script type=”text/javascript” src=”js/jquery.mailto.js”></script>
{literal}
<script type=”text/javascript”>
$(document).ready(function() {
$(‘a.email’).mailto();
});
</script>
{/literal}
Quali parametri sono disponibili?
- email – l’indirizzo email che si intende inserire.
- (opzionale) class – string, un eventuale classe da associare al link generato (o all’immagine nel caso si scelga la generazione dell’immagine). Di default la classe è email (nel caso la si cambi in modalità js è necessario ricordarsi di cambiare la classe anche nel codice js.
- (opzionale) messaggio – string, permette di impostare un messaggio da visualizzare nel caso non sia inserito il paramentro email (utile nel caso vogliate impostare un campo content block nel template per permettere agli utenti di inserire la email
- (opzionale) mode – string, permette di scegliere la modalità di generazione. È disponibile “js” o “image”, di default js. La modalità “image” è ancora abbozzata, funziona ma ha dei limiti nella customizzazione. E’ possibile scegliere il formato (png,jpg,gif), il path di salvataggio dell’immagine generata, il colore dello sfondo e quello del testo ma non il font e la sua dimensione.
- (opzionali) width e height – int, inserire le dimensioni dell’immagine generata (default altezza 20px, larghezza 250px)
- (opzionale) path - string, inserire il path in cui salvare le immagini generate (di default: uploads/images/)
- (opzionale) color e bgColor - string, inserire il valore esadecimale per ciascun parametro (di default colore nerro su sfondo bianco).
Esempio:
[sniplet secure2]
Potete scaricare la prima versione del plugin da qui: secureMailto
Lascia un commento