Update to-do and interface documentation

svn path=/plone.app.discussion/trunk/; revision=27013
This commit is contained in:
Martin Aspeli 2009-05-18 15:49:48 +00:00
parent 250b556428
commit 7d79304b33
2 changed files with 20 additions and 18 deletions

View File

@ -7,11 +7,6 @@ plone.app.discussion to-do
[ ] ++comments++ namespace traversal adapter [ ] ++comments++ namespace traversal adapter
[ ] Acquisition wrapping - should it happen on:
- Conversation retrieval methods (get, __getitem__, values etc)?
- IConversation adapter lookup?
[ ] Implement plone.indexer indexers for comments, filling standard metadata [ ] Implement plone.indexer indexers for comments, filling standard metadata
- Note discrepancy between Python datetime and indexing expecting a Zope 2 - Note discrepancy between Python datetime and indexing expecting a Zope 2
@ -23,11 +18,25 @@ plone.app.discussion to-do
- Number of comments - Number of comments
- Date/time of most recent comment - Date/time of most recent comment
Needs to reindex when comment is added/removed (IContainerModifiedEvent) These have to be reindexed when comment is added/removed
(IContainerModifiedEvent). They also need to be set up in catalog.xml.
[ ] Add tests for conversation dict API [ ] Add tests for conversation dict API
[ ] Add tests for IReplies adapters [ ] Add tests for IReplies adapters
[ ] Add UI
- comment display should be a viewlet overriding the standard comments
viewlet
- comment forms should use z3c.form subforms and plone.z3cform's
ExtensibleForm support
[ ] Add control panel
- install plone.registry records using registry.xml
- create control panel using helper class in plone.app.registry
[ ] Make sure a catalog Clear & Rebuild doesn't lose all comments [ ] Make sure a catalog Clear & Rebuild doesn't lose all comments
[ ] Add BBB support for the existing portal_discussion interface [ ] Add BBB support for the existing portal_discussion interface

View File

@ -15,13 +15,6 @@ class IDiscussionSettings(Interface):
description=_(u"Use this setting to enable or disable comments globally"), description=_(u"Use this setting to enable or disable comments globally"),
default=True) default=True)
index_comments = schema.Bool(title=_(u"Index comments"),
description=_(u"Enable this option to ensure that comments are searchable. "
"Turning this off may improve performance for sites with large "
"volumes of comments that do not wish to make them searcahble using "
"the standard search tools."),
default=True)
class IConversation(IIterableMapping): class IConversation(IIterableMapping):
"""A conversation about a content object. """A conversation about a content object.
@ -49,16 +42,16 @@ class IConversation(IIterableMapping):
last_comment_date = schema.Date(title=_(u"Date of the most recent comment"), readonly=True) last_comment_date = schema.Date(title=_(u"Date of the most recent comment"), readonly=True)
commentators = schema.Set(title=_(u"The set of unique commentators (usernames)"), readonly=True) commentators = schema.Set(title=_(u"The set of unique commentators (usernames)"), readonly=True)
def __delitem__(key):
"""Delete the comment with the given key. The key is a long id.
"""
def addComment(comment): def addComment(comment):
"""Adds a new comment to the list of comments, and returns the """Adds a new comment to the list of comments, and returns the
comment id that was assigned. The comment_id property on the comment comment id that was assigned. The comment_id property on the comment
will be set accordingly. will be set accordingly.
""" """
def __delitem__(key):
"""Delete the comment with the given key. The key is a long id.
"""
def getComments(start=0, size=None): def getComments(start=0, size=None):
"""Return a batch of comment objects for rendering. The 'start' """Return a batch of comment objects for rendering. The 'start'
parameter is the id of the comment from which to start the batch. parameter is the id of the comment from which to start the batch.