= Registration Confirmation Patch for AccountManagerPlugin =

== Description ==

This is a patch for AccountManagerPlugin that adds an IRegistrationConfirmation extension point that enables pluggable verifications for new user registration.

== Bugs/Feature Requests == 

Existing bugs and feature requests for RegistrationConfirmationPatch are 
[report:9?COMPONENT=RegistrationConfirmationPatch here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=RegistrationConfirmationPatch&owner=nicholasbs new ticket].

== Patch ==

The patch can be downloaded here: attachment:RegistrationConfirmationPatch.diff

== Example ==

The IRegistrationConfirmation extension point this patch provides makes it easy to add things such as [http://en.wikipedia.org/wiki/CAPTCHA CAPTCHAs] and e-mail confirmation to AccountManagerPlugin's user registration form. 

The interface provided by IRegistrationConfirmation includes two methods.

{{{
class IRegistrationConfirmation(Interface):
    """An interface for receiving notification before and after the new user                                                                                                                                     
    registration form has been submitted.                                                                                                                                                                        
    """

    def pre_registration(self, req):
        """Returns the markup to be added to the registration form                                                                                                                                               
        """

    def verify_registration(self, req):
        """Returns an error message if confirmation fails, or None on success                                                                                                                                    
        """
}}}

This is a very generalized interface and has not been thoroughly assessed to ensure that it meets all use-case requirements. [http://trac-hacks.org/newticket?component=RegistrationConfirmationPatch&owner=nicholasbs&type=Enhancement Suggestions are welcome].

For example, SimpleCaptchaPlugin uses this interface.

== Recent Changes ==

[[ChangeLog(registrationconfirmationpatch, 3)]]

== Author/Contributors ==

''Originally developed at [http://topp.openplans.org The Open Planning Project]''

'''Author:''' [wiki:nicholasbs] [[BR]]
'''Contributors:''' [wiki:k0s]