You are here

README.txt in Webform Select Limit 7

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

The Webform Select Limit module provides a webform validator to
prevent submissions of webforms where the option in the select list has
already been submitted a set number of times.

An example of this being used could be a booking form where a maximum of
two people can select a certain time slot.

An additional configuration option allows for the ability to disable options
which are not available any longer.

This validator is used for webform select components.


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

This module requires the following modules:

 * Webform Validation (https://drupal.org/project/webform_validation)


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

 * Install as you would normally install a contributed Drupal module. See:
   https://drupal.org/documentation/install/modules-themes/modules-7
   for further information.


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

 * Create a Webform, add select components and configure. Found within this
   form is a fieldset, select option limitation, which provides the following
   options:

   - Enable select option limitation

     This option allows the component to use the validator. The component must
     still be added to the validator added in the next step.

   - Select option limitation number (required if enabled)

     This is where you set the number of times the individual options can be
     submitted. Alternatively you can provide a catch all setting to set a single
     limit across all form values.

   - Select option limitation error message (optional)

     Provides the ability to enter a component specific error message. If this
     is not set then a default message will be displayed.

   - Disable unavailable options in select list (optional)

     Will disable the unavailable options using javascript, preventing the user
     from selecting it.

 * Select the form validation menu link and add the "Maximum number of select
   option submissions" validator. Select the webform components to validate
   and save. Validation will only happen if the component has the "enable select
   option limitation" option set.

 * Submit the Webform and see the magic happen.

File

README.txt
View source
  1. INTRODUCTION
  2. ------------
  3. The Webform Select Limit module provides a webform validator to
  4. prevent submissions of webforms where the option in the select list has
  5. already been submitted a set number of times.
  6. An example of this being used could be a booking form where a maximum of
  7. two people can select a certain time slot.
  8. An additional configuration option allows for the ability to disable options
  9. which are not available any longer.
  10. This validator is used for webform select components.
  11. REQUIREMENTS
  12. ------------
  13. This module requires the following modules:
  14. * Webform Validation (https://drupal.org/project/webform_validation)
  15. INSTALLATION
  16. ------------
  17. * Install as you would normally install a contributed Drupal module. See:
  18. https://drupal.org/documentation/install/modules-themes/modules-7
  19. for further information.
  20. CONFIGURATION
  21. -------------
  22. * Create a Webform, add select components and configure. Found within this
  23. form is a fieldset, select option limitation, which provides the following
  24. options:
  25. - Enable select option limitation
  26. This option allows the component to use the validator. The component must
  27. still be added to the validator added in the next step.
  28. - Select option limitation number (required if enabled)
  29. This is where you set the number of times the individual options can be
  30. submitted. Alternatively you can provide a catch all setting to set a single
  31. limit across all form values.
  32. - Select option limitation error message (optional)
  33. Provides the ability to enter a component specific error message. If this
  34. is not set then a default message will be displayed.
  35. - Disable unavailable options in select list (optional)
  36. Will disable the unavailable options using javascript, preventing the user
  37. from selecting it.
  38. * Select the form validation menu link and add the "Maximum number of select
  39. option submissions" validator. Select the webform components to validate
  40. and save. Validation will only happen if the component has the "enable select
  41. option limitation" option set.
  42. * Submit the Webform and see the magic happen.