add info about storing Store TimeLog with Messages

Author: Richard Jones

CHANGES.txt

@@ -13,14 +13,14 @@ Feature:
 - @required in forms may now specify properties of linked items (sf patch
   1507093)
 
-
 Fixed:
 - Verbose option for import and export (sf bug 1505645)
 - -c option for roundup-mailgw won't accept parameter (sf bug 1505649)
 - '?' in rfc2822-encoded header isn't quoted (sf bug 1505663)
 - fix error message in form parser
 - update for latest version of pysqlite (sf bug 1487098; patch 1534227)
 - updated ZRoundup for Zope 2.9 (sf patch 1511734)
+- fix timelog example in customisation doc to mention permissions
 
 
 2006-04-27 1.1.2

doc/customizing.txt

@@ -2,7 +2,7 @@
 Customising Roundup
 ===================
 
-:Version: $Revision: 1.202 $
+:Version: $Revision: 1.203 $
 
 .. This document borrows from the ZopeBook section on ZPT. The original is at:
    http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx
@@ -3386,6 +3386,32 @@ be able to give a summary of the total time spent on a particular issue.
    the code changes. When that's done, you'll be able to use the new
    time logging interface.
 
+An extension of this modification attaches the timelog entries to any
+change message entered at the time of the timelog entry:
+
+1. Add a link to the timelog to the msg class:
+
+    msg = FileClass(db, "msg",
+                    author=Link("user", do_journal='no'),
+                    recipients=Multilink("user", do_journal='no'),
+                    date=Date(),
+                    summary=String(),
+                    files=Multilink("file"),
+                    messageid=String(),
+                    inreplyto=String()
+                    times=Multilink("timelog"))
+
+2. Add a new hidden field that links that new timelog item (new
+   because it's marked as having id "-1") to the new message.
+   It looks like this::
+ 
+      <input type="hidden" name="msg-1@link@times" value="timelog-1" />
+ 
+   The "times" property of the message will have the new id added to it.
+
+3. Add the timelog listing from step 5. to the ``msg.item.html`` template
+   so that the timelog entry appears on the message view page.
+
 
 Tracking different types of issues
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~