jQuery Real Person Reference

A jQuery plugin that enhances an input field to help reduce automated form submission. If you find this plugin useful please vote for it on the jQuery site.

This page provides a documentation reference for working with the plugin v1.0.1. See a demonstration of the real person plugin and download the code from there. Or see a minimal page that you could use as a basis for your own investigations.

Settings
Global

Instance Settings

Customise each targetted input field with the settings below (all are optional):

$(selector).realperson({length: 4});

Name	Type	Default	Comments
length	number	6	The number of characters to be entered.
includeNumbers	boolean	false	Set to true to include the digits 0 to 9 in the characters used to generate the challenge string. Otherwise only the alphabetic characters are used.
regenerate	string	'Click to change'	The text to display to inform the user that they may click on the challenge to generate a new value - in case they cannot easily read the original value.
hashName	string	'{n}Hash'	The field name to use for the hash value that corresponds to the challenge text. Use '(n}' within the setting to substitute the name of the original input field.

Functions

Signature	Returns	Comments
$.realperson.setDefaults(settings)	RealPerson object	Update the default instance settings to use with all real person instances.
$(selector).realperson('change', settings)	jQuery object	Update the settings for the real person instance attached to the given input(s).
$(selector).realperson('destroy')	jQuery object	Remove the real person functionality from the given input(s).