FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...

PresideCMS Extension: Validation Extras

v1.2.1+0000043 Preside Extensions

Preside Validation Extras

A collection of useful additional validators for use with Preside's forms system.

Installation

box install preside-ext-validation-extras

The validators

requiredIfOtherFieldChecked

Makes a field required if another specified checkbox field is checked.

<field name="subscribe"     control="checkbox" />
<field name="email_address" control="emailInput">
	<rule validator="requiredIfOtherFieldChecked">
		<param name="otherField"   value="subscribe" />
		<param name="checkedValue" value="1" />
	</rule>
</field>

requiredIfOtherFieldNotChecked

Makes a field required if another specified checkbox field is not checked.

<field name="use_billing_address" control="checkbox" />
<field name="shipping_address">
	<rule validator="requiredIfOtherFieldNotChecked">
		<param name="otherField"   value="use_billing_address" />
		<param name="checkedValue" value="1" />
	</rule>
</field>

requiredIfOtherFieldEmpty

Makes a field required if another specified field is empty. In this example, at least one of the inputs would have to be filled.

<field name="input_one">
	<rule validator="requiredIfOtherFieldEmpty">
		<param name="otherField" value="input_two" />
	</rule>
</field>
<field name="input_two">
	<rule validator="requiredIfOtherFieldEmpty">
		<param name="otherField" value="input_one" />
	</rule>
</field>

requiredIfOtherFieldNotEmpty

Makes a field required if another specified field is not empty. In this example, if one input is filled then the other is also required.

<field name="address">
	<rule validator="requiredIfOtherFieldNotEmpty">
		<param name="otherField" value="postcode" />
	</rule>
</field>
<field name="postcode">
	<rule validator="requiredIfOtherFieldNotEmpty">
		<param name="otherField" value="address" />
	</rule>
</field>

requiredIfOtherFieldValue

Makes a field required if the value of another field matches the specified value. Here, if "Yes" is chosen from the subcribe select control, then the email address is required.

<field name="subscribe"     control="select" values="yes,no" />
<field name="email_address" control="emailInput">
	<rule validator="requiredIfOtherFieldValue">
		<param name="otherField"      value="subscribe" />
		<param name="otherFieldValue" value="yes" />
	</rule>
</field>

requiredIfOtherFieldMatchSystemLookup

Makes a field required if the value of another field matches systemSetting. In this example, if the ethnicity value matches the value on systemSetting ( category="lookup", setting="ethnicity_other" ), then the ethnicity_other field will be required

<field name="ethnicity"       control="objectPicker" object="ethnicity" />
<field name="ethnicity_other" control="textInput">
	<rule validator="requiredIfOtherFieldMatchSystemLookup">
		<param name="otherField" value="ethnicity"       />
		<param name="category"   value="lookup"          />
		<param name="setting"    value="ethnicity_other" />
	</rule>
</field>

simpleUrl

Checks for a simple web URL. Requires either http:// or https:// at the start.

<field name="website_url">
	<rule validator="simpleUrl" />
</field>

ukPhone

Validates a phone number is valid for the UK. Allows brackets, spaces, +44 or 0 prefix, and an optional extension following a #.

<field name="telephone">
	<rule validator="ukPhone" />
</field>

ukPostcode

Validates a UK postcode format. Valid with or without a space in the middle.

<field name="postal_code">
	<rule validator="ukPostcode" />
</field>

ukDrivingLicence

Validates a UK driving licence number.

<field name="driving_licence">
	<rule validator="ukDrivingLicence" />
</field>

Contributing

Contribution in all forms is very welcome. Use Github to create pull requests for tests, logic, features and documentation. Or, get in touch over at Preside's slack team and we'll be happy to help and chat: https://presidecms-slack.herokuapp.com/.

Changelog

v1.2.1

  • Update build version generator

v1.2.0

  • VALIDATION-5 - requiredIfOtherFieldInValues to allow required for multiple values
  • VALIDATION-4 - Add rule for a field to be required if other field match system config

v1.1.0

  • VALIDATION-3 - requiredIfOtherFieldValue should work with radio lists

v1.0.5

  • VALIDATION-2 - i18n missing on error label when "required if checkbox checked" fields are not filled in

v1.0.4

  • Further fix to Javascript validator for requiredIfOtherFieldChecked

v1.0.3

  • Use correct i18n error message for simpleUrl validator

v1.0.2

  • Use Github Actions for building and deploying
  • Fix Javascript validator for requiredIfOtherFieldChecked

$ box install preside-ext-validation-extras

No collaborators yet.
     
  • {{ getFullDate("2019-02-11T13:28:09Z") }}
  • {{ getFullDate("2024-02-22T10:42:27Z") }}
  • 2,468
  • 74,133