Commit 0941dc7a authored by volkswagenchick's avatar volkswagenchick Committed by wundo

Issue #3006824 by volkswagenchick, alonaoneill, wundo: README configs and formatting

parent e286d714
CAPTCHA module for Drupal CONTENTS OF THIS FILE
--------------------------- ---------------------
[![Build Status]
(https://travis-ci.org/chuva-inc/captcha.svg?branch=8.x-1.x)] * Introduction
(https://travis-ci.org/chuva-inc/captcha) * Requirements
* Conflicts/Known issues
* Installation
* Configuration
* Maintainers
[![Code Climate]
(https://codeclimate.com/github/chuva-inc/captcha/badges/gpa.svg)]
(https://codeclimate.com/github/chuva-inc/captcha)
INTRODUCTION INTRODUCTION
----------- ------------
captcha.module is the basic CAPTCHA module, offering general CAPTCHA
administration and a simple maths challenge.
SUB MODULE 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
image_captcha.module offers an image based challenge. 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.
INSTALLATION: * For a full description of the module, visit the project page:
------------- https://www.drupal.org/project/captcha
1. Extract the tar.gz into your 'modules' or directory and copy to modules
folder. * To submit bug reports and feature suggestions, or to track changes:
2. Go to "Extend" after successfully login into admin. https://www.drupal.org/project/issues/captcha
3. Enable the module at 'administer >> modules'.
DEPENDENCIES
------------
The basic CAPTCHA module has no dependencies, nothing special is required.
REQUIREMENTS REQUIREMENTS
------------ ------------
No special requirements.
This module requires no modules outside of Drupal core.
CONFLICTS/KNOWN ISSUES 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'.
CONFIGURATION 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
The configuration page is at admin/config/people/captcha, 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 the CAPTCHA module as you would normally install a contributed
Drupal module. Visit https://www.drupal.org/node/1897420 for further
information.
The configuration page is at admin/config/people/captcha,
where you can configure the CAPTCHA module where you can configure the CAPTCHA module
and enable challenges for the desired forms. and enable challenges for the desired forms.
You can also tweak the image CAPTCHA to your liking. You can also tweak the image CAPTCHA to your liking.
UNINSTALLATION CONFIGURATION
-------------- -------------
1. Disable the module from 'administer >> modules'.
2. Uninstall the module 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.
MAINTAINERS MAINTAINERS
----------- -----------
Current maintainers:
* Fabiano Sant'Ana (wundo) - https://www.drupal.org/u/wundo * Fabiano Sant'Ana (wundo) - https://www.drupal.org/u/wundo
* Andrii Podanenko (podarok) - https://www.drupal.org/u/podarok * Andrii Podanenko (podarok) - https://www.drupal.org/u/podarok
* soxofaan - https://www.drupal.org/u/soxofaan * soxofaan - https://www.drupal.org/u/soxofaan
* Lachlan Ennis (elachlan) - https://www.drupal.org/u/elachlan * Lachlan Ennis (elachlan) - https://www.drupal.org/u/elachlan
* Rob Loach (RobLoach) - https://www.drupal.org/u/robloach * Rob Loach (RobLoach) - https://www.drupal.org/u/robloach
Supporting organizations:
* Chuva Inc. - https://www.drupal.org/chuva-inc
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment