FAQ

Installation Instructions

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 Google Captcha” menu.
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

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 <?php do_action('comment_form', $post->ID); ?> 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”: <?php comment_form(); ?>
If you have WP3 and captcha is still missing, make sure your theme has <?php comment_form(); ?>
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.

Add Google Captcha (reCAPTCHA) plugin to a custom form on your WordPress website

Follow the instructions below in order to add Google Captcha (reCAPTCHA) plugin to your custom PHP or HTML form:
1. Install the Google Captcha (reCAPTCHA) plugin and activate it.
2. (Optional) If you would like to have an ability to enable and disable the reCAPTCHA for your custom form on the plugin settings page, please add the following code to the ‘functions.php’ file of your theme:

function add_custom_recaptcha_forms( $forms ) {
    $forms['my_custom_form'] = array( "form_name" => "Custom Form Name" );
    return $forms;
}
add_filter( 'gglcptch_add_custom_form', 'add_custom_recaptcha_forms' );

In this example, ‘my_custom_form’ is a slug of your custom form.

Please don’t use the following form slugs since they are predefined by plugin settings: login_form, registration_form, reset_pwd_form, comments_form, contact_form, cf7, si_contact_form, jetpack_contact_form, sbscrbr, bbpress_new_topic_form, bbpress_reply_form, buddypress_register, buddypress_comments, buddypress_group, woocommerce_login, woocommerce_register, woocommerce_lost_password, woocommerce_checkout, wpforo_login_form, wpforo_register_form, wpforo_new_topic_form, wpforo_reply_form.
– Save file changes;
– Go to the “Settings” tab on the plugin settings page (Admin Dashboard -> Google Captcha); If everything is OK, you will see your form in ‘Enable reCAPTCHA for’ => ‘Custom Forms’ (with labels which you specified in the “gglcptch_add_custom_form” hook call function).
– Enable it and configure form options as you need;
– Click “Save Changes” button;

If you don’t add this code, no option for your custom form will be displayed on the plugin settings page and the reCAPTCHA will be always displayed in your custom form.

1. Open the file with the form (where you would like to add reCAPTCHA);

2. Find a place to insert the code for the reCAPTCHA output;
   If you completed the instructions in p. 2, then you should add:

In this example, the second parameter is a slug of your custom form.

Otherwise, insert the following line:

<?php echo apply_filters( 'gglcptch_display_recaptcha', '' ); ?>

1. After that, you should add the following lines to the function of the entered data checking.
   If you completed the instructions in p. 2, then you should add:

In this example, the third parameter is a slug of your custom form.

Otherwise, insert the following lines:

<?php $check_result = apply_filters( 'gglcptch_verify_recaptcha', true, 'string' );
if ( true === $check_result ) { /* the reCAPTCHA answer is right */
    /* do necessary action */
} else { /* the reCAPTCHA answer is wrong or there are some other errors */
    echo $check_result; /* display the error message or do other necessary actions in case when the reCAPTCHA test was failed */
} ?>

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

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