#               -------------
#                  WEBFLUX 1.0
#               -------------
#               Access log
#
#         File: webflux.pl webflux.html webflux.swf webflux.fla log.pl webflux.gif
#  Description: Show how the surfeur navigate on your web.
#               Permet de voir comment les surfeur passe sur votre site.
#       Author: LAINE Pierre-jean - DAHU.FR
#        Email: dahu@dahu.fr
#          Web: http://www.webcorp.tv
#      Version: 1.0
#
# Copyright 2004-2006 DAHU.FR   All Rights Reserved.
#

TABLE OF CONTENTS
    1. Welcome
        1.1 Copyright Notice
        1.2 About the Script
        1.3 System Requirements        
    2. Installation
        2.1 Quick Install
    3. Problems
    4. Revision History

1. Welcome
====================================================

1.1 COPYRIGHT NOTICE:
----------------------------------------------------



Commercial use must register the script for a one time fee of 35 $. 
With registration you receive 10 days of email tech support, free upgrades
within the version number. 

Selling the code for this program, or a program derived from Links, without 
prior written consent is expressly forbidden. Similarly, redistributing
this program, or a program derived from Links, over the Internet, CD-Rom 
or any other medium is expressly forbidden without prior written consent. 
By using this program you agree to indemnify DAHU.FR from any liability.
    


1.2 About the Script
----------------------------------------------------
Webflux is a log access viewer. 
You can mark multiple web pages with an image tag that call the script and log.
Webflux analyse it and show you where you lose traffic. 


1.3 System Requirements
----------------------------------------------------
Links requires the following:

    * A working copy of Perl 5 (might have problems on versions less then
      5.002).
    * A basic understanding of both Perl and CGI.
    * FLASH PLAYER 8



2. Installation
----------------------------------------------------


 Install:

1- Edit log.pl and replace 

print "Location: http://www.yourdomain.com/webflux.gif \n\n";

by the url of you picture (may a transparent 1x1 gif)

2- Upload log.pl in your cgi-bin directory and chmod it 755

3- Create a "log" directory where all log file will be generated and chmod it 777

4- Edit webflux.pl and replace 

my $logPath="../log/"; 

with your log directory just created. 

5 - Upload "webflux.pl" and chmod it 755

6 - edit webflux.txt and replace the correct url of you webflux.pl file 

7 - upload webflux.html, webflux.swf, traffic.as in the same directory


ADDING MARK ON YOUR PAGE 


<script language="Javascript">
<!--
document.write("<IMG src=\"http://www.arthur-bouline.com/cgi-bin/log.pl?e="+ Math.round (Math.random () * 1000000000000000)+"\" border=0>" );
//-->
</script>

 
  9.Surf a little bit on your web and go to http://......./webflux.html



 Warnings:

     Webflux show by default the analyse of the current day.
 
     All the log files are put in the "log" directory: Be aware of the size. 

     We don't know the CPU charge of an analyse. Be carefull if you try a year
     analyse. 

     There is a flock use for log.pl , try to disable it if it doesn't work on Window. 

     Webflux is provided "AS IS" without warranty of any kind, either express or
     implied, including but not limited to the implied warranties of
     merchantability and fitness for a particular purpose. In no event shall
     DAHU.FR be liable for any damages whatsoever including direct,
     indirect, incidental, consequential, loss of business profits or special
     damages, even if DAHU.FR has been advised of the possibility of
     such damages.


    
4. Problems
====================================================
* 500 Server Errors.
I've tried to remove as much chance of 500 server errors as possible. If you still 
get one check the following:

   - Did you upload/ftp the file up in ASCII mode?
   - Is the path to Perl right? (#!/usr/local/bin/perl)
   - Is the path to Perl to a version of perl5?
   - Are the file set to the right permissions?
   
500 server errors are 99% of the time caused by: File uploaded in BINARY mode, or
path to perl is wrong or goes to perl version 5.


Remember: Please be careful with the script as it does create 
files and other potentially hazardous stuff. 

Good Luck!

LAINE Pierre-jean
Dahu.fr



=======================================================================================   
TRADUCTION EN FRANCAIS DE L'INSTALLATION

=======================================================================================  



 Le programme
----------------------------------------------------

Webflux est un analyseur de log. 
Vous pouvez marquer plusieurs pages web avec une balise image qui appel le programme et logue. 
Webflux analyse ce log


 Systeme Requis
----------------------------------------------------
Links requires the following:

    * Perl 5 (might have problems on versions less then
      5.002).
    * XML::TWIG installé sur le serveur
    * Un minimum de connaissance en Perl et CGI.
    * FLASH PLAYER 7



 Installation
----------------------------------------------------


 Install:

1- Editer log.pl et remplacer:

print "Location: http://www.yourdomain.com/webflux.gif \n\n";

par l'url de votre image (un gif transparent de 1x1 )

2- Uploader log.pl dans votre repertoire cgi-bin et chmod en 755

3- Créer un repertoire "log" où tous les fichiers log seront générés et chmod en 777

4- Editer webflux.pl et remplacer 

my $logPath="../log/"; 

Avec le chemin du repertoire "log" que vous venez de créer. 

5 - Uploader "webflux.pl" dans le repertoire cgi-bin et chmod en 755

6 - Editer webflux.txt et remplacer avec l'adresse correcte de votre fichier webflux.pl 

7 - uploader webflux.html, webflux.swf, traffic.as dans le même repertoire (autre que cgi-bin)


Ajouter des mouchards sur vos pages 

<script language="Javascript">
<!--
document.write("<IMG src=\"http://www.YOURDOMAIN.com/cgi-bin/log.pl?e="+ Math.round (Math.random () * 1000000000000000)+"\" border=0>" );
//-->
</script>

 
  9.Surfer un peu sur votre site et allez sur http://......./webflux.html



 Warnings:

Webflux montre par défaut l'analyse du jour courant.
 
Tous les fichiers log sont dans le repertoires prévu à cet effet: attention à la taille !

Il y a un flock pour log.pl , essayez de le désactiver si cela ne marche pas sous windows. 






    

EURL DAHU.FR 
335 rue Charles Cabaud
73290 MOTTE SERVOLEX - FRANCE