=== Really Simple CAPTCHA === Contributors: takayukister Donate link: http://contactform7.com/donate/ Tags: captcha Requires at least: 3.

2 Tested up to: 3.3.1 Stable tag: 1.5 Really Simple CAPTCHA is a CAPTCHA module intended to be called from other plugi ns. It is originally created for my Contact Form 7 plugin. == Description == Really Simple CAPTCHA does not work alone and is intended to work with other plu gins. It is originally created for [Contact Form 7](http://contactform7.com/), h owever, you can use it with your own plugin. Note: This product is "really simple" as its name suggests, i.e., it is not stro ngly secure. If you need perfect security, you should try other solutions. = How does it work? = Really Simple CAPTCHA does not use PHP "Sessions" for storing states, unlike man y other PHP CAPTCHA solutions, but stores them as temporary files. This allows y ou to embed it into WordPress without worrying about conflicts. When you generate a CAPTCHA, Really Simple CAPTCHA creates two files for it; one is an image file of CAPTCHA, and the other is a text file which stores the corr ect answer to the CAPTCHA. The two files have the same (random) prefix in their file names, for example, "a 7hk3ux8p.png" and "a7hk3ux8p.txt." In this case, for example, when the responden t answers "K5GF" as an answer to the "a7hk3ux8p.png" image, then Really Simple C APTCHA calculates hash of "K5GF" and tests it against the hash stored in the "a7 hk3ux8p.txt" file. If the two match, the answer is confirmed as correct. = How to use with your plugin = Note: Below are instructions for plugin developers. First, create an instance of ReallySimpleCaptcha class: $captcha_instance = new ReallySimpleCaptcha(); You can change the instance variables as you wish. // Change the background color of CAPTCHA image to black $captcha_instance->bg = array( 0, 0, 0 ); See really-simple-captcha.php if you are interested in other variables. Generate a random word for CAPTCHA. $word = $captcha_instance->generate_random_word(); Generate an image file and a corresponding text file in the temporary directory. $prefix = mt_rand(); $captcha_instance->generate_image( $prefix, $word );

Then, show the image and get an answer from respondent. Check the correctness of the answer. $correct = $captcha_instance->check( $prefix, $the_answer_from_respondent ); If the $correct is true, go ahead. Otherwise, block the respondent -- as it woul d appear not to be human. And last, remove the temporary image and text files, as they are no longer in us e. $captcha_instance->remove( $prefix ); That's all. If you wish to see a live sample of this, you can try [Contact Form 7](http://co ntactform7.com/). == Installation == In most cases you can install automatically from WordPress. However, if you install this manually, follow these steps: 1. Upload the entire `really-simple-captcha` folder to the `/wp-content/plugins/ ` directory. 1. Activate the plugin through the 'Plugins' menu in WordPress. FYI: There is no "control panel" for this plugin. == Frequently Asked Questions == = CAPTCHA does not work; the image does not show up. = Really Simple CAPTCHA needs GD and FreeType library installed on your server. As k your server administrator if they are installed. Also, make the temporary file folder writable. The location of the temporary fil e folder is managed by the instance variable `tmp_dir` of ReallySimpleCaptcha cl ass. Note that the setting varies depending on the calling plugin. For example, Contact Form 7 uses `wp-contents/uploads/wpcf7_captcha` as the temporary folder basically, but it can use different folder depending on your settings. If you have any further questions, please submit them [to the support forum](htt p://wordpress.org/tags/really-simple-captcha?forum_id=10#postform). == Screenshots == 1. screenshot-1.png == Changelog == = 1.5 = * The required WordPress version changed to 3.2 and higher. * Use plain text file as answer file (again). This time, hash value generated wi th hash_hmac() is stored in the file. = 1.4 =

* Reverted answer file to PHP. As plain text file is visible from client side, t hat's not good. = 1.3 = * Use plain text file as answer file. = 1.2 = * File name sanitization added. = 1.1 = * The required WordPress version changed to 2.8 and higher. * cleanup() method added.