Difference between revisions of "Extension:SemanticComments"

 
Line 6: Line 6:
|type3        = ajax
|type3        = ajax
|username      =
|username      =
|author        = Benjamin Langguth & others, [[User:Pokoptsev|Dmitry Pokoptsev]]
|author        = Benjamin Langguth & others
|description  = This extension manages comments for a page, using the Comment namespace.
|description  = This extension manages comments for a page, using the Comment namespace.
|image        =
|image        =
Line 35: Line 35:
:The latest release may be found .
:The latest release may be found .
;Prerequisites
;Prerequisites
:[[Extension:Semantic MediaWiki|Semantic MediaWiki 1.8+]]
:[[Extension:SemanticMediaWiki|Semantic MediaWiki 1.8+]]
;Copy Files
;Copy Files
:Extract the downloaded archive into folder $IP/extensions/SemanticComments/
:Extract the downloaded archive into folder $IP/extensions/SemanticComments/
Line 43: Line 43:
:<syntaxhighlight lang="php">enableSemanticComments();</syntaxhighlight>
:<syntaxhighlight lang="php">enableSemanticComments();</syntaxhighlight>
;Import ontology
;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 <code>/extensions/SemanticComments/import/SemanticComments.xml</code>
:SemanticComments comes with a small ontology to provide functionality for displaying and querying existing comments and some icons.  Go to [[Special:Import]] and upload <code>/extensions/SemanticComments/import/SemanticComments.xml</code>
;Import graphics
;Import graphics
:To use the delivered icons you need to upload the following files in your wiki:
:To use the delivered icons you need to upload the following files in your wiki:
#'/extensions/SemanticComments/skins/icons/bad_active.png'
#/extensions/SemanticComments/skins/icons/bad_active.png
#'/extensions/SemanticComments/skins/icons/neutral_active.png'
#/extensions/SemanticComments/skins/icons/neutral_active.png
#'/extensions/SemanticComments/skins/icons/good_active.png'
#/extensions/SemanticComments/skins/icons/good_active.png
#'/extensions/SemanticComments/skins/icons/defaultuser.gif'
#/extensions/SemanticComments/skins/icons/defaultuser.gif
#'/extensions/SemanticComments/skins/icons/Comment_icon_crystal.png'
#/extensions/SemanticComments/skins/icons/Comment_icon_crystal.png
:Please be sure that you keep the original file names.
:Please be sure that you keep the original file names.
;Options
;Options
Line 57: Line 57:
:To reformat the style of existing comments or of the comment form, use the Cascading Style Sheet in the '/skins' directory.
:To reformat the style of existing comments or of the comment form, use the Cascading Style Sheet in the '/skins' directory.


===Testing your installation===
==Usage==
Now you can enter {{ShowComments|show=True}} to any article where you want to get a
Enter <code><nowiki>{{ShowComments|show=True}}</nowiki></code> to any article where you want to get a list of all 'related comments' and a form that allows you to enter new comments.  
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”.
From the list of Special pages, go to page “Special:SemanticComments”.

Latest revision as of 01:17, 21 January 2013

Template:Extension

Description

SemanticComments is an extension that displays & manages any number of comments and replies that are attached to any page in a wiki. This extension stores comments in semantic properties while also providing an alternative to TALK namespaces for each SUBJECT namespace in a wiki.

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

Setup

To install SemanticComments, please follow the steps indicated below.

Download instructions
The latest release may be found .
Prerequisites
Semantic MediaWiki 1.8+
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

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 supported

SemanticComments has support for three languages so far:

  • English
  • German
  • French

Extension Wishlist

  • Store all comments and their replies in subobjects on a single page in the Comment namespace.