Commenting

Abstract

Commenting allows registered users of a wiki to discuss a page's contents.

Status

API logic is being implemented by MaxM, frontend will be done by RoyK. On track for Hayes Beta3 release. Commenting went feature complete on July 9th, 2007.

Goals

Facilitate discussion of a page's contents

Requirements

Do not allow HTML tags (yet)
Can only be made by registered users
Can be deleted by the commenter and any administrator
1. When deleted, a placeholder comment is put into the comment list to prevent the "jump" of comment numbers
Can only be edited by commenter
1. When edited, the edited timestamp is displayed
Appear in chronological order (oldest first)
Only show X most recent comments, where X is defined by $wgCommentCount in Default/LocalSettings.php
User has the option of viewing all comments on a page
All functionality must work without Javascript being enabled

Configuration

Config Key	Default Value	Description	Addtl notes
$wgCommentCount	15	Determines number of comments to display on initial page load	Setting to '0' disables commenting on the UI
$wgCommentCountAll	10000	Determines the number of comments to show when requesting 'ALL' comments	A high number is set in case there's a ridiculous number of comments so there's no timeouts from API or mySQL