Revision [19928]
This is an old revision of URModuleHowTo made by BrianKoontz on 2008-05-13 22:11:04.
Writing a UR (User Registration) Module
This page outlines the steps that can be used to write a UR (user registration) module. UR modules are pluggable, standalone modules that are used to interface with the UR validation framework introduced in 1.1.6.4.
Basically, a UR module contains all the logic necessary for alternative methods of user registration validation, and utilizes callbacks set up in the framework to display registration fields and text, retrieve user input, approve/disapprove registration requests, and display appropriate confirmation and error messages. Designing a UR module should never require modification to the Wikka core code libraries and routines.
About this tutorial
This tutorial will outline the steps I took to convert YodaHome's excellent FreeCap anti-spam captcha code to a UR module. I modified the original code for 1.1.7, but since the UR framework has not yet been ported to trunk, this example will use a clean checkout of the 1.1.6.4 version (the release tarball/zipfile will work as well). Setting up a working 1.1.6.4 Wikka instance is an exercise left for the reader, and is a prerequisite for continuing with the tutorial.
