[[PageOutline(2-5,Contents,pullout)]]

= Validate ticket fields

== Description

This plugin allows you to perform validations on form input fields in your Trac pages.

Key features:
 * support validate anonymous to input valid email address
 * support required fields
 * support match fields to regular expression

== Bugs/Feature Requests

Existing bugs and feature requests for TracTicketValidatorPlugin are 
[report:9?COMPONENT=TracTicketValidatorPlugin here].

If you have any issues, create a 
[/newticket?component=TracTicketValidatorPlugin new ticket].

[[TicketQuery(component=TracTicketValidatorPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:tracticketvalidatorplugin here].

== Source

You can check out TracTicketValidatorPlugin from [/svn/tracticketvalidatorplugin here] using Subversion, or [source:tracticketvalidatorplugin browse the source] with Trac.

== Example

 1. Validate anonymous author email address and make the comment a required input:
{{{#!ini
[components]
ticketvalidator.* = enabled

[ticketvalidator]
validate_author = true
validate_author.tip = Please fill your valid email address
validates = comment, summary
comment.rule = .*
comment.tip = Please input comment
summary.rule = [A-Z].*
summary.tip = Please correct summary
}}}

 '''Note''': when validating more than one field, use a list after "validates =". 

 2. There is a very straightward implementation of parent/child tickets: just prepend parent ticket number to the child ticket summary. For example, if the parent ticket 234 summary is {{{<#0>A parent ticket}}}, then the child ticket summary will be {{{<#234>A child ticket}}}. We can perform a validation as follows:
{{{#!ini
[components]
ticketvalidator.* = enabled

[ticketvalidator]
validates = summary
summary.rule = ^<#\d*>.*
summary.tip = Please correct summary format
}}}

== Recent Changes

[[ChangeLog(tracticketvalidatorplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:richard] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''