WP AuthImage Plugin (v3.0)
written by Keith McDuffee (2004-6-7)
http://www.gudlyf.com
gudlyf@realistek.com

---

CHANGELOG:

V2 of this README.TXT file by danoschmano 2004-04-26 specific to v1.5 of WordPress using Letterhead theme.

3.0 -- Much more effective (too much?) captcha generation, thanks to the
       freely available VeriWord PHP class package
       (http://www.phpclasses.org/browse/package/1768.html).  In this release,
       I've decided to forget about the phoenetic text option.  If you want
       that option, just continue to use version 2.1.1.
       Note that quite a bit has changed in this README, so if you want to
       upgrade, read this document fully.



---

INSTALLATION:

Following the directions below with the included files should allow you to
add authorization image checking for comments posted on your site.  It displays
an image with a random word from a supplied list that the commenter has to enter in order for
their comment to go through.  This should cut down on any bots out there from
spamming your comments area and perhaps remove the need for comment moderation.

NOTE: It's important to make the indicated changes to BOTH the regular AND the
popup versions of the comment pages.  If you don't do that, spammers may
perhaps find a way to target the unedited version of the page.

----
1. Put the file "authimage.php" and the directory "authimage-inc" in your WP
   plugins directory. Rename 'authimage-hacks.php' to 'my-hacks.php' and upload it to the root WordPress directory (or append to it if it already exists).
   
   Read about my-hacks.php at:   http://wiki.wordpress.org/my-hacks.php (if you are interested).

----
2. Look for this in your theme's 'comments.php' and/or 'comments-popup.php':

COULDN'T FIND THIS LINE (maybe because I am using Letterhead theme?) -- danoschmano <label for="url"><?php _e("<acronym title=\"Uniform Resource Identifier\">URI</acronym>"); ?></label>

BUT FOUND THIS SERIES INSTEAD

	<p>
	  <input type="text" name="url" id="url" value="<?php echo $comment_author_url; ?>" size="28" tabindex="3" />
	   <label for="url"><?php _e("<acronym title=\"Uniform Resource Identifier\">URI</acronym>"); ?></label>
	</p>

  and add this after it:

<p>
          <input type="text" name="code" id="code" value="<?php echo ""; ?>" size="28" tabindex="4" />
          <label for="code"><?php _e("Enter this code: "); ?></label>
          <img src="<?php global $authimage; echo $authimage; ?>" width="155" height="50" alt="authimage" />
</p>



  Also, replace this line:
  
<form action="<?php echo get_settings('siteurl'); ?>/wp-comments-post.php"
method="post" id="commentform">

  with this line:

<form action="<?php echo get_settings('siteurl'); ?>/wp-comments-post.php"
method="post" id="commentform" onSubmit="return testValues(this)">


----
3. In 'wp-comments-post.php' (located in the root directory):

  Find this line:
  
$comment_content      = $_POST['comment'];

  and add this after it:

$comment_code         = $_POST['code'];  // AuthImage

  
  
  Also, find this line:

if ( '' == $comment_content )
        die( __('Error: please type a comment.') );

  and add this after it:

// AuthImage
if ( !checkAICode($comment_code) )
        die( __('Error: please enter the valid authorization code.') );


----
4. Activated the AuthImage plugin in the WordPress control pannel.


----
5. Enable the 'my-hacks.php legacy support from the WordPress control panel under Options >> Miscellaneous.


----
6. You can configure lots of how the captcha image appears by editing the
   'authimage-inc/veriword.ini' file.  Read the PDF documentation at
   'authimage-inc/manualveriword.pdf' for a list of options.  You can also
   alter the dictionary used to generate words as well as the length of
   the word generated.


----
7. If you want to validate the email address, edit the plugin and uncomment
   the code that checks for email.  That's it! -- I HAVE NO IDEA WHAT THIS IS TALKING ABOUT.




   

REQUIREMENTS -- If you are interested (THESE ARE SUPPORTED BY 1AND1 -- danoschmano):

This hack assumes the following for your blog.  Anything else is up to
the user to hack for their own use.  These are the only reqs that have been
fully tested up to this point.

- WordPress (http://wordpress.org/) version 1.2 or above (includes 1.5).
- Apache 1.3 or above running on Linux.
- PHP 4 or above.
- GD library (http://www.boutell.com/gd/) and Freetype library
  (http://www.freetype.org/) for PHP.  See http://us2.php.net/gd for more
  information.
- Some sort of shell access to your web server.

You can test your version of PHP for GD and Freetype with the following
commands "from a shell":

    php -i | grep "GD Support"

should return:

<tr><td class="e">GD Support </td><td class="v">enabled </td></tr>

and:

    php -i | grep "FreeType Support"

should return:

<tr><td class="e">FreeType Support </td><td class="v">enabled </td></tr>