Zebra_Form

The class provides templates for built-in client-side and server-side validation procedures.

This validation rules can be applied individually to desired form fields, based on the data we want users to fill in.

When the form is submitted, data is checked first in the browser and if no errors are detected is then sent to the server for processing.

Client-side validation is done via JavaScript (jQuery).

What is new in this release:

• The clientside_validation method now has a new property called "disable_upload_validation" which can be used for disabling any client-side processing of file upload controls; useful for using custom plugins to handle file uploads;
• Changed how placeholders, prefixes and character counters are positioned and these are now relative to the parent element;
• Added lots of new mime types to the mimes.json file;
• Corrections in the documentation, related to the "date" element;
• Added Catalan language file.

What is new in version 2.9.5:

• The clientside_validation method now has a new property called "disable_upload_validation" which can be used for disabling any client-side processing of file upload controls; useful for using custom plugins to handle file uploads;
• Changed how placeholders, prefixes and character counters are positioned and these are now relative to the parent element;
• Added lots of new mime types to the mimes.json file;
• Corrections in the documentation, related to the "date" element;
• Added Catalan language file.

What is new in version 2.9.0:

• Fixed a few depencies related bugs.
• Fixed an issue that broke the library's functionality when using jQuery 1.9.0 (which removed $.browser).
• Fixed a bug where date format not including days or month (like only ‘Y' or ‘M, Y', etc) would never pass validation.
• Fixed a bug where the "Clear" button on the date picker was not using the string from the language file.
• Fixed an issue where the library would break with plugins that hide the original elements and put in their places divs having the exact same classes as the original element.
• Fixed a bug where the "length" rule was not taken into consideration when using "auto_fill" for elements having also the "digits" and/or "number" rule set.

What is new in version 2.8.9c:

• Fixed a bug where dependencies on an element with no other rules would be ignored;
• Fixed a bug where custom arguments for the "custom" rule were not passed correctly;
• Fixed a bug where since the last release the files upload control was not working anymore;
• Fixed a bug where the library would trigger a JavaScript error if none of the form's element would have any validation rule.

What is new in version 2.8.9:

• Fixed a bug where the placeholder, if the element had margins, would not be correctly positioned.
• Fixed a bug where having elements with names representing array properties in JavaScript (length, constructor, prototype) would result in error messages not showing for that particular element in client-side validation.
• Fixed a bug which I thought it was fixed in 2.8.3 regarding the order in which rules are checked.
• Fixed a bug where when having "validate_on_the_fly" for client-side validation and moving away from a date control without selecting a date, would correctly show the error tip with the message, but the error would not automatically go away when selecting date, and the user would manually need to hide the error message.
• Fixed a bug in the CSS affecting notes placed after a date control on Internet Explorer 7.
• Fixed a bug where when using placeholders for textareas the "resize" icon (on browsers that automatically place it on textareas) would appear twice.
• Fixed a bug where having an error message on select control with the "other" option selected, the error message would not automatically disappear once the "other" field was filled out.
• Fixed a WebKit-specific issue where Chrome & Safari seem to get it wrong for password fields when using various font families, and display really small dots instead of the discs that appear for every other browser - now WebKit browsers will behave as expected.
• Updated Zebra_DatePicker to version 1.6.4.

What is new in version 2.8.6:

• Fixed a bug where having the ‘other' option set for select controls having non-numerical values, would result in the form never passing validation;
• Fixed a bug where for select boxes having non-numerical indices, a malicious user could submit other values than those defined when creating the form;

What is new in version 2.8.5:

• Fixed a bug where file controls were *always* required even if the "required" rule was not set.
• Fixed a few bugs related to the generation of the CSRF token where the token was always generated with the default values and was re-generated each time the csrf() method was called.
• The library will now automatically decide what method to use for storing the CSRF token (session or cookie) in so that if a session is already started it will store the token in session or in a cookie otherwise; thanks to PunKeel for the heads up.

What is new in version 2.8.4:

• Fixed a few bugs related to the date control.
• Fixed a bug where setting "validate_all" to true would have no effects.
• Hopefully the bug where sometimes error messages remained stuck and could not be closed anymore, is now fixed.
• Placeholders now clone the parent element's styles (padding, border, font style, font weight, font size).
• The minimum required PHP version is now 4.3 instead of 4.2.
• Hidden fields used by the library internally were previously available in the $_POST superglobal after submission and now are automatically stripped out so that we don't pollute the $_POST.

What is new in version 2.8.3:

• A new property of Zebra_Form is now available: "file_upload_permissions" which can be used to set the filesystem permissions for uploaded files;
• 12 hour format can now also be used for the "time" control;
• Changed the name of the "first_day_of_the_week" method (available for the "Date" control) to "first_day_of_week"; thanks to Edward for the feedback
• default padding for text boxes, text areas, passwords and selects was changed from "padding: 4px 3px 3px" to "padding: 5px" (in zebra_form.css) thus slightly increasing their size; note that this might break your layout, so be Careful and change it back if it does so;
• Updated Zebra_DatePicker to version 1.4
• Most examples were updated
• Some corrections and additions to the documentation.

What is new in version 2.8.2:

• The upload rule now has also a client-side validation side, where it checks if the indicated path exists and is writable.
• Fixed a bug for file uploads where, if the name of the uploaded file was too long, the "x" for canceling was not visible anymore.
• Fixed a bug where, after selecting a file, by clicking very close to the file's name, users could open the file picker again, resulting in bogus visuals.
• Fixed a bug which made the file name not to appear for an upload control having "upload" as the sole attached rule.
• Updated Zebra_DatePicker to version 1.3.2.

Requirements:

• PHP 5.0.2 or higher
• JavaScript enabled on client side
• jQuery