You are here

Home » API reference » Captcha Questions 8

README.txt in Captcha Questions 8

Same filename and directory in other branches
  1. 7 README.txt
README FILE FOR THE CAPTCHA QUESTIONS MODULE FOR DRUPAL
-------------------------------------------------------

CONTENTS OF THIS FILE
---------------------

 * INTRODUCTION
 * REQUIREMENTS
 * INSTALLATION
 * CONFIGURATION
 * USING THE CAPTCHA
 * KNOWN UNKNOWNS
 * FUTURE DEVELOPMENT
 * CONTACT

INTRODUCTION
------------

 - Captcha questions is a light-weight module that employs a very simple
   captcha-mechanism to stop unwanted form submissions.

REQUIREMENTS
------------

 - No dependencies.

INSTALLATION
------------

 - Extract the files in your module directory (typically /modules)
 - Visit the modules page and enable the module
 - From the modules page you will find links to
    - permission settings
    - configuration
    - help

CONFIGURATION
------------

1. Enable the module using drush or by going to `admin/modules`.
2. Go to `/admin/config/people/captcha_questions` for configurations related to
   captcha questions module.

USING THE CAPTCHA
-----------------

 - You create a question/answer-pair and attach this to selected forms.
 - If the user fails to answer the question correctly, the form will not be
   submitted.
 - Logging to database is handled in a submodule and is entirely optional.
 - It is similar in nature to Trick Question and Captcha Riddler, but will be
   actively maintained.
 - Image captchas can be hard also for humans. Captcha questions was made after
   realising most spam can be blocked by a simple question that is easy for
   humans but very difficult for automated scripts.
 - It is recommended to make the questions as simple as possible.


KNOWN UNKNOWNS
--------------

Captcha questions has not been thoroughly tested and never
on multilingual sites.

FUTURE DEVELOPMENT
------------------

 - Set different question/answer pairs on different forms
 - Rotation between several question/answer pairs in one form
 - Write tests
 - Test on various site configurations, including multilingual sites
 - Translations

CONTACT
-------

Please provide feedback to agnar@norweb.no if you have problems, comments,
patches, praise or ideas.

File

README.txt
View source 
  1. README FILE FOR THE CAPTCHA QUESTIONS MODULE FOR DRUPAL

  2. -------------------------------------------------------

  3. 

  4. CONTENTS OF THIS FILE

  5. ---------------------

  6. 

  7.  * INTRODUCTION

  8.  * REQUIREMENTS

  9.  * INSTALLATION

  10.  * CONFIGURATION

  11.  * USING THE CAPTCHA

  12.  * KNOWN UNKNOWNS

  13.  * FUTURE DEVELOPMENT

  14.  * CONTACT

  15. 

  16. INTRODUCTION

  17. ------------

  18. 

  19.  - Captcha questions is a light-weight module that employs a very simple

  20.    captcha-mechanism to stop unwanted form submissions.

  21. 

  22. REQUIREMENTS

  23. ------------

  24. 

  25.  - No dependencies.

  26. 

  27. INSTALLATION

  28. ------------

  29. 

  30.  - Extract the files in your module directory (typically /modules)

  31.  - Visit the modules page and enable the module

  32.  - From the modules page you will find links to

  33.     - permission settings

  34.     - configuration

  35.     - help

  36. 

  37. CONFIGURATION

  38. ------------

  39. 

  40. 1. Enable the module using drush or by going to `admin/modules`.

  41. 2. Go to `/admin/config/people/captcha_questions` for configurations related to

  42.    captcha questions module.

  43. 

  44. USING THE CAPTCHA

  45. -----------------

  46. 

  47.  - You create a question/answer-pair and attach this to selected forms.

  48.  - If the user fails to answer the question correctly, the form will not be

  49.    submitted.

  50.  - Logging to database is handled in a submodule and is entirely optional.

  51.  - It is similar in nature to Trick Question and Captcha Riddler, but will be

  52.    actively maintained.

  53.  - Image captchas can be hard also for humans. Captcha questions was made after

  54.    realising most spam can be blocked by a simple question that is easy for

  55.    humans but very difficult for automated scripts.

  56.  - It is recommended to make the questions as simple as possible.

  57. 

  58. 

  59. KNOWN UNKNOWNS

  60. --------------

  61. 

  62. Captcha questions has not been thoroughly tested and never

  63. on multilingual sites.

  64. 

  65. FUTURE DEVELOPMENT

  66. ------------------

  67. 

  68.  - Set different question/answer pairs on different forms

  69.  - Rotation between several question/answer pairs in one form

  70.  - Write tests

  71.  - Test on various site configurations, including multilingual sites

  72.  - Translations

  73. 

  74. CONTACT

  75. -------

  76. 

  77. Please provide feedback to agnar@norweb.no if you have problems, comments,

  78. patches, praise or ideas.