diff doc/customizing.txt @ 1151:7e0024954954

making it easier to add new actions, and more docco
author Richard Jones <richard@users.sourceforge.net>
date Mon, 16 Sep 2002 05:32:09 +0000
parents 22c78fb54af4
children e0142ee233e8
line wrap: on
line diff
--- a/doc/customizing.txt	Mon Sep 16 04:30:45 2002 +0000
+++ b/doc/customizing.txt	Mon Sep 16 05:32:09 2002 +0000
@@ -2,7 +2,7 @@
 Customising Roundup
 ===================
 
-:Version: $Revision: 1.39 $
+:Version: $Revision: 1.40 $
 
 .. This document borrows from the ZopeBook section on ZPT. The original is at:
    http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx
@@ -1872,6 +1872,25 @@
 the "Fixer" Permission, the error will be raised.
 
 
+Setting up a "wizard" (or "druid") for controlled adding of issues
+------------------------------------------------------------------
+
+1. set up the page templates you wish to use for data input
+2. determine what actions need to be taken between the pages - these are
+   usually to validate user choices and determine what page is next
+3. encode those actions in methods on the interfaces Client class and insert
+   hooks to those actions in the "actions" attribute on that class, like so::
+
+    actions = client.Class.actions + (
+        ('page1_submit', page1SubmitAction),
+        ...
+    )
+
+    def page1SubmitAction(self):
+        # do the page 1 submit stuff, redirecting the user to the appropriate
+        # next page if necessary
+
+
 -------------------
 
 Back to `Table of Contents`_

Roundup Issue Tracker: http://roundup-tracker.org/