Threaded Discussions

DiscussionApp

Discussion forum application

Description

Documentation

TopicType

Comment

TopicType for threaded comments
A Comment is linked to the commented topic by the TopicRef field, which is either another Comment or a discussion. In addition every Comment points to the originating discussion using the BaseRef field. So while TopicRef referrs to the direct parent in a thread, BaseRef points to the root of it.

See also: CommentTemplate, WebPreferences, RenderAddComment

Discussion

Tool to manage discussions
A dicussion can be added to a topic by adding %DISCUSS% to the end of a topic. You may add a Discussion TWikiForm to the topic to bring about an array of structured information to it. This is the case by default if you used the DiscussionFactory tool. The Discussion's form is derived from the normal TWikiTopic containing the TopicType and Summary fields. The Summary field is used to give the discussion a kind of description or headline. In addition it is a CategorizedTopic that allows to assign tags and categories to mark the discussion to be about a certain subject. Note, that all CategorizedTopics are retrievable in the WebTagCloud. Finally there are two properties of a Discussion that are unique to them, the Name and the State field. The Name field is initialized with the WikiName of the (registered) user that opened this discussion. This will be the person in charge to decide when to "close" a Discussion. This is done by changing the State from "open" to "close". Note, that you can only comment on open discussions while closed discussions will only display the comments collected so far. You may chose to open a discussion later on at any time.

See also: DiscussionTemplate, RenderDiscussion, RenderListOfDiscussions

TWikiForm

Comment

TopicType for threaded comments
A Comment is linked to the commented topic by the TopicRef field, which is either another Comment or a discussion. In addition every Comment points to the originating discussion using the BaseRef field. So while TopicRef referrs to the direct parent in a thread, BaseRef points to the root of it.

See also: CommentTemplate, WebPreferences, RenderAddComment

Discussion

Tool to manage discussions
A dicussion can be added to a topic by adding %DISCUSS% to the end of a topic. You may add a Discussion TWikiForm to the topic to bring about an array of structured information to it. This is the case by default if you used the DiscussionFactory tool. The Discussion's form is derived from the normal TWikiTopic containing the TopicType and Summary fields. The Summary field is used to give the discussion a kind of description or headline. In addition it is a CategorizedTopic that allows to assign tags and categories to mark the discussion to be about a certain subject. Note, that all CategorizedTopics are retrievable in the WebTagCloud. Finally there are two properties of a Discussion that are unique to them, the Name and the State field. The Name field is initialized with the WikiName of the (registered) user that opened this discussion. This will be the person in charge to decide when to "close" a Discussion. This is done by changing the State from "open" to "close". Note, that you can only comment on open discussions while closed discussions will only display the comments collected so far. You may chose to open a discussion later on at any time.

See also: DiscussionTemplate, RenderDiscussion, RenderListOfDiscussions

TopicTemplate

CommentTemplate

Template for comments

DiscussionTemplate

Template for discussion topics

TopicView

CommentViewTemplate

TopicView for comments

DiscussionViewTemplate

TopicView for discussions

NatSkinCommentViewTemplate

TopicView for comments

NatSkinDiscussionViewTemplate

TopicView for discussions

TopicFunction

RenderAddComment

Render a form to post a comment
Parameters
NONE

Css
  • blogAddComment
  • blogSubmitButton

This function renders a form to comment on a topic, that is on another comment or a posting. If you are logged in the fields "Name", "EMail" and "Url" will be populated with values taken from the user's profile.

See also: Comment, CommentTemplate, RenderNextCommentNr

RenderComment

Renders all comments of a discussion

RenderComments

Renders all comments of a discussion

RenderDiscussion

Render a discussion
This function will display all comments to the current discussion (BASEWEB.BASETOPIC) listing them recursively in a threaded way. As long as the discussion is open (State=open) a form will be appended to the page to allow to reply to the discussion. Note, that each comment itself is displayed similar to the discussion itself allowing the communication to proceed from that point independently.

See also: RenderComments, RenderAddComment

RenderDiscussionHeader

Render the header of a discussion
This function renders the head of a discussion, including its summary and how it is classified. It is called in a discussion view template and operates on the basetopic.

Parameters
NONE

RenderDiscussionInfo

Render the header of a discussion
This function renders the head of a discussion, including its summary and how it is classified. It is called in a discussion view template and operates on the basetopic.

Parameters
NONE

RenderDocNavigation

Render a double linked list to previous and next documents

RenderListOfComments

Render a list of recent comments
List a set of most recent comments

See also: RenderListOfDiscussions, Discussions

Parameters
  • THEWEB: search in the given web, defaults to BASEWEB
  • LIMIT: max nr of discussions to show, defaults to all

RenderListOfDiscussions

Render a list of discussions
List all discussions with the given properties

Parameters
  • STATE: either open or close, defaults to both
  • CAT: extract discussions in the given Category, defaults to all
  • THEWEB: search in the given web, defaults to BASEWEB
  • REVERSE: on/off - sorting order, defaults to off
  • LIMIT: max nr of discussions to show, defaults to all

RenderNextCommentNr

Compute the next comment nr given a current discussion or comment

RenderSubComments

Render all comments recursively

Installation

...

Manifest

Nr Name Type
1 BaseRef TWikiFormAttribute
  Pointer to the start of a comment thread
2 Comment AuthorTool, TopicType, TWikiForm, TWikiFormAttribute
  TopicType for threaded comments
3 CommentTemplate TopicTemplate
  Template for comments
4 CommentViewTemplate TopicView
  TopicView for comments
5 Discussion AuthorTool, DocuTopic, TopicType, TWikiForm
  Tool to manage discussions
6 DiscussionTemplate TopicTemplate
  Template for discussion topics
7 DiscussionViewTemplate TopicView
  TopicView for discussions
8 NatSkinCommentViewTemplate TopicView
  TopicView for comments
9 NatSkinDiscussionViewTemplate TopicView
  TopicView for discussions
10 RenderAddComment DocuTopic, TopicFunction
  Render a form to post a comment
11 RenderComment TopicFunction
  Renders all comments of a discussion
12 RenderComments TopicFunction
  Renders all comments of a discussion
13 RenderDiscussion TopicFunction, DocuTopic
  Render a discussion
14 RenderDiscussionHeader DocuTopic, TopicFunction
  Render the header of a discussion
15 RenderDiscussionInfo DocuTopic, TopicFunction
  Render the header of a discussion
16 RenderDocNavigation TopicFunction
  Render a double linked list to previous and next documents
17 RenderListOfComments DocuTopic, TopicFunction
  Render a list of recent comments
18 RenderListOfDiscussions DocuTopic, TopicFunction
  Render a list of discussions
19 RenderNextCommentNr TopicFunction
  Compute the next comment nr given a current discussion or comment
20 RenderSubComments TopicFunction
  Render all comments recursively
21 TopicRef TWikiFormAttribute
  Name of the topic this one is a comment to (comment relation)
22 WebRssDiscussion AdminTool
  Rss feed for discussions

Applications.TWikiApplication
TopicType: TWikiApplication
Summary: Discussion forum application
Version: v0.1
Author: Michael Daum
Copyright: © 2006-2007 Michael Daum http://wikiring.de
License: GnuGeneralPublicLicense?
Dependencies: TWikiWorkbench
r0 - 09 Jul 2007 - 14:17:04 - TWikiContributor
© giant orange extension cord that reeks hip-hop, funk & soul