=== Captcha ===
Contributors: simplywordpress
Tags: captcha, capcha, security, spam blocker, simple captcha, antispam, protection, text captcha, captcha numbers, captcha plugin, web form protection, captcha protection
Requires at least: 3.9
Tested up to: 4.9.1
Stable tag: 4.4.5
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html


#1 super security anti-spam captcha plugin for Wordpress forms.



== Description ==

The Captcha plugin allows you to implement a super security captcha form into web forms. It protects your website from spam by means of math logic, easily understood by human beings. You will not have to spend your precious time on annoying attempts to understand hard-to-read words, combinations of letters or pictures that make your eyes pop up. All you need is to do one of the three basic maths actions - add, subtract and multiply.
This captcha can be used for login, registration, password recovery, comments forms.






= Translation =

* Arabic (ar_AR) (thanks to Albayan Design Hani Aladoli)

* Bangla (bn_BD) (thanks to [SM Mehdi Akram](mailto:[email protected]), www.shamokaldarpon.com)

* Belarusian (bel) (thanks to [Natasha Diatko](mailto:[email protected]))

* Brazilian Portuguese (pt_BR) (thanks to [Breno Jacinto](mailto:[email protected]), www.iconis.org.br)

* Bulgarian (bg_BG) (thanks to [Nick](mailto:[email protected]))

* Catalan (ca) (thanks to [Psiete](mailto:[email protected]))

* Chinese (zh_CN) (thanks to [TIM(mailto:[email protected])], [Jack Chen](email: mailto:[email protected]), www.jackchen.im)

* Taiwan (zh_TW) (thanks to [Kaiconan](mailto:[email protected]))

* Croatian (hr) (thanks to [Daniel](mailto:[email protected]))

* Czech (cs_CZ) (thanks to [Michal Kučera](mailto:[email protected]) www.n0lim.it)

* Danish (da_DK) (thanks to Byrial Ole Jensed)

* Dutch (nl_NL) (thanks to [Bart Duineveld](mailto:[email protected]))

* Estonian (et) (thanks to Ahto Tanner)

* Greek (el) (thanks to Aris, www.paraxeno.net)

* Farsi/Persian (fa_IR) (thanks to [Mostafa Asadi](mailto:[email protected]), www.ma73.ir, [Morteza Gholami](mailto:[email protected]))

* Finnish (fi) (thanks to Mikko Sederholm)

* French (fr_FR) (thanks to Martel Benjamin, [Capronnier luc](mailto:[email protected]))

* German (de_DE) (thanks to Thomas Hartung, [Lothar Schiborr](mailto:[email protected]))

* Hebrew (he_IL) (thanks to Sagive SEO)

* Hindi (hi_IN) (thanks to [Outshine Solutions](mailto:[email protected]), www.outshinesolutions.com)

* Hungarian (hu_HU) (thanks to [Peter Aprily](mailto:[email protected]))

* Japanese (ja) (thanks to Foken)

* Indonesian (id_ID) (thanks to [Nasrulhaq Muiz](mailto:[email protected]), www.al-badar.net)

* Italian (it_IT) (thanks to [Marco](mailto:[email protected]))

* Latvian (lv) (thanks to [Juris O](mailto:[email protected]))

* Lithuanian (lt_LT) (thanks to [Arnas](mailto:[email protected]))

* Norwegian (nb_NO) (thanks to Tore Hjartland)

* Polish (pl_PL) (thanks to Krzysztof Opuchlik)

* Portuguese (pt_PT) (thanks to [João Paulo Antunes](mailto:[email protected]))

* Romanian (ro_RO) (thanks to Ciprian)

* Russian (ru_RU)

* Serbian (sr_RS) (thanks to Radovan Georgijevic)

* Slovak (sk_SK) (thanks to Branco Radenovich)

* Slovenian (sl_SI) (thanks to [Uroš Klopčič](mailto:[email protected]), www.klopcic.net)

* Spain (es_ES)

* Swedish (sv_SE) (thanks to Christer Rönningborg, [Blittan](mailto:[email protected]))

* Tagalog (tl) (thanks to [Roozbeh Jalali](mailto:[email protected]), www.languageconnect.net)

* Turkish (tr_TR) (thanks to Can Atasever, www.canatasever.com)

* Ukrainian (uk)

* Vietnamese (vi_VN) (thanks to NDT Solutions)







== Installation ==

1. Upload the `captcha` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin via the 'Plugins' menu in WordPress.
3. Plugin settings are located in "Captcha".



== Frequently Asked Questions ==



= Why the CAPTCHA is missing in the comments form? =



The Captcha by SimplyWordpress.net plugin displays the CAPTCHA for those comments forms which were written in the same way as comments forms for the standard WordPress themes.



Unfortunately, the plugin is incompatible with comments forms generated by using SAAS (eg: Disqus or JetPack comments forms).



If you don't use SAAS comments forms, please follow the next steps:



1. Using FTP, please go to {wp_root_folder}/wp-content/themes/{your_theme}.

2. Find and open `comments.php` file. It is possible that the file that is used to display the comment form in your theme called differently or comment form output functionality is inserted directly in the other templates themes (eg single.php or page.php). In this case, you need to open the corresponding file.

3. Make sure that the file contains one of the next hooks: `do_action ( 'comment_form_logged_in_after' )`, `do_action ( 'comment_form_after_fields' )` or `do_action ( 'comment_form' )`. If you didn't find one of these hooks, then put the string `<?php do_action( 'comment_form', $post->ID ); ?>` in the comment form.



= I would like to add Captcha to the custom form on my website. How can I do this? =



1. Install the Captcha plugin and activate it.

2. (Optional) If you want to use own settings for your custom forms (for example, for your contact and sign up forms), please follow steps below:



a. Open "functions.php" file of your theme in the edit mode;

b. Add the following lines to the end of the file:



`function add_my_forms( $forms ) {

    $forms['form_slug']   = "Form Display Name";

    $forms['form_2_slug'] = "Form 2 Display Name";

    return $forms;

}

add_filter( 'cptch_add_form', 'add_my_forms' );`



Please don't use the next form slugs since they are predefined by plugin settings: general, wp_login, wp_register, wp_lost_password, wp_comments, bws_contact, bws_subscriber, buddypress_register, buddypress_comments, buddypress_group, cf7_contact, woocommerce_login, woocommerce_register, woocommerce_lost_password, woocommerce_checkout.



c. Save file changes;

d. Go to the "Settings" tab on the plugin settings page (Admin Dashboard -> BWS Panel -> Captcha);



If everything is OK, you will see new tabs with labels which you specified in the "cptch_add_form_tab" hook call function.



e. Switch to new tabs and configure form options on them as you need;

f. Click "Save changes";



In case when you don`t want to use own settings for displaying the CAPTCHA in your custom form, the settings from "General Options" tab from the plugin settings page will be used.



3. Open the file with the form (where you would like to add CAPTCHA);

4. Find a place to insert the code for the CAPTCHA output;

5. Insert the following lines:



`<?php echo apply_filters( 'cptch_display', '', 'my_contact_form' ); ?>`



In this example, the second parameter is a slug for your custom form. If you don`t use the custom form settings (see point 2 of this instructions) you can leave it empty:



`<?php echo apply_filters( 'cptch_display', '' ); ?>`



6. After that, you should add the following lines to the function of the entered data checking:



`<?php $error = apply_filters( 'cptch_verify', true );

if ( true === $error ) { /* the CAPTCHA answer is right */

    /* do necessary action */

} else { /* the CAPTCHA answer is wrong or there are some other errors */

    echo $error; /* display the error message or do other necessary actions in case when the CAPTCHA test was failed */

} ?>`



If there is a variable in the check function responsible for the errors output, you can concatenate variable $error to this variable. If the 'cptch_verify' filter hook returns 'true', it means that you have entered the CAPTCHA answer properly. In all other cases, the function will return the string with the error message.





= Can I move the Captcha block in the comment form? =



It depends on the comments form. If the hook call by means of which captcha works (after_comment_field or something like this) is present in the file comments.php, you can change captcha positioning by moving this hook call.



Please find the file 'comments.php' in the theme and change position of the line `do_action( 'comment_form_after_fields' );` or any similar line - place it under the Submit button.

In case there is no such hook in the comments file of your theme, then, unfortunately, this option is not available.





== Screenshots ==

1. Login form with Captcha.

2. Registration form with Captcha.

3. Lost password form with Captcha.

4. Comments form with Captcha.

5. Contact form with Captcha.

6. Captcha Basic Settings page.

7. Captcha Basic Settings page ("Notification Messages" options block).

8. Captcha Whitelist.




== Changelog ==
= V4.4.5 - 12.12.2017 =
* Update :URL change to fit the t&c of wordpress
* Update :Rollback of version 4.4.4 to faster version
* Update :Security issue fixed

= V4.3.6 - 18.09.2017 =
* Update : Fix last version issues
* Update : Contact Form7 integration issue with newer version resolve.

= V4.3.5 - 06.09.2017 =
* Update : Fix last version issues
* Update : Captcha + Contact Form7 integration.

= V4.3.4 - 02.09.2017 =
* Update : Fix last version issues
* Update : Custom form issue
* Update : Fix last version issues

= V4.3.3 - 30.08.2017 =
* Update : Fix last version issues

= V4.3.2 - 30.08.2017 =
* Update : Captcha + Contact Form7 integration.
* Update : fixed- Bug image captcha last update

= V4.3.1 - 10.07.2017 =
* Update : The plugin settings page has been updated.

= V4.3.1 =
* Appearance improved.