#the form that the user fills in to add themselves to the database
#a simple example:

<form action="add_user" method="post">

Name:  <input type="text" name="name"><br>
Password: <input type="password" name="password" ><br>
Confirm password: <input type="password" name="confirm"><br>

#to cycle through all available roles and add them to a selection box
#do the following:

User roles: <br>
  <select name="roles:list" size="5" multiple>
  <dtml-in valid_roles>
  <dtml-if expr="_vars['sequence-item'] != 'Anonymous'">
  <dtml-if expr="_vars['sequence-item'] != 'Shared'">
  <option value="<dtml-var sequence-item html_quote>"><dtml-var 
   sequence-item>
  </dtml-if>
  </dtml-if>
  </dtml-in valid_roles>
  </select>
<br>
<input type="submit" name="submit" value="Add" />
</form>

#that's it with the form! now for the python script
#the python script which your form calls

context.acl_users.manage_users('Add', context.REQUEST)
return "User added!"

#note: you must have an acl_users folder in the same directory as the form and the python script.

#Note: there is an optional property for a user, the domain field.
#to add it, just add it to the form as follows:

Domains: <input type="text" name="domains:tokens" size="30" value="" />