These are the installation and configuration instructions for Semantic Result Formats.
|Status||Release date||Git branch|
|SRF 2.2.x||Development version||-||master|
|SRF 2.1.1||Stable release||2015-02-04||2.1.1|
|SRF 2.0||Stable release||2014-08-06||2.0|
|SRF 1.9.1||Stable release||2014-04-25||1.9.1|
|SRF 1.9.0||Legacy release||2014-01-10||1.9|
|SRF 1.8.0||Legacy release||2012-12-02||1.8|
|SRF 2.1.x||5.3.2 - 5.6.x||1.19 - 1.24||2.x||Required|
|SRF 2.0.x||5.3.2 - 5.5.x||1.19 - 1.23||2.x||Required|
|SRF 1.9.x||5.3.2 - 5.5.x||1.19 - 1.23||1.9.x||Required|
|SRF 1.8.x||5.2.0 - 5.5.x||1.17 - 1.22||1.8.x||Not supported|
|SRF 1.7.x||5.2.0 - 5.4.x||1.16 - 1.19||1.7.x||Not supported|
The PHP and MediaWiki version ranges listed are those in which SRF is known to work. It might also work with more recent versions of PHP and MediaWiki, though this is not guaranteed.
Download and installation
The recommended way to install Semantic Result Formats is with Composer using MediaWiki 1.22 built-in support for Composer. MediaWiki versions prior to 1.22 can use Composer via the Extension Installer extension.
If you have MediaWiki 1.22 or later, go to the root directory of your MediaWiki installation, and go to step 2. You do not need to install any extensions to support composer.
For MediaWiki 1.21.x and earlier you need to install the Extension Installer extension.
Once you are done installing the Extension Installer extension, go to its directory so composer.phar is installed in the right place.
If you have previously installed Composer skip to step 3.
To install Composer:
Now using Composer, install Semantic Result Formats.
If you do not have a composer.json file yet, copy the composer-example.json file to composer.json. If you are using the Extension Installer extension, the file to copy will be named example.json, rather than composer-example.json. When this is done, run:
php composer.phar require mediawiki/semantic-result-formats "~2.1"
Verify installation success
As final step, you can verify SRF got installed by looking at the "Special:Version" page on your wiki and verifying the Semantic Result Formats section is listed.
A default set of formats is enabled. These are the the formats that satisfy the following criteria:
- they do not require further software to be installed (besides SMW),
- they do not transmit any data to external websites, not even by making client browsers request any static external resources (such as an externally hosted image file),
- they are considered reasonably stable and secure.
Currently, these default formats thus are: 'vcard', 'icalendar', 'calendar', 'timeline', 'eventline', 'bibtex', 'outline', 'gallery', 'jqplotbar', 'jqplotpie', 'sum', 'average', 'min', 'max', 'tagcloud', 'median', 'product', 'valuerank', 'array', 'tree', 'ultree', 'oltree', 'D3Line'¹, 'D3Bar'¹, 'D3Treemap'¹, 'hash'².
¹ from MediaWiki 1.17 onwards ² with HashTables extension installed
To add more formats to this list, you can add lines like:
$srfgFormats = 'googlebar';
... or you can override the set of formats entirely, with a call like:
$srfgFormats = array( 'calendar', 'timeline' );
There are some formats that you may not want to include because they may not follow certain policies within your wiki; the formats 'googlebar' and 'googlepie', for instance, send data to external web services for rendering, which may be considered a data leak.
Notes on specific formats:
- googlebar: sends data to Google for rendering. Googlebar requires access to the Google servers in order to render.
- googlepie: sends data to Google for rendering. Googlepie requires access to the Google servers in order to render.
- graph: in order to get the graph format to run, you first must have the MediaWiki Graph extension running.
- process: in order to get the process format to run, you first must have the MediaWiki Graph extension running
- ploticus: requires that the Ploticus application be installed on the server.