Location: PHPKode > scripts > Animus Error Catcher in PHP > readme.txt
/*******************************************************************************
*  Title: Animus Error Catcher
*  Version: 1.0 
*  Author: Jon Cohen
*  Website: http://www.animusprogramming.com
********************************************************************************
*  COPYRIGHT NOTICE
*  Copyright 2010 Jon Cohen. All Rights Reserved.
*
*  This script may be used and modified free of charge by anyone
*  provided all copyright notices and links back to animusprogramming.com 
*  remain intact.   By using this code you agree to indemnify 
*  Jon Cohen from any liability that might arise from it's use.
*
*  Selling the code for this program, in part or full, without prior
*  written consent is expressly forbidden.
*
*  Removing any of the links back to my site is sleazy, and you should feel
*  bad about doing that (I did write this program and give it to you for free, 
*  and all.)  Besides, you can always buy the professional version at 
*  http://www.animusprogramming.com/pro/ which has more functionality
*  and does not link back to my site.  Leaving the links in or paying for the 
*  script helps pay my bills, ensuring that I won't starve to death -- which 
*  means more free scripts down the road.
*******************************************************************************/

Hi there!  Thank you for downloading my script.  Here's the instructions..

1) Installation
Installation should be pretty simple, just upload the script to your root directory.
In other words, if your main page is http://www.animusprogramming.com, you would
upload the script to http://www.animusprogramming.com/errorc.php.  The script 
will create a directory named aecdqxzj, on the extremely unlikely event that you
already have a directory of that name make sure that you change your directory's
name before you upload the script.  If your FTP software gives you the choice, make 
sure that you  upload it as ASCII, not binary.  Congratulations, the install is 
complete!  Now it's time to configure the script.

2) Logging into your admin page
To log in to your admin page, simply open your favorite web browser and enter
the URL of your errorc.php file into the address window.  You should see a page
asking you for a password.  The default password is "password", without quotes.
Now that you're in, you should be able to figure out what to do, but feel free to
keep reading if you need more help.

3) Changing the password
I'd really suggest changing the password immediately, as "password" is a really,
really bad password.  To do so, scroll to the bottom of the admin page and use 
the "Change your password" form.  

4) Making the script look "right"
You have 3 basic ways to customize the look of the script.  The first is your header.
This can be entered through the "Change the header" form.  Anything that you put
in that form will be placed between the <body> tag and any HTML the script 
generates.  The second way to change the look would be with the footer form, which
works just like the header except anything you put in it will go between any HTML
that the script generates and the </body> tag.  Finally, you can use the "Change your
settings" form to change colors, use a .css file, and change the title of your links page.
While you're using the settings form, you may wish to enter your e-mail address
if you want the script to e-mail you when there is an issue.

5) Sending the script your 404s and 500s.
By now you should have the script looking like a part of your web site and protected 
with a better password than "password", it's time to start sending it your errors.  To
do this, you'll have to edit your .htaccess file.  The .htaccess file is an extremely
important file when it comes to your web site working right (not just catching errors),
so if you already have a file in your root directory named .htaccess, make sure that 
you back it up before you do anything -- that way if you have a problem, you can
always upload your backup back to your web site and fix it.

Now that you have your .htaccess file backed up, use the appropriate form in the script
to either add the lines neccesary for it to catch errors (if you already had an .htaccess
file) or create an .htaccess file (if you didn't).

6) Make sure it works.
At this point, everything should be good to go.  To test the script, simply go to a page
on your site that doesn't exist and should give a 404 -- if everything is working right,
you should see a form asking you what you were looking for and when you check your admin
page (you may have to hit reload), you should see a record of the attempt to get the
non-existant file.

7) HELP!
If you find yourself lost, go to http://www.animusprogramming.com/errorc/ and click the
help link.

8) Losing the links
The script will generate small links at the bottom of each page it creates back to my site
in order to pay for itself.  If you'd like to lose those links and help me out a bit please 
consider buying the professional version of the script at  
http://www.animusprogramming.com/pro/errorc/
Return current item: Animus Error Catcher in PHP