Read Me

-----------------------------------
|    IPHPLog Fast Guide (beta)    |
-----------------------------------
Last update: 30 Dec 2009

Thanks for try to use this software!

About:
IPHPLog (IP PHP Log) is a simple software written in PHP, JS and SQL that runs over a SQL language for data management system like MySQL (at the moment, IPHPLog works only under MySQL, I'll implement this in the next versions). IPHPLog can log the information of your visitors and organize it in the data base.
You can get a lot of information organized by IP, date, hostname, browser, Operative System and more.

Author:
IPHPLog is written by Tomas Aparicio.
Currently, this is a personal project, but anyway, if you want the help me or send some improvements you can mail me via
( tomas -at- rijndael-project.com ).
Note: this is not a professional project, and, obviously, not is a professional code development.
I'm just a student of Computers System and once of my hobbies is the programming in various languages.
This is only another personal project.

Version: 
I'm working in a greater version improving the in many ways the software and will be release soon. 
Check the homepage < http://iphplog.rijndael-project.com /> for keep updated.
At the moment, this project still Alpha, therefore, you not should use it for final use, just for test it.
The code needs a lot of improvements and maybe are bugs (SQL Inyection). Please, take that into account.

Installation:

*IMPORTANTE NOTE: I detect some errors with PHP version 5.3.0 and higher versions, however,
IPHPLog can run over lower versions than 5.3.0 until I update de code. Sorry.
 
Put all the content of the compressed IPHPlog file on a webserver directory. You must be have PHP support (version 4.5.0 or greater).
Start a browser and type the path of your IPHPlog system (for example: http://localhost/iphplog)
If all runs fine, you should see the installation wizard page. If not, check if all files are correctly uncompressed into the directory.
Later, simply follow the steps of the wizard installer.

How to use:
When you are setup IPHPLog, you can start recolecting data of your different visitors making
a virtual require global function on a virtual host you want (always inside of your server).
The "get.php" script recolect the data.
A simple example:
Imagine you want recolect the data of once of your virtual host, for example myserver.net
Your web running a version of Wordpress, DotClear, Bigace CMS or any more, and this software
runs over PHP, so, you can edit the code and include inside a simple function:
Example:
open the template.php (or whatever you want)
<?php
/**
 * @package WordPress
 * @subpackage Default_Theme
 */
get_header(); ?>
	<div id="content" class="narrowcolumn" role="main">
	<?php if (have_posts()) : ?>
		<?php while (have_posts()) : the_post(); ?>
 and continue..
?>

Well, so now add the next code into the file you want to take the log:

<?php

/*--------------------------------------------------------------------------------*/
# IPHPLog Custom Script  
# Instructions of use:
# Paste this code in your web page where you want to take a log of your visitors. 
# For example, the header.php of Wordpress or another CMS. Needs PHP support.

// Set below your custom IPHPLog path inside your server. Just the IPHPLog folder.
// Remember the last slash "/"
define ('IPHPLOG_PATH','/your/custom/path/iphplog/');  
if (file_exists(IPHPLOG_PATH.'get.php')) {
	include (IPHPLOG_PATH.'get.php');
}
# End of the script
/*--------------------------------------------------------------------------------*/

/**
 * @package WordPress
 * @subpackage Default_Theme
 */

get_header(); ?>
	<div id="content" class="narrowcolumn" role="main">
	<?php if (have_posts()) : ?>
		<?php while (have_posts()) : the_post(); ?>
 and continue..
?>

Remember, always the require path should call get.php in the same server.
Not valid path like "http://iphplog.myserver.net/get.php"

This is and very fast guide to use IPHPLog. I was do with hurry and probably not be easy
for inexperienced users.
Soon I'll release a small documentation about the project.
Check the project homepage:
< http://iphplog.rijndael-project.com />
And don't forget review the code and feedback me about you think.

PS: Sorry for my English, this project is not the unique thing I need to improve