bkhouy/captcha

The CAPTCHA module provides this feature to virtually any user facing web form on a Drupal site.

Installs: 28

Dependents: 1

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Type:drupal-module

2.0.0 2023-07-16 14:05 UTC

This package is not auto-updated.

Last update: 2024-05-06 16:08:16 UTC


README

Important

This is a temporarily fix of upgrading captcha module from Drupal 9 to Drupal 10, see the issue detail on: https://www.drupal.org/project/captcha/issues/3367503

Upgrading steps:

1 - Remove existing drupal/captcha package: composer remove drupal/captcha

2 - Require bkhouy/captcha package: composer require bkhouy/captcha:^2.0

3 - Continue upgrading the rest of your project...

4 - Once you finish the upgrade and your project is running on Drupal 10 version on production, then you need to rollback to drupal/captcha module by following those steps:

  • Remove bkhouy/captcha package: composer remove bkhouy/captcha
  • Require drupal/captcha package: composer require drupal/captcha:^2.0

Description

A CAPTCHA is a challenge-response test most often placed within web forms to determine whether the user is human. The purpose of CAPTCHA is to block form submissions by spambots, which are automated scripts that post spam content everywhere they can. The CAPTCHA module provides this feature to virtually any user facing web form on a Drupal site.

For a full description of the module, visit the project page

Submit bug reports and feature suggestions, or track changes in the issue queue

Table of contents

  • Requirements
  • Conflicts/Known issues
  • Installation
  • Configuration
  • Development
  • Maintainers

Requirements

This module requires no modules outside of Drupal core.

Conflicts/Known issues

CAPTCHA and page caching do not work together currently. However, the CAPTCHA module does support the Drupal core page caching mechanism: it just disables the caching of the pages where it has to put its challenges.

If you use other caching mechanisms, it is possible that CAPTCHA's won't work, and you get error messages like 'CAPTCHA validation error: unknown CAPTCHA session ID'.

Installation

Install as you would normally install a contributed Drupal module. For further information, see Installing Drupal Modules.

Configuration

The configuration page is at admin/config/people/captcha, where you can configure the CAPTCHA module and enable challenges for the desired forms. You can also tweak the image CAPTCHA to your liking.

  1. Navigate to Administration > Extend and enable the module.
  2. Navigate to Administration > Configuration > People > Captcha module settings to administer how and when Captcha is used.
  3. Select the challenge type you want for each of the listed forms.
  4. Select "Add a description to the CAPTCHA" to add a configurable description to explain the purpose of the CAPTCHA to the visitor.
  5. For Default CAPTCHA validation, define how the response should be processed by default. Note that the modules that provide the actual challenges can override or ignore this.
  6. Save configuration.

Development

You can disable captcha in your local or test environment by adding the following line to settings.php:

$settings['disable_captcha'] = TRUE;

Maintainers

Supporting organizations: