├── LICENSE.md
├── README.md
├── Zebra_Form.php
├── composer.json
├── examples
├── includes
│ ├── contact-custom.php
│ ├── contact-horizontal.php
│ ├── contact-vertical.php
│ ├── container-html
│ │ └── container.html
│ ├── custom-templates
│ │ ├── contact.php
│ │ ├── divs-login.php
│ │ ├── example1-dependencies.php
│ │ ├── example2-dependencies.php
│ │ ├── registration.php
│ │ ├── reservation.php
│ │ └── tables-login.php
│ ├── dependencies-example1-custom.php
│ ├── dependencies-example2-custom.php
│ ├── fileupload-basic-image-vertical.php
│ ├── fileupload-basic-vertical.php
│ ├── login-divs-custom.php
│ ├── login-horizontal.php
│ ├── login-labels-inside.php
│ ├── login-tables-custom.php
│ ├── login-vertical.php
│ ├── registration-custom.php
│ ├── registration-horizontal.php
│ ├── registration-vertical.php
│ ├── reservation-autofill-vertical.php
│ ├── reservation-custom.php
│ ├── reservation-horizontal.php
│ ├── reservation-vertical.php
│ └── validation-vertical.php
├── index.html
├── index.php
├── libraries
│ └── highlight
│ │ └── public
│ │ ├── AUTHORS.en.txt
│ │ ├── LICENSE
│ │ ├── css
│ │ ├── dark.css
│ │ ├── default.css
│ │ ├── ir_black.css
│ │ ├── sunburst.css
│ │ └── zenburn.css
│ │ ├── javascript
│ │ ├── css.js
│ │ ├── highlight.js
│ │ ├── html-xml.js
│ │ ├── javascript.js
│ │ └── php.js
│ │ └── readme.eng.txt
└── public
│ ├── css
│ ├── reset.css
│ └── style.css
│ ├── images
│ ├── comment.png
│ ├── letter.png
│ └── user.png
│ └── javascript
│ ├── core.js
│ └── jquery-1.12.0.js
├── includes
├── Button.php
├── Captcha.php
├── Checkbox.php
├── Control.php
├── Date.php
├── File.php
├── Hidden.php
├── Image.php
├── Label.php
├── Note.php
├── Password.php
├── Radio.php
├── Reset.php
├── Select.php
├── Submit.php
├── Text.php
├── Textarea.php
├── Time.php
├── XSSClean.php
├── babelsans-bold.ttf
└── index.html
├── index.html
├── languages
├── afrikaans.php
├── albanian.php
├── catalan.php
├── deutsch.php
├── dutch.php
├── english.php
├── espanol.php
├── francais.php
├── index.html
├── italiano.php
├── japanese.php
├── romana.php
├── russian.php
└── türk.php
├── mimes.json
├── process.php
└── public
├── css
├── button-background.gif
├── calendar-disabled.png
├── calendar.png
├── close.png
├── ico-close.gif
├── ico-close.png
├── ico-refresh.gif
├── ico-refresh.png
├── ico-warning.gif
├── ico-warning.png
├── index.html
├── note.gif
├── spinner.gif
├── textbox-background.gif
└── zebra_form.css
├── index.html
└── javascript
├── index.html
├── readme.txt
├── zebra_form.js
└── zebra_form.src.js
/LICENSE.md:
--------------------------------------------------------------------------------
1 | ### GNU LESSER GENERAL PUBLIC LICENSE
2 |
3 | Version 3, 29 June 2007
4 |
5 | Copyright (C) 2007 Free Software Foundation, Inc.
6 |
7 |
8 | Everyone is permitted to copy and distribute verbatim copies of this
9 | license document, but changing it is not allowed.
10 |
11 | This version of the GNU Lesser General Public License incorporates the
12 | terms and conditions of version 3 of the GNU General Public License,
13 | supplemented by the additional permissions listed below.
14 |
15 | #### 0. Additional Definitions.
16 |
17 | As used herein, "this License" refers to version 3 of the GNU Lesser
18 | General Public License, and the "GNU GPL" refers to version 3 of the
19 | GNU General Public License.
20 |
21 | "The Library" refers to a covered work governed by this License, other
22 | than an Application or a Combined Work as defined below.
23 |
24 | An "Application" is any work that makes use of an interface provided
25 | by the Library, but which is not otherwise based on the Library.
26 | Defining a subclass of a class defined by the Library is deemed a mode
27 | of using an interface provided by the Library.
28 |
29 | A "Combined Work" is a work produced by combining or linking an
30 | Application with the Library. The particular version of the Library
31 | with which the Combined Work was made is also called the "Linked
32 | Version".
33 |
34 | The "Minimal Corresponding Source" for a Combined Work means the
35 | Corresponding Source for the Combined Work, excluding any source code
36 | for portions of the Combined Work that, considered in isolation, are
37 | based on the Application, and not on the Linked Version.
38 |
39 | The "Corresponding Application Code" for a Combined Work means the
40 | object code and/or source code for the Application, including any data
41 | and utility programs needed for reproducing the Combined Work from the
42 | Application, but excluding the System Libraries of the Combined Work.
43 |
44 | #### 1. Exception to Section 3 of the GNU GPL.
45 |
46 | You may convey a covered work under sections 3 and 4 of this License
47 | without being bound by section 3 of the GNU GPL.
48 |
49 | #### 2. Conveying Modified Versions.
50 |
51 | If you modify a copy of the Library, and, in your modifications, a
52 | facility refers to a function or data to be supplied by an Application
53 | that uses the facility (other than as an argument passed when the
54 | facility is invoked), then you may convey a copy of the modified
55 | version:
56 |
57 | - a) under this License, provided that you make a good faith effort
58 | to ensure that, in the event an Application does not supply the
59 | function or data, the facility still operates, and performs
60 | whatever part of its purpose remains meaningful, or
61 | - b) under the GNU GPL, with none of the additional permissions of
62 | this License applicable to that copy.
63 |
64 | #### 3. Object Code Incorporating Material from Library Header Files.
65 |
66 | The object code form of an Application may incorporate material from a
67 | header file that is part of the Library. You may convey such object
68 | code under terms of your choice, provided that, if the incorporated
69 | material is not limited to numerical parameters, data structure
70 | layouts and accessors, or small macros, inline functions and templates
71 | (ten or fewer lines in length), you do both of the following:
72 |
73 | - a) Give prominent notice with each copy of the object code that
74 | the Library is used in it and that the Library and its use are
75 | covered by this License.
76 | - b) Accompany the object code with a copy of the GNU GPL and this
77 | license document.
78 |
79 | #### 4. Combined Works.
80 |
81 | You may convey a Combined Work under terms of your choice that, taken
82 | together, effectively do not restrict modification of the portions of
83 | the Library contained in the Combined Work and reverse engineering for
84 | debugging such modifications, if you also do each of the following:
85 |
86 | - a) Give prominent notice with each copy of the Combined Work that
87 | the Library is used in it and that the Library and its use are
88 | covered by this License.
89 | - b) Accompany the Combined Work with a copy of the GNU GPL and this
90 | license document.
91 | - c) For a Combined Work that displays copyright notices during
92 | execution, include the copyright notice for the Library among
93 | these notices, as well as a reference directing the user to the
94 | copies of the GNU GPL and this license document.
95 | - d) Do one of the following:
96 | - 0) Convey the Minimal Corresponding Source under the terms of
97 | this License, and the Corresponding Application Code in a form
98 | suitable for, and under terms that permit, the user to
99 | recombine or relink the Application with a modified version of
100 | the Linked Version to produce a modified Combined Work, in the
101 | manner specified by section 6 of the GNU GPL for conveying
102 | Corresponding Source.
103 | - 1) Use a suitable shared library mechanism for linking with
104 | the Library. A suitable mechanism is one that (a) uses at run
105 | time a copy of the Library already present on the user's
106 | computer system, and (b) will operate properly with a modified
107 | version of the Library that is interface-compatible with the
108 | Linked Version.
109 | - e) Provide Installation Information, but only if you would
110 | otherwise be required to provide such information under section 6
111 | of the GNU GPL, and only to the extent that such information is
112 | necessary to install and execute a modified version of the
113 | Combined Work produced by recombining or relinking the Application
114 | with a modified version of the Linked Version. (If you use option
115 | 4d0, the Installation Information must accompany the Minimal
116 | Corresponding Source and Corresponding Application Code. If you
117 | use option 4d1, you must provide the Installation Information in
118 | the manner specified by section 6 of the GNU GPL for conveying
119 | Corresponding Source.)
120 |
121 | #### 5. Combined Libraries.
122 |
123 | You may place library facilities that are a work based on the Library
124 | side by side in a single library together with other library
125 | facilities that are not Applications and are not covered by this
126 | License, and convey such a combined library under terms of your
127 | choice, if you do both of the following:
128 |
129 | - a) Accompany the combined library with a copy of the same work
130 | based on the Library, uncombined with any other library
131 | facilities, conveyed under the terms of this License.
132 | - b) Give prominent notice with the combined library that part of it
133 | is a work based on the Library, and explaining where to find the
134 | accompanying uncombined form of the same work.
135 |
136 | #### 6. Revised Versions of the GNU Lesser General Public License.
137 |
138 | The Free Software Foundation may publish revised and/or new versions
139 | of the GNU Lesser General Public License from time to time. Such new
140 | versions will be similar in spirit to the present version, but may
141 | differ in detail to address new problems or concerns.
142 |
143 | Each version is given a distinguishing version number. If the Library
144 | as you received it specifies that a certain numbered version of the
145 | GNU Lesser General Public License "or any later version" applies to
146 | it, you have the option of following the terms and conditions either
147 | of that published version or of any later version published by the
148 | Free Software Foundation. If the Library as you received it does not
149 | specify a version number of the GNU Lesser General Public License, you
150 | may choose any version of the GNU Lesser General Public License ever
151 | published by the Free Software Foundation.
152 |
153 | If the Library as you received it specifies that a proxy can decide
154 | whether future versions of the GNU Lesser General Public License shall
155 | apply, that proxy's public statement of acceptance of any version is
156 | permanent authorization for you to choose that version for the
157 | Library.
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # Zebra_Form
2 |
3 | #### A jQuery augmented PHP library for creating and validating HTML forms
4 |
5 | ----
6 | [Packagist](https://packagist.org/) stats
7 |
8 | [](https://packagist.org/packages/stefangabos/zebra_form) [](https://packagist.org/packages/stefangabos/zebra_form) [](https://packagist.org/packages/stefangabos/zebra_form) [](https://packagist.org/packages/stefangabos/zebra_form) [](https://packagist.org/packages/stefangabos/zebra_form)
9 |
10 | Zebra_Form is a PHP library that greatly simplifies the process of creating and validating HTML forms. Its object-oriented structure promotes rapid HTML forms development and encourages developers to write clean and easily maintainable code and it frees the developers from the repetitive task of writing the code for validating forms by offering powerful built-in client-side and server-side validation.
11 |
12 | Zebra_Form has integrated [cross-site scripting](http://en.wikipedia.org/wiki/Cross-site_scripting) (XSS) prevention mechanism that automatically strips out potentially malicious code from the submitted data, and also features protection against [cross-site request forgery](http://en.wikipedia.org/wiki/Cross-site_request_forgery) (CSRF) attacks. It also prevents automated SPAM posts, out of the box and without relying on CAPTCHA by using [honeypots](http://haacked.com/archive/2007/09/11/honeypot-captcha.aspx).
13 |
14 | Forms layout can be generated either automatically or manually – using templates. When generated automatically, the generated output validates as HTML 4.01 Strict, XHTML 1.0 Strict or HTML5, and has the same look & feel across all major browsers like Firefox, Chrome, Opera, Safari and Internet Explorer 6+.
15 |
16 | It provides all the controls you’d expect in an HTML form and, additionally, date/time pickers, CAPTCHA and advanced AJAX-like file upload controls – see the [documentation](http://stefangabos.ro/wp-content/docs/Zebra_Form/Generic/Zebra_Form_Control.html#methodset_rule) for validation rules that can be used out of the box.
17 |
18 | The client-side validation is done using jQuery 1.5.2+
19 |
20 | Zebra\_Form's code is heavily commented and generates no warnings/errors/notices when PHP’s error reporting level is set to E_ALL.
21 |
22 | ## Features
23 |
24 | - provides protection against cross-site scripting (XSS) and cross-site request forgery (CSRF) attacks out of the box
25 | it automatically prevents automated SPAM posts using the “honeypot” technique (CAPTCHAs can also be used for even stronger protection)
26 | - provides both server-side and client-side validation (client-side validation is done using jQuery 1.5.2+) and has a lot of predefined rules that can be used out of the box; custom validation rules (including AJAX-based) can easily be added
27 | - forms’ layout can be generated either automatically or manually using templates
28 | - generated output validates as HTML 4.01 Strict, XHTML 1.0 Strict or HTML5
29 | - works in all major browsers like Firefox, Chrome, Opera, Safari and Internet Explorer 6+
30 | - code is heavily commented and generates no warnings/errors/notices when PHP’s error reporting level is set to E_ALL
31 | - has comprehensive documentation
32 |
33 | ## Requirements
34 |
35 | PHP 5.0.2+ (preferably PHP 5.3.0 compiled with the “fileinfo” extension for more secure file uploads – read more at the change log for version 2.7.3)
36 |
37 | jQuery 1.5.2+
38 |
39 | ## How to use
40 |
41 | ##### The HTML
42 |
43 | ```html
44 |
45 |
46 |
47 |
48 |
49 |
50 |
51 | Zebra_Form Example
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 |
63 |
64 |
65 |
66 |
67 |
68 |
69 |
70 |
71 |
72 |
73 | ```
74 |
75 | ##### The PHP
76 |
77 | ```php
78 | // include the Zebra_Form class
79 | require 'path/to/Zebra_Form.php';
80 |
81 | // instantiate a Zebra_Form object
82 | $form = new Zebra_Form('form');
83 |
84 | // the label for the "email" field
85 | $form->add('label', 'label_email', 'email', 'Email');
86 |
87 | // add the "email" field
88 | $obj = $form->add('text', 'email', '', array('autocomplete' => 'off'));
89 |
90 | // set rules
91 | $obj->set_rule(array(
92 |
93 | // error messages will be sent to a variable called "error", usable in custom templates
94 | 'required' => array('error', 'Email is required!'),
95 | 'email' => array('error', 'Email address seems to be invalid!'),
96 |
97 | ));
98 |
99 | // "password"
100 | $form->add('label', 'label_password', 'password', 'Password');
101 |
102 | $obj = $form->add('password', 'password', '', array('autocomplete' => 'off'));
103 |
104 | $obj->set_rule(array(
105 |
106 | 'required' => array('error', 'Password is required!'),
107 | 'length' => array(6, 10, 'error', 'The password must have between 6 and 10 characters'),
108 |
109 | ));
110 |
111 | // "remember me"
112 | $form->add('checkbox', 'remember_me', 'yes');
113 |
114 | $form->add('label', 'label_remember_me_yes', 'remember_me_yes', 'Remember me');
115 |
116 | // "submit"
117 | $form->add('submit', 'btnsubmit', 'Submit');
118 |
119 | // validate the form
120 | if ($form->validate()) {
121 |
122 | // do stuff here
123 |
124 | }
125 |
126 | // auto generate output, labels above form elements
127 | $form->render();
128 | ```
129 |
130 | For demos and more information visit the **[project's homepage](http://stefangabos.ro/php-libraries/zebra-form/)**
131 |
--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "stefangabos/zebra_form",
3 | "type": "library",
4 | "description": "A jQuery augmented PHP library for creating and validating HTML forms",
5 | "keywords": ["form","validation", "csrf", "xss", "honeypot", "validate", "jquery validation", "client side validation", "server side validation"],
6 | "homepage": "http://stefangabos.ro/php-libraries/zebra-form/",
7 | "license": "LGPL-3.0",
8 | "authors": [
9 | {
10 | "name": "Stefan Gabos",
11 | "email": "contact@stefangabos.ro",
12 | "homepage": "http://stefangabos.ro/",
13 | "role": "Developer"
14 | }
15 | ],
16 | "require": {
17 | "php": ">=5.3.0"
18 | },
19 | "version": "2.9.8",
20 | "autoload": {
21 | "classmap": [
22 | "Zebra_Form.php"
23 | ]
24 | }
25 | }
26 |
--------------------------------------------------------------------------------
/examples/includes/contact-custom.php:
--------------------------------------------------------------------------------
1 |
A contact form
2 |
3 |
Note the uneditable prefixes (text and images) for some of the fields.
4 |
5 |
Check the "Template source" tab to see how it's done!
4 |
5 | add('label', 'label_file', 'file', 'Upload an image');
15 |
16 | // add the "file" element
17 | $obj = $form->add('file', 'file');
18 |
19 | // set rules
20 | $obj->set_rule(array(
21 |
22 | // error messages will be sent to a variable called "error", usable in custom templates
23 | 'required' => array('error', 'An image is required!'),
24 | 'upload' => array('tmp', ZEBRA_FORM_UPLOAD_RANDOM_NAMES, 'error', 'Could not upload file! Check that the "tmp" folder exists inside the "examples" folder and that it is writable'),
25 |
26 | // notice how we use the "image" rule instead of the "filetype" rule (used in previous example);
27 | // the "image" rule does a thorough checking aimed specially for images
28 | 'image' => array('error', 'File must be a jpg, png or gif image!'),
29 | 'filesize' => array(102400, 'error', 'File size must not exceed 100Kb!'),
30 |
31 | ));
32 |
33 | // attach a note
34 | $form->add('note', 'note_file', 'file', 'File must have the .jpg, .jpeg, png or .gif extension, and no more than 100Kb!');
35 |
36 | // "submit"
37 | $form->add('submit', 'btnsubmit', 'Submit');
38 |
39 | // validate the form
40 | if ($form->validate()) {
41 |
42 | // do stuff here
43 | print_r('
Once you upload the file, don't forget to look into the "tmp" folder inside the "examples" folder for the result.
4 |
5 | add('label', 'label_file', 'file', 'Upload Microsoft Word document');
15 |
16 | // add the "file" element
17 | $obj = $form->add('file', 'file');
18 |
19 | // set rules
20 | $obj->set_rule(array(
21 |
22 | // error messages will be sent to a variable called "error", usable in custom templates
23 | 'required' => array('error', 'A Microsoft Word document is required!'),
24 | 'upload' => array('tmp', ZEBRA_FORM_UPLOAD_RANDOM_NAMES, 'error', 'Could not upload file! Check that the "tmp" folder exists inside the "examples" folder and that it is writable'),
25 | 'filetype' => array('doc, docx', 'error', 'File must be a Microsoft Word document!'),
26 | 'filesize' => array(102400, 'error', 'File size must not exceed 100Kb!'),
27 |
28 | ));
29 |
30 | // attach a note
31 | $form->add('note', 'note_file', 'file', 'File must have the .doc or .docx extension, and no more than 100Kb!');
32 |
33 | // "submit"
34 | $form->add('submit', 'btnsubmit', 'Submit');
35 |
36 | // validate the form
37 | if ($form->validate()) {
38 |
39 | // do stuff here
40 | print_r('
In this demo we're creating a custom template using only divs; this is suitable for creating "vertical" templates (when
4 | a control's label is above the control), but when we want some elements to be side-by-side. Don't forget to check the
5 | "Template source" tab to see how it's done.
6 |
7 | 'off'));
14 |
15 | // the label for the "email" element
16 | $form->add('label', 'label_email', 'email', 'Email');
17 |
18 | // add the "email" element
19 | $obj = $form->add('text', 'email');
20 |
21 | // set rules
22 | $obj->set_rule(array(
23 |
24 | // error messages will be sent to a variable called "error", usable in custom templates
25 | 'required' => array('error', 'Email is required!'),
26 | 'email' => array('error', 'Email address seems to be invalid!'),
27 |
28 | ));
29 |
30 | // "password"
31 | $form->add('label', 'label_password', 'password', 'Password');
32 |
33 | $obj = $form->add('password', 'password');
34 |
35 | $obj->set_rule(array(
36 |
37 | 'required' => array('error', 'Password is required!'),
38 | 'length' => array(6, 10, 'error', 'The password must have between 6 and 10 characters!'),
39 |
40 | ));
41 |
42 | // "remember me"
43 | $form->add('checkbox', 'remember_me', 'yes');
44 |
45 | $form->add('label', 'label_remember_me_yes', 'remember_me_yes', 'Remember me', array('style' => 'font-weight:normal'));
46 |
47 | // "submit"
48 | $form->add('submit', 'btnsubmit', 'Submit');
49 |
50 | // if the form is valid
51 | if ($form->validate()) {
52 |
53 | // show results
54 | show_results();
55 |
56 | // otherwise
57 | } else
58 |
59 | // generate output using a custom template
60 | $form->render('includes/custom-templates/divs-login.php');
61 |
62 | ?>
63 |
--------------------------------------------------------------------------------
/examples/includes/login-horizontal.php:
--------------------------------------------------------------------------------
1 |
A login form
2 |
3 | 'off'));
10 |
11 | // the label for the "email" element
12 | $form->add('label', 'label_email', 'email', 'Email');
13 |
14 | // add the "email" element
15 | $obj = $form->add('text', 'email');
16 |
17 | // set rules
18 | $obj->set_rule(array(
19 |
20 | // error messages will be sent to a variable called "error", usable in custom templates
21 | 'required' => array('error', 'Email is required!'),
22 | 'email' => array('error', 'Email address seems to be invalid!'),
23 |
24 | ));
25 |
26 | // "password"
27 | $form->add('label', 'label_password', 'password', 'Password');
28 | $obj = $form->add('password', 'password');
29 | $obj->set_rule(array(
30 | 'required' => array('error', 'Password is required!'),
31 | 'length' => array(6, 10, 'error', 'The password must have between 6 and 10 characters!'),
32 | ));
33 |
34 | // "remember me"
35 | $form->add('checkbox', 'remember_me', 'yes');
36 | $form->add('label', 'label_remember_me_yes', 'remember_me_yes', 'Remember me', array('style' => 'font-weight:normal'));
37 |
38 | // "submit"
39 | $form->add('submit', 'btnsubmit', 'Submit');
40 |
41 | // if the form is valid
42 | if ($form->validate()) {
43 |
44 | // show results
45 | show_results();
46 |
47 | // otherwise
48 | } else
49 |
50 | // generate output using a custom template
51 | $form->render('*horizontal');
52 |
53 | ?>
54 |
--------------------------------------------------------------------------------
/examples/includes/login-labels-inside.php:
--------------------------------------------------------------------------------
1 |
A login form
2 |
3 | 'off'));
10 |
11 | // the label for the "email" element
12 | $form->add('label', 'label_email', 'email', 'Email address', array('inside' => true));
13 |
14 | // add the "email" element
15 | $obj = $form->add('text', 'email');
16 |
17 | // set rules
18 | $obj->set_rule(array(
19 |
20 | // error messages will be sent to a variable called "error", usable in custom templates
21 | 'required' => array('error', 'Email is required!'),
22 | 'email' => array('error', 'Email address seems to be invalid!'),
23 |
24 | ));
25 |
26 | // "password"
27 | $form->add('label', 'label_password', 'password', 'Password', array('inside' => true));
28 | $obj = $form->add('password', 'password');
29 | $obj->set_rule(array(
30 | 'required' => array('error', 'Password is required!'),
31 | 'length' => array(6, 10, 'error', 'The password must have between 6 and 10 characters!'),
32 | ));
33 |
34 | // "remember me"
35 | $form->add('checkbox', 'remember_me', 'yes');
36 | $form->add('label', 'label_remember_me_yes', 'remember_me_yes', 'Remember me', array('style' => 'font-weight:normal'));
37 |
38 | // "submit"
39 | $form->add('submit', 'btnsubmit', 'Submit');
40 |
41 | // if the form is valid
42 | if ($form->validate()) {
43 |
44 | // show results
45 | show_results();
46 |
47 | // otherwise
48 | } else
49 |
50 | // generate output using a custom template
51 | $form->render();
52 |
53 | ?>
54 |
--------------------------------------------------------------------------------
/examples/includes/login-tables-custom.php:
--------------------------------------------------------------------------------
1 |
A login form
2 |
3 |
In this demo we're creating a custom template using tables; this is suitable for creating "horizontal" templates (when
4 | a control's label is to the left of the control). Don't forget to check the "Template source" tab to see how it's done.
5 |
6 | 'off'));
13 |
14 | // the label for the "email" element
15 | $form->add('label', 'label_email', 'email', 'Email');
16 |
17 | // add the "email" element
18 | $obj = $form->add('text', 'email');
19 |
20 | // set rules
21 | $obj->set_rule(array(
22 |
23 | // error messages will be sent to a variable called "error", usable in custom templates
24 | 'required' => array('error', 'Email is required!'),
25 | 'email' => array('error', 'Email address seems to be invalid!'),
26 |
27 | ));
28 |
29 | // "password"
30 | $form->add('label', 'label_password', 'password', 'Password');
31 | $obj = $form->add('password', 'password');
32 | $obj->set_rule(array(
33 | 'required' => array('error', 'Password is required!'),
34 | 'length' => array(6, 10, 'error', 'The password must have between 6 and 10 characters!'),
35 | ));
36 |
37 | // "remember me"
38 | $form->add('checkbox', 'remember_me', 'yes');
39 | $form->add('label', 'label_remember_me_yes', 'remember_me_yes', 'Remember me', array('style' => 'font-weight:normal'));
40 |
41 | // "submit"
42 | $form->add('submit', 'btnsubmit', 'Submit');
43 |
44 | // if the form is valid
45 | if ($form->validate()) {
46 |
47 | // show results
48 | show_results();
49 |
50 | // otherwise
51 | } else
52 |
53 | // generate output using a custom template
54 | $form->render('includes/custom-templates/tables-login.php');
55 |
56 | ?>
57 |
--------------------------------------------------------------------------------
/examples/includes/login-vertical.php:
--------------------------------------------------------------------------------
1 |
A login form
2 |
3 | 'off'));
10 |
11 | // the label for the "email" element
12 | $form->add('label', 'label_email', 'email', 'Email');
13 |
14 | // add the "email" element
15 | $obj = $form->add('text', 'email');
16 |
17 | // set rules
18 | $obj->set_rule(array(
19 |
20 | // error messages will be sent to a variable called "error", usable in custom templates
21 | 'required' => array('error', 'Email is required!'),
22 | 'email' => array('error', 'Email address seems to be invalid!'),
23 |
24 | ));
25 |
26 | // "password"
27 | $form->add('label', 'label_password', 'password', 'Password');
28 | $obj = $form->add('password', 'password');
29 | $obj->set_rule(array(
30 | 'required' => array('error', 'Password is required!'),
31 | 'length' => array(6, 10, 'error', 'The password must have between 6 and 10 characters!'),
32 | ));
33 |
34 | // "remember me"
35 | $form->add('checkbox', 'remember_me', 'yes');
36 | $form->add('label', 'label_remember_me_yes', 'remember_me_yes', 'Remember me', array('style' => 'font-weight:normal'));
37 |
38 | // "submit"
39 | $form->add('submit', 'btnsubmit', 'Submit');
40 |
41 | // if the form is valid
42 | if ($form->validate()) {
43 |
44 | // show results
45 | show_results();
46 |
47 | // otherwise
48 | } else
49 |
50 | // auto generate output, labels above form elements
51 | $form->render();
52 |
53 | ?>
54 |
--------------------------------------------------------------------------------
/examples/includes/registration-custom.php:
--------------------------------------------------------------------------------
1 |
A registration form
2 |
3 |
Check the "Template source" tab to see how it's done!
4 |
5 | 'off'));
12 |
13 | // the label for the "first name" element
14 | $form->add('label', 'label_firstname', 'firstname', 'First name:');
15 |
16 | // add the "first name" element
17 | $obj = $form->add('text', 'firstname');
18 |
19 | // set rules
20 | $obj->set_rule(array(
21 |
22 | // error messages will be sent to a variable called "error", usable in custom templates
23 | 'required' => array('error', 'First name is required!'),
24 |
25 | ));
26 |
27 | // "last name"
28 | $form->add('label', 'label_lastname', 'lastname', 'Last name:');
29 | $obj = $form->add('text', 'lastname');
30 | $obj->set_rule(array(
31 | 'required' => array('error', 'Last name is required!')
32 | ));
33 |
34 | // "email"
35 | $form->add('label', 'label_email', 'email', 'Email address:');
36 | $obj = $form->add('text', 'email');
37 | $obj->set_rule(array(
38 | 'required' => array('error', 'Email is required!'),
39 | 'email' => array('error', 'Email address seems to be invalid!')
40 | ));
41 |
42 | // attach a note to the email element
43 | $form->add('note', 'note_email', 'email', 'Please enter a valid email address. An email will be sent to this
44 | address with a link you need to click on in order to activate your account', array('style'=>'width:200px'));
45 |
46 | // "password"
47 | $form->add('label', 'label_password', 'password', 'Choose a password:');
48 | $obj = $form->add('password', 'password');
49 | $obj->set_rule(array(
50 | 'required' => array('error', 'Password is required!'),
51 | 'length' => array(6, 10, 'error', 'The password must have between 6 and 10 characters'),
52 | ));
53 | $form->add('note', 'note_password', 'password', 'Password must be have between 6 and 10 characters.', array('style' => 'width: 180px'));
54 |
55 | // "confirm password"
56 | $form->add('label', 'label_confirm_password', 'confirm_password', 'Confirm password:');
57 | $obj = $form->add('password', 'confirm_password');
58 | $obj->set_rule(array(
59 | 'compare' => array('password', 'error', 'Password not confirmed correctly!')
60 | ));
61 |
62 | // "captcha"
63 | $form->add('captcha', 'captcha_image', 'captcha_code');
64 | $form->add('label', 'label_captcha_code', 'captcha_code', 'Are you human?');
65 | $obj = $form->add('text', 'captcha_code');
66 | $form->add('note', 'note_captcha', 'captcha_code', 'You must enter the characters with black color that stand
67 | out from the other characters', array('style'=>'width: 200px'));
68 | $obj->set_rule(array(
69 | 'required' => array('error', 'Enter the characters from the image above!'),
70 | 'captcha' => array('error', 'Characters from image entered incorrectly!')
71 | ));
72 |
73 | // "submit"
74 | $form->add('submit', 'btnsubmit', 'Submit');
75 |
76 | // if the form is valid
77 | if ($form->validate()) {
78 |
79 | // show results
80 | show_results();
81 |
82 | // otherwise
83 | } else
84 |
85 | // generate output using a custom template
86 | $form->render('includes/custom-templates/registration.php');
87 |
88 | ?>
--------------------------------------------------------------------------------
/examples/includes/registration-horizontal.php:
--------------------------------------------------------------------------------
1 |
A registration form
2 |
3 | 'off'));
10 |
11 | // the label for the "first name" element
12 | $form->add('label', 'label_firstname', 'firstname', 'First name:');
13 |
14 | // add the "first name" element
15 | $obj = $form->add('text', 'firstname');
16 |
17 | // set rules
18 | $obj->set_rule(array(
19 |
20 | // error messages will be sent to a variable called "error", usable in custom templates
21 | 'required' => array('error', 'First name is required!'),
22 |
23 | ));
24 |
25 | // "last name"
26 | $form->add('label', 'label_lastname', 'lastname', 'Last name:');
27 | $obj = $form->add('text', 'lastname');
28 | $obj->set_rule(array(
29 | 'required' => array('error', 'Last name is required!')
30 | ));
31 |
32 | // "email"
33 | $form->add('label', 'label_email', 'email', 'Email address:');
34 | $obj = $form->add('text', 'email');
35 | $obj->set_rule(array(
36 | 'required' => array('error', 'Email is required!'),
37 | 'email' => array('error', 'Email address seems to be invalid!')
38 | ));
39 |
40 | // attach a note to the email element
41 | $form->add('note', 'note_email', 'email', 'Please enter a valid email address. An email will be sent to this
42 | address with a link you need to click on in order to activate your account', array('style'=>'width:200px'));
43 |
44 | // "password"
45 | $form->add('label', 'label_password', 'password', 'Choose a password:');
46 | $obj = $form->add('password', 'password');
47 | $obj->set_rule(array(
48 | 'required' => array('error', 'Password is required!'),
49 | 'length' => array(6, 10, 'error', 'The password must have between 6 and 10 characters'),
50 | ));
51 | $form->add('note', 'note_password', 'password', 'Password must be have between 6 and 10 characters.');
52 |
53 | // "confirm password"
54 | $form->add('label', 'label_confirm_password', 'confirm_password', 'Confirm password:');
55 | $obj = $form->add('password', 'confirm_password');
56 | $obj->set_rule(array(
57 | 'compare' => array('password', 'error', 'Password not confirmed correctly!')
58 | ));
59 |
60 | // "captcha"
61 | $form->add('captcha', 'captcha_image', 'captcha_code');
62 | $form->add('label', 'label_captcha_code', 'captcha_code', 'Are you human?');
63 | $obj = $form->add('text', 'captcha_code');
64 | $form->add('note', 'note_captcha', 'captcha_code', 'You must enter the characters with black color that stand
65 | out from the other characters', array('style'=>'width: 200px'));
66 | $obj->set_rule(array(
67 | 'required' => array('error', 'Enter the characters from the image above!'),
68 | 'captcha' => array('error', 'Characters from image entered incorrectly!')
69 | ));
70 |
71 | // "submit"
72 | $form->add('submit', 'btnsubmit', 'Submit');
73 |
74 | // if the form is valid
75 | if ($form->validate()) {
76 |
77 | // show results
78 | show_results();
79 |
80 | // otherwise
81 | } else
82 |
83 | // generate output using a custom template
84 | $form->render('*horizontal');
85 |
86 | ?>
--------------------------------------------------------------------------------
/examples/includes/registration-vertical.php:
--------------------------------------------------------------------------------
1 |
A registration form
2 |
3 | 'off'));
10 |
11 | // the label for the "first name" element
12 | $form->add('label', 'label_firstname', 'firstname', 'First name:');
13 |
14 | // add the "first name" element
15 | $obj = $form->add('text', 'firstname');
16 |
17 | // set rules
18 | $obj->set_rule(array(
19 |
20 | // error messages will be sent to a variable called "error", usable in custom templates
21 | 'required' => array('error', 'First name is required!'),
22 |
23 | ));
24 |
25 | // "last name"
26 | $form->add('label', 'label_lastname', 'lastname', 'Last name:');
27 | $obj = $form->add('text', 'lastname');
28 | $obj->set_rule(array(
29 | 'required' => array('error', 'Last name is required!')
30 | ));
31 |
32 | // "email"
33 | $form->add('label', 'label_email', 'email', 'Email address:');
34 | $obj = $form->add('text', 'email');
35 | $obj->set_rule(array(
36 | 'required' => array('error', 'Email is required!'),
37 | 'email' => array('error', 'Email address seems to be invalid!')
38 | ));
39 |
40 | // attach a note to the email element
41 | $form->add('note', 'note_email', 'email', 'Please enter a valid email address. An email will be sent to this
42 | address with a link you need to click on in order to activate your account', array('style'=>'width:200px'));
43 |
44 | // "password"
45 | $form->add('label', 'label_password', 'password', 'Choose a password:');
46 | $obj = $form->add('password', 'password');
47 | $obj->set_rule(array(
48 | 'required' => array('error', 'Password is required!'),
49 | 'length' => array(6, 10, 'error', 'The password must have between 6 and 10 characters'),
50 | ));
51 | $form->add('note', 'note_password', 'password', 'Password must be have between 6 and 10 characters.');
52 |
53 | // "confirm password"
54 | $form->add('label', 'label_confirm_password', 'confirm_password', 'Confirm password:');
55 | $obj = $form->add('password', 'confirm_password');
56 | $obj->set_rule(array(
57 | 'compare' => array('password', 'error', 'Password not confirmed correctly!')
58 | ));
59 |
60 | // "captcha"
61 | $form->add('captcha', 'captcha_image', 'captcha_code');
62 | $form->add('label', 'label_captcha_code', 'captcha_code', 'Are you human?');
63 | $obj = $form->add('text', 'captcha_code');
64 | $form->add('note', 'note_captcha', 'captcha_code', 'You must enter the characters with black color that stand
65 | out from the other characters', array('style'=>'width: 200px'));
66 | $obj->set_rule(array(
67 | 'required' => array('error', 'Enter the characters from the image above!'),
68 | 'captcha' => array('error', 'Characters from image entered incorrectly!')
69 | ));
70 |
71 | // "submit"
72 | $form->add('submit', 'btnsubmit', 'Submit');
73 |
74 | // if the form is valid
75 | if ($form->validate()) {
76 |
77 | // show results
78 | show_results();
79 |
80 | // otherwise
81 | } else
82 |
83 | // generate output using a custom template
84 | $form->render();
85 |
86 | ?>
--------------------------------------------------------------------------------
/examples/includes/reservation-autofill-vertical.php:
--------------------------------------------------------------------------------
1 |
A meeting room reservation form
2 |
3 |
All fields will be automatically filled with random values - very useful for when debugging forms. The random values will obey the rules set for each element!
4 |
5 | auto_fill();
16 |
17 | // the label for the "name" element
18 | $form->add('label', 'label_name', 'name', 'Your name:');
19 |
20 | // add the "name" element
21 | $obj = $form->add('text', 'name');
22 |
23 | // set rules
24 | $obj->set_rule(array(
25 |
26 | // error messages will be sent to a variable called "error", usable in custom templates
27 | 'required' => array('error', 'Name is required!')
28 |
29 | ));
30 |
31 | // "email"
32 | $form->add('label', 'label_email', 'email', 'Your email address:');
33 | $obj = $form->add('text', 'email');
34 | $obj->set_rule(array(
35 | 'required' => array('error', 'Email is required!'),
36 | 'email' => array('error', 'Email address seems to be invalid!'),
37 | ));
38 |
39 | // "department"
40 | $form->add('label', 'label_department', 'department', 'Department:');
41 | $obj = $form->add('select', 'department', '', array('other' => true));
42 | $obj->add_options(array(
43 | 'Marketing',
44 | 'Operations',
45 | 'Customer Service',
46 | 'Human Resources',
47 | 'Sales Department',
48 | 'Accounting Department',
49 | 'Legal Department',
50 | ));
51 | $obj->set_rule(array(
52 | 'required' => array('error', 'Department is required!')
53 | ));
54 |
55 | // "room"
56 | $form->add('label', 'label_room', 'room', 'Which room would you like to reserve:');
57 | $obj = $form->add('radios', 'room', array(
58 | 'A' => 'Room A',
59 | 'B' => 'Room B',
60 | 'C' => 'Room C',
61 | ));
62 | $obj->set_rule(array(
63 | 'required' => array('error', 'Room selection is required!')
64 | ));
65 |
66 | // "extra"
67 | $form->add('label', 'label_extra', 'extra', 'Extra requirements:');
68 | $obj = $form->add('checkboxes', 'extra[]', array(
69 | 'flipchard' => 'Flipchard and pens',
70 | 'plasma' => 'Plasma TV screen',
71 | 'beverages' => 'Coffee, tea and mineral water',
72 | ));
73 |
74 | // "date"
75 | $form->add('label', 'label_date', 'date', 'Reservation date');
76 | $date = $form->add('date', 'date');
77 | $date->set_rule(array(
78 | 'required' => array('error', 'Date is required!'),
79 | 'date' => array('error', 'Date is invalid!'),
80 | ));
81 |
82 | // date format
83 | // don't forget to use $date->get_date() if the form is valid to get the date in YYYY-MM-DD format ready to be used
84 | // in a database or with PHP's strtotime function!
85 | $date->format('M d, Y');
86 |
87 | $form->add('note', 'note_date', 'date', 'Date format is M d, Y');
88 |
89 | // "time"
90 | $form->add('label', 'label_time', 'time', 'Reservation time :');
91 | $obj = $form->add('time', 'time', '', array(
92 | 'format' => 'hm',
93 | 'hours' => array(9, 10, 11, 12, 13, 14, 15, 16, 17),
94 | 'minutes' => array(0, 30),
95 | ));
96 |
97 | $obj->set_rule(array(
98 | 'required' => array('error', 'Time is required!'),
99 | ));
100 |
101 | // "submit"
102 | $form->add('submit', 'btnsubmit', 'Submit');
103 |
104 | // if the form is valid
105 | if ($form->validate()) {
106 |
107 | // show results
108 | show_results();
109 |
110 | // otherwise
111 | } else
112 |
113 | // generate output using a custom template
114 | $form->render();
115 |
116 | ?>
--------------------------------------------------------------------------------
/examples/includes/reservation-custom.php:
--------------------------------------------------------------------------------
1 |
A meeting room reservation form
2 |
3 |
Check the "Template source" tab to see how it's done!
4 |
5 | add('label', 'label_name', 'name', 'Your name:');
15 |
16 | // add the "name" element
17 | $obj = $form->add('text', 'name');
18 |
19 | // set rules
20 | $obj->set_rule(array(
21 |
22 | // error messages will be sent to a variable called "error", usable in custom templates
23 | 'required' => array('error', 'Name is required!')
24 |
25 | ));
26 |
27 | // "email"
28 | $form->add('label', 'label_email', 'email', 'Your email address:');
29 | $obj = $form->add('text', 'email');
30 | $obj->set_rule(array(
31 | 'required' => array('error', 'Email is required!'),
32 | 'email' => array('error', 'Email address seems to be invalid!'),
33 | ));
34 |
35 | // "department"
36 | $form->add('label', 'label_department', 'department', 'Department:');
37 | $obj = $form->add('select', 'department', '', array('other' => true));
38 | $obj->add_options(array(
39 | 'Marketing',
40 | 'Operations',
41 | 'Customer Service',
42 | 'Human Resources',
43 | 'Sales Department',
44 | 'Accounting Department',
45 | 'Legal Department',
46 | ));
47 | $obj->set_rule(array(
48 | 'required' => array('error', 'Department is required!')
49 | ));
50 |
51 | // "room"
52 | $form->add('label', 'label_room', 'room', 'Which room would you like to reserve:');
53 | $obj = $form->add('radios', 'room', array(
54 | 'A' => 'Room A',
55 | 'B' => 'Room B',
56 | 'C' => 'Room C',
57 | ));
58 | $obj->set_rule(array(
59 | 'required' => array('error', 'Room selection is required!')
60 | ));
61 |
62 | // "extra"
63 | $form->add('label', 'label_extra', 'extra', 'Extra requirements:');
64 | $obj = $form->add('checkboxes', 'extra[]', array(
65 | 'flipchard' => 'Flipchard and pens',
66 | 'plasma' => 'Plasma TV screen',
67 | 'beverages' => 'Coffee, tea and mineral water',
68 | ));
69 |
70 | // "date"
71 | $form->add('label', 'label_date', 'date', 'Reservation date');
72 | $date = $form->add('date', 'date');
73 | $date->set_rule(array(
74 | 'required' => array('error', 'Date is required!'),
75 | 'date' => array('error', 'Date is invalid!'),
76 | ));
77 |
78 | // date format
79 | // don't forget to use $date->get_date() if the form is valid to get the date in YYYY-MM-DD format ready to be used
80 | // in a database or with PHP's strtotime function!
81 | $date->format('M d, Y');
82 |
83 | // selectable dates are starting with the current day
84 | $date->direction(1);
85 |
86 | $form->add('note', 'note_date', 'date', 'Date format is M d, Y');
87 |
88 | // "time"
89 | $form->add('label', 'label_time', 'time', 'Reservation time :');
90 | $form->add('time', 'time', '', array(
91 | 'hours' => array(9, 10, 11, 12, 13, 14, 15, 16, 17),
92 | 'minutes' => array(0, 30),
93 | ));
94 |
95 | // "submit"
96 | $form->add('submit', 'btnsubmit', 'Submit');
97 |
98 | // if the form is valid
99 | if ($form->validate()) {
100 |
101 | // show results
102 | show_results();
103 |
104 | // otherwise
105 | } else
106 |
107 | // generate output using a custom template
108 | $form->render('includes/custom-templates/reservation.php');
109 |
110 | ?>
--------------------------------------------------------------------------------
/examples/includes/reservation-horizontal.php:
--------------------------------------------------------------------------------
1 |
A meeting room reservation form
2 |
3 | add('label', 'label_name', 'name', 'Your name:');
13 |
14 | // add the "name" element
15 | $obj = $form->add('text', 'name');
16 |
17 | // set rules
18 | $obj->set_rule(array(
19 |
20 | // error messages will be sent to a variable called "error", usable in custom templates
21 | 'required' => array('error', 'Name is required!')
22 |
23 | ));
24 |
25 | // "email"
26 | $form->add('label', 'label_email', 'email', 'Your email address:');
27 | $obj = $form->add('text', 'email');
28 | $obj->set_rule(array(
29 | 'required' => array('error', 'Email is required!'),
30 | 'email' => array('error', 'Email address seems to be invalid!'),
31 | ));
32 |
33 | // "department"
34 | $form->add('label', 'label_department', 'department', 'Department:');
35 | $obj = $form->add('select', 'department', '', array('other' => true));
36 | $obj->add_options(array(
37 | 'Marketing',
38 | 'Operations',
39 | 'Customer Service',
40 | 'Human Resources',
41 | 'Sales Department',
42 | 'Accounting Department',
43 | 'Legal Department',
44 | ));
45 | $obj->set_rule(array(
46 | 'required' => array('error', 'Department is required!')
47 | ));
48 |
49 | // "room"
50 | $form->add('label', 'label_room', 'room', 'Which room would you like to reserve:');
51 | $obj = $form->add('radios', 'room', array(
52 | 'A' => 'Room A',
53 | 'B' => 'Room B',
54 | 'C' => 'Room C',
55 | ));
56 | $obj->set_rule(array(
57 | 'required' => array('error', 'Room selection is required!')
58 | ));
59 |
60 | // "extra"
61 | $form->add('label', 'label_extra', 'extra', 'Extra requirements:');
62 | $obj = $form->add('checkboxes', 'extra[]', array(
63 | 'flipchard' => 'Flipchard and pens',
64 | 'plasma' => 'Plasma TV screen',
65 | 'beverages' => 'Coffee, tea and mineral water',
66 | ));
67 |
68 | // "date"
69 | $form->add('label', 'label_date', 'date', 'Reservation date');
70 | $date = $form->add('date', 'date');
71 | $date->set_rule(array(
72 | 'required' => array('error', 'Date is required!'),
73 | 'date' => array('error', 'Date is invalid!'),
74 | ));
75 |
76 | // date format
77 | // don't forget to use $date->get_date() if the form is valid to get the date in YYYY-MM-DD format ready to be used
78 | // in a database or with PHP's strtotime function!
79 | $date->format('M d, Y');
80 |
81 | // selectable dates are starting with the current day
82 | $date->direction(1);
83 |
84 | $form->add('note', 'note_date', 'date', 'Date format is M d, Y');
85 |
86 | // "time"
87 | $form->add('label', 'label_time', 'time', 'Reservation time :');
88 | $form->add('time', 'time', '', array(
89 | 'hours' => array(9, 10, 11, 12, 13, 14, 15, 16, 17),
90 | 'minutes' => array(0, 30),
91 | ));
92 |
93 | // "submit"
94 | $form->add('submit', 'btnsubmit', 'Submit');
95 |
96 | // if the form is valid
97 | if ($form->validate()) {
98 |
99 | // show results
100 | show_results();
101 |
102 | // otherwise
103 | } else
104 |
105 | // generate output using a custom template
106 | $form->render('*horizontal');
107 |
108 | ?>
--------------------------------------------------------------------------------
/examples/includes/reservation-vertical.php:
--------------------------------------------------------------------------------
1 |
A meeting room reservation form
2 |
3 | add('label', 'label_name', 'name', 'Your name:');
13 |
14 | // add the "name" element
15 | $obj = $form->add('text', 'name');
16 |
17 | // set rules
18 | $obj->set_rule(array(
19 |
20 | // error messages will be sent to a variable called "error", usable in custom templates
21 | 'required' => array('error', 'Name is required!')
22 |
23 | ));
24 |
25 | // "email"
26 | $form->add('label', 'label_email', 'email', 'Your email address:');
27 | $obj = $form->add('text', 'email');
28 | $obj->set_rule(array(
29 | 'required' => array('error', 'Email is required!'),
30 | 'emails' => array('error', 'Email address seems to be invalid!'),
31 | ));
32 |
33 | // "department"
34 | $form->add('label', 'label_department', 'department', 'Department:');
35 | $obj = $form->add('select', 'department', '', array('other' => true));
36 | $obj->add_options(array(
37 | 'Marketing',
38 | 'Operations',
39 | 'Customer Service',
40 | 'Human Resources',
41 | 'Sales Department',
42 | 'Accounting Department',
43 | 'Legal Department',
44 | ));
45 | $obj->set_rule(array(
46 | 'required' => array('error', 'Department is required!')
47 | ));
48 |
49 | // "room"
50 | $form->add('label', 'label_room', 'room', 'Which room would you like to reserve:');
51 | $obj = $form->add('radios', 'room', array(
52 | 'A' => 'Room A',
53 | 'B' => 'Room B',
54 | 'C' => 'Room C',
55 | ));
56 | $obj->set_rule(array(
57 | 'required' => array('error', 'Room selection is required!')
58 | ));
59 |
60 | // "extra"
61 | $form->add('label', 'label_extra', 'extra', 'Extra requirements:');
62 | $obj = $form->add('checkboxes', 'extra[]', array(
63 | 'flipchard' => 'Flipchard and pens',
64 | 'plasma' => 'Plasma TV screen',
65 | 'beverages' => 'Coffee, tea and mineral water',
66 | ));
67 |
68 | // "date"
69 | $form->add('label', 'label_date', 'date', 'Reservation date');
70 | $date = $form->add('date', 'date');
71 | $date->set_rule(array(
72 | 'required' => array('error', 'Date is required!'),
73 | 'date' => array('error', 'Date is invalid!'),
74 | ));
75 |
76 | // date format
77 | // don't forget to use $date->get_date() if the form is valid to get the date in YYYY-MM-DD format ready to be used
78 | // in a database or with PHP's strtotime function!
79 | $date->format('M d, Y');
80 |
81 | $form->add('note', 'note_date', 'date', 'Date format is M d, Y');
82 |
83 | // "time"
84 | $form->add('label', 'label_time', 'time', 'Reservation time :');
85 | $obj = $form->add('time', 'time', '', array(
86 | 'format' => 'hm',
87 | 'hours' => array(9, 10, 11, 12, 13, 14, 15, 16, 17),
88 | 'minutes' => array(0, 30),
89 | ));
90 |
91 | $obj->set_rule(array(
92 | 'required' => array('error', 'Time is required!'),
93 | ));
94 |
95 | // "submit"
96 | $form->add('submit', 'btnsubmit', 'Submit');
97 |
98 | // if the form is valid
99 | if ($form->validate()) {
100 |
101 | // show results
102 | show_results();
103 |
104 | // otherwise
105 | } else
106 |
107 | // generate output using a custom template
108 | $form->render();
109 |
110 | ?>
--------------------------------------------------------------------------------
/examples/includes/validation-vertical.php:
--------------------------------------------------------------------------------
1 |
More validation rules
2 |
3 | add('label', 'label_alphabet', 'alphabet', 'Alphabet:');
13 |
14 | $obj = $form->add('text', 'alphabet');
15 |
16 | // set rules
17 | $obj->set_rule(array(
18 |
19 | // error messages will be sent to a variable called "error", usable in custom templates
20 | 'required' => array('error', 'This field is required!'),
21 | 'alphabet' => array('', 'error', 'Accepts only characters from the alphabet (case-insensitive a to z)')
22 |
23 | ));
24 |
25 | // attach a note
26 | $form->add('note', 'note_alphabet', 'alphabet', 'Accepts only characters from the alphabet (case-insensitive a to z)');
27 |
28 | // "alphanumeric"
29 | $form->add('label', 'label_alphanumeric', 'alphanumeric', 'Alphanumeric:');
30 | $obj = $form->add('text', 'alphanumeric');
31 | $obj->set_rule(array(
32 | 'required' => array('error', 'This field is required!'),
33 | 'alphanumeric' => array('', 'error', 'Accepts only characters from the alphabet (case-insensitive a to z) and digits (0 to 9)')
34 | ));
35 | $form->add('note', 'note_alphanumeric', 'alphanumeric', 'Accepts only characters from the alphabet (case-insensitive a to z) and digits (0 to 9)');
36 |
37 | // "digits"
38 | $form->add('label', 'label_digits', 'digits', 'Digits:');
39 | $obj = $form->add('text', 'digits');
40 | $obj->set_rule(array(
41 | 'required' => array('error', 'This field is required!'),
42 | 'digits' => array('', 'error', 'Accepts only digits (0 to 9)')
43 | ));
44 | $form->add('note', 'note_digits', 'digits', 'Accepts only digits (0 to 9)');
45 |
46 | // "float"
47 | $form->add('label', 'label_float', 'float', 'Float:');
48 | $obj = $form->add('text', 'float');
49 | $obj->set_rule(array(
50 | 'required' => array('error', 'This field is required!'),
51 | 'float' => array('', 'error', 'Accepts only digits (0 to 9) and/or one dot (but not as the very first character) and/or one minus sign (but only if it is the very first character)')
52 | ));
53 | $form->add('note', 'note_float', 'float', 'Accepts only digits (0 to 9) and/or one dot (but not as the very first character) and/or one minus sign (but only if it is the very first character)');
54 |
55 | // "length"
56 | $form->add('label', 'label_length', 'length', 'Length:');
57 | $obj = $form->add('text', 'length');
58 | $obj->set_rule(array(
59 | 'required' => array('error', 'This field is required!'),
60 | 'length' => array(6, 12, 'error', 'Must contain between 6 and 12 characters!')
61 | ));
62 | $form->add('note', 'note_length', 'length', 'Must contain between 6 and 12 characters');
63 |
64 | // "number"
65 | $form->add('label', 'label_number', 'number', 'Number:');
66 | $obj = $form->add('text', 'number');
67 | $obj->set_rule(array(
68 | 'required' => array('error', 'This field is required!'),
69 | 'number' => array('', 'error', 'Accepts only digits (0 to 9) and/or one minus sign (but only if it is the very first character)')
70 | ));
71 | $form->add('note', 'note_number', 'number', 'Accepts only digits (0 to 9) and/or one minus sign (but only if it is the very first character)');
72 |
73 | // "regular expression"
74 | $form->add('label', 'label_regexp', 'regexp', 'Regular expression:');
75 | $obj = $form->add('text', 'regexp');
76 | $obj->set_rule(array(
77 | 'required' => array('error', 'This field is required!'),
78 | 'regexp' => array('^07[0-9]{8}$', 'error', 'Validates only if the value matches the following regular expression: ^07[0-9]{8}$')
79 | ));
80 | $form->add('note', 'note_regexp', 'regexp', 'Validates if the value satisfies the following regular expression: ^07[0-9]{8}$');
81 |
82 | // "change case"
83 | $form->add('label', 'label_case', 'case', 'Change case:');
84 | $obj = $form->add('text', 'case');
85 | $obj->set_rule(array(
86 | 'required' => array('error', 'This field is required!'),
87 | ));
88 | // force all characters to be upper-case
89 | $obj->change_case('upper');
90 | $form->add('note', 'note_case', 'case', 'All entered characters will be upper-case');
91 |
92 | // "submit"
93 | $form->add('submit', 'btnsubmit', 'Submit');
94 |
95 | // if the form is valid
96 | if ($form->validate()) {
97 |
98 | // show results
99 | show_results();
100 |
101 | // otherwise
102 | } else
103 |
104 | // generate output using a custom template
105 | $form->render();
106 |
107 | ?>
--------------------------------------------------------------------------------
/examples/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 | 403 Forbidden
4 |
5 |
6 |