Extension:Evaluation WikiFlow

What can this extension do?
Evaluation WikiFlow enhance MediaWiki with evaluation workflow, supporting all the life-cycle of a certification process of the content of the wiki pages.

Evaluation workflow
Evaluation workflow is performed through the following special pages:
 * Special:AskForReview
 * Special:AssignReview
 * Special:MakeReview
 * Special:Certify

while information about article state, pending reviews and assignments can be found at these pages:
 * Special:WaitingForReviews
 * Special:AssignedReviews

Evaluation tab
All articles belonging to a category to evaluate (see configuration for details) will have the evaluation section (tab) added to the actions menu.

The evaluation section shows information about the article reviews, assignments and provide buttons to perform the following actions:

Ask for review
Users with the askforreview permission can ask for a review about the current article. Perfmorming this action will mark the article with the custom Category Waiting for review. The same action can be performed through the special page Special:AskForReview, by typing the article's title in the form provided.

Make review
Users with the makereview permission can make reviews by clicking the related button in the evaluation section or using the special page Special:MakeReview. Review article will be created in the custom namespace Review with the title UserName about PageName. If the article object of the review belongs to category Waiting for review, annotation is deleted.

Assign review
Users with the assignreview permission can perform this operation. Clicking the button from the evaluation section will prepare the form provided by the special page Special:AssignReview with the page name precompiled. User can fill in the username of the Reviewer and assign the review. Article object of the assignment will belongs to category Review assigned. This annotation will be deleted when the reviewer will create a review through the Special:MakeReview.

Certify
Users with the certify permission can perform this action directly from the evaluation section, to precompile the form provided by the Special:Certify page with the current article's pagename.

The interface allows two modes: the move page mode and the lock and copy mode:

Certify by move
Page is renamed. Categories that marked the article as 'to evaluate' are deleted. User can also write the old name of the article, to don't perform move operation.

Certify by lock and copy
Page edition and moving is protected and content is used for a new page (all subpages are also copied, following the base page). This could be useful if site permissions are configured depending on namespaces, to let some users have different rights on articles to evaluate and certified.

Requirements
MediaWiki: 1.11.1+ is required.

Version tested are also:
 * 1.12.*
 * 1.13.0, 1.13.1

Other versions have not been tested yet... (if someone does it with newer versions, feel free to add notice here)

Required extensions:
 * Extension:SemanticMediaWiki
 * Extension:SemanticForms

Suggested extensions:
 * Extension:ParserFunctions, you need this to benefit from Evaluation WikiFlow parser functions

Download instructions
You can download the version 0.3 here

Unzip the package and copy the folder EvaluationWikiflow in your  directory.

To install this extension, add the following to LocalSettings.php:

Configuration
To configure the extension you must follow these steps:


 * 1) Edit the file 'includes/EW_Settings.php' and:
 * 2) Define a Template for the reviews and add in the wiki text the following parser function:

This is important in order to make the system recognize pages that are reviews about artcles to evaluate. (see Extension:SemanticForms for more details about how to configure a form):
 * 1) Define a new semantic Form to use for reviews. The template variable showed above ''' must be the article the review is about, so take in account this when you setup your Form. You will use this form only for Review creation. For edit action you need to setup a different form. This form must:
 * 2) * use the template created above;
 * 3) * use the custom input types:
 * 4) ** 'reviewaboutpage' (mandatory)
 * 5) ** 'reviewer' (optional)
 * 6) ** 'reviewaboutrevision' (optional)

[...]

Reviewer:

Review about:

Revision ID:

[...]

Form for review::Form:My_review_form
 * 1) Add to the Category of the articles to be evaluated the semantic property Form for reviews pointing to the review Form:

User rights
EvalWF use five new user rights:

Parser functions
EvalWF enhance wiki parser with some functions for managing revision and evaluation process, tu use with Extension:ParserFunctions

About article's revision:

About evaluation workflow state:

Towards version 1.0

 * report evaluation wf -> export history in RDF
 * more easy configuration
 * multiple category/review configuration

E-mail features
 * Advise reviewer about a new assignment
 * Advise author(s) of the proposal if a new review has been done

Others
 * Advise the reviewer on login for new pending assignments

Versions log

 * 0.2 Messages added, some bugs fixed
 * 0.1