Extension:UIFeedback

MediaWiki extensions manual

File:OOjs UI icon advanced.svg UIFeedback Release status: beta
File:Screenshot form.png
Implementation	User interface, Database , Special page , Notify
Description	Allows users to send feedback about the user interface.
Author(s)	lbenedixtalk
Latest version	0.5.0
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	>= 1.34.0
Database changes	Yes
License	MIT License
Download	<translate> Download extension</translate> <translate> Git</translate> [?]: <translate> Download Git master</translate> <translate> browse repository</translate> (GitHub) <translate> commit history</translate> <translate> repository contributors (GitHub)</translate> <translate> code review</translate>
Example	http://lbenedix.monoceres.uberspace.de/mediawiki/index.php?title=Main_Page
Added rights read_uifeedback write_uifeedback
Hooks used BeforePageDisplay LoadExtensionSchemaUpdates
Quarterly downloads
Public wikis using
Translate the UIFeedback extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

The UIFeedback extension allows Users to give feedback about the user interface. It implements two different methods:

• a questionnaire with several questions about a found usability-flaw
• a JavaScript-based screenshot-renderer where a user can highlight and blackout areas

The Renderer is based on the html2canvas-library by Niklas von Hertzen.

Download

<translate> The extension can be retrieved directly from Git</translate> ^[?]:

• <translate> Browse code</translate>
• <translate> Some extensions have tags for stable releases.</translate>
  • <translate> Browse tags</translate>
  • <translate> Select the tag</translate>
  • <translate> Click "snapshot"</translate>
• <translate> Each branch is associated with a past MediaWiki release.</translate> <translate> There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).</translate>
  • <translate> Browse branches</translate>
  • <translate> Select a branch name</translate>
  • <translate> Click "<tvar name=1>⧼extdist-submit-version⧽</tvar>"</translate>

<translate> Extract the snapshot and place it in the <tvar name=name>extensions/UIFeedback/</tvar> directory of your MediaWiki installation.

If you are familiar with Git and have shell access to your server, you can also obtain the extension as follows: </translate>

cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/UIFeedback.git

Installation

• download the extension (will be transfered to Gerrit soon)

 git clone https://github.com/lbenedix/UIFeedback.git

• add the following line to 'LocalSettings.php':

 require_once( "$IP/extensions/UIFeedback/UiFeedback.php" );

• make sure you activated fileupload for the screenshots. Add the following lines to 'LocalSettings.php':

 $wgEnableUploads = true; // enable file upload
 $wgFileExtensions = array_merge($wgFileExtensions, array('png')); // add png to the list of allowed extensions
 $wgMimeDetectorCommand = "file -bi"; // have a look at: http://www.mediawiki.org/wiki/Manual:$wgMimeDetectorCommand
 $wgStrictFileExtensions = true; // http://www.mediawiki.org/wiki/Manual:$wgStrictFileExtensions 
 $wgCheckFileExtensions = true; // http://www.mediawiki.org/wiki/Manual:$wgCheckFileExtensions

• create the table in your database

 run `update.php` from maintenance-folder

Configuration parameters

The feedback method is chosen randomly by the JavaScript code. If you want to set it to use the screenshot method only you have to set 'var use_html2canvas = true;' in resources/ext.uiFeedback.js. If you only want the questionnaire method to 'var use_html2canvas = false'