=== Google Captcha (reCAPTCHA) by BestWebSoft ===
Contributors: bestwebsoft
Donate link: https://bestwebsoft.com/donate/
Tags: anti-spam security, antispam, recaptcha, captcha, captha, Invisible reCaptcha, Invisible captcha, Invisibl reCaptcha, comment, cpatcha, google catcha, Invisible re captcha
Requires at least: 3.9
Tested up to: 4.8.1
Stable tag: 1.31
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Protect WordPress website forms from spam entries with Google reCaptcha.

== Description ==

Google Captcha (reCaptcha) plugin is an effective security solution that protects your WordPress website forms from spam entries while letting real people pass through with ease.  It can be used for login, registration, password recovery, comments, popular contact forms, and other.

Users are required to confirm that they are not a robot before the form can be submitted. It's easy for people and hard for bots.

[View Demo](https://bestwebsoft.com/demo-for-google-captcha/)

http://www.youtube.com/watch?v=qwHsW3IJ7gQ

= Free Features =

* Add Google Captcha (reCAPTCHA) to:
	* Registration form
	* Login form
	* Reset password form
	* Comments form
	* [Contact Form](https://bestwebsoft.com/products/wordpress/plugins/contact-form/?k=56575444122cff9ab3ee3e640efb001a)
	* Custom form
* Hide Google Captcha (reCAPTCHA) for the whitelisted IP addresses
* Validity check of keys in admin panel
* Available Google Captcha (reCAPTCHA) themes for:
	* Version 1
		* Red (default)
		* White
		* Blackglass
		* Clean
	* Version 2
		* Light (default)
		* Dark
* Hide Google Captcha (reCAPTCHA) in comments form for certain user roles
* Supports Google Captcha (reCAPTCHA):
	* Version 1
	* Version 2
	* Invisible reCAPTCHA
* Add custom code via plugin settings page
* Compatible with latest WordPress version
* Incredibly simple settings for fast setup without modifying code
* Detailed step-by-step documentation and videos
* Multilingual and RTL ready

> **Pro Features**
>
> All features from Free version included plus:
>
> * Compatible with:
> 	* Contact Form 7 (since v 3.4)
> 	* [Subscriber](https://bestwebsoft.com/products/wordpress/plugins/subscriber/?k=e6d1742fcf1806a39afac207f7920cf3)
> 	* Multilanguage
> * Compatible with WooCommerce:
> 	* Login form
> 	* Register form
> 	* Lost password form
> 	* Checkout billing form
> * Compatible with BuddyPress:
> 	* Registration form
> 	* Comments form
> 	* Create a Group form
> * Select Google Captcha (reCAPTCHA) language manually
> * Change size: normal or compact (for version 2)
> * Configure all subsites on the network
> * Get answer to your support question within one business day ([Support Policy](https://bestwebsoft.com/support-policy/))
>
> [Upgrade to Pro Now](https://bestwebsoft.com/products/wordpress/plugins/google-captcha/?k=c4f2e3054fdbaca8a2b61554cbb9638c)

If you have a feature suggestion or idea you'd like to see in the plugin, we'd love to hear about it! [Suggest a Feature](https://support.bestwebsoft.com/hc/en-us/requests/new)

= Documentation & Videos =

* [[Doc] Installation](https://docs.google.com/document/d/1-hvn6WRvWnOqj5v5pLUk7Awyu87lq5B_dO-Tv-MC9JQ/)
* [[Doc] Purchase](https://docs.google.com/document/d/1EUdBVvnm7IHZ6y0DNyldZypUQKpB8UVPToSc_LdOYQI/)
* [[Video] Installation Instruction](http://www.youtube.com/watch?v=RUJ9VwZLFSY)
* [[Video] Purchase, Installation & Configuration](https://www.youtube.com/watch?v=X-ccRdEFcM0)

= Help & Support =

Visit our Help Center if you have any questions, our friendly Support Team is happy to help - <https://support.bestwebsoft.com/>

= Translation =

* Czech (cs_CZ) (thanks to [Michal Kučera](mailto:kucerami@gmail.com), www.n0lim.it, [PaMaDeSSoft](mailto:info@pamadessoft.cz), www.pamadessoft.cz)
* Russian (ru_RU)
* Spanish (es_ES)
* Ukrainian (uk)

Some of these translations are not complete. We are constantly adding new features which should be translated. If you would like to create your own language pack or update the existing one, you can send [the text of PO and MO files](http://codex.wordpress.org/Translating_WordPress) to [BestWebSoft](https://support.bestwebsoft.com/hc/en-us/requests/new) and we'll add it to the plugin. You can download the latest version of the program for work with PO and MO [files Poedit](http://www.poedit.net/download.php).

= Recommended Plugins =

* [Updater](https://bestwebsoft.com/products/wordpress/plugins/updater/?k=f47f3eb3d739725d592249dbd129f7ff) - Automatically check and update WordPress website core with all installed plugins and themes to the latest versions.
* [Contact Form](https://bestwebsoft.com/products/wordpress/plugins/contact-form/?k=56575444122cff9ab3ee3e640efb001a) - Allow customers to reach you using secure contact form plugin any website must have.
* [Subscriber](https://bestwebsoft.com/products/wordpress/plugins/subscriber/?k=e6d1742fcf1806a39afac207f7920cf3) - Add email newsletter sign up form to WordPress posts, pages and widgets. Collect data and subscribe your users.
* [Multilanguage](https://bestwebsoft.com/products/wordpress/plugins/multilanguage/?k=e48e145002e4b2472e568a81d171b888) - Translate WordPress website content to other languages manually. Create multilingual pages, posts, widgets, menus, etc.

= Credits =

* lib/recaptchalib.php - Copyright © 2007. Mike Crawford, Ben Maurer (reCAPTCHA - <http://recaptcha.net>). All Rights Reserved.

== Installation ==

1. Upload the `google-captcha` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin via the 'Plugins' menu in WordPress.
3. Plugin settings are located in "BWS Panel" > "Google Captcha".
4. Create a form in post and insert the shortcode [bws_google_captcha] into the form.

[View a Step-by-step Instruction on Google Captcha (reCAPTCHA) Installation](https://docs.google.com/document/d/1-hvn6WRvWnOqj5v5pLUk7Awyu87lq5B_dO-Tv-MC9JQ/)

http://www.youtube.com/watch?v=RUJ9VwZLFSY

== Frequently Asked Questions ==

= How to get Google Captcha (reCAPTCHA) keys? =

Follow the next steps in order to get and enable Google Captcha (reCAPTCHA) protection using the official Google Captcha keys:
1. Open your Wordpress admin dashboard.
2. Navigate to the plugin Settings page.
3. Click the "Get the API Keys" link.
4. Enter your domain name and click "Create Key" button.
5. You will see your public and private keys. Copy them and paste to the appropriate fields on plugin Settings page.
6. Save changes.

= How to hide Google Captcha in Comments for registered users? =

You should go to the Settings page and select the roles, for which you want to hide Google Captcha. Then you must click "Save Changes" button.

= Is it possible to Change the appearance and style of the Google Captcha (reCAPTCHA)? =

Follow the next steps in order to change the appearance of the Google Captcha:
1. Open your Wordpress admin dashboard.
2. Navigate to the plugin Settings page.
3. Select ReCaptcha version.
4. Find the "Theme" option (only available for versions 1 and 2) and select the necessary style from the drop-down list.
5. Save changes and check the result.

= Google Captcha (reCaptcha) not displayed on my comment form. Why? =

You might have a theme where "comments.php" is coded incorrectly. Wordpress version matters.
(WP2 series): Make sure that you theme contains a tag &lt;?php do_action('comment_form', $post-&gt;ID); ?&gt; inside the file /wp-content/themes/[your_theme]/comments.php.
Most WP2 themes already have it. The best place to put this tag is before the comment text area, you can move it up if it is below the comment text area.
(WP3 series): WP3 has a new function comment_form inside of /wp-includes/comment-template.php.
Your theme is probably not up-to-date to call that function from "comments.php".
WP3 theme does not need the code line do_action('comment_form'… inside of /wp-content/themes/[your_theme]/comments.php.
Instead it uses a new function call inside of "comments.php": &lt;?php comment_form(); ?&gt;
If you have WP3 and captcha is still missing, make sure your theme has &lt;?php comment_form(); ?&gt;
inside of /wp-content/themes/[your_theme]/comments.php (please check the Twenty Ten theme’s "comments.php" for proper example).

= How can I change the location of Google Captcha (reCAPTCHA) in the comments 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.

= How to add Google Captcha (reCaptcha) plugin to a custom form on my Wordpress website? =

Follow the next steps in order to add Google Captcha (reCaptcha) to a custom form on your Wordpress website:
1. Install the Google Captcha plugin and activate it.
2. Open the file (PHP or HTML) with the form (where you would like to add Google Captcha to).
3. Insert the following lines to display the Google Captcha.

For PHP:

`if( function_exists( 'gglcptch_display' ) ) { echo gglcptch_display(); } ;`

For HTML:

`&lt;?php if( function_exists( 'gglcptch_display' ) ) { echo gglcptch_display(); } ; ?&gt;`

If you have followed all steps, but the problem remains, we can help you to configure your Google Captcha custom form. This will be a paid service since there are a lot of different custom forms and the code should be inserted individually into each of them, so we need some time to study each unique case.

= I have some problems with the plugin's work. What Information should I provide to receive proper support? =

Please make sure that the problem hasn't been discussed yet on our forum (<https://support.bestwebsoft.com>). If no, please provide the following data along with your problem's description:
- The link to the page where the problem occurs
- The name of the plugin and its version. If you are using a pro version - your order number.
- The version of your WordPress installation
- Copy and paste into the message your system status report. Please read more here: [Instruction on System Status](https://docs.google.com/document/d/1Wi2X8RdRGXk9kMszQy1xItJrpN0ncXgioH935MaBKtc/)

== Screenshots ==

1. Login form with Google Captcha (reCAPTCHA).
2. Registration form with Google Captcha (reCAPTCHA).
3. Lost password form with Google Captcha (reCAPTCHA).
4. Comments form with Google Captcha (reCAPTCHA).
5. Contact Form with Google Captcha (reCAPTCHA).
6. The form with Google Captcha (reCAPTCHA) version 1.
7. The form with Google Captcha (reCAPTCHA) dark theme.
8. Google Captcha (reCAPTCHA) Settings page.
9. Google Captcha (reCAPTCHA) Whitelist page.

== Changelog ==

= V1.31 - 21.08.2017 =
* Update : The plugin settings page has been updated.

= V1.30 - 18.05.2017 =
* Update : The Spanish language file has been updated.

= V1.29 - 27.04.2017 =
* NEW : Invisible reCAPTCHA version has been added.
* Update : The Czech language file has been updated.

= V1.28 - 14.04.2017 =
* Bugfix : Multiple Cross-Site Scripting (XSS) vulnerability was fixed.

= V1.27 - 26.10.2016 =
* NEW : Ability to hide Google Captcha (reCAPTCHA) for whitelisted IP and ability to set whitelist notification.
* PRO : Compatibility with WooCommerce plugin has been added.
* PRO : List of reCAPTCHA languages updated.

= V1.26 - 15.08.2016 =
* Update : Hook's priority was changed for displaying captcha in the registration form.
* Update : Compatible with JetPack.

= V1.25 - 15.07.2016 =
* Update : BWS panel section was updated.

= V1.24 - 27.06.2016 =
* Update : Functionality to use Captcha with Contact Form Multi was updated.
* Update : BWS Panel section is updated.

= V1.23 - 19.04.2016 =
* NEW : Ability to test entered site key and secret key.
* NEW : Ability to add custom styles.

= V1.22 - 25.02.2016 =
* NEW : The Czech language file has been added.
* UPDATE : Functionality of plugin`s scripts adding has been changed so that they will be added only on pages where the CAPTCHA will be displayed.
* Bugfix : The bug with displaying several reCAPTCHA`s blocks on the same page in different forms has been fixed.
* Bugfix : The bug with definition of JS function on() has been fixed.

= V1.21 - 10.12.2015 =
* NEW : A button for Google Captcha (reCAPTCHA) shortcode inserting to the content was added.
* NEW : The Farsi/Persian language file was added.
* NEW : The French language file was added.

= V1.20 - 02.10.2015 =
* Update : Textdomain was changed.

= V1.19 - 28.08.2015 =
* Bugfix : We fixed the bug with Google Captcha (reCAPTCHA) version 2 working in PHP version lower than 5.3.

= V1.18 - 26.08.2015 =
* NEW : Ability to restore default settings.
* Update : BWS Menu was updated.
* Update : We updated all functionality for wordpress 4.3.

= V1.17 - 29.06.2015 =
* Bugfix : We fixed the bug with checking captcha in custom login form\register form\lost password form.

= V1.16 - 18.05.2015 =
* Bugfix : We fixed the bug with checking captcha when deleted 'recaptcha_widget_div'.
* Bugfix : We fixed the bug with using deprecated jQuery methods (thanks to Junio Vitorino, github.com/juniovitorino).
* NEW : The Arabic language file is added.
* NEW : The German language file is added.
* NEW : The Hindi language file is added.
* Update : We updated all functionality for wordpress 4.2.2.

= V1.15 - 09.04.2015 =
* Bugfix : We fixed the bug with captcha check for users from the list of exceptions.

= V1.14 - 07.04.2015 =
* Bugfix : Captcha work with comments forms with disabled javascript was fixed.
* Bugfix : Check reCaptcha v2 in PHP version 5.6 and above was fixed.
* NEW : The Italian language file is added.

= V1.13 - 13.02.2015 =
* Bugfix : We fixed the vulnerability when entering the dashboard.
* NEW : The Greek language file is added.

= V1.12 - 20.01.2015 =
* NEW : The Bulgarian language file is added.
* Update : We added the check of the "allow_url_fopen" option in PHP settings.
* Update : We added style for forms that use captcha v2.

= V1.11 - 30.12.2014 =
* Update : New Google Captcha (reCAPTCHA) version is added.
* Bugfix : We fixed the bug with displaying Google Captcha (reCAPTCHA) on the multisite register form.
* Bugfix : We fixed the bug with multilanguage plugin.
* Update : We updated all functionality for wordpress 4.1.

= V1.10 - 26.11.2014 =
* Update : We updated url and key names for Google Api.

= V1.09 - 14.11.2014 =
* Bugfix : We fixed the bug with joint displaying Google reCaptcha and Captcha.
* Bugfix : We fixed the bug with wrong answers in custom forms.
* Bugfix : We fixed the bug with login redirect.

= V1.08 - 14.10.2014 =
* New : The Spanish language file is added.
* Bugfix : Bug with multisite was fixed.
* Bugfix : Bug with user`s login was fixed.
* Bugfix : Bug when Contact Form submit was fixed.

= V1.07 - 02.09.2014 =
* New : The Chinese (Traditional) language file is added.

= V1.06 - 07.08.2014 =
* Bugfix : Security Exploit was fixed.
* Bugfix : The display of private key in the front-end was removed.

= V1.05 - 21.07.2014 =
* Bugfix : Problem with submitting form with Google Captcha (reCAPTCHA) is fixed.

= V1.04 - 18.07.2014 =
* Bugfix : Problem with displaying Google Captcha (reCAPTCHA) in Contact Form Pro (by BestWebSoft) is fixed.
* New : The Brazilian Portuguese language file is added.

= V1.03 - 06.06.2014 =
* New : The Polish language file is added.
* New : The Ukrainian language file is added.
* New : Renew captcha automaticly if was entered wrong value (thanks to Yaroslav Rogoza, github.com/rogyar).
* Update : We updated all functionality for wordpress 3.9.1.
* Bugfix : Problem with checking captcha for sites with https was fixed.

= V1.02 - 03.04.2014 =
* Update : Screenshots are updated.
* Update : BWS plugins section is updated.
* Bugfix : Plugin optimization is done.

= V1.01 - 05.02.2014 =
* Bugfix : The bug with adding comments from admin panel was fixed.
* NEW : "Settings", "FAQ", "Support" links were added to the plugin action page.
* NEW : Links on the plugins page were added.

= V1.0 =
* NEW : Ability to add Google Captcha (reCAPTCHA) into standard forms was added.

== Upgrade Notice ==

= V1.31 =
* Appearance improved.

= V1.30 =
* Languages updated.

= V1.29 =
* Functionality expanded.
* Languages updated.

= V1.28 =
* Bugs fixed.

= V1.27 =
* New features added.
* Functionality improved.

= V1.26 =
* Bugs fixed.

= V1.25 =
Usability improved.

= V1.24 =
Functionality to use Captcha with Contact Form Multi was updated. BWS Panel section is updated.

= V1.23 =
Ability to test entered site key and secret key. Ability to add custom styles.

= V1.22 =
The Czech language file has been added. Functionality of plugin`s scripts adding has been changed so that they will be added only on pages where the CAPTCHA will be displayed. The bug with displaying several reCAPTCHA`s blocks on the same page in different forms has been fixed. The bug with definition of JS function on() has been fixed.

= V1.21 =
A button for Google Captcha (reCAPTCHA) shortcode inserting to the content was added. The Farsi/Persian language file was added. The French language file was added.

= V1.20 =
Textdomain was changed.

= V1.19 =
We fixed the bug with Google Captcha (reCAPTCHA) version 2 working in PHP version lower than 5.3.

= V1.18 =
Ability to restore default settings. BWS Menu was updated. We updated all functionality for wordpress 4.3.

= V1.17 =
We fixed the bug with checking captcha in custom login form\register form\lost password form.

= V1.16 =
We fixed the bug with checking captcha when deleted 'recaptcha_widget_div'. We fixed the bug with using deprecated jQuery methods (thanks to Junio Vitorino, github.com/juniovitorino). The Arabic language file is added. The German language file is added. The Hindi language file is added. We updated all functionality for wordpress 4.2.2.

= V1.15 =
We fixed the bug with captcha check for users from the list of exceptions.

= V1.14 =
Captcha work with comments forms with disabled javascript was fixed. Check reCaptcha v2 in PHP version 5.6 and above was fixed. The Italian language file is added.

= V1.13 =
We fixed the vulnerability when entering the dashboard. The Greek language file is added.

= V1.12 =
The Bulgarian language file is added. We added the check of the "allow_url_fopen" option in PHP settings. We added style for forms that use captcha v2.

= V1.11 =
New Google Captcha (reCAPTCHA) version is added. We fixed the bug with displaying Google Captcha (reCAPTCHA) on the multisite register form. We fixed the bug with multilanguage plugin. We updated all functionality for wordpress 4.1.

= V1.10 =
We updated url and key names for Google Api.

= V1.09 =
We fixed the bug with joint displaying Google reCaptcha and Captcha. We fixed the bug with wrong answers in custom forms. We fixed the bug with login redirect.

= V1.08 =
The Spanish language file is added. Bug with multisite was fixed. Bug with user`s login was fixed. Bug when Contact Form submit was fixed.

= V1.07 =
The Chinese (Traditional) language file is added.

= V1.06 =
Security Exploit was fixed. The display of private key in the front-end was removed.

= V1.05 =
Problem with submitting form with Google Captcha (reCAPTCHA) is fixed.

= V1.04 =
Problem with displaying Google Captcha (reCAPTCHA) in Contact Form Pro (by BestWebSoft) is fixed. The Brazilian Portuguese language file is added.

= V1.03 =
The Polish language file is added. The Ukrainian language file is added. Renew captcha automaticly if was entered wrong value (thanks to Yaroslav Rogoza, github.com/rogyar). We updated all functionality for wordpress 3.9.1. Problem with checking captcha for sites with https was fixed.

= V1.02 =
Screenshots are updated. BWS plugins section is updated. Plugin optimization is done.

= V1.01 =
"Settings", "FAQ", "Support" links were added to the plugin action page. The links were added on the plugins page.
The bug with adding comments from admin panel was fixed.

= V1.0 =
Ability to add Google Captcha (reCAPTCHA) into standard forms was added.
