Introduzione
PhpAds è la soluzione per quei siti medio/grandi che necessitano di un sistema di rotazione banner indirizzato per ogni pagina del sito. Ad esempio in un area di Programmazione si possono visualizzare solo i banner dei nostri clienti che hanno un sito di Programmazione; oppure possiamo scegliere se visualizzare i banner in html o i banner normali. Rappresenta anche un'ottima scelta per piccoli siti che usano più servizi di scambio banner (tipo Bpath) e vogliono utilizzarli tutti nel proprio sito.
La documentazione è esauriente, mentre il supporto non sembra molto aperto a commenti e piccoli aiuti. Comunque, superate le difficolta iniziali nell'utilizzo, questo script si rivela utile e potente.
Configurazione dello Script
Per prima cosa scompattare il file in una directory.
A questo punto editare il file config.inc.php3 impostando i seguenti parametri:
$phpAds_hostname = "localhost";
Inserire il nome del server MySQL, generalmente localhost.
$phpAds_mysqluser = "root";
Inserire il nome utente di accesso al server MySQL.
$phpAds_mysqlpassword = "";
Inserire la password di accesso al server MySQL.
$phpAds_db = "phpads";
Inserire il nome del database da usare.
$phpAds_tbl_xxxxx = "xxxxx";
Indica il nome delle tabelle da usare all'interno del database; è utile usare un prefisso se si vuole usare questo script per più siti, ma usando lo stesso database.
$phpAds_url_prefix = "http://www.server.com/phpAds";
URL della directory di installazione di phpAds, in genere del tipo www.tuosito.it/phpAds.
$phpAds_insert_delayed = false;
Permette di abilitare (true) o disabilitare (false) la funzione di INSERT DELAYED.
$phpAds_language = "italian";
Da qui puoi selezinare il linguaggio da usare per l'interfaccia di phpAds. Sono disponibili "english", "italian", "czech", "german", "polish", "spanish".
$phpAds_log_adviews = true;
Abilita (true) o disabilita (false) il log delle visualizzazioni.
$phpAds_log_adclicks = true;
Abilita (true) o disabilita (false) il log dei click.
$phpAds_admin = "tobias";
Il nome utente dell'amministratore; di default viene usato tobias ma si possono scegliere username come "admin", "root", etc.
$phpAds_admin_pw = "justdoit";
La password dell'amministratore; si consiglia di cambiarla rispetto a quella di default.
$phpAds_admin_fullname = "Your phpAds Adminstrator";
Il nome completo dell'amministratore (usato quando vengono mandate le statistiche via mail).
$phpAds_admin_email = "phpAdsAdmin@htmlwizard.net";
L'email dell'amministratore (usata per settare il campo "DA" quando viene mandata una email).
$phpAds_admin_email_headers = "From: $phpAds_admin_email n";
Intestazione dell'email per il rapporto giornaliero sulle statistiche.
$phpAds_name = "phpAds";
Il nome di questa applicazione.
$phpAds_ignore_hosts = array(); // Example: array("slashdot.org", "microsoft.com");
Indirizzi Host da ignorare (non vengono contate le viusalizzazioni provienti da questi host).
$phpAds_reverse_lookup = true;
Abilita (true) o disabilita (false) il "reverse DNS" su host remoti.
Installazione sul Server
Adesso basta carica i file sul server e inserire il proprio nome utente e password per accedere all'area di amministrazione dei banner. Il link al quale dovrete accedere sarà del tipo http://www.tuohost.it/phpAds/index.php3 sia per voi (l'amministratore) sia per i vostri clienti che potrano (una volta che gli avrete fornito nome utente e password) controllare le statistiche relative al proprio banner.
L'area di amministrazione
Qui spiegheremo come l'amministratore dovrà utilizzare l'interfaccia per gestire i banner.
Una volta fatto il login ci comparirà un menu con le seguenti opzioni:
Aggiungi nuovo utente
Se non hai ancora inserito un utente, devi inserirne subito almeno uno.
Modifica utente
Permette di modificare i dati relativi ad un utente.
Cancella utente
Permette di cancellare un utente.
Amministrazione Banner
Permette di inserire uno o più banner per un utente.
I banner possono essere in locale, remoto oppure in html.
Mettere un parola chiave relativa al banner per permettere le visualizzazioni specifiche.
Visualizza statistiche dell'utente
Permette di vedere le statistiche dei banner per ogni utente.
In pratica questa è la pagina che vede un cliente quando fa il login.
Total AdViews
Visualizzazioni Totali.
Total AdClicks
Click Totali.
Utilizzo dello Script
Per utilizzare invece lo script all'interno delle vostre pagine dovrete, dapprima includere in ogni pagina (che utilizza tale script) i file config.inc.php3, view.inc.php3 e acl.inc.php3, successivamente dovrete utilizzare la funzione view() che viene spiegata di seguito:
Sintassi - int view (mixed what [, int clientID [, string target [, bool withText = 0[, array context]]]]);
- L'argomento what, può essere uno dei seguenti:
-
- "[int]": Visualizza il banner con questo BannerID. Esempio: view(1);
- "[larghezza]x[altezza]": Visualizza casualmente uno tra i banner con queste dimensioni. Esempio: view("468x60");
- "html": Visualizza in maniera casuale un Banner-HTML.
- "[keyword]": Visualizza in maniera casuale un banner con queste Parole-Chiave. Esempio: view("argument");
I banner con Parola-Chiave global associata, saranno consideratti per ogni argomento.
- L'argomento opzionale clientID permette di selezionare solamente i banner di un cliente specifico. Specifica 0 per vedere i banner di tutti i clienti (devi esplicitare questo argomento se vuoi usare i prossimi due argomenti).
- L'argomento opzionale target permette di specificare un frame target.
Puoi scegliere tra: "[nomeframe]", "_blank", "_parent" e "_top". - L'argomento opzionale withText permette di abilitare (1) o disabilitare (0) la visualizzazione dei banner con associata una linea di testo sotto di essi.
- L'argomento opzionale context è un array che specifica i banner ai quali limitarsi o i banner da escludere dalla ricerca. L'array può contenere più array associativi. Le chiavi da usare sono "==" per specificare un banner al quale la ricerca è limitata oppure "!=" per denotare un banner da escludere nella ricerca. Il valore da inserire è l'ID del banner, che si può ottenere anche dando ad una variabile il valore della funzione "view()" usata precedentemente.
Utilizzo remoto dello Script
Si può inoltre utilizzare phpAds su siti che non hanno il supporto PHP. Banner casuali o prestabiliti possono essere visualizzati usando il costrutto standard <IMG>, utilizzando l'argomento what per selezionare il banner. Per usare più banner in una singola pagina, seleziona un nome univoco per ogni banner ed assegnagli l' "n"simo argoment sia per "click.php3" che per "phpads.php3".
<a href="click.php3"><img src="phpads.php3?what=468x60&n=ban1"></a>
Visualizza un banner in maniera casuale della dimensione 468x60.
<a href="click.php3?n=top"><img src="phpads.php3?what=main&n=top"></a>
Visualizza un banner in maniera casuale dal gruppo "main" con il nome "top".
<a href="click.php3?n=left"><img src="phpads.php3?what=468x60&n=left"></a>
Visualizza un banner in maniera casuale delle dimensioni 468x60 con il nome "left".
La configurazione è finita e anche se è abbastanza complessa lo script alla fine funziona egregiamente e permette un alto grado di configurabilità nelle pagine.
