The addon Google reCAPTCHA for X-Cart 5 uses the free Google reCAPTCHA service to protect your shop from robots creating fake user accounts and sending spam through your site.

Enabling Google ReCAPTCHA Addon

To start using the addon:

  1. Make sure it is installed and enabled as described in Installing Addons from the X-Cart App Store. addon-enabled.png

  2. Sign up for a free Google reCAPTCHA account, to get your site key and secure key that you will need to specify during the addon configuration.

Configuring Google ReCAPTCHA

To configure the addon:

  1. Click the “Settings” link for Google ReCAPTCHA after the addon has been enabled. settings-link.png

    You will be redirected to the addon settings page: 540-settings-page.png

  2. Adjust the parameters on the settings page, that are divided into 3 subsections:

    • Google reCAPTCHA account

      This secton enables a store admin to provide the sign-in data of a registered free Google reCAPTCHA account. settings-1.png

      • API version : Choose the API version you want to use.
      • Site key : Specify the site key generated for the API version selected above.
      • Secret key : Specify the secret key generated for the API version selected above.
    • Google reCAPTCHA settings

      This section allows a store admin to configure the settings of a reCAPTCHA form.

      • Options available for reCAPTCHA v2 are as follows: settings-2.png
        • Theme : Select the theme of the form.
        • Size : Select the size of the form.
      • Options available for reCAPTCHA v3 (Beta version) are as follows: settings-2-v3.png
        • 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.
    • Forms protected with Google reCAPTCHA

      This section allows a store admin to choose the actions that will be protected with Google ReCAPTCHA.

      • API v2 allows to toggle on the reCAPTCHA protection for the folowing forms: setings-3.png
        • Sign-in form (storefront)
        • Password recovery form
        • Customer sign-up form
        • Contact form
        • Vendor sign-up form (if the Multi-vendor addon is enabled)
      • API v3 (Beta version) allows to toggle on the reCAPTCHA protection for the following forms: settings-3-v3.png
        • Sign-in form (storefront)
        • Password recovery form
        • Customer sign-up form
        • Contact form
        • Vendor sign-up form (if the Multivendor addon is enabled)
        • Newsletter subscription form (if the Newsletter addon is enabled)

        A store admin can configure the following parameters for each enabled form: setting-3-v3-on.png

        • FORM_NAME minimal score : Define a score from 0 (definitely bot) to 1 (definitely human) a user should gain to pass verification. The value set for the field overrides the “Minimal score” option from “Google reCAPTCHA settings”.
        • Fallback action (challenge) : An action (challenge) that should be taken if a user is scored less than allowed in “minimal score” for the form. Available options are:
          • Do nothing
          • Deny using the form
          • Email confirmation link
  3. Click Submit to make the settings active.

The enabled Google reCAPTCHA v2 protection for the chosen forms will look as follows:

Forgot password formgre-forgot-password.png
Sign-in formgre-sign-in.png
Sign-up formgre-create-new-account.png
Contact formgre-contact_us.png

The enabled Google reCAPTCHA v3 protection works for the site as a whole and may not be even seen by the customers. recaptcha-v3-cus.png