PrestaShop EU CAPTCHA {User- Guide}

PrestaShop EU CAPTCHA: Protect your online store from spams and bots while ensuring compliance with EU data protection regulation.

A reliable and effective solution that blocks spammers from forms that a user might fill out like login, registration, or contact form.

PrestaShop EU CAPTCHA provides advanced security by preventing fake registrations, spam, bots, and attacks.

Note: To use this module, you will require any of the following:

• A dedicated URL for testing and production environment. You will receive both URLs as part of the EU CAPTCHA onboarding journey. This method supports only sliding CAPTCHA.
• A dedicated server for Self-hosting EU CAPTCHA. This method supports all 3 CAPTCHAs i.e. alphanumeric, image rotation, and sliding.

Further, it will require custom integration from Webkul.

Old APIs has been deprecated. Working shown in the blog is dependent on the API.

• Enable EU CAPTCHA on customer login, registration, contact, and back office login pages.
• Support 3 CAPTCHA types: alphanumeric, image rotation, and sliding CAPTCHA.
• Provide audio transcription with alphanumeric CAPTCHA.
• Set the length of alphanumeric CAPTCHA.
• Enable the combination of uppercase and lowercase letters for alphanumeric CAPTCHA.
• Select arrows or slider for image rotation.
• Select languages for CAPTCHA form.
• Use EU CAPTCHA in live or test mode.

• Firstly, go to the module manager in the back office and click on ‘upload a module’.
• After that, drag and drop the module file or select the file from the system.
• In this way, the module installation will be successful.

For the proper functioning of the module, you need to add some hook in prestashop core files –

1.) Add Hook

{hook h='DisplayWkCustomerLoginForm'}

in Front-Office

File name – login-form.tpl
Path – /themes/_YOUR_THEME_NAME_/templates/customer/_partials/

Position – In Login Form with id=”login-form”, Inside {block name=’login_form_fields’} section and after {/foreach}

2.) Add Hook

{hook h='DisplayWkCustomerContactForm'}

in Front-Office

A.) File name – contactform.tpl
Path – /modules/contactform/views/templates/widget

Position – Inside <section class=”form-fields”> after Message filed <label>…….</label>

B.) File name – contactform.tpl
Path – /themes/_YOUR_THEME_NAME_/modules/contactform/views/templates/widget

Position – Inside <section class=”form-fields”> after Message filed <div class=”form-group”>……</div>

3.) Add Hook

{hook h='DisplayWkAdminLoginForm'}

in Back-Office

File name – content.tpl
Path – /admin/themes/default/template/controllers/login

Position – Inside Login Form with id=”login_form”, After Password field <div class=”form-group”>……</div>

4.) Add Hook –

Hook::exec('actionWkAdminLoginControllerSubmit');

in Back-Office

File name – AdminLoginController.php
Path – /controllers/admin/

Position – Inside processLogin() function, after ‘password’ validation check and before this line – “if (!count($this->errors)) {“

We override some prestashop core files –

1. Classes/form – CustomerForm.php
function name – validate()

2. Classes/form – CustomerLoginForm.php
function name – submit()

3. modules/contactform – contactform.php
function name – sendMessage()

API Settings

Under API configuration, the admin has to select the mode of EU CAPTCHA. The admin can choose to use EU CAPTCHA in test (Sandbox) or live (Production) mode.

Login Page Settings

Enable CAPTCHA on customer login page and select the type of CAPTCHA to be displayed on the page.

There are three types of CAPTCHA that are supported by EU CAPTCHA.

1. Alphanumeric CAPTCHA
2. Image rotation CAPTCHA
3. Sliding CAPTCHA

Alphanumeric CAPTCHA

Admin can choose to show audio playback with alphanumeric CAPTCHA on the customer’s login page.

Also, the admin can set the alphanumeric CAPTCHA length and display a combination of uppercase and lowercase letters in CAPTCHA.

Front End View

Image rotation CAPTCHA

The admin can enable image with the use of arrows or slider.

Front End View

Sliding CAPTCHA

In this CAPTCHA type, the customer has to select a number within a specified range by using a slider.

Front End View

Registration Page Settings

Front End View

The CAPTCHA type selected by the admin will display in customer registration form.

The CAPTCHA type selected by admin for customer registration page will also display in personal information page.

Contact Page Settings

Front End View

Back Office Login Page Settings

Back Office View

Language Settings

The module lets admin enable languages on CAPTCHA form so that the customers can view the instruction for CAPTCHA validation in their preferred language.

European Union recommends 22 languages for CAPTCHA.

Front End View

Once enabled by admin, the language drop-down gets added above CAPTCHA. The user can select the language as per preference.

For any kind of technical assistance or query, please raise a ticket or send us a mail at support@webkul.com

Also, please explore our Prestashop development services and a vast range of quality Prestashop addons.