http://xataface.com/wiki/index.php?-action=single_record_search&-table=wiki&page_id=%3D79&-cursor=0&-skip=0&-limit=30&-mode=list&--subsearch= Wed, 19 Jun 2013 05:12:21 +0100 FeedCreator 1.7.2 http://www.xataface.com/wiki/GettingStarted:validation <table><thead><tr><th>Field</th><th>Value</th></tr></thead><tbody><tr><td valign="top">Page name</td><td valign="top">GettingStarted:validation</td></tr><tr><td valign="top">Page id</td><td valign="top">79</td></tr><tr><td valign="top">Page title</td><td valign="top">Form Validation</td></tr><tr><td valign="top">Content</td><td valign="top"> <h2 id="toc0">Form Validation</h2> <p>Xataface allows you to add validation rules to fields using the fields.ini file A common requirement for forms is to have some validation rules. Here are some example validation rules:</p> <ul> <li> The Username field is required.</li> <li> The Username must be between 6 and 16 characters long.</li> <li> The password must have at least one letter and one digit.</li> <li> The Email field must contain a valid email address.</li> </ul> <p>There is no end to the types of things that you will need to validate. Xataface takes care of most of this for you with both client-side (javascript) and server-side validation. All you have to do is define some validation rules in the fields.ini file.</p> <h3 id="toc1">Example 1: Make 'Username' a required field</h3> <pre><code>[Username] validators:required = true validators:required:message = &quot;Username is required&quot;</code></pre> <p>Placing the above inside the fields.ini file will cause the Username field to be a required field.</p> <h3 id="toc2">Example 2: Username must be between 6 and 16 characters long</h3> <p>For this rule we will use a regular expression. <pre><code>[Username] validators:regex = &quot;/^.{6,16}$/&quot; validators:regex:message = &quot;Username must be between 6 and 16 characters long&quot;</code></pre> </p> <h3 id="toc3">Example 3: Email field must contain a valid email address</h3> <pre><code>[Email] validators:email = true validators:regex:message = &quot;Email must contain a valid email address&quot;</code></pre> <h3 id="toc4">Available validation rules</h3> <p>Xataface uses the PEAR library HTML_Quickform for validation, so any of the validators available in this package will be available in Xataface. Some of the available validation rules include:</p> <ul> <li> required</li> <li> maxlength</li> <li> rangelength</li> <li> regex</li> <li> email</li> <li> emailorblank</li> <li> lettersonly</li> <li> alphanumeric</li> <li> numeric</li> <li> nopunctuation</li> <li> nonzero</li> </ul> <h3 id="toc5">Default validation rules</h3> <p>There are certain validation rules that are automatically applied to fields of with certain characteristics. For example, any field designated NOT NULL in the SQL table definition will automatically be a 'required' field. At the time of this writing, that is the only 'default' validation rule applied, but more may be added in the future if their addition makes sense.</p> </td></tr><tr><td valign="top">Keywords</td><td valign="top">form validation,required field,validation rules</td></tr><tr><td valign="top">Language</td><td valign="top">en</td></tr></tbody></table> GettingStarted:validation