      _______                          .__ .__   .__   .__                 
      \      \    ____   __ __ _______ |__||  |  |  |  |__|  ____    ____  
      /   |   \ _/ __ \ |  |  \\_  __ \|  ||  |  |  |  |  | /  _ \  /    \ 
     /    |    \\  ___/ |  |  / |  | \/|  ||  |__|  |__|  |(  <_> )|   |  \
     \____|__  / \___  >|____/  |__|   |__||____/|____/|__| \____/ |___|  /
    =========\/======\/=================================================\/==
  v0.01 04/JUL/2007 (C) Copyright 2007-2007 Scott D. Yelich SOME RIGHTS RESERVED
 .,-*~'`^`'~*-,._.,-*~'`^`'~*-,._.,-*~'`^`'~*-,._.-*~'`^`'~*-,._.,-*~'`^`'~*-,. 



This is the "INSTALL" file for the Neurillion free web page counter "unique" v1 
http://www.neurillion.com/p/33/counters/unique/v1/INSTALL

The software is released under Creative Commons - Attribution 3.0 unported 
see: http://creativecommons.org/licenses/by/3.0/legalcode

This counter requires sqlite3 to be available.  Although it's possible
to include the single amalgamated sqlite3.h file and compile, the
current configuration uses sqlite3 as a library.  A version after v1
will have details on using the amalgamated sqlite3.h file to compile.

As with the other v1 counters, the name of the database needs to be
edited directly in the code (Unique.cpp).  Remember -- both the file
and the directory must be writable by the process running the counter.
This counter uses two tables, by default, so I gave it a different
initial name from the other counters.  The other counts all use the
same database -- this one could put the totals into that DB and just
use another DB for the hits, but I didn't want to go between multiple
databases.  Perhaps in a version after v1, I'll split those two tables
between multiple databases.

The counter source is in the "src" sub directory.  There is a unix
makefile in the directory.  It will compile the component classes and
link the final program for you.

After the program has compiled successfully, the resulting binary
needs to be put into a location where it may be executed via a URL.
Please refer to your web server manual for information on how to
enable this.

Finally, put the call into the HTML page(s):

  <img border=0 src="http://site.com/path/to/counterprog?period">

I don't provide a period in the demo page, so I get only unique visitors
overall (of course, based on IP).

A version after v1 will have the ability to use a cookie instead of
the IP.


Enjoy!

Scott
