FTLS.org 
Francais     English
 
 
Accueil
 
 Linux
Introduction
Liens
 
 Initiation
Internet
HTML
CGI
Perl
 
 Archives
Java
Perl Tools
Scripts CGI
       Calendar
       Counter
       SSI Counter
       Guestbook
       Form2Mail
       MTG
       Random Img
       Random Text
       Random Link
       Redirect URL
       Text Clock
       Text Counter
       WAccess
       WWWAdverts
       eRS
       eNews
       eUpload
       ewla
       CGI Utils
Scripts PHP
 
 Calculatrices
HP 48
TI 92
 
 Gratuit du Net
A Gratuit
Comparatifs
Se divertir
 
 Aide Webmasters
Trucs & Astuces
JavaScript
 
 Site
Partenaires
Contact
 
 Powered by
linux
 

cgi


WWWAdverts
Version 1.5






    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





                                                                                                                  

 
© Copyright 2000 FTLS (Tyndiuk Frédéric). All rights reserved.
Last Update 08/03/2000 - Send all comments to webmaster@ftls.org