Location: PHPKode > scripts > Animus Comments > readme.txt
/*******************************************************************************
*  Title: Animus Comments
*  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
Create a directory for the script to run in with whatever name you want and set its permissions to 755 (read/write/execute for owner, read/execute for group and public). Upload all the files in the zip to that directory.  Congratulations, the script is now installed.


2) Logging into your admin page
To log in to your admin page, simply open your favorite web browser and enter the URL of the comments.php file you just uploaded 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) Configuring the script the way that you want it
Scroll down to the "Change your settings" and read the options.  This form can be can be used to change the colors that the script uses, or simply have it use a CSS file.  Additionally, you can use this form to set the number of comments you'll allow on any single page, allow or disallow people to post anonymously, turn the human verification features on or off, and turn the language filter on and off.  Everything is written in plain English, so you shouldn't have any issues.

5) Adding a header and footer
Use the "Change the header" and "Change the footer" forms to add HTML to the top or bottom of the script pages.  This can be used to make the script look like the rest of your web site so that people don't feel that they've left your web site when they enter a comment.

6) The Language filter
If you've turned the language filter on in the "Change your settings" form, you can use the "Add to the language filter" to add words that you'd like filtered out and the "Edit or delete the language filter dictionary" to remove or edit words that you're filtering.  Be warned that this is just a simple find and replace, so you probably don't want to get carried away here.

7) Restricting the script to certain domains
Due to how the script is written, it can be used to add comments to any page that you control regardless of what web server it is on.  If you'd like to restrict this, you can use the "Add approved domains" to add domains that you want the script to be able to run on and the "Remove approved domains" to remove them.  Note that if you have no domains on the list, the script will allow itself to be run on any web page.

8) Making your comments look right
You can use the "Change the format for your comments" form to adjust the look of comments that are left.  You have 4 basic formats the the script will use, one for highly rated comments that should be more visible, one for average comments, one for poorly rated comments, and one for extremely poorly rated comments.  This uses raw HTML.

9) Adding comments to your page
Towards the top of the admin page, you'll see the "Add comments to a page" form which contains a gray box with some HTML in it.  Simply copy/paste the HTML into whatever page you want wherever you want to add a comments form.

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

11) 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/comments/ .  Note that the professional version of thescript also has the ability to send you an e-mail whenever someone leaves a comment, making it much easier to keep an eye on it.
Return current item: Animus Comments