                                                     http://www.onlinetools.org/          

-=| Disclaimer |=---------------------------------------------------------------

This script is part of and was dowloaded from http://www.onlinetools.org/ .
It was written by Chris Heilmann and the author does not take any responsibility
for any possible damage the usage of it can cause. 

This script can be used free for personal use, any commercial use requires the 
consent from the author. Please contact me for any commercial use, via the 
contact form on the homepage http://www.onlinetools.org/

-=| The script |=---------------------------------------------------------------

This script is delivered in two flavours:

1) Plain vanilla  (scripname_dev.php)

This is the developer version of the script, it is intended for people who know
about PHP and can change and set variables (in the top part of the script) 
without breaking it (for example by not quoting "). 
There is no extra information on this one on its homepage, rather than bugfixes
and new versions. 

This version causes less traffic on the server but is not as maintainable and 
skin-able as the other one is. 

This version only needs the datafile (scriptname.txt) to run. 

2) Chocolate Chunks (scriptname.php)

This is the user version of the script, it is intended for people who know 
how to create proper (x)HTML but don't want to touch PHP. 
This version of the script is dependent on two other files, which get included. 
It is a bit more traffic consuming than the plain vanilla one.

These files are:

template.html and config.xml

The template.html is a very simple HTML file, this is the look and feel of the
outcome of the script. 
It is not only HTML but contains variables indicated by %...% around their 
names. These variables will be replaced by the real content when the script 
loads the template. 
You can read what the variables represent in the info to the script and its 
infopage within onlinetools.org.
The template.html only contains the look and feel of the script and not the 
logic, this means these scripts are actually "skin-able". 
By changing the template you can give them a new look. 
Sometimes the script gets delivered with different "skins" to choose from. 

The config.xml file contains all the variables you can set to make the script 
behave differently. I chose XML to store this data, as its easy to read for 
people and the data comes with it's  explanation around it. 
Information on all the elements in the xml and what changing them does to the 
script can be found in the info to the script and its infopage.

-=| Installing the script |=----------------------------------------------------

To install this script simply unzip its content and upload all of it to your 
server. 
!!! Important !!!
Make sure that the .txt file can be changed and written to. You do this by
setting the file permissions to read/write/execute all, either by ticking these
properties in a ftp client or using the UNIX command 

chmod 777 scriptname.txt 

(on linux/unix machines of course). 

Calling the script

-=| Executing the script |=-----------------------------------------------------

This is a PHP script, there are several ways to execute it. First of all make
sure that your server DOES support PHP. 

You do that by opening a file in fe. Textpad (or VI :-) ) and type 

<? phpinfo() ?>

then you save this file as test.php and upload it to your server.

"Surf" to it and it displays all information about your installed PHP, if you
just see the stuff you typed in, you have to install PHP first. For doing 
that, please refer to the PHP page or PHPbuilder, loads of help there. The 
links are at the end of this readme.

Now, when you see the information about your PHP, you can go further...

1) Embedding the script in an own HTML

	Say you have this HTML page
	
	mepage.html:
	
	<html>
		<head>
			<title>Welcome to me homepage</title>
		</head>
		<body>
			Found a wicked script:<br><br>
		</body>
	</html>
	
	and one of the scripts here:
	
	wickedscript.php:
	
	<?
		/*
			Easywicked
		*/
		echo "oy, you are using: $HTTP_USER_AGENT";
	?>
	
	copy the PHP into the HTML and save both with the extension "php":
	
	mepage.php
	
	<html>
		<head>
			<title>Welcome to me homepage</title>
		</head>
		<body>
			Found a wicked script:<br><br>
				<?
					/*
						Easywicked
					*/
					echo "oy, you are using: $HTTP_USER_AGENT";
				?>
		</body>
	</html>
	
	If you now "surf" to this page, it displays the user's browser ident string.

2) Calling the script from another php:

	mepage.php:
	
	<?
	 if ($ultrasecretpw=="password"){
	 	echo "Wow, you ARE worthy, check diz:";
		include("wickedscript.php")
	 }
	 if ($display=="wow"){
	 	echo "hey a display!";
	 }
	?>

3) Linking to it from an html page:
	
	mepage.html:
	
	<html>
		<head>
			<title>Welcome to me homepage</title>
		</head>
		<body>
			Found a wicked script:<br><br>
			<a href="mepage.php">Click here to see this wicked script</a>
		</body>
	</html>

	you can also send parameters to it using ? and &
	
	mepage.html:

	<html>
		<head>
			<title>Welcome to me homepage</title>
		</head>
		<body>
			Found a wicked script:<br><br>
			<a href="mepage.php?ultrasecretpw=password&display=wow">
			Click here to see this wicked script</a>
		</body>
	</html>

4) Using it as a form action

	mepage.html:

	<html>
		<head>
			<title>Welcome to me homepage</title>
		</head>
		<body>
			<form action="mepage.php">
				Password<input type="password" name="ultrasecretpw">
				Display
					<select name="display">
						<option name="wow">WOW</option>
						<option name="duh">DUH</option>
					</select>
				<input type="submit" value="hit me!">
			</form>
		</body>
	</html>

That's about all the magic it takes, for more info about embedding and using
PHP stick to the homepage or some of the help pages.

-=| Dazed? Confused? Lonely? |=-------------------------------------------------

If you still have problems with this script, make sure you read all the extra
information on the information page of onlinetools.org. It might be that there
is a new version of this out, that has exactly the feature you need. 

Use the forum advertised on onlinetools.org http://1216.rapidforum.org/ for any
question, as others should also be able to follow your problem (or even answer
it for us!).

Sign up for the newsletter, newest bugfixes will be signalled there. 

Get a decent host for your webpage (hint, there are some ads on onlinetools.org
and I did not put them there to earn my living)

Check some of the links below for help about PHP itself.

Please do only contact me personally for information about commercial use of 
these scripts or for telling me how great I am. Or both. Or when you know me 
personally. Or when I asked you to. Or when you have THE job for me (for money).
Or when you are a (female) supermodel who always wanted to date me. Or, well, 
I suppose you get the drift.

If you post in the forum, show patience as well, I do try to answer things ASAP
but sometimes I have to do my real job as well...

-=| More reading |=-------------------------------------------------------------

http://www.onlinetools.org/ 	-> where this came from
http://www.php.net/  			-> The motherload, all of it
http://conf.php.net/ 			-> Presentation slides by Rasmus himself
http://www.phpbuilder.net 		-> Very active forum (guess who is active 
								   there as well)
http://www.thickbook.com/		-> Very good book on PHP and great tutorials
http://www.webmonkey.com/		-> Eeek Eeek !

                                                                     Cheers, 
                                                                          Chris
															
-----------------------------------------------------------=| +++ no carrier |=-
	