Introduction

This document is a tutorial that demonstrates how to integrate JCaptcha with a Roller.
It Uses the Roller Weblogger VERSION 0.9.9.5.

This tutorial is devided into 3 Steps.

• Step 1 : Prerequisites
• Step 2 : install and configure the jcaptcha struts plugin
• Step 3 : Change the Roller comment configuration

Prerequisites

It is assume that you have a 0.9.9.5 roller web application instance running. See Roller installation guide to achieve this.

Install the jcaptcha Roller plugin

• Copy the jcaptcha jar to the WEB-INF/lib dir of the roller web-app : jcaptcha-all-${version}.jar
• Add the folowing at the end of the struts config file

  <plug-in className="com.octo.captcha.module.struts.CaptchaServicePlugin"/>

• There's many settable property available, but none are required, this is detailed in the module documentation. Add the following action declaration :

  <action path="/jcaptcha" type="com.octo.captcha.module.struts.image.RenderImageCaptchaAction" />

  That's it.
  You can now test your configuration by restarting your roller web-app and directly point your browser to the jcaptcha.do action.
  You should see a jcaptcha image!.

Change the Roller comment configuration

Roller provides a Comment Athenticator interface to plug anti spam comment implementation.
The only thing to change in order to activate the jcaptcha plugin is the folowing line in the web.xml file :

<!--
UnComment authenticator to be used.
-->
<context-param>
    <param-name>org.roller.commentAuthenticatorClass</param-name>
    <param-value>com.octo.captcha.module.roller.JCaptchaCommentAuthenticator</param-value>
    <!--
    <param-value>org.roller.presentation.velocity.DefaultCommentAuthenticator</param-value>
    <param-value>org.roller.presentation.velocity.MathCommentAuthenticator</param-value>
    -->
</context-param>