mvccaptchalib Wiki Rss Feed

New Comment on "Documentation"

jaybald — Fri, 04 Jan 2013 20:05:27 GMT

Good work, but I cannot use it as the HTML does not render the way I need it. Suggestion would be to separate the image, from the refresh label (which should also be able to be an image) and the textbox. Make sure you can add styles to the textbox as well. Good luck!

Updated Wiki: Home

leon_mz — Sun, 06 May 2012 17:40:27 GMT

Project Description

ASP.NET MVC compliant the captcha generation library.

Features

The following features are supported:

Fully customizable rendering engine
AJAX-enabled captcha image reload
Seamless integration into ASP.NET MVC workflow
Declarative captcha verification using annotated model approach

Updated Wiki: Home

leon_mz — Sun, 06 May 2012 17:40:07 GMT

Project Description

ASP.NET MVC compliant the captcha generation library.

Features

The following features are supported:

Fully customizable rendering engine
AJAX-enabled captcha image reload
Seamless integration into ASP.NET MVC workflow
Declaration captcha verification using annotated model approach

Updated Wiki: Documentation

leon_mz — Sat, 05 May 2012 09:10:08 GMT

Installing

You can build the library from the sources or install using NuGet package manager. Run the following command in the Package Manager Console:

PM> Install-Package MvcCaptchaLib

Generating captcha image

Write the following code to the controller's action method:

 public ActionResult GetCaptcha()
    {
        return this.Captcha();
    }

Validating captcha code

Write the following code to the model you use:

    [ValidateCaptcha]
    public string Captcha {get;set;}

The validation then runs as usual and you can check is the model valid by accessing ModelState.IsValid property in your action method.

Rendering to the HTML

Write the following code to the view:

 @Html.CaptchaFor(m => m.Captcha, "GetCaptcha", "Is captcha unintelligible? Reload new one.")
@Html.ValidationMessageFor(m => m.Captcha)

Copy captcha.js file to your web application project. (This script uses Jquery 1.3+, make sure you also reference this as well.)

Add reference to the javascript like this:

<script type="text/javascript" src="@Url.Content("~/Scripts/captcha.js")"></script>

Customization

You can customize rendering by setting a number of properies of CaptchaImage instance. Also you can place a number of captches onto the single page by providing unique captcha identifiers to Captcha method and ValidateCaptcha attribute.