Extension:SemanticComments

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual
Crystal Clear action run.png
SemanticComments

Release status: beta

Implementation MyWiki, Special page, Ajax
Description This extension manages comments for a page, using a custom Comment namespace.
Author(s) Benjamin Langguth & others
Latest version 1.0 (2013-02-01)
MediaWiki 1.19+
PHP 5.3+
Database changes no
License GNU GENERAL PUBLIC LICENSE, Version 2, June 1991
Download
README
Example www.bestpracticeswiki.net
Parameters
  • $cegIP
  • $cegScriptPath
  • $cegEnableComment
  • $cegEnableCommentFor
  • $cegEnableRatingForArticles
  • $cegEnableFullDeletion
  • $cegShowCommentsExpanded
  • $cegEnableFileAttachments
  • $cegUseRMUploadFunc
  • $cegDefaultDelimiter
Hooks used
LanguageGetMagic

MakeGlobalVariablesScript
smwhACNamespaceMappings

Translate the SemanticComments extension if it is available at translatewiki.net

Check usage and version matrix; code metrics

SemanticComments is an extension that displays & manages comments and replies that are attached to any page in a wiki. This extension stores comments in semantic properties attached to pages in the "Comment" namespace which are queried by a special page.

The SemanticComments extension was derived by Hypergrove from the Project Halo Collaboration extension.

Setup[edit | edit source]

To install SemanticComments, please follow the steps indicated below.

Prerequisite extensions
Install Extension:Variables is necessary.
Download instructions
The latest release may be found at https://gerrit.wikimedia.org/r/#/admin/projects/mediawiki/extensions/SemanticComments.
Prerequisites
Semantic MediaWiki 1.8+
Variables Extension
ParserFunctions Extension
Copy Files
Extract the downloaded archive into folder $IP/extensions/SemanticComments/
LocalSettings.php
Add the following to LocalSettings.php:
include_once("$IP/extensions/SemanticComments/SemanticComments.php");
enableSemanticComments();
Import ontology
SemanticComments comes with a small ontology to provide functionality for displaying and querying existing comments and some icons. Go to Special:Import and upload /extensions/SemanticComments/import/SemanticComments.xml
Import graphics
To use the delivered icons you need to upload the following files in your wiki:
  1. /extensions/SemanticComments/skins/icons/bad_active.png
  2. /extensions/SemanticComments/skins/icons/neutral_active.png
  3. /extensions/SemanticComments/skins/icons/good_active.png
  4. /extensions/SemanticComments/skins/icons/defaultuser.gif
  5. /extensions/SemanticComments/skins/icons/Comment_icon_crystal.png
Please be sure that you keep the original file names.
Options
All configuration options are defined in /SemanticComments/SemanticComments.php.
To reformat the style of existing comments or of the comment form, use the Cascading Style Sheet in the '/skins' directory.

Usage[edit | edit source]

Enter {{ShowComments|show=True}} to any article where you want to get a list of all 'related comments' and a form that allows you to enter new comments.

From the list of Special pages, go to page “Special:SemanticComments”.

Languages[edit | edit source]

SemanticComments has support for three languages so far:

  • English
  • German
  • French

Wishlist[edit | edit source]

  • Store all comments and their replies in subobjects on a single page in the Comment namespace instead of a page per comment.
  • Provide date ascending and descending sort options
  • Provide ability to display user pictures instead of standard user icon

See also[edit | edit source]