Difference between revisions of "Extension:SemanticComments"

(Created page with "{{Extension|templatemode = |name = SemanticComments |status = beta |type1 = page action |type2 = special |type3 = ajax |username =...")
 
Line 31: Line 31:


==Setup==
==Setup==
===Download instructions===
The latest release may be found .
===Installation===
* [[Extension:Semantic MediaWiki|Semantic MediaWiki 1.8+]]
To install SemanticComments, please follow the steps indicated below.
To install SemanticComments, please follow the steps indicated below.
 
;Download instructions
===Copy Files===
:The latest release may be found .
Extract the downloaded archive into your extension folder so that you get the following path $IP/extensions/SemanticComments/
;Prerequisites
 
:[[Extension:Semantic MediaWiki|Semantic MediaWiki 1.8+]]
{{$IP}}
;Copy Files
 
:Extract the downloaded archive into folder $IP/extensions/SemanticComments/
===LocalSettings.php===
;LocalSettings.php
Add the following to [[Manual:LocalSettings.php|LocalSettings.php]]:
:Add the following to [[Manual:LocalSettings.php|LocalSettings.php]]:
<syntaxhighlight lang="php">include_once("$IP/extensions/SemanticComments/SemanticComments.php");</syntaxhighlight>
:<syntaxhighlight lang="php">include_once("$IP/extensions/SemanticComments/SemanticComments.php");</syntaxhighlight>
<syntaxhighlight lang="php">enableSemanticComments();</syntaxhighlight>
:<syntaxhighlight lang="php">enableSemanticComments();</syntaxhighlight>
 
;Import ontology
===Process the extension setup===
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.
;Import graphics
 
:To use the delivered icons you need to upload the following files in your wiki:
For that go to Special:Import, select and upload '/extensions/SemanticComments/import/SemanticComments.xml'
 
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'
Line 60: Line 51:
#'/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:
:All configuration options are defined in /SemanticComments/SemanticComments.php.
========
:
All configuration options are defined and described 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.
 
To reformat the style of existing comments or of the comment form, use the provided Cascading Style Sheet in '/skins' directory.


===Testing your installation===
===Testing your installation===

Revision as of 02:10, 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.

Testing your installation

Now you can enter

nopreview

{{#set: |Article has average rating={{#averagerating:}} }} {{#showcommentform:}}

{{#ask: Belongs to article::Extension:SemanticComments

 | ?Has comment person
 | ?Has comment date
 | ?Has comment text
 | ?Has comment rating
 | ?Belongs to comment
 | ?Comment was deleted#true,false
 | ?Has comment editor
 | ?Modification date
 | ?Has attached article
 | format=template
 | template=CommentResult
 | sort=Has comment date
 | order=asc
 | link=none
 | limit=100

}}

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.