=== MyCaptcha ===
Contributors: andre renaut
Donate link: don't forget to rate this plugin !
Tags: Comment, comments, Spam, Anti-spam, Captcha, Wordpress, Plugin, Cryptograph,Post, posts
Requires at least: 2.5
Tested up to: 2.5
Stable tag: 2.5.0.2

Allows you to display a captcha on your comment form to avoid spam.

== Description ==

**Allows you** to display a captcha on your comment form to avoid spam.

**Several** choices of captcha style plus a random option.

**Look and Feel** totally compliant with Wordpress 2.5 

**Requires** GD php extension. 

Supported languages : English, French	(.pot provided)

Tested on Firefox2, Internet Explorer 7, Safari 3.1 (Windows XP)

== Installation ==

###First ! & Important Stuff !###

1. **Add** the following code at the **FIRST** line of your favorite theme(s) 'single.php' file(s) :
<em>

`<?php 
//
	if (class_exists('MyCaptcha')) 
	{
		$MyCaptcha->initialize();
	} 
//
?>`

</em>
1. **Add** the following code in your favorite theme(s) 'comment.php' file(s) (usually before the comment textarea) :
<em>

`<?php
	if (class_exists('MyCaptcha')) 
	{
			global $MyCaptcha;
?>
		Enter this code   <!-- or any text that fits you -->
		<?php $MyCaptcha->comment_form(); ?><br>
		<input type="text" name="securitycode" id="securitycode" size="30" />
<?php
	}
?>`

</em>
###Installing The Plugin###

**Extract** all files from the ZIP file, making sure to keep the file structure intact, and then upload it to   /wp-content/plugins/  .

This should result in the following file structure:

`- wp-content
    - plugins
     	  - MyCaptcha
            | MyCaptcha.php
            | readme.txt
            | screenshot-1.jpg
            | screenshot-2.jpg
            | screenshot-3.jpg

            - lang
                 | MyCaptcha.pot
                 | MyCaptcha-fr_FR.po
                 | MyCaptcha-fr_FR.mo

            - php
                 | settings.php

                 - crypt
                      | cryptographp.php
                      | cryptographp.fct.php
                      | cryptographp.inc.php

                      - cfg
                          - bluesky
                          - colornumber
                          - default
                          - frenchcancan
                          - gray
                          - paradise
                          - pencil
                          - xcolor

                      - fonts
                          | Alanden_.ttf
                          | Batavia_.ttf
                          | Bragga.ttf
                          | bsurp___.ttf
                          | ELECHA__.TTF
                          | JOKEWOOD.ttf
                          | LCD-BOLD.ttf
                          | lucon.ttf
                          | luggerbu.ttf
                          | php fonts.php
                          | RASCAL__.TTF
                          | SCRAWL.TTF
                          | WAVY.TTF`

All   MyCaptcha/php/crypt/cfg/"sub-folders"   should have the following structure (here with 'bluesky' folder).

`- bluesky
      | bluesky.zip
      | cryptographp.cfg.php
      | exemple.png
      | lisezmoi.txt
      | readme.txt 			(we read this for you, part of cryptographp library)

      - fonds 				(optionnal, 'fonds' means 'background' in french)`

**See Also:** ["Installing Plugins" article on the WP Codex](http://codex.wordpress.org/Managing_Plugins#Installing_Plugins)

**Visit** your admin area and activate the plugin. 

###Settings > MyCaptcha###

* Save your settings ...

* Enjoy !

== Frequently Asked Questions ==

= Is it possible to extend the library of captchas ? =

In the folder MyCaptcha/php/crypt/cfg/default , you will find 4 more folders (blackwhite, classic, psychedelic, small).
Some of these styles are not in the original config because they are using licensed fonts (#) that cannot be provided by this plugin.

* blackwhite is using (#)arial font (line 73 of cryptographp.cfg.php) 

* classic is using (#)verdana font (line 73 of cryptographp.cfg.php)

* small is using (#)times font (line 73 of cryptographp.cfg.php)

* psychedelic is using luggerbu and looks ugly for me (line 69 of cryptographp.cfg.php)

You may have already paid for these **licensed fonts if they are genuine with your computer or your softwares.

so to install one or several new styles do as follow

**For each style** 

1. copy the folder (blackwhite,classic, ...) to   MyCaptcha/php/crypt/cfg   .
1. copy the 'MyCaptcha style' requested font file in the MyCaptcha/php/crypt/fonts folder. (you should find it on your computer)
1. in MyCaptcha/php/crypt/fonts check and/or modify 'php fonts.php' file accordingly.

**Once you've finished** to install all your styles, edit MyCaptcha.php (main plugin file)

The line 15 of this file ( $this->ver = '2.5'; ) should be modified in ( $this->ver = '2.50000001'; )

if you have to repeat this operation don't forget to increment $this->ver.

**If every thing was done** by the book, you should have the MyCaptcha setting panel modified accordingly.

= Is it possible to delete captcha styles from the library ? =

1. READ the previous question and its answer,
1. Replace the **For each style** all steps by the following step :
      * Delete the appropriate Captcha folder in MyCaptcha/php/crypt/cfg 
1. Don't forget to increment $this->ver.

== Screenshots ==

1. Settings form
2. Sample of presentation with default Wordpress theme ('paradise' Captcha)
3. Sample of presentation with default Wordpress theme ('gray' Captcha)

== Log ==

 **2.5.0.2**     		2008/04/20 independant from folder name plugin

 2.5.0.1     		2008/04/17 display bug for random option in settings

 2.5		     		2008/04/17 first release


== Next features ==

**Any new idea** or **code improvement** can be posted at : contact@nogent94.com