PREREQUISITES: Create or sign in to your Google reCAPTCHA account and get the site key and secret key there.


To configure the addon:

  1. Click the “Settings” link for the Google ReCAPTCHA add-on.

    You will be redirected to the addon settings page:

  2. Adjust the addon settings.

  3. Click Submit to make the settings active. Once you do so, Google ReCAPTCHA protection for your store will be enabled.

Google reCAPTCHA account

This section enables you to specify the information your store will require for connection to your registered free Google reCAPTCHA account.

settings-1.png

  • API version: The API version you want to use.

  • Site key: The site key generated for the API version selected above.

  • Secret key: The secret key generated for the API version selected above.

Google reCAPTCHA settings

This section enables you to configure your general reCAPTCHA form settings.

  • For reCAPTCHA v2, you will be able to adjust the following settings:

    • Theme: Select the theme of the form.

    • Size: Select the size of the form.

      settings-2.png


      Depending on the selected theme and size, your reCAPTCHA form will look different:

      recaptcha_themes.jpg
  • For reCAPTCHA v3 (Beta version), you will be able to adjust the following settings:

    • Minimal score required to pass verification: Define a score from 0 (definitely bot) to 1 (definitely human) a user should gain to pass verification.

    • Throttling period (seconds): Set the period in seconds to limit the number of requests a user can submit in a given amount of time.

      settings-2-v3.png

Forms protected with Google reCAPTCHA

This section enables you to choose the actions that will be protected with Google reCAPTCHA.

  • API v2 allows to toggle on the reCAPTCHA protection for the following forms:

    • Sign-in form (storefront)

    • Password recovery form

    • Customer sign-up form

    • Contact form

    • Vendor sign-up form (if the Multi-vendor addon is enabled)

      setings-3.png
  • API v3 (Beta version) allows to toggle on the reCAPTCHA protection for the following forms:

    • Sign-in form (storefront)

    • Password recovery form

    • Customer sign-up form

    • Contact form

    • Vendor sign-up form (if the addon is enabled)Multivendor

    • Newsletter subscription form (if the addon is enabled)Newsletter

      settings-3-v3.png

    Note that the contents of the page section “Forms protected with Google reCAPTCHA” in your Admin area may not look like on the screenshot above.
    For example, you may see it like this:

    google_recaptcha_v3_forms.png

    That is because, for each of the forms on the list, the section provides two more settings; they are hidden while the toggle for the form is set to OFF and are revealed when this toggle is reset to ON. Since the use of ReCAPTCHA for some of the forms is enabled by default, you may see these settings in the revealed state when you first access the addon settings page.

    setting-3-v3-on.png

    These settings enable you to configure the following parameters for the form:

    • FORM_NAME minimal score: A score that the user needs to gain to pass verification. It can be set to any value from 0 (definitely bot) to 1 (definitely human). The value set for the field overrides the “Minimal score” setting from “Google reCAPTCHA settings.”

    • Fallback action (challenge): An action (challenge) that should be taken if the user’s score is less than the value specified by the “minimal score” setting for the form. The available options here are:

      • Do nothing;

      • Deny using the form;

      • Email confirmation link.

Did this answer your question?