You are here

Home » API reference » Clientside Validation 7

README.txt in Clientside Validation 7

Same filename and directory in other branches
  1. 6 README.txt
  2. 7.2 README.txt
DESCRIPTION
===========
  This module adds clientside validation for all forms and webforms using
  jquery.validate[1]. The included jquery.validate.js file is patched because we
  needed to be able to hide empty messages.

EXAMPLE
=======
  If you want to try out an example of Clientside Validation in combination with
  the form API, FAPI Validation (http://www.drupal.org/project/fapi_validation),
  and/or Vertical Tabs (D6: http://www.drupal.org/project/vertical_tabs, D7: in
  core) you can download and enable the example module from this sandbox project:
  http://drupal.org/sandbox/jelles/1193994
  or
  http://drupal.org/project/1193994/git-instructions (direct link to git
  instructions tab)

DEMO
====
  Demo's can be a little bit outdated
  Drupal 6:
    * Custom form: http://atix.be/cv6a
    * Webform: http://atix.be/cv6b
  Drupal 7:
    * Custom form: http://atix.be/cv7a
    * Webform: http://atix.be/cv7b

STATUS
======
  * Validation is added to all forms and webforms (only tested with version 3).
  * The error messages are displayed the same way as without this module, in a
    div above the form.
  * The error messages use the same css classes as drupal does out of the box,
    so you only have to theme it once.
  * Supports the following conditions: Fields that
      - are required
      - have a maximum length
      - must have one of specified extensions
      - must be one of the allowed values
      - can only contain max x elements (checkboxes, multiple selects)
      - must contain minimum x elements (checkboxes, multiple selects)
      - must be greater than a minimum value
      - must be smaller than a maximum value
      - must be a number
      - must be a decimal
      - must equal an other field
      - can not equal an other field
      - must equal a specific value
      - must be an ean number
      - must match a POSIX regex
      - must match a PCRE regex
      - must be a valid e-mail address
      - must be a valid url
      - must be alpha (FAPI validation)
      - must be alphanumeric (FAPI validation)
      - must be valid IPv4 (FAPI validation)
      - must be "alpha dash" (FAPI validation)
    Note: The FAPI validation rules come down to matching a PCRE regex
  * CCK: textfield, textarea, decimal, float, integer, file and image
  * Supports multiple forms on one page
  * Added support for Webform Validation
  * Added support for FAPI Validation
  * D7: Added support for Field Validation
  * Added support for Vertical Tabs (for D6: Vertical Tabs)
  * Supports most of CCK Date
  * Added an option to enclose the field name in quotes (defaults to nothing)
  * Added an option to validate all tabs or only the visible one (defaults to
    all tabs)
  * Added an option to specify on which forms to validate all fields (including
    those hidden) and on which forms only to validate the visible fields
    (defaults to only visible)
  * Added an option to specify on which forms to add Clientside Validation
    (defaults to all forms)
  * Added an option to specify whether or not to use the minified version of
    jquery.validate.js
  * Checkboxes are working
  * Now using jquery.validate 1.8
  * Supports multi page webforms

TODO
====
  * Add settings to control position and behaviour of the error messages

USAGE
=====
  The only thing this module will do is translate validation rules defined in
  PHP to javascript counter parts, if you mark a field as required it will
  create a javascript rule that checks the field on submit. This means no real
  configuration is needed. You can however configure the prefix and suffix used
  for the field names in the error messages (e.g.: prefix:", suffix:" or
  prefix:<<, suffix:>>), whether or not to use the minified version of
  jquery.validate.js, whether or not to validate hidden fields on specific
  forms, whether or not to validate all vertical tabs or only the visible one
  and to add Clientside Validation to all forms or only to those specified.

AUTHOR
======
  The author can be contacted for paid customizations of this module as well as
  Drupal consulting and development.DESCRIPTION
===========
  This module adds clientside validation for all forms and webforms using
  jquery.validate[1]. The included jquery.validate.js file is patched because we
  needed to be able to hide empty messages.

EXAMPLE
=======
  If you want to try out an example of Clientside Validation in combination with
  the form API, FAPI Validation (http://www.drupal.org/project/fapi_validation),
  and/or Vertical Tabs (D6: http://www.drupal.org/project/vertical_tabs, D7: in
  core) you can download and enable the example module from this sandbox project:
  http://drupal.org/sandbox/jelles/1193994
  or
  http://drupal.org/project/1193994/git-instructions (direct link to git
  instructions tab)

DEMO
====
  Demo's can be a little bit outdated
  Drupal 6:
    * Custom form: http://atix.be/cv6a
    * Webform: http://atix.be/cv6b
  Drupal 7:
    * Custom form: http://atix.be/cv7a
    * Webform: http://atix.be/cv7b

STATUS
======
  * Validation is added to all forms and webforms (only tested with version 3).
  * The error messages are displayed the same way as without this module, in a
    div above the form.
  * The error messages use the same css classes as drupal does out of the box,
    so you only have to theme it once.
  * Supports the following conditions: Fields that
      - are required
      - have a maximum length
      - must have one of specified extensions
      - must be one of the allowed values
      - can only contain max x elements (checkboxes, multiple selects)
      - must contain minimum x elements (checkboxes, multiple selects)
      - must be greater than a minimum value
      - must be smaller than a maximum value
      - must be a number
      - must be a decimal
      - must equal an other field
      - can not equal an other field
      - must equal a specific value
      - must be an ean number
      - must match a POSIX regex
      - must match a PCRE regex
      - must be a valid e-mail address
      - must be a valid url
      - must be alpha (FAPI validation)
      - must be alphanumeric (FAPI validation)
      - must be valid IPv4 (FAPI validation)
      - must be "alpha dash" (FAPI validation)
    Note: The FAPI validation rules come down to matching a PCRE regex
  * CCK: textfield, textarea, decimal, float, integer, file and image
  * Supports multiple forms on one page
  * Added support for Webform Validation
  * Added support for FAPI Validation
  * D7: Added support for Field Validation
  * Added support for Vertical Tabs (for D6: Vertical Tabs)
  * Supports most of CCK Date
  * Added an option to enclose the field name in quotes (defaults to nothing)
  * Added an option to validate all tabs or only the visible one (defaults to
    all tabs)
  * Added an option to specify on which forms to validate all fields (including
    those hidden) and on which forms only to validate the visible fields
    (defaults to only visible)
  * Added an option to specify on which forms to add Clientside Validation
    (defaults to all forms)
  * Added an option to specify whether or not to use the minified version of
    jquery.validate.js (defaults to not)
  * Checkboxes are working
  * Now using jquery.validate 1.8
  * Supports multi page webforms

TODO
====
  * Add settings to control position and behaviour of the error messages

USAGE
=====
  The only thing this module will do is translate validation rules defined in
  PHP to javascript counter parts, if you mark a field as required it will
  create a javascript rule that checks the field on submit. This means no real
  configuration is needed. You can however configure the prefix and suffix used
  for the field names in the error messages (e.g.: prefix:", suffix:" or
  prefix:<<, suffix:>>), whether or not to use the minified version of
  jquery.validate.js, whether or not to validate hidden fields on specific
  forms, whether or not to validate all vertical tabs or only the visible one
  and to add Clientside Validation to all forms or only to those specified.

AUTHOR
======
  The author can be contacted for paid customizations of this module as well as
  Drupal consulting and development.

File

README.txt
View source 
  1. DESCRIPTION

  2. ===========

  3.   This module adds clientside validation for all forms and webforms using

  4.   jquery.validate[1]. The included jquery.validate.js file is patched because we

  5.   needed to be able to hide empty messages.

  6. 

  7. EXAMPLE

  8. =======

  9.   If you want to try out an example of Clientside Validation in combination with

  10.   the form API, FAPI Validation (http://www.drupal.org/project/fapi_validation),

  11.   and/or Vertical Tabs (D6: http://www.drupal.org/project/vertical_tabs, D7: in

  12.   core) you can download and enable the example module from this sandbox project:

  13.   http://drupal.org/sandbox/jelles/1193994

  14.   or

  15.   http://drupal.org/project/1193994/git-instructions (direct link to git

  16.   instructions tab)

  17. 

  18. DEMO

  19. ====

  20.   Demo's can be a little bit outdated

  21.   Drupal 6:

  22.     * Custom form: http://atix.be/cv6a

  23.     * Webform: http://atix.be/cv6b

  24.   Drupal 7:

  25.     * Custom form: http://atix.be/cv7a

  26.     * Webform: http://atix.be/cv7b

  27. 

  28. STATUS

  29. ======

  30.   * Validation is added to all forms and webforms (only tested with version 3).

  31.   * The error messages are displayed the same way as without this module, in a

  32.     div above the form.

  33.   * The error messages use the same css classes as drupal does out of the box,

  34.     so you only have to theme it once.

  35.   * Supports the following conditions: Fields that

  36.       - are required

  37.       - have a maximum length

  38.       - must have one of specified extensions

  39.       - must be one of the allowed values

  40.       - can only contain max x elements (checkboxes, multiple selects)

  41.       - must contain minimum x elements (checkboxes, multiple selects)

  42.       - must be greater than a minimum value

  43.       - must be smaller than a maximum value

  44.       - must be a number

  45.       - must be a decimal

  46.       - must equal an other field

  47.       - can not equal an other field

  48.       - must equal a specific value

  49.       - must be an ean number

  50.       - must match a POSIX regex

  51.       - must match a PCRE regex

  52.       - must be a valid e-mail address

  53.       - must be a valid url

  54.       - must be alpha (FAPI validation)

  55.       - must be alphanumeric (FAPI validation)

  56.       - must be valid IPv4 (FAPI validation)

  57.       - must be "alpha dash" (FAPI validation)

  58.     Note: The FAPI validation rules come down to matching a PCRE regex

  59.   * CCK: textfield, textarea, decimal, float, integer, file and image

  60.   * Supports multiple forms on one page

  61.   * Added support for Webform Validation

  62.   * Added support for FAPI Validation

  63.   * D7: Added support for Field Validation

  64.   * Added support for Vertical Tabs (for D6: Vertical Tabs)

  65.   * Supports most of CCK Date

  66.   * Added an option to enclose the field name in quotes (defaults to nothing)

  67.   * Added an option to validate all tabs or only the visible one (defaults to

  68.     all tabs)

  69.   * Added an option to specify on which forms to validate all fields (including

  70.     those hidden) and on which forms only to validate the visible fields

  71.     (defaults to only visible)

  72.   * Added an option to specify on which forms to add Clientside Validation

  73.     (defaults to all forms)

  74.   * Added an option to specify whether or not to use the minified version of

  75.     jquery.validate.js

  76.   * Checkboxes are working

  77.   * Now using jquery.validate 1.8

  78.   * Supports multi page webforms

  79. 

  80. TODO

  81. ====

  82.   * Add settings to control position and behaviour of the error messages

  83. 

  84. USAGE

  85. =====

  86.   The only thing this module will do is translate validation rules defined in

  87.   PHP to javascript counter parts, if you mark a field as required it will

  88.   create a javascript rule that checks the field on submit. This means no real

  89.   configuration is needed. You can however configure the prefix and suffix used

  90.   for the field names in the error messages (e.g.: prefix:", suffix:" or

  91.   prefix:<<, suffix:>>), whether or not to use the minified version of

  92.   jquery.validate.js, whether or not to validate hidden fields on specific

  93.   forms, whether or not to validate all vertical tabs or only the visible one

  94.   and to add Clientside Validation to all forms or only to those specified.

  95. 

  96. AUTHOR

  97. ======

  98.   The author can be contacted for paid customizations of this module as well as

  99.   Drupal consulting and development.DESCRIPTION

  100. ===========

  101.   This module adds clientside validation for all forms and webforms using

  102.   jquery.validate[1]. The included jquery.validate.js file is patched because we

  103.   needed to be able to hide empty messages.

  104. 

  105. EXAMPLE

  106. =======

  107.   If you want to try out an example of Clientside Validation in combination with

  108.   the form API, FAPI Validation (http://www.drupal.org/project/fapi_validation),

  109.   and/or Vertical Tabs (D6: http://www.drupal.org/project/vertical_tabs, D7: in

  110.   core) you can download and enable the example module from this sandbox project:

  111.   http://drupal.org/sandbox/jelles/1193994

  112.   or

  113.   http://drupal.org/project/1193994/git-instructions (direct link to git

  114.   instructions tab)

  115. 

  116. DEMO

  117. ====

  118.   Demo's can be a little bit outdated

  119.   Drupal 6:

  120.     * Custom form: http://atix.be/cv6a

  121.     * Webform: http://atix.be/cv6b

  122.   Drupal 7:

  123.     * Custom form: http://atix.be/cv7a

  124.     * Webform: http://atix.be/cv7b

  125. 

  126. STATUS

  127. ======

  128.   * Validation is added to all forms and webforms (only tested with version 3).

  129.   * The error messages are displayed the same way as without this module, in a

  130.     div above the form.

  131.   * The error messages use the same css classes as drupal does out of the box,

  132.     so you only have to theme it once.

  133.   * Supports the following conditions: Fields that

  134.       - are required

  135.       - have a maximum length

  136.       - must have one of specified extensions

  137.       - must be one of the allowed values

  138.       - can only contain max x elements (checkboxes, multiple selects)

  139.       - must contain minimum x elements (checkboxes, multiple selects)

  140.       - must be greater than a minimum value

  141.       - must be smaller than a maximum value

  142.       - must be a number

  143.       - must be a decimal

  144.       - must equal an other field

  145.       - can not equal an other field

  146.       - must equal a specific value

  147.       - must be an ean number

  148.       - must match a POSIX regex

  149.       - must match a PCRE regex

  150.       - must be a valid e-mail address

  151.       - must be a valid url

  152.       - must be alpha (FAPI validation)

  153.       - must be alphanumeric (FAPI validation)

  154.       - must be valid IPv4 (FAPI validation)

  155.       - must be "alpha dash" (FAPI validation)

  156.     Note: The FAPI validation rules come down to matching a PCRE regex

  157.   * CCK: textfield, textarea, decimal, float, integer, file and image

  158.   * Supports multiple forms on one page

  159.   * Added support for Webform Validation

  160.   * Added support for FAPI Validation

  161.   * D7: Added support for Field Validation

  162.   * Added support for Vertical Tabs (for D6: Vertical Tabs)

  163.   * Supports most of CCK Date

  164.   * Added an option to enclose the field name in quotes (defaults to nothing)

  165.   * Added an option to validate all tabs or only the visible one (defaults to

  166.     all tabs)

  167.   * Added an option to specify on which forms to validate all fields (including

  168.     those hidden) and on which forms only to validate the visible fields

  169.     (defaults to only visible)

  170.   * Added an option to specify on which forms to add Clientside Validation

  171.     (defaults to all forms)

  172.   * Added an option to specify whether or not to use the minified version of

  173.     jquery.validate.js (defaults to not)

  174.   * Checkboxes are working

  175.   * Now using jquery.validate 1.8

  176.   * Supports multi page webforms

  177. 

  178. TODO

  179. ====

  180.   * Add settings to control position and behaviour of the error messages

  181. 

  182. USAGE

  183. =====

  184.   The only thing this module will do is translate validation rules defined in

  185.   PHP to javascript counter parts, if you mark a field as required it will

  186.   create a javascript rule that checks the field on submit. This means no real

  187.   configuration is needed. You can however configure the prefix and suffix used

  188.   for the field names in the error messages (e.g.: prefix:", suffix:" or

  189.   prefix:<<, suffix:>>), whether or not to use the minified version of

  190.   jquery.validate.js, whether or not to validate hidden fields on specific

  191.   forms, whether or not to validate all vertical tabs or only the visible one

  192.   and to add Clientside Validation to all forms or only to those specified.

  193. 

  194. AUTHOR

  195. ======

  196.   The author can be contacted for paid customizations of this module as well as

  197.   Drupal consulting and development.