Menu
Forge Entry Types
reCAPTCHA
coldbox plugin to consume the reCAPTCHA service to avoid spam during form submissions.
Description
1) Get public/private key from reCAPTCHA service for your site @ https://www.google.com/recaptcha/admin/create.
2) Please add the following required settings to your coldbox configuration file.
reCaptcha_publicKey: public key got from reCAPTCHA
reCaptcha_privateKey: private key got from reCAPTCHA
3) place the reCaptcha.cfc plugin in the plugins directory and make sure the reCAPTCHA credentials are set for the service to work properly.
Further info on reCAPTCHA can be found @ http://www.google.com/recaptcha
Then just use the below methods:
Displays a reCAPTCHA image for form validation using the Recaptch service http://www.google.com/recaptcha.
- display(isSSL,theme,locale,tabIndex,message) method displays the reCAPTCHA image. If the user is returning to the form from a failed captcha validation (using validate method), an error message also appears under the image, which can be customized by the 'message' argument.
- validate(recaptcha_challenge_field,recaptcha_response_field,remoteIP) method is used in the event that handles the form and takes as an argument the form field value from the request collection in which the user entered the RECAPTCHA code. It returns true if there is a match and false if not (and also sets a flag in the session scope to tell the plugin to display the error message if the user is redirected back to the form.)
Installation Instructions
place the reCaptcha.cfc plugin in the plugins directory and make sure the reCAPTCHA credentials are set for the service to work properly.
Changelog
initial release
