Footerbanner con jQuery per le campagne pubblicitarie

Il footerbanner è uno strumento di advertising basato su un div posizionato staticamente in fondo alla pagina. Questa versione è basata su jquery ^[1] e richiede il plugin jquery.cookie ^[2] come requisito primario. L’implementazione è semplice e non richiede più di qualche minuto per la personalizzazione.

E’ possibile visualizzare la demo dello script in questa pagina ^[3].

Prima di tutto apriamo il file jquery.footerbanner.js e modifichiamo le variabili principali:

/****************************/
/*	CONFIGURATION	            */
/****************************/
var fb_defaults = {
	fb_pagesdir	        : 'http://www.sito.it/advertising/jquery.footerbanner',
	fb_cssurl		: 'http://www.sito.it/advertising/jquery.footerbanner/css',
	fb_imgdir		: 'http://www.sito.it/advertising/jquery.footerbanner/img',
	fb_closetime	: '30 sec',
	fb_cookielife	: '20 min',
	fb_advpage		: 'footerbanner.htm',
	fb_advwidth	: '99.9%',
	fb_advheight	: '60px',
	fb_id			: 'fb',
	fb_fadefx		: 'y',
	fb_speedfx		: 'fast',
	fb_showborder	: 'y',
	fb_closebutton	: 'y',
	fb_closepos_t	: '0',
	fb_closepos_l	: '0',
	fb_maindomain	: 'n',
	fb_alignment	: 'c',
	fb_mbottom	: '0',
	fb_imgname	: 'fb_close.png',
	fb_maxscreen_w	: '920'
};
// set array to hide (visibility=hidden) some elements which may contain flash stuff
fb_hide_elem = new Array();
// set array to hide (display=none) some elements which may contain flash stuff
fb_none_elem = new Array();
// set main domain if you have some subdomains in the same site
fb_site_cookname = new Array();
/****************************/
/*	END CONFIGURATION       */
/****************************/

Analizziamo ogni singolo parametro:

• fb_pagesdir

  Indica l’URL assoluto che porta alla cartella in cui avete caricato i file del footerbanner. Nessuno slash finale.

• fb_cssurl

  Indica l’URL assoluto alla cartella in cui sono contenuti i fogli di stile. Nessuno slash finale.

• fb_imgdir

  Indica l’URL assoluto alla cartella in cui è contenuta l’immagine del bottone di chiusura. Nessuno slash finale.

• fb_closetime

  E’ il tempo di chiusura automatica del footerbanner. Sono ammesse le seguenti unità di tempo: “sec“, “min“, “hou“, “day” rispettivamente per secondi, minuti, ore e giorni. Es.: “30 sec”.

• fb_cookielife

  E’ il tempo che deve intercorrere tra una visualizzazione e l’altra del footerbanner. Sono ammesse le seguenti unità di tempo: “sec“, “min“, “hou“, “day” rispettivamente per secondi, minuti, ore e giorni. Es.: “20 min”.

• fb_advpage

  E’ la pagina (html, php, asp, etc) contenente il codice della campagna advertising. Deve essere posizionata nella cartella definita precedentemente da “fb_pagesdir“.

• fb_advwidth

  Indica la lunghezza che dovrà avere il footerbanner. E’ necessario includere l’unità di misura come ad esempio ‘%’ o ‘px’. Se esprimete la lunghezza in percentuale consiglio di non inserire 100% ma 99.9%. Questo per evitare la comparsa di scrollbar orizzontali con alcuni browser (a meno che non impostiate una regola css specifica per l’overflow ovviamente.)

• fb_advheight

  Indica l’altezza che dovrà avere il footerbanner. E’ necessario includere l’unità di misura. Ad esempio % o px.

• fb_id

  E’ un prefisso identificativo del cookie. Se viene utilizzato un footerbanner alla volta basta lasciarlo così altrimenti è necessario personalizzarlo ad ogni chiamata. Successivamente verrà spiegato come fare.

• fb_fadefx

  Se impostato su “y” verrà visualizzato un effetto “fade” sul footerbanner. L’alternativa è “n”.

• fb_speedfx

  Se viene attivato l’effetto “fade” potete scegliere la velocità di esecuzione. Possibili parametri: “slow” e “fast”.

• fb_showborder

  Mostra o meno un bordo intorno al footerbanner. Possibili parametri: “y” e “n”.

• fb_closebutton

  Mostra o meno il bottone di chiusura sul footerbanner. Possibili parametri: “y” e “n”.

• fb_closepos_t

  Indica la distanza del bottone dal margine superiore del footerbanner (in pixel). Vanno inseriti solo numeri senza unità di misura.

• fb_closepos_l

  Indica la distanza del bottone dal margine sinistro del footerbanner (in pixel). Vanno inseriti solo numeri senza unità di misura.

• fb_maindomain

  Normalmente dovrebbe essere lasciato su “n”. Viene impostato su “y” quando è necessario visualizzare lo stesso footerbanner su siti di terzo livello appartenenti allo stesso dominio.
  Un esempio chiarirà meglio la situazione. Si supponga di avere http://www.sito.it e http://terzo.sito.it. Impostando la variabile su “n” ed inserendo un footerbanner in ciascuno dei due siti, al primo caricamento l’utente vedrà entrambi gli annunci senza che il cookie del primo influenzi la visualizzazione del secondo. Viceversa mettendo la variabile su “y”, il cookie dato all’utente al caricamento del primo annuncio varrà anche per il secondo sito.

• fb_alignment

  Indica l’allineamento del footerbanner. Se la lunghezza non raggiunge il totale della pagina possiamo decidere l’allineamento a sinistra piuttosto che centrato. Possibili valori “c” oppure “l”.

• fb_mbottom

  Permette di impostare un margine inferiore alla pagina quando viene chiuso il banner. Vanno inseriti solo numeri senza unità di misura. Di norma può essere lasciato a zero.

• fb_imgname

  Indica il nome dell’immagine per il bottone di chiusura. L’immagine viene cercata all’interno del percorso impostato con la variabile “fb_imgdir”.

• fb_maxscreen_w

  Indica la lunghezza minima che deve avere la risoluzione dell’utente per poter visualizzare il footerbanner. Supponiamo di impostare un valore pari a 800. Tutti i browser con risoluzione dello schermo inferiore a questo valore non vedranno la campagna pubblicitaria. Inserire solo numeri senza unità di misura!

Questo per quanto riguarda le variabili principali. Rimangono 3 array da poter personalizzare in base alle necessità:

• fb_hide_elem = new Array();

  Indica gli ID degli elementi html che devono essere nascosti al caricamento del footerbanner. Ad esempio un div, o un qualsiasi altro contenitore di filmati flash, potrebbe creare problemi di visualizzazione. Per risolvere basta inserire gli ID di quegli elementi che vogliamo momentaneamente nascondere. Torneranno visibili alla chiusura della campagna pubblicitaria. Es.: new Array(‘elem1′,’wrapper’);

• fb_none_elem = new Array();

  Simile al parametro precedente tranne per il fatto che viene utilizzata la direttiva “display” al posto di “visibility“. Ciò significa che gli elementi inseriti in questo array verranno nascosti e modificheranno “lo spazio” nella pagina. Torneranno visibili alla chiusura della campagna pubblicitaria. Es.: new Array(‘elem1′,’wrapper’);

• fb_site_cookname = new Array();

  Facciamo un passo indietro e torniamo alla variabile “fb_maindomain“. Se impostata su “y” è necessario inserire i domini per cui far valere il cookie. Nell’esempio precedente è stato fatto il caso di due siti: “http://www.sito.it” e “http://terzo.sito.it”. In questo caso basta inserire il dominio di secondo livello “sito.it” nell’array (senza www o altro prefisso).

L’opera di personalizzazione è terminata. Passiamo alla fase di inserimento del codice. Per prima cosa richiamiamo i javascript necessari nell’head della pagina:

<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="jquery.cookie.js"></script>
<script type="text/javascript" src="jquery.footerbanner.js"></script>

Le prime due righe, come è evidente, caricano il framework “jquery” e il plugin “jquery.cookie”. L’ultimo script, invece, è il footerbanner.

Subito dopo inseriamo la chiamata alla funzione principale:

<script type="text/javascript">
$(document).ready(function() {
	$().footerbanner();
});
</script>

Visto che abbiamo personalizzato il codice direttamente nel file “jquery.footerbanner.js“, è stato possibile inserire solamente il nome della funzione senza parametri.

Supponiamo, invece, di voler utilizzare footerbanner diversi nello stesso sito. Possiamo sovrascrivere le variabili di default, impostate precedentemente, in questa maniera:

<script type="text/javascript">
$(document).ready(function() {
	$().footerbanner({
		fb_advheight: '180px',
		fb_closetime: '5 sec',
		fb_advwidth: '100%',
		fb_cookielife: '5 sec',
		fb_id:'foot1'
	});
});
</script>

In questa maniera otteniamo l’importante risultato di poter attivare footerbanner diversi ed indipendenti (nel cookie, nella pagina da richiamare, nelle opzioni, etc) richiamando sempre e solo gli stessi file javascript. Possiamo inserire e sovrascrivere tutte le variabili viste in precedenza.

Il codice è stato testato sui più diffusi browser in circolazione e non dovrebbero esserci problemi di compatibilità.

Download

Il pacchetto .zip contiene tutti i file necessari (compresi jQuery ed il plugin jquery.cookie). Per scaricare lo script cliccate sul link: Saibal jQuery Footerbanner ^[4]