Bachir Soussi Chiadmi 50f0d72e62 better registration form and accompt creation 6 years ago
..
config 50f0d72e62 better registration form and accompt creation 6 years ago
src 50f0d72e62 better registration form and accompt creation 6 years ago
tests 50f0d72e62 better registration form and accompt creation 6 years ago
.travis.yml 50f0d72e62 better registration form and accompt creation 6 years ago
LICENSE.txt 50f0d72e62 better registration form and accompt creation 6 years ago
README.md 50f0d72e62 better registration form and accompt creation 6 years ago
composer.json 50f0d72e62 better registration form and accompt creation 6 years ago
docker-compose.yml 50f0d72e62 better registration form and accompt creation 6 years ago
honeypot.api.php 50f0d72e62 better registration form and accompt creation 6 years ago
honeypot.info.yml 50f0d72e62 better registration form and accompt creation 6 years ago
honeypot.install 50f0d72e62 better registration form and accompt creation 6 years ago
honeypot.links.menu.yml 50f0d72e62 better registration form and accompt creation 6 years ago
honeypot.module 50f0d72e62 better registration form and accompt creation 6 years ago
honeypot.permissions.yml 50f0d72e62 better registration form and accompt creation 6 years ago
honeypot.routing.yml 50f0d72e62 better registration form and accompt creation 6 years ago

README.md

Honeypot

Build Status

Installation

To install this module, composer require it, or place it in your modules folder and enable it on the modules page.

Configuration

All settings for this module are on the Honeypot configuration page, under the Configuration section, in the Content authoring settings. You can visit the configuration page directly at admin/config/content/honeypot.

Note that, when testing Honeypot on your website, make sure you're not logged in as an administrative user or user 1; Honeypot allows administrative users to bypass Honeypot protection, so by default, Honeypot will not be added to forms accessed by site administrators.

Use in Your Own Forms

If you want to add honeypot to your own forms, or to any form through your own module's hook_form_alter's, you can simply place the following function call inside your form builder function (or inside a hook_form_alter):

honeypot_add_form_protection(
  $form,
  $form_state,
  ['honeypot', 'time_restriction']
);

Note that you can enable or disable either the honeypot field, or the time restriction on the form by including or not including the option in the array.

Testing

Honeypot includes a docker-compose.yml file that can be used for testing purposes. To build a Drupal 8 environment for local testing, do the following:

  1. Make sure you have Docker for Mac (or for whatever OS you're using) installed.
  2. Add the following entry to your /etc/hosts file: 192.168.22.33 local.drupalhoneypot.com
  3. Run docker-compose up -d in this directory.
  4. Install Drupal: docker exec honeypot install-drupal (optionally provide a version after install-drupal).
  5. Link the honeypot module directory into the Drupal modules directory: docker exec honeypot ln -s /opt/honeypot/ /var/www/drupalvm/drupal/web/modules/honeypot
  6. Visit http://local.drupalhoneypot.com/user and log in using the admin credentials Drush displayed.

Credit

The Honeypot module was originally developed by Jeff Geerling of Midwestern Mac, LLC (midwesternmac.com), and sponsored by Flocknote (flocknote.com).