Qu'est ce que c'est ?
WWWAdverts est un système d'affichage aléatoire de bandeaux publicitaires
pour votre site Web. Les bannières sont affichées sur votre page grâce à un
appel SSI (Server Side Include) ou PHP. Vous pouvez spécifier que certaines bannières
n'apparaissent que sur certaines pages, suivant la langue du visiteur, suivant
son système d'exploitation (OS) ou en fonction de mots clés.
De plus WWWAdverts garde le nombre d'exposition / de clics pour chaque
bannière ainsi que pour l'ensemble. Il permet aussi d'autoriser l'annonceur
à voir les statistiques de son/ses bandeau(x) publicitaire(s) (protégé par mot
de passe).
Note: Le format de la base des bandeaux publicitaires a changé ainsi que
celui des fichiers de Logs, vous devez donc refaire la saisie...
Dépendances:
- Perl 4.0 ou une version plus récente; vous pouvez le trouver sur
http://www.perl.com
- Un serveur Web avec la possibilité d'ajouter/exécuter des scripts CGI.
- Optionnel un serveur Web supportant le PHP.
Télécharger la version courante :
La version en cours est la Version 1.5, crée le 05/30/98, dernière modification le 05/30/00.
Télécharger le code source / script et la documentation :
Archive Tar/Gzip : WWWAdverts.tar.gz (0 Ko)
Format Zip DOS : WWWAdverts.zip (0 Ko)
Que contient cette archive ?
Cette Archive contient différents fichiers :
- COPYING: La licence de ce programme (GPL).
- README: La doc en anglais...
- LISEZMOI: Ce fichier...
- WWWAdvertsLib.pl: Bibliothèque spécifique à WWWAdverts.
- WWWAdvertsSSI.cgi: L'aficheur de bannières.
- WWWAdvertsClicks.cgi: Le compteur de clics
- WWWAdvertsAdm.cgi: Affiche le tableau d'administration
- WWWAdverts-display.php3: L'aficheur de bannières PHP.
- cgi-lib.pl: Bibliothèque CGI-Lib (de Steven E. Brenner).
- Adverts.txt: Fichier contenant la liste des Bandeaux.
- AdvEx_Log.txt: Fichier du compteur d'exposition.
- AdvCl_Log.txt: Fichier du compteur de clics.
- password.txt: Fichier de mots de passe.
Installation et configuration:
C'est un script Perl, l'installation est simple. Vous n'avez pas besoin
de compiler quelque chose...
Copiez *.cgi et *.pl dans le répertoire /cgi-bin/
Copiez *.txt dans le répertoire data.
Rendez les exécutable (chmod a+rx *.cgi) Unix seulement...
Rendez les fichiers donnés modifiable (chmod a+rw *.txt) Unix seulement...
Pour le bon fonctionnement de ce script, vous avez quelques configurations
à faire...
Editez tous les scripts CGI (*.cgi) et changez #/usr/bin/perl,
si nécessaire...
Editez la section "Necessary Variables" de WWWAdvertsLib.pl et faites
les changements suivants :
my ($datadir) = "/Absolute/path/to/data/";# Répertoire des donnés.
Nom fichier des bannières.
$AdvertDataFile = $datadir."Adverts.txt";
Nom du fichier du compteur d'expositions.
$AdvertExLogFile = $datadir."AdvEx_Log.txt";
# Nom du fichier du compteur de clics.
$AdvertClLogFile = $datadir."AdvCl_Log.txt";
$DISPLAY_LANG = 'Fr'; # Si vous voulez que l'administration soit en français.
$EXIT_URL = '/'; # Url de retour après le clic sur le bouton exit.
$WEBMASTER_EMAIL = 'you@yourdomain.com';
Chemin du fichier de mots de passe (au format WAccess).
$PASSWORD_FILE = '/Absolute/path/to/password.txt';
Les Utilisateurs doivent être declaré Adminnistrateur dans le fichier
de mots de passe pour pouvoir changer les Bandeaux.
Login est passord universel, au cas ou vous auriez perdu le votre.
$UnivLogin = "FTLS"; # Changez le...
$UnivPassword = "www.ftls.org"; # Changez le...
Comment l'utiliser ?
Utiliser l'afficheur dans une page web:
Ajouter dans votre:
<!--#include virtual="/cgi-bin/WWWAdvertsSSI.cgi?[Opt1]&[Opt2]"-->
Options:
lg=fr : Langue (De/En/Es/Fr) force l'utilisation de la langue
spécifiée.
kw=Word : le mot clés
Utiliser l'afficher dans un script CGI:
Ajouter dans votre script:
require "WWWAdvertsLib.pl";
print &Adverts(time, $Lang, $Keyword);
time : date courant (pour initialisation du générateur aléatoire)
doit être modifie, ex (time - 1) si vous utilisez plusieurs bannière sur la meme page
sinon ca affiche la même bannière...
$Lang : force la langue
$Keyword : 1 mot cles
Utiliser le compteur de clics:
Ajouter dans le code de la bannière:
<A HREF="/cgi-bin/WWWAdvertsClicks.cgi?Value_Adverts&http://www.hostname.dom/page">Your Adverts</A>
Utiliser l'écran de statistiques annonceur:
Définissez un login et mots de passe pour chaque bandeau et utilisez
WWWAdvertsAdm.cgi en mode visiteur, si un login/mot de passe sont définis
plusieurs fois, affichera les X correspondant à ce couple.
Utiliser l'Administration:
Allez sur: WWWAdvertsAdm.cgi
ou : WWWAdvertsAdm.cgi?login=YourLogin&pass=YourPassword
Si vous voulez y acceder directement sans taper le mots de passe
à chaque fois. Le login et le mot de passe par défaut sont respectivement
admin et admin.
-> Regarder les infos affichées, y a pas besoin de description...
Juste une precision, dans les collones Expos & Clics, les informations
sont de la forme 1111 (+120), -> 1111 Expositions depuis le début, et 120
aujourd'hui...
Edition/Ajout d'un bandeau :
Nom: Nom de la bannière.
Commentaire : Ajouter des commentaires, (non affichés).
Visiteur : Définissez un identifiant et un mot de passe pour autoriser
la consultation des statistiques de cette bannière.
(Run/Stop): Si la bannière doit être affichée ou pas.
Multipl: Multiplie par X, les chances d'affichage de cette bannière.
Date début: Date de l'ajout
Date de Fin / Hist Max: Fin de l'affichage
Langue: Affiche si le visiteur est de cette langue (Seulement Fr, En,
De, Es) / All pour tous.
Langue / Mots clés: Affiche si Langue ET Mots clés / Langue OU Mots clés.
Mots clés: Affiche seulement si ce mot est comptenu dans le champs
mots clés.
OS: N'affiche la bannière que si l'utilisateur utilise cet OS.
Code Bandau: code HTML de la bannière.
Vous pouvez ajouter dans le code:
cgi-bin/WWWAdvertsClicks.cgi?Value_Adverts&DestURL'
si vous désirez compter les clics
'Value_1000Random' (Génere un nombre aléatoire entre 0-1000)
'Value_100Random' (Génere un nombre aléatoire 0-100)
'Value_10Random' (Génere un nombre aléatoire 0-10)
A utiliser si votre sponsor peut faire changer sa pub
en modifiant un nombre dans son code...
Le code %%Other%% permet de passer à une la prochaine bannière.
Utilisation de l'afficheur PHP:
Inserez le code suivant dans vos pages PHP :
<?php
require("WWWAdverts-display.php3");
display_adverts();
?>
Editez WWWAdverts-display.php3 et modifiez la variable
$data_dir = "/Absolute/path/to/data_dir/"
Histoire:
Version 1.5 30/05/00 - Mise à jour
- Ajout WWWAdverts-display.php3
- Supression du retour chariot en fin de bannière.
Version 1.3 15/01/00 - Mise à jour
- Ajout gestion multi-bannières pour 1 sponsor.
- Ajout gestion maximum de clics
- Correction d'un bug sur l'affichage des
stats pour les visiteurs sponsors.
Version 1.2 26/12/99 - Mise à jour
- Ajout gestion compte visiteurs.
- Changement du système de protection.
- Correction de quelques bugs.
Version 1.1 15/09/99 - Mise à jour
- Ajout affichage / jours.
- Ajout administration francais.
Version 1.02 ??/09/99 - Mise à jour
- Ajout gestion OS.
- Correction de bugs mineures.
Version 1.01 ??/06/99 - Non distribuée...
- Ajout gestion hits et date de fin.
- Ajout vérouillage du fichier de log.
Version 1.0 30/05/99 - Création de l'archive.
Remerciements:
Merci a Mark Sorensen, http://www.TheOpportunitySpot.com/ pour sa signalisation
de bugs et ses suggestions.
Copyright:
This software is copyright (C) 1999 Frédéric TYNDIUK. It is distributed
under the terms of the GNU General Public License (GPL). Because it is licensed
free of charge, there is NO WARRANTY, it is provided AS IS. The author can not
be held liable for any damage that might arise from the use of this software.
Use it at your own risk.
See the file COPYING for more details (or http://www.gnu.org/).
Nouvelles versions:
Les nouvelles versions ainsi que d'autres scripts sont disponibles sur:
http://www.ftls.org/fr/
Contact:
N'hésitez pas à m'envoyez un mail si vous avez des commentaires, des
suggestions, si vous trouvez des bugs, ou si vous avez des critiques, ou juste
pour me dire que vous aimez ce programme...
Si vous avez des problèmes de configuration, d'utilisation de ces
scripts, relisez ce document en premier, si vous ne trouvez pas la
solution, n'hésitez pas à me contacter...
E-Mail: tyndiuk@ftls.org
Web: http://www.ftls.org/
Frédéric TYNDIUK
