diff options
| author | Yaco <franco@reevo.org> | 2020-06-04 11:01:00 -0300 |
|---|---|---|
| committer | Yaco <franco@reevo.org> | 2020-06-04 11:01:00 -0300 |
| commit | fc7369835258467bf97eb64f184b93691f9a9fd5 (patch) | |
| tree | daabd60089d2dd76d9f5fb416b005fbe159c799d /www/wiki/extensions/SemanticMediaWiki/docs | |
first commit
Diffstat (limited to 'www/wiki/extensions/SemanticMediaWiki/docs')
71 files changed, 5285 insertions, 0 deletions
diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/COMPATIBILITY.md b/www/wiki/extensions/SemanticMediaWiki/docs/COMPATIBILITY.md new file mode 100644 index 00000000..0bcf6486 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/COMPATIBILITY.md @@ -0,0 +1,370 @@ +For a full list of changes in each release, see the [release notes](https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/master/docs/releasenotes). For instructions +on how to install the latest version of Semantic MediaWiki (SMW), see the [installation instructions](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/docs/INSTALL.md). + + +## Release versions + +<table> + <tr> + <th></th> + <th>Status</th> + <th>Release date</th> + <th>Git branch</th> + </tr> + <tr> + <th><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/milestone/6">SMW 3.1.x</a></th> + <td>Future release</td> + <td>Q2 2019</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/master">master</a></td> + </tr> + <tr> + <th><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/milestone/6">SMW 3.0.x</a></th> + <td>Stable release</td> + <td>2018-10-11</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/3.0.x">3.0.x</a></td> + </tr> + <tr> + <th><a href="https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.5.0">SMW 2.5.x</a></th> + <td>Obsolete release</td> + <td>2017-03-14</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/2.5.x">2.5.x</a></td> + </tr> + <tr> + <th><a href="https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.4.0">SMW 2.4.x</a></th> + <td>Obsolete release</td> + <td>2016-07-09</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/2.4.x">2.4.x</a></td> + </tr> + <tr> + <th><a href="https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.3.0">SMW 2.3.x</a></th> + <td>Obsolete release</td> + <td>2015-10-25</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/2.3.x">2.3.x</a></td> + </tr> + <tr> + <th><a href="https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.2.0">SMW 2.2.x</a></th> + <td>Obsolete release</td> + <td>2015-05-09</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/2.2.x">2.2.x</a></td> + </tr> + <tr> + <th><a href="https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.1.x">SMW 2.1.x</a></th> + <td>Obsolete release</td> + <td>2015-01-19</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/2.1.x">2.1.x</a></td> + </tr> + <tr> + <th><a href="https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_2.0">SMW 2.0.x</a></th> + <td>Obsolete release</td> + <td>2014-08-04</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/2.0.x">2.0.x</a></td> + </tr> + <tr> + <th><a href="https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.9.2">SMW 1.9.2</a></th> + <td>Obsolete release</td> + <td>2014-04-18</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/1.9.2">1.9.2</a></td> + </tr> + <tr> + <th><a href="https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.9.1">SMW 1.9.1</a></th> + <td>Obsolete release</td> + <td>2014-02-09</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/1.9.1">1.9.1</a></td> + </tr> + <tr> + <th><a href="https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.9.0">SMW 1.9.0</a></th> + <td>Obsolete release</td> + <td>2014-01-03</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/1.9">1.9</a></td> + </tr> + <tr> + <th><a href="https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.8.0">SMW 1.8.x</a></th> + <td>Obsolete release</td> + <td>2012-12-02</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/1.8.x">1.8.x</a></td> + </tr> + <tr> + <th><a href="https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_1.7.1">SMW 1.7.1</a></th> + <td>Obsolete release</td> + <td>2012-03-05</td> + <td><a href="https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/1.7.1">1.7.1</a></td> + </tr> +</table> + + +## Platform compatibility + +The PHP and MediaWiki version ranges listed are those in which SMW is known to work. It might also +work with more recent versions of PHP and MediaWiki, though this is not guaranteed. Increases of +minimum requirements are indicated in bold. + +Note that HHVM is only required if you do not use PHP. + +<table> + <tr> + <th></th> + <th>PHP</th> + <th>HHVM</th> + <th>MediaWiki</th> + </tr> + <tr> + <th>SMW 3.1.x</th> + <td><strong><a href="https://php.net/supported-versions.php">7.1.0</a></strong> - latest</td> + <td>No support</td> + <td><strong><a href="https://www.mediawiki.org/wiki/Version_lifecycle">1.31.0</a></strong> - ?</td> + </tr> + <tr> + <th>SMW 3.0.x</th> + <td><strong><a href="https://php.net/supported-versions.php">5.6.0</a></strong> - latest</td> + <td>3.5.0 - latest</td> + <td><strong><a href="https://www.mediawiki.org/wiki/Version_lifecycle">1.27.0</a></strong> - 1.31.x</td> + </tr> + <tr> + <th>SMW 2.5.x</th> + <td><strong><a href="https://php.net/supported-versions.php">5.5.0</a></strong> - 7.1.x</td> + <td>3.5.0 - 3.12.x</td> + <td><strong><a href="https://www.mediawiki.org/wiki/Version_lifecycle">1.23.0</a></strong> - 1.30.x</td> + </tr> + <tr> + <th>SMW 2.4.x</th> + <td>5.3.2 - 7.0.x</td> + <td>3.5.0 - 3.9.x</td> + <td>1.19 - 1.27</td> + </tr> + <tr> + <th>SMW 2.3.x</th> + <td>5.3.2 - 5.6.x</td> + <td><strong>3.5.0</strong> - 3.9.x</td> + <td>1.19 - 1.25</td> + </tr> + <tr> + <th>SMW 2.2.x</th> + <td>5.3.2 - 5.6.x</td> + <td>3.3.0 - 3.9.x</td> + <td>1.19 - 1.25</td> + </tr> + <tr> + <th>SMW 2.1.x</th> + <td>5.3.2 - 5.6.x</td> + <td>3.3.0 - 3.5.x</td> + <td>1.19 - 1.24</td> + </tr> + <tr> + <th>SMW 2.0.x</th> + <td>5.3.2 - 5.6.x</td> + <td>No support</td> + <td>1.19 - 1.23</td> + </tr> + <tr> + <th>SMW 1.9.x</th> + <td>5.3.2 - 5.6.x</td> + <td>No support</td> + <td>1.19 - 1.22</td> + </tr> +</table> + +* *Note:* It is strongly recommended to also always upgrade the underlying MediaWiki software to supported versions. See the [version lifecycle](https://www.mediawiki.org/wiki/Version_lifecycle) for current information on supported versions. +* For the 1.28 MediaWiki release branch, 1.28.1 or later is recommended due to [T154428](https://phabricator.wikimedia.org/T154428). +* For the 1.27 MediaWiki release branch, 1.27.4 or later is recommended due to [T100085](https://phabricator.wikimedia.org/T100085). +* PHP 7.1+ requires at least MediaWiki 1.29 due to [T153505](https://phabricator.wikimedia.org/T153505) and [T143788](https://phabricator.wikimedia.org/T143788) (at the time of this writing). Please also consult the official MediaWiki release documentation. + +**Releases before Composer support:** + +<table> + <tr> + <th></th> + <th>PHP</th> + <th>HHVM</th> + <th>MediaWiki</th> + <th>Validator</th> + </tr> + <tr> + <th>SMW 1.8.x</th> + <td>5.2.0 - 5.5.x</td> + <td>No support</td> + <td>1.17 - 1.22</td> + <td>0.5.1</td> + </tr> + <tr> + <th>SMW 1.7.1</th> + <td>5.2.0 - 5.4.x</td> + <td>No support</td> + <td>1.16 - 1.19</td> + <td>0.4.13 or 0.4.14</td> + </tr> +</table> + + +## Database compatibility + +### SQL support + +<table> + <tr> + <th></th> + <th>MySQL</th> + <th>SQLite</th> + <th>PostgreSQL</th> + </tr> + <tr> + <th>SMW 3.0.x</th> + <td>Full support (5.x)</td> + <td>Full support (3.x)</td> + <td>Full support (9.x)</td> + </tr> + <tr> + <th>SMW 2.5.x</th> + <td>Full support (5.x)</td> + <td>Full support (3.x)</td> + <td>Full support (9.x)</td> + </tr> + <tr> + <th>SMW 2.4.x</th> + <td>Full support (5.x)</td> + <td>Full support (3.x)</td> + <td>Full support (9.x)</td> + </tr> + <tr> + <th>SMW 2.3.x</th> + <td>Full support (5.x)</td> + <td>Full support (3.x)</td> + <td>Full support (9.x)</td> + </tr> + <tr> + <th>SMW 2.2.x</th> + <td>Full support (5.x)</td> + <td>Full support (3.x)</td> + <td>Full support (9.x)</td> + </tr> + <tr> + <th>SMW 2.1.x</th> + <td>Full support (5.x)</td> + <td>Full support (3.x)</td> + <td>Full support (9.x)</td> + </tr> + <tr> + <th>SMW 2.0.x</th> + <td>Full support</td> + <td>Full support</td> + <td>Beta support</td> + </tr> + <tr> + <th>SMW 1.9.x</th> + <td>Full support</td> + <td>Full support</td> + <td>Beta support</td> + </tr> + <tr> + <th>SMW 1.8.x</th> + <td>Full support</td> + <td>Full support</td> + <td>Experimental support</td> + </tr> + <tr> + <th>SMW 1.7.1</th> + <td>Full support</td> + <td>Experimental support</td> + <td>No support</td> + </tr> +</table> + +Note that MS SQL Server and Oracle are not supported as database backends. + +### Triple store support + +<table> + <tr> + <th></th> + <th><a href="https://jena.apache.org/">Fuseki</a></th> + <th><a href="https://github.com/openlink/virtuoso-opensource">Virtuoso</a></th> + <th><a href="https://github.com/garlik/4store">4store</a></th> + <th><a href="http://rdf4j.org/">Sesame</a></th> + <th><a href="https://wiki.blazegraph.com/">Blazegraph</a></th> + </tr> + <tr> + <th>SMW 3.0.x</th> + <td>Full support<br />(1.x >=1.1) + 2.4.0</td> + <td>Full support<br />(6.x >=6.1) + 7.2<sup>[t.1]</sup></td> + <td>Beta support<br />(1.x >=1.1)<sup>[t.2]</sup></td> + <td>Full support<br />(2.8.x)</td> + <td>Full support<br />(1.5.2) + 2.1.0<sup>[t.3]</sup></td> + </tr> + <tr> + <th>SMW 2.5.x</th> + <td>Full support<br />(1.x >=1.1) + 2.4.0</td> + <td>Full support<br />(6.x >=6.1) + 7.2<sup>[t.1]</sup></td> + <td>Beta support<br />(1.x >=1.1)<sup>[t.2]</sup></td> + <td>Full support<br />(2.8.x)</td> + <td>Full support<br />(1.5.2) + 2.1.0<sup>[t.3]</sup></td> + </tr> + <tr> + <th>SMW 2.4.x</th> + <td>Full support<br />(1.x >=1.1) + 2.4.0</td> + <td>Full support<br />(6.x >=6.1) + 7.2<sup>[t.1]</sup></td> + <td>Beta support<br />(1.x >=1.1)<sup>[t.2]</sup></td> + <td>Full support<br />(2.8.x)</td> + <td>Full support<br />(1.5.2) + 2.1.0<sup>[t.3]</sup></td> + </tr> + <tr> + <th>SMW 2.3.x</th> + <td>Full support<br />(1.x >=1.1)</td> + <td>Full support<br />(6.x >=6.1) + 7.1<sup>[t.1]</sup></td> + <td>Beta support<br />(1.x >=1.1)<sup>[t.2]</sup></td> + <td>Full support<br />(2.7.x)</td> + <td>Full support<br />(1.5.2)</td> + </tr> + <tr> + <th>SMW 2.2.x</th> + <td>Full support<br />(1.x >=1.1)</td> + <td>Full support<br />(6.x >=6.1) + 7.1<sup>[t.1]</sup></td> + <td>Beta support<br />(1.x >=1.1)<sup>[t.2]</sup></td> + <td>Full support<br />(2.7.x)</td> + <td>Beta support<br />(1.5.2)</td> + </tr> + <tr> + <th>SMW 2.1.x</th> + <td>Full support<br />(1.x >=1.1)</td> + <td>Full support<br />(6.x >=6.1)</td> + <td>Beta support<br />(1.x >=1.1)</td> + <td>Full support<br />(2.7.x)</td> + <td>Not tested</td> + </tr> + <tr> + <th>SMW 2.0.x</th> + <td>Full support</td> + <td>Full support</td> + <td>Beta support</td> + <td>Beta support</td> + <td>Not tested</td> + </tr> + <tr> + <th>SMW 1.9.x</th> + <td>No support</td> + <td>Beta support</td> + <td>Beta support</td> + <td>Beta support</td> + <td>Not tested</td> + </tr> + <tr> + <th>SMW < 1.9</th> + <td>No support</td> + <td>Experimental support</td> + <td>Experimental support</td> + <td>No support</td> + <td>Not tested</td> + </tr> +</table> + +- "Full support" means that all functionality has been verified to work and that it can be used in production +- "Beta support" means that most functionality has been verified to work, though stability is still low, and things might be buggy +- "Experimental support" means there is some preliminary support which is still much too immature for use in production + +The information in brackets denotes the versions with which SMW is known to work. SMW might also +work with different versions, especially more recent ones, though this is not guaranteed. + +## Notes + +- <sup>[t.1]</sup> On an irregular test plan with [Virtuoso 7.2](https://travis-ci.org/mwjames/SemanticMediaWiki/builds/97294290) +- <sup>[t.2]</sup> On an irregular test plan with [4store 1.1.4](https://travis-ci.org/mwjames/SemanticMediaWiki/builds/61200454) +- <sup>[t.3]</sup> [#1583](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1583) +- [#2688](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2688) Removed HHVM support diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/CONTRIBUTING.md b/www/wiki/extensions/SemanticMediaWiki/docs/CONTRIBUTING.md new file mode 100644 index 00000000..32afad72 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/CONTRIBUTING.md @@ -0,0 +1,51 @@ +<!-- Note that the headers in this file are being linked to via bitly.com. In case the headers change these links must be changed, too. Just ping kghbln on changes. --> +There are different ways to make a contribution to [Semantic MediaWiki][smw] (SMW) while a few guidelines are necessary to keep the workflow and review process most efficient. + +### Report bugs + +A bug is the occurrence of an unintended or unanticipated behaviour that causes a vulnerability or fatal error. + +* You may help us by reporting bugs and feature requests via the [issue tracker][smw-issues]. See the help page on [reporting bugs (environment, reproducing)][smw-bugs1] as well as on [identifying bugs (stack-trace)][smw-bugs2] for information on how to do this best. Please remember to always provide information about your environment as well as a stack-trace. +* You may help us to do [pre-release testing][smw-testing] by joining the [team of testers][smw-testers] on GitHub. + +### Feature requests + +A feature request is a new, or altered behaviour of an existing functionality. + +A request should contain a detailed description of the expected behaviour in order to avoid misconceptions in the process of an implementation. The following notes are provided to aid the process and help prioritize a request for project members. + +* Why is the feature requested or relevant? +* What does the feature solve? (e.g. it addresses a generalizable behaviour, it solves a specific use case etc.) +* Examples demonstrate the expected behaviour by: + * Being simple, clear, and targeted towards the feature and not rely on any other external functionality (such as other parser functions or extensions). + * In case of a modified behaviour, examples demonstrate the old and new behaviour together with an explanation of the expected difference + * In case of a new behaviour, examples are written down to outline the expected new behaviour (best practice is a step-by-step description) together with a [use case](https://en.wikipedia.org/wiki/Use_case) +* Examples made available via the [sandbox](https://sandbox.semantic-mediawiki.org). +* Examples should be adaptable so they can be used as part of an [integration test](https://www.semantic-mediawiki.org/wiki/Help:Integration_tests). + +### Improve documentation + +* You may help us by providing software translations via [translatewiki.net][twn]. See their [progress-statistics][twn-smw] to find out if there is still work to do for your language. +* You may help us by creating, updating or amending the documentation of the software on [Semantic-MediaWiki.org][smw]. + +### Provide patches + +You may help us by providing patches or additional features via a pull request but in order to swiftly co-ordinate your code contribution, the following should suffice: + +* Please ensure that pull requests are based on the current master. See also the [developer documentation overview][smw-ddo] for further information. +* Code should be easily readable (see [NPath complexity][smw-npath], `if else` nesting etc.) and if necessary be put into separate components (or classes) +* Newly added features should not alter existing tests but instead provide additional test coverage to verify the expected new behaviour. For a description on how to write and run PHPUnit test, please consult the [manual][mw-testing]. + +Thank you for contributing to Semantic MediaWiki! + +[smw]: https://github.com/SemanticMediaWiki/SemanticMediaWiki +[smw-issues]: https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues +[smw-bugs1]: https://www.semantic-mediawiki.org/wiki/Help:Reporting_bugs +[smw-bugs2]: https://www.semantic-mediawiki.org/wiki/Help:Identifying_bugs +[smw-testing]: https://www.semantic-mediawiki.org/wiki/Help:Reporting_bugs#Pre-release_testing +[smw-testers]: https://github.com/orgs/SemanticMediaWiki/teams/testers +[twn]: https://translatewiki.net/ +[twn-smw]: https://translatewiki.net/w/i.php?title=Special%3AMessageGroupStats&x=D&group=ext-semanticmediawiki&suppressempty=1 +[smw-ddo]: https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/docs/technical/README.md +[mw-testing]: https://www.mediawiki.org/wiki/Manual:PHP_unit_testing +[smw-npath]: https://www.semantic-mediawiki.org/wiki/Code_coverage#NPath_complexity diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/INSTALL.md b/www/wiki/extensions/SemanticMediaWiki/docs/INSTALL.md new file mode 100644 index 00000000..aeb04a88 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/INSTALL.md @@ -0,0 +1,138 @@ +# Installation guide (brief) + +This is a brief installation and configuration guide for [Semantic MediaWiki](../README.md) (SMW) +that only contains the core steps. More verbose installation instructions with additional explanation +and upgrading instructions can be found [here](https://www.semantic-mediawiki.org/wiki/Help:Installation). + +A list of supported PHP versions, MediaWiki versions and databases per SMW release can be found +in the [compatibility matrix](COMPATIBILITY.md). + + +## Download and installation + +### Installation with Composer + +The strongly recommended way to install Semantic MediaWiki is with [Composer](http://getcomposer.org) using +[MediaWiki's built-in support for Composer](https://www.mediawiki.org/wiki/Composer). + +#### Step 1 + +Change to the base directory of your MediaWiki installation. This is where the "LocalSettings.php" +file is located. If you have not yet installed Composer do it now by running the following command +in your shell: + + wget https://getcomposer.org/composer.phar + +#### Step 2 + +If you do not have a "composer.local.json" file yet, create one and add the following content to it: + +``` +{ + "require": { + "mediawiki/semantic-media-wiki": "~3.0" + } +} +``` + +If you already have a "composer.local.json" file add the following line to the end of the "require" +section in your file: + + "mediawiki/semantic-media-wiki": "~3.0" + +Remember to add a comma to the end of the preceding line in this section. + +#### Step 3 + +Run the following command in your shell: + + php composer.phar update --no-dev + +Note if you have Git installed on your system add the `--prefer-source` flag to the above command. Also +note that it may be necessary to run this command twice. If unsure do it twice right away. + +#### Step 4 + +Run the MediaWiki [update script](https://www.mediawiki.org/wiki/Manual:Update.php). The location of +this script is `maintenance/update.php`. It can be run as follows in your shell: + + php maintenance/update.php + +#### Step 5 + +Add the following line to the end of your "LocalSettings.php" file: + + enableSemantics( 'example.org' ); + +Note that "example.org" should be replaced by your wiki's domain. + +#### Step 6 + +If you are installing SMW on a freshly installed wiki continue to the next step. If the wiki already has content +pages run the Semantic MediaWiki [data rebuild script](https://www.semantic-mediawiki.org/wiki/Help:Maintenance_script_"rebuildData.php"). The location of this script +is `extensions/SemanticMediaWiki/maintenance/rebuildData.php`. It can be run as follows in your shell: + + php extensions/SemanticMediaWiki/maintenance/rebuildData.php -v + +#### Verify installation success + +As final step, you can verify SMW got installed by looking at the "Special:Version" page on your wiki and check that +the Semantic MediaWiki section is listed. + +### Installation without shell access + +As an alternative to installing via Composer, you can obtain the SMW code by creating your own [individual file release](https://github.com/SemanticMediaWiki/IndividualFileRelease) most likely if command line access to the webspace is not available or if the hoster imposes restrictions on required functionality. + +Note that SMW no longer provides file releases [(See #3347).](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1732) + +#### Step 1 + +Create your [individual file release](https://github.com/SemanticMediaWiki/IndividualFileRelease) using the respective script. Please pay attention to the MediaWiki version used in the script and adapt to your setup if necessary. + +#### Step 2 + +Transfer the code thus compiled to the appropriate folders on your webspace. + +#### Step 3 + +Add the following lines to the end of your "LocalSettings.php" file: + + enableSemantics( 'example.org' ); + +Note that "example.org" should be replaced by your wiki's domain. + +#### Step 4 + +Log in as a user with administrator permission to your wiki and go to the "Maintenance" tab on special page "Special:SemanticMediaWiki": + +Click on the "Initialise or upgrade tables" button in the "Database maintenance" section to setup the +database. + +#### Step 5 + +If you are installing SMW on a freshly installed wiki continue to the next step. If the wiki already has content +pages also do the following on page "Special:SemanticMediaWiki": + +Click on the "Start updating data" button in the "Data rebuild" subsection of "Maintenance" tab +to activate the [automatic data update](https://www.semantic-mediawiki.org/wiki/Help:Repairing_SMW's_data). + +#### Verify installation success + +As final step, you can now verify SMW got installed by looking at the "Special:Version" page on your wiki and check that +the Semantic MediaWiki section is listed. + +### Installation of development versions and release candidates + +If you would like to install a development version or release candidate then replace the lines as stated in step 3 of the +"Installation with Composer" section with the following line + +* master: `"mediawiki/semantic-media-wiki": "@dev"` +* legacy branch: `"mediawiki/semantic-media-wiki": "3.0.x@dev"` +* release candidate: `"mediawiki/semantic-media-wiki": "~3.0@rc"` + +## More instructions + +* [Verbose installation instructions](https://www.semantic-mediawiki.org/wiki/Help:Installation) +* [Upgrading instructions](https://www.semantic-mediawiki.org/wiki/Help:Installation#Upgrading) +* [Configuration instructions](https://www.semantic-mediawiki.org/wiki/Help:Configuration) +* [Administrator manual](https://www.semantic-mediawiki.org/wiki/Help:Administrator_manual) diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/ISSUE_TEMPLATE.md b/www/wiki/extensions/SemanticMediaWiki/docs/ISSUE_TEMPLATE.md new file mode 100644 index 00000000..087e9e86 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/ISSUE_TEMPLATE.md @@ -0,0 +1,21 @@ +### Setup and configuration + +- SMW version: +- MW version: +- PHP version: +- DB system (MySQL, Blazegraph, etc.) and version: + +_Note that it is **required** to provide the setup and configuration information. If you believe to have detected a regression after updating your software please also provide information about your previous setup as well. **In any case only this information will enable us to allocate appropriate review time.** Thank you for you help._ + +### Issue +_Please describe the issue as best as you can and also fill in the following two sections if applicable._ + +### Stack trace +Produces a [stack trace](https://www.semantic-mediawiki.org/wiki/Help:Identifying_bugs) and/or outputs: + +``` +Placeholder for the stack trace or code! +``` + +### Steps to reproduce +_It is recommend to use the [sandbox](https://sandbox.semantic-mediawiki.org) to demonstrate the observed issue, otherwise provide us with a simple reproducible use case._ diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/PULL_REQUEST_TEMPLATE.md b/www/wiki/extensions/SemanticMediaWiki/docs/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 00000000..574b18c9 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,12 @@ +This PR is made in reference to: # + +This PR addresses or contains: +- ... +- ... +- ... + +This PR includes: +- [ ] Tests (unit/integration) +- [ ] CI build passed + +Fixes #
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/README.md b/www/wiki/extensions/SemanticMediaWiki/docs/README.md new file mode 100644 index 00000000..963fdfeb --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/README.md @@ -0,0 +1,23 @@ + +The documentation for Semantic MediaWiki (SMW) can primarily be found on the [SMW homepage](https://www.semantic-mediawiki.org). +Some core documentation is included together with the source code, and can mostly be found in the +`docs/` directory. This documentation includes basic installation instructions, release notes and +technical documentation. + +* [Installation instructions](INSTALL.md) (see also the [upgrade guide](https://www.semantic-mediawiki.org/wiki/Help:Installation)) +* [Compatibility matrix](COMPATIBILITY.md) + +## Release notes + +* [Latest release notes](RELEASE-NOTES.md) +* [Other release notes](releasenotes/README.md) + +## Technical documentation + +* [Technical documentation](technical/README.md) + +## Repository documentation + +* [Contributing](CONTRIBUTING.md) +* [Issue template](ISSUE_TEMPLATE.md) +* [Pull request template](PULL_REQUEST_TEMPLATE.md) diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/RELEASE-NOTES.md b/www/wiki/extensions/SemanticMediaWiki/docs/RELEASE-NOTES.md new file mode 100644 index 00000000..36557b5c --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/RELEASE-NOTES.md @@ -0,0 +1,24 @@ +# Semantic MediaWiki 3.0.2 + +Released on April 11, 2019. + +## Enhancements + +* [#3682](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3682) as `f5d0cab`: Removed `IsFileCacheable` hook and improves file caching +* [#3856](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3854) as `767c981`: Switched setting of configuration parameter "$smwgCompactLinkSupport" to "false" + +## Bug fixes and internal code changes + +* [#3742](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3742): Fixed raw output of templated message particles +* [#3771](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3771) as `b7a78e0`: Removed `doPostOutputShutdown` +* [#3772](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3772) as `79e4adb`: Fixed "... expects parameter 1 to be a valid callback ..." +* [#3775](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3775) as `3b0d83c`: Made data type "Equivalent URI" non declarative +* [#3847](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3847) as `d088204`: Fixed warning "a non-numeric value" was encountered +* [#3854](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3854) as `d05671e`: Provided a new test case for "display title" +* [#3859](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3859): Updated "InfolinkTest" +* [#3863](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3863): Fixed resource loading by replacing `localpath` with `localBasePath` +* [0ed4bbf7](https://github.com/SemanticMediaWiki/SemanticMediaWiki/commit/0ed4bbf75e7ee9989d2ac84437d3733b52885eb8): Updated "EventHandlerTest" + +## See also +* [RELEASE NOTES](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/3.0.x/docs/releasenotes/RELEASE-NOTES-3.0.0.md) for Semantic MediaWiki 3.0.0 +* [RELEASE NOTES](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/3.0.x/docs/releasenotes/RELEASE-NOTES-3.0.1.md) for Semantic MediaWiki 3.0.1 diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/README.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/README.md new file mode 100644 index 00000000..8f1df375 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/README.md @@ -0,0 +1,36 @@ +## Release notes + +* [SMW 3.0.2 release notes](RELEASE-NOTES-3.0.2.md) +* [SMW 3.0.1 release notes](RELEASE-NOTES-3.0.1.md) +* [SMW 3.0.0 release notes](RELEASE-NOTES-3.0.0.md) +* [SMW 2.5.8 release notes](RELEASE-NOTES-2.5.8.md) +* [SMW 2.5.7 release notes](RELEASE-NOTES-2.5.7.md) +* [SMW 2.5.6 release notes](RELEASE-NOTES-2.5.6.md) +* [SMW 2.5.5 release notes](RELEASE-NOTES-2.5.5.md) +* [SMW 2.5.4 release notes](RELEASE-NOTES-2.5.4.md) +* [SMW 2.5.3 release notes](RELEASE-NOTES-2.5.3.md) +* [SMW 2.5.2 release notes](RELEASE-NOTES-2.5.2.md) +* [SMW 2.5.1 release notes](RELEASE-NOTES-2.5.1.md) +* [SMW 2.5.0 release notes](RELEASE-NOTES-2.5.0.md) +* [SMW 2.4.6 release notes](RELEASE-NOTES-2.4.6.md) +* [SMW 2.4.5 release notes](RELEASE-NOTES-2.4.5.md) +* [SMW 2.4.4 release notes](RELEASE-NOTES-2.4.4.md) +* [SMW 2.4.3 release notes](RELEASE-NOTES-2.4.3.md) +* [SMW 2.4.2 release notes](RELEASE-NOTES-2.4.2.md) +* [SMW 2.4.1 release notes](RELEASE-NOTES-2.4.1.md) +* [SMW 2.4.0 release notes](RELEASE-NOTES-2.4.0.md) +* [SMW 2.3.1 release notes](RELEASE-NOTES-2.3.1.md) +* [SMW 2.3.0 release notes](RELEASE-NOTES-2.3.0.md) +* [SMW 2.2.3 release notes](RELEASE-NOTES-2.2.3.md) +* [SMW 2.2.2 release notes](RELEASE-NOTES-2.2.2.md) +* [SMW 2.2.1 release notes](RELEASE-NOTES-2.2.1.md) +* [SMW 2.2.0 release notes](RELEASE-NOTES-2.2.0.md) +* [SMW 2.1.3 release notes](RELEASE-NOTES-2.1.3.md) +* [SMW 2.1.2 release notes](RELEASE-NOTES-2.1.2.md) +* [SMW 2.1.1 release notes](RELEASE-NOTES-2.1.1.md) +* [SMW 2.1.0 release notes](RELEASE-NOTES-2.1.0.md) +* [SMW 2.0.0 release notes](RELEASE-NOTES-2.0.md) +* [SMW 1.9.2 release notes](RELEASE-NOTES-1.9.2.md) +* [SMW 1.9.1.1 release notes](RELEASE-NOTES-1.9.1.1.md) +* [SMW 1.9.1 release notes](RELEASE-NOTES-1.9.1.md) +* [SMW 1.9.0 release notes](RELEASE-NOTES-1.9.md) diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.6.1.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.6.1.md new file mode 100644 index 00000000..af3f8620 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.6.1.md @@ -0,0 +1,10 @@ +Released on August 20, 2011. + +* #ask queries now allow printouts (table columns) that are exactly the same. + In previous versions, multiple printouts with the same label would be + collapsed (e.g. {{#ask: [[Catgegory:City]] |?|?|?}} now shows four columns). +* Fixed continue and limit escaping issues on Special:Ask. +* Fixed error occurring for invalid queries with count or debug formats. +* Fixed several small issues with the table format and cleaned it up somewhat. +* Fixed parsing of years for data properties. +* Internationalization improvements and layout tweaks to #smwdoc.
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.6.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.6.md new file mode 100644 index 00000000..2655c60d --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.6.md @@ -0,0 +1,50 @@ +Released on July 30, 2011. + +* Full support for synchronizing RDF stores with SMW, and for answering #ask + queries based on this data. The communication happens via SPARQL (1.1), and + all SPARQL-capable stores should be supported. The following settings are + needed in LocalSettings.php: + $smwgDefaultStore = 'SMWSparqlStore'; + $smwgSparqlDatabase = 'SMWSparqlDatabase'; + // The following should be set to the URLs to reach the store: + $smwgSparqlQueryEndpoint = 'http://localhost:8080/sparql/'; + $smwgSparqlUpdateEndpoint = 'http://localhost:8080/update/'; + $smwgSparqlDataEndpoint = 'http://localhost:8080/data/'; // can be empty + The specific support that SMW used to have for the RAP RDF store has been + discontinued. +* The Type namespace has been abolished. Builtin types now are displayed by the + special page Special:Types, and there are no "custom types" any longer. + By default, the Type namespace is gone and existing pages in this namespace + can no longer be accessed. This can be changed by setting + $smwgHistoricTypeNamespace = true in LocalSettings.php before including SMW. +* Changed the way in which units of measurement work. Type:Number now does not + accept any units, and a new type "Quantity" is used for numbers with units. + Units must be declared on the property page (not on the Type page as before), + and only units that have a declared conversion factor are accepted. +* The declaration of Type:Record properties has changed. Instead of a list of + datatypes, the declaration now requires a list of properties that are to be + used for the fields of the record. The declaration is still done with the + property "has fields" as before. Properties must not be used more than once + in has_fields, or the order of values will be random. +* Introduced pre-defined builtin properties for every datatype. For example, + the property String is always of type String and available on all (English) + wikis. This helps to keep some of the old Tpe:Record declarations valid. +* Changed the way parameters in query printers are specified and handled + using the Validator extension. This includes improvements to the parameter + options in the Special:Ask GUI and better error reporting for ask queries. +* Added UNIX-style DSV (Delimiter-separated values) result format. +* Reworked internal data model, cleaning up and re-implementing SMWDataValue and + all of its subclasses, and introducing new data item classes to handle data. + The class SMWCompatibilityHelpers provides temporary help for extensions that + still depend on the old format and APIs. +* Fixed PostgreSQL issues with the installation and upgrade code. +* Added API module (smwinfo) via which statistics about the semantic data can + be obtained. +* Added second parameter to #info that allows chosing either the info or warning + icon. +* Added #smwdoc parser hook that displays a table with parameter documentation for + a single specified result format. +* Fixed escaping issues in the JSON result format. A compatibility breaking change + is that per property an array of values will be returned, even if there is only + one. +* Added SMWStore::updateDataBefore and SMWStore::updateDataAfter hooks.
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.7.1.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.7.1.md new file mode 100644 index 00000000..ac55e9d7 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.7.1.md @@ -0,0 +1,24 @@ +Released on March 5, 2012. + +* Added basic support for OpenLink Virtuoso RDF database. In addition to + $smwgDefaultStore = 'SMWSparqlStore', users should set + $smwgSparqlDatabase = 'SMWSparqlDatabaseVirtuoso' and use Virtuoso's SPARQL + endpoint at ./sparql/ for query and update alike. for further remarks and known + limitations, see the file ./includes/sparql/SMW_SparqlDatabaseVirtuoso.php . +* Added ability to sort dates as dates in tables generated by SMW (bug 25768). +* Added "Last editor is" and "Is a new page" special properties (bug 34359). +* When there are only invalid query conditions, query answering is stopped (bug 33177). +* Fixed display of nearby values on Special:SearchByProperty (bug 34178). +* Fixed display of URL values (bug 34312, 34044). +* Fixed warning when browsing certain property pages (bug 34306). +* Fixed failure of SMW_setup --delete when using postgresql (bug 31153). +* Fixed division by 0 error when setting the "Corresponds to" property to 0 (bug 32594). +* Fixed accept header send with SPARQL query requests (bug 32280). +* Fixed unresolved prefixed name in SPARQL queries (bug 33687). +* Fixed issues with modification date property occurring when using SMWSparqlStore (bug 30989). +* Fixed erroneous SPARQL for property value comparison queries (bug 30993). +* Fixed broken +index=x for records (bug 30284). +* Fixed querying of subobjects using 4store as a datastore. +* Fixed issue with namespace internationalization (bug 34383). + +Also see the [SMW 1.7 release notes](RELEASE-NOTES-1.7.md)
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.7.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.7.md new file mode 100644 index 00000000..ab46062a --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.7.md @@ -0,0 +1,56 @@ +Released on January 1, 2012. + +* Added native "internal objects" that can be set using #subobject. +* Added support for selecting a default graph when using RDF stores, + configuration called $smwgSparqlDefaultGraph +* Use of native MediaWiki sortable tables for the table formats. +* Added value distribution functionality that can be used by result formats. +* Added validation and manipulation of the 'format' parameter using Validator. +* Added 'class' parameter to the 'table' format, which allows setting the CSS + class. +* Added automatically-generated CSS classes for rows and cells in 'table' format. +* Added alpha version of native SMW Ask API with modules 'ask' and 'askargs'. +* Added alpha version of a new ask query interface: Special:QueryCreator. +* Added setting to choose which optional special properties are enabled ($smwgPageSpecialProperties). +* Added creation date special property (disabled by default) (bug 32165). +* Added support for altitudes in geographic coordinates (bug 32698). +* Added definitions for missing params (sort, order, searchlabel) to the base query printer. +* Added automatic invocation of the SMW_setup maintenance script when running + update.php (for MW >= 1.19). +* Added support for the Page Schemas extension. +* Removed defunct "SMWLight" files. +* Fixed separator and filename parameters for the DSV format. +* Fixed display of properties of type URL (bug 30912). +* Fixed hide query functionality on Special:Ask (bug 30768). +* Fixed display of internal SMW helper constants in certain queries (bug 30969). +* Fixed some issues with the category result format (including bug 30761). +* Fixed email validation issue (bug 32295). +* Fixed incorrect handling of sort and order parameters on Special:Ask (bug 32706). +* Fixed display of images to old behavior after a recent regression. +* Fixed fatal error in the concept cache maintenance script (bug 32592). +* Fixed factbox links to Special:SearchByProperty containing numerical numbers for + wikis in languages with the comma as decimal separator instead of a dot. +* Fixed the "hide incoming properties" link on Special:Browse. +* Fixed several more issues not listed here. +* Dropped compatibility with MediaWiki 1.15.x (and earlier). +* Dropped compatibility with old-style (SMW < 1.6) query printers. +* Full compatibility with MediaWiki 1.18 and foreward-compatibility with 1.19. + +== SMW 1.7.0.2 == + +Released on January 16, 2012. + +* Fixed creation of concept cache and display of matching objects on concept pages (bug 32592, 32718). +* Fixed fatal error occurring for some invalid property definitions (bug 33652). +* Fixed error in RSS when using creator or date parameters (bug 33721). +* Fixed incorrect offset of export formats (bug 33726). + +== SMW 1.7.0.1 == + +Released on January 9, 2012. + +* Fixed bug in "further results" links causing the main column to be displayed twice on Special:Ask (bug 33473). +* Fixed incorrect case-sensitivity of the format parameter (bug 31138). +* Fixed internationalization of magic words. +* Fixed offset and limit value in further results links (bug 33575). + diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.8.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.8.md new file mode 100644 index 00000000..cf3f358b --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.8.md @@ -0,0 +1,79 @@ +Semantic MediaWiki 1.8 is a stable release. + +Released December 2nd, 2012. + +=== Compatibility changes === + +* Changed minimum MediaWiki version from 1.16 to 1.17. +* Full compatibility with MediaWiki 1.19 and forward-compatibility with 1.20. +* Changed minimum Validator version from 0.4 to 0.5. +* The structure of the JSON result format has been altered (bug 37418). +* The default database layout has changed. Please read the upgrade instructions for existing sites. + +=== New features === + +* The #subobject function now supports the use of empty subobject names ("-" has the same effect). A new anonymous subobject will be created in this case. (bug 36634) +* Added atom printer (bug 38636) +* SMW now collects data about all queries, and this data can be queried to get an overview of queries used on the wiki. Information about queries is stored in subobjects of the page they are on. The property [[Property:Has query]] links a page to a query. The query subobject currently holds values for the following properties: [[Property:Query string]], [[Property:Query format]], [[Property:Query size]], [[Property:Query depth]]. +* Added new info tooltip (bug 37361) +* Added two new output formats for properties of type Time, "Gr" and "Jl", to set the desired calendar model for display in #ask results. If nothing is given, SMW will select the calendar based on the date as before (Julian calendar defaults from until 4th Oct 1582). As before. the same behavior is used when entering dates, and "Jl" and "Gr" also work in this case. +* Added new output format "nowiki" to properties of type URL, which will format a URL in such a way that it will not be autolinked by MediaWiki. + +=== Enhancements === + +* Significanlty less database write activity on wiki edits that do not change semantic data +* Less database read activity (esp. for displaying long query results and special pages) due to new and improved caching mechanisms +* Improved database table layout for more efficient access and better use of storage space +* Significant performance improvements for Special:Properties and Special:UnusedProperties +* Support for configuring dedicated tables for more efficient handling of frequently used properties, see http://semantic-mediawiki.org/wiki/Fixed_properties +* Improved JSON export (bug 37418). +* Improved Special:Ask UI. +** Enabled Special:Ask parameters form to be collapsible. +** Added individual format help links to enable access to online help manuals. +* Added continuation support to the Ask API. +* Added possibility to change the appearance of the service link icon via CSS (bug 40644) + +=== Dropped features === + +* Special:QueryCreator got disabled pending fixes. +* Values of type Time can no longer be selected by string pattern matching (the string was unspecified and has an internal format that is not useful to match against). This safes database memory (fewer indexes). + +=== Bug fixes === + +* Fixed automatic running of SMW updating script when running maitenance/update.php. +* Fixed page parameter handling on Special:ExportPDF (bug 35180). +* Fixed handling of #set_recurring_event for 'month' and 'year' time units. +* Fixed error on Special:URIResolver (bug 35643). +* Fixed 'badtitle' error on Special:URIResolver (bug 39967). +* Fixed alternative query source ($smwgQuerySources) (bug 38292). +* Fixed getMaxIncludeSize() on a non-object error in Special:Ask (bug 40650) +* Fixed markup issue with the display of service links (bug 39445) +* Fixed tooltip size issue (bug 29764) +* Fixed Special:Ask autocomplete issue (bug 40676) +* Fixed serialisation of Category namespace queries (bug 37065) +* Fixed non-linked output of URL values in query results (bug 39392) +* Avoid malformed SPARQL when default graph is not set (bug 37575) +* Do not batch process pages when using SMW_refreshData.php with delay option (bug 38136) +* Avoid use of hash_init PHP functions; use md5() instead (bug 38185) +* Fixed parsing of malformed printout requests that could cause exception (bug 38489) +* Don't confuse Julian an Gregorian dates internally (bug 41126) +* Avoid MediaWiki problem that can cause errors when refreshing data and using _LEDT (last editor is) (bug 35962) +* Fixed Special:PageProperty, which was broken + +=== Technical improvements and code quality === + +* Added tests for the query processor, the store, data items and result printers, including base test classes for the later two that can be used by extensions. +* Refactored large portions of the SQLStore implementation (SMWSQLStore3). + * More, shorter files for various task groups (SQLStore3_Writers, SQLStore3_Readers, SQLStore3_SpecialPageHandlers, SQLStore_SetupHandler, and others) + * Different types of data now handled modularly by DIHandler classes + * Completely rewritten writing methods that compute a full diff on a database level to decide which write activities are needed (if any) +* No more inline CSS and JavaScript on special pages (now all resource loader modules). +* Added SMWExportPrinter class to facilitate creating export printers and simplify handling code. +* Added SMWIResultPrinter interface to type hint result printers against. +* Migrated Validator parameter definitions to new Validator 0.5 array style. +* Transformed SMW_custom.css, SMW_tooltip.js, and the skin folder to comply with the ResourceLoader environment +* Made query link generation completely generic. Links for all formats will now contain all provided arguments. + +=== Extended translations === + +As usual, translations have been extended thanks to the [[Translatewiki.net|Translatewiki.net project]]. diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.0.1.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.0.1.md new file mode 100644 index 00000000..ae0ea7e3 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.0.1.md @@ -0,0 +1,19 @@ +# Semantic MediaWiki 1.9.0.1 + +Released January 6th, 2014. + +### New features + +* (Issue 82) It is now possible to view all SMW settings via Special:SMWAdmin. + +### Bug fixes + +* (Bug 59204) Fixed removal of properties on deletion of pages in custom namespaces. +* (Issue 73) Fixed double table prefixing issue causing problems when using SQLite. +* (Issue 84) Fixed the link to the INSTALL file on Special:SMWAmin. +* (9ac5288) Fixed reference to DataTypeRegistry in the SPARQL store. + +### New configuration parameters + +* [$smwgOnDeleteAction](https://semantic-mediawiki.org/wiki/Help:$smwgOnDeleteAction) +(incl. $smwgDeleteSubjectAsDeferredJob, $smwgDeleteSubjectWithAssociatesRefresh) diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.0.2.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.0.2.md new file mode 100644 index 00000000..c915fdda --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.0.2.md @@ -0,0 +1,11 @@ +# Semantic MediaWiki 1.9.0.2 + +Released January 17th, 2014. + +### Bug fixes + +* #85 Fixed compatibility issue with PHP 5.3 on Special:SMWAdmin and added regression test +* #86 Fixed compatibility with older MediaWiki versions by supporting legacy job definitions +* #89 The resource paths will now be correct event if SMW is put on a non-standard location +* #97 Fixed strict standards notice in the SQLStore +* #99 Fixed issue occurring in the SQLStore for people using mysqli and MediaWiki 1.22 or later
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.1.1.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.1.1.md new file mode 100644 index 00000000..200da60a --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.1.1.md @@ -0,0 +1,11 @@ +# Semantic MediaWiki 1.9.1.1 + +Released February 28th, 2014. + +### Bug fixes + +* #183 Fixed 1.9.1 regression in resource paths that caused resouces not to load + +### Internal enhancements + +* #200 Improved the usage of "InternalParseBeforeLinks" to indicate whether semantic data have been processed or not diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.1.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.1.md new file mode 100644 index 00000000..0b1a6f18 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.1.md @@ -0,0 +1,44 @@ +# Semantic MediaWiki 1.9.1 + +Released February 9th, 2014. + +### New features + +* #162 Added possibility to create `_MEDIA` [(special property "Media type")](https://semantic-mediawiki.org/wiki/Help:Special_property_Media_type) and `_MIME` +[(special property "MIME type")](https://semantic-mediawiki.org/wiki/Help:Special_property_MIME_type) +property annotation when uploading a file (This feature can only be used with appropriate +[`$smwgPageSpecialProperties`](https://www.semantic-mediawiki.org/wiki/Help:$smwgPageSpecialProperties) +settings after running the "update.php" script.) +* #173 Extended the [factbox](https://semantic-mediawiki.org/wiki/Factbox#The_factbox) in +order to display "historical" data when used by `action=history` +* #180 Added further CSS classes for improved customization of special page +["Ask"](https://semantic-mediawiki.org/wiki/Help:Special:Ask) + +### Bug fixes + +* #80 Fixed issue with running the system tests on a MySQL based setup +* #110 Fixed type mismatch issue in the caching code of SQLStore3 +* #121 (Bug 60336) Fixed sortkey issue for multibyte characters in ListResultPrinter +* #144 (Bug 60284) Fixed record data type issue when using #set/#subobject +* #145 Fixed PHP strict standards notice in SMWParamFormat::formatValue +* #146 Fixed 1.9.0.2 regression in resource paths that caused the SMW badge and JS+CSS to +not be loaded on some wikis +* #148 Fixed regression that made data type labels case sensitive +* #151 (Bug 50155) Fixed issue with category hierarchies on SQLite +* #164 (Bug 19487) Fixed update of predefined properties when uploading a file +* #166 Fixed Factbox display issue during preview and edit mode +* #170 Fixed 1.9.0 regression of [special property "Is a new page"](https://semantic-mediawiki.org/wiki/Help:Special_property_Is_a_new_page) (`_NEWP`) +(Run ["SMW_refreshData.php"](https://semantic-mediawiki.org/wiki/Help:SMW_refreshData.php) +to amend falsely set values.) + +### Internal enhancements + +* #112 Added a date data type regression test +* #118 Added a possibility to inject a Revision into the ContentParser +* #119 Added a LinksUpdate integration test +* #131 Added internationalization support for special property "Query duration" +* #132 Added smoke test for the special language files +* #142 Changed the Norwegian language code (Bokmål variant) from "no" to "nb" for +L10n of datatypes, special properties, etc. +* #144 Added a record data type regression test +* #151 Added a category hierarchy regression test diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.2.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.2.md new file mode 100644 index 00000000..f1c58119 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.2.md @@ -0,0 +1,37 @@ +# Semantic MediaWiki 1.9.2 + +Released April 18th, 2014. + +### New features + +* #199 Added [object-Id lookup](https://www.semantic-mediawiki.org/wiki/Help:Object_ID_lookup) to SMWAdmin +* #217 Extended ListResultPrinter to make `userparam` parameter available to intro and outro templates and introduced [additional parameters](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/217) +* #243 Added `--query` parameter to the `SMW_refreshData.php` maintenance script + +### Bug fixes + +* #203 Fixed undefined index in connection with `$smwgQuerySources` +* #215 (Bug 62150) Fixed malformed query order in SparqlQueryEngine +* #272 #276 Fixed ConceptCache on SQLite +* #273 Fixed footer logo path for windows based installations + +### Deprecated + +* #187 Use of `SMW_conceptCache.php` has been deprecated in favour of `rebuildConceptCache.php` +* #244 Use of `SMW_refreshData.php` has been deprecated in favour of `rebuildData.php` + +### Internal enhancements + +* #195 Improvement of handling configuration settings in getPropertyTables +* #204 Added update job for new redirects +* #207 Removed SMWParamSource and added a `$smwgQuerySources` integration test +* #218 Extended SparqlStore to inject a SparqlDatabase to enable basic test coverage +* #226 Added ExecutionTimeTestListener to report long running tests +* #227 Moved all job related classes into the `SMW\MediaWiki\Jobs\` namespace +* #234 Added redirects regression test +* #236, #265 Removed wfGetDB from SMWSQLStore3Writers and extended test coverage +* #244, #253, #256, #267, #268 Refactored and migrate `SMW_refreshData.php` to `rebuildData.php` +* #248 Added support for the new MediaWiki i18n JSON system +* #256 Improved data selection for DataRebuilder filters +* #262 Improved SQLStore upgrading for Postgres +* #270 Removed SQLStore3::getPropertyTables as static caller diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.md new file mode 100644 index 00000000..ef5dd772 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-1.9.md @@ -0,0 +1,142 @@ +# Semantic MediaWiki 1.9 + +Released January 3rd, 2014. + +### Platform compatibility changes + +* Changed minimum PHP version from 5.2. to 5.3.2. +* Changed minimum MediaWiki version from 1.17 to 1.19. +* Full compatibility with MediaWiki 1.19, 1.20, 1.21, 1.22 and forward-compatibility with 1.23. +* Changed minimum Validator version from 0.5 to 1.0. +* Added beta support for PostgreSQL. + +### New features + +* SMW (and its dependencies) can now be installed via [Composer](https://getcomposer.org/) +* Added maintenance script [rebuildPropertyStatistics.php](https://semantic-mediawiki.org/wiki/Help:RebuildPropertyStatistics.php) to rebuild the property statistics +* (271864f) The property type String is now an alias for Text and has no more length restrictions +* (38499a8) Special:Statistics now shows a "semantic statistics" version (only when using a recent version of MediaWiki) +* (ed52df7) (Bug 50844) Special:Properties now provides a form to search user-defined properties +* (a949f04) (Bug 33181) Add page [Special:Concepts](https://semantic-mediawiki.org/wiki/Help:Special:Concepts) that lists available concepts +* (0c971f8) (Bug 46458) Extend smwinfo API module to provide additional information +* (b8aea6c) (Bug 48840) Add a smw-admin right to enable restricted access to Special:SMWAdmin +* (9714d04) (a33411f) Add new "browsebysubject" API module to fetch semantic data for a given subject + +### Enhancements + +* (Bug 36309) and (Bug 39019) Add +sep= as multiple value separator for #set and #subobject parser function +* (6dd845e) (Bug 34477) Add cache information to concept pages +* (Bug 34172) Add [individual CSS class](https://www.semantic-mediawiki.org/wiki/Help:Further_results) injection for further result links +* (I2e509e) Improved efficiency of property statistics rebuilding script +* (8bcee83) (Bug 44696) Fix XML output for AskApi +* (bb35e8a) (Bug 47123) Aggregate numbers based on the label/group +* (5cda766) (Bug 46930) SMWSQLStore3Writers::changeTitle only create redirects when appropriate +conditions are met +* (e4a5fb8) (Bug 31880) Formatting numbers in tables based based on a customizable typeId +* (e4a2035) Modify SMW\RecurringEvents to use a subobject as datamodel to represent +individual events within a page +* (7d1e2ad) (Bug 34782) Add note parameter to #info parser function + +#### New configuration parameters + +* [$smwgEnabledSpecialPage](https://semantic-mediawiki.org/wiki/Help:$smwgEnabledSpecialPage) +* [$smwgQueryProfiler](https://semantic-mediawiki.org/wiki/Help:$smwgQueryProfiler) +* [$smwgShowHiddenCategories](https://semantic-mediawiki.org/wiki/Help:$smwgShowHiddenCategories) +* [$smwgFactboxUseCache](https://semantic-mediawiki.org/wiki/Help:$smwgFactboxUseCache), [$smwgFactboxCacheRefreshOnPurge](https://semantic-mediawiki.org/wiki/Help:$smwgFactboxCacheRefreshOnPurge) +* [$smwgPropertyZeroCountDisplay](https://semantic-mediawiki.org/wiki/Help:$smwgPropertyZeroCountDisplay), [$smwgPropertyLowUsageThreshold](https://semantic-mediawiki.org/wiki/Help:$smwgPropertyLowUsageThreshold) +* [$smwgFixedProperties](https://semantic-mediawiki.org/wiki/Help:$smwgFixedProperties) +* [$smwgAutoRefreshOnPageMove](https://semantic-mediawiki.org/wiki/Help:$smwgAutoRefreshOnPageMove), [$smwgAutoRefreshOnPurge](https://semantic-mediawiki.org/wiki/Help:$smwgAutoRefreshOnPurge) +* [$smwgCacheType](https://semantic-mediawiki.org/wiki/Help:$smwgCacheType), [$smwgCacheUsage](https://semantic-mediawiki.org/wiki/Help:$smwgCacheUsage) + +### Bug fixes + +* The property statistics rebuilding is no longer done whenever you run update.php. +* (Bug 42321) Fixed issue frequently causing notices in SQLStore3 +* (5fdbb83) Fix offset display in Special:Ask +* (9113ad1) (Bug 47010) SMWInfoLink +* (af0cbe0) Fix escaping issue on Special:Ask +* (ba74804) Fix construction of SMWExpLiteral +* (d16a103) (Bug 45053) Fix quantity display support in SMW\ListResultPrinter +* (9b2b5c7) (Bug 44518) Do not display <li> elements for |format=list +* (Bug 43932) Fix html tag support for non-list results in SMW\ListResultPrinter +* (Bug 44275) Fix .data( 'sortkey' ) support in SMW\ListResultPrinter +* (fcb7da9) (Bug 42324) fix SQlite support in sqlstore3 +* (3507f84) (Bug 21893) Fixed queries that use the like comparator for properties with a restricted +set of values + +### Compatibility changes + +* Deleted pre SMW 1.5.1 entry point (includes/SMW_Settings.php), the main entry point is SemanticMediaWiki.php +* (I17a3e0) Support for quantity export via API and JSON format +* (50c5109) Removed old storage implementation SMWSQLStore2, superseded by SMWSQLStore3 in SMW 1.8 +* (I5db911) #set_recurring_event using subobjects (changes query behavior +for recurring events; for more see the help page on [recurring events](https://semantic-mediawiki.org/wiki/Help:Recurring_events "Recurring events") + +### Deprecated classes + +If not noted otherwise, deprecated methods or classes will be removed in SMW 1.11. + +* (b4664be) smwfIsSemanticsProcessed was replaced by SMW\NamespaceExaminer +* (3ba701f) smwfEncodeMessages was replaced by SMW\Highlighter, SMW\MessageFormatter +* SMWParseData was replaced by a non-static SMW\ParserData class +* SMWListResultPrinter, SMWResultPrinter, SMWSubobject, SMWSet +* SMWFeedResultPrinter, SMWDISerializer +* SMWDIString, SMWStringLengthException, SMWSetRecurringEvent + +### Added or changed classes + +* (eb764db) Add SMW\PropertyAnnotatorDecorator for handling individual "standard" properties +* (f33fd12) Add SMW\ExtensionContext and \SMW\ContextAware +* (40e7572) Renamed SMWDISerializer to \SMW\Serializers\QueryResultSerializer +* (a0b08fe) Add SMW\Serializes\SemanticDataSerializer in order for SemanticData to be serializable +* (02635a1) Replace SkinTemplateToolboxEnd hook with SMW\BaseTemplate +* (ec5dd46) Add SMW\SimpleDependencyBuilder and SMW\SharedDependencyContainer as simple framework that +allows for individual object factoring and dependency injection +* (92b67bd) Add SMW\TableFormatter for the table query printer +* (5a33d2d) Add SMW\CacheHandler to separate MediaWiki specific cache injection +* (395b584) Add ResourceLoaderGetConfigVars to populate SMW related configuration details for JavaScript +* (7c60e50) Add SMW\ApiResultPrinter to support query printers to use Ajax/WebApi interface for +query result updates +* (cb6c6ad) SMW\ResultPrinter class turn RequestContext aware + +The following classes and interfaces were re-factored and/or added in order to promote testability: + +* (e0f3f4d) Rename and re-factor \SMW\RefreshJob +* (I3b41d4) Rename and re-factor \SMW\UpdateJob +* (6d5a3c5) Add SMW\JobBase to enable dependency injection +* (058c2fc) Add SMW\Setup to separate extension registration and initialization +* (87b214f) Add SMW\Settings class to remove GLOBAL state and enable injection of individual configuration +details during runtime +* (5a82da8) Re-factor SMW\Factbox and add SMW\FactboxCache to minimize content parsing +* (24cca37) Add SMW\Test\MockObjectBuilder to easily manage MW and SMW mock objects +* (71dbba1) Add SMW\ObservableDispatcher to enable Observes to act as an observable subject itself +* (dc28899) (18d17a5) Add SMW\StoreUpdater, SMW\UpdateDispatcherJob, and SMW\PropertyTypeComparator +to separate responsibilities during the update +* (6c06567) Add SMW\SQLStore\PropertyTableDefinitionBuilder to separate build definition +* (2164a25) Add \SMW\ResultCollector interface to support cacheable results when executing Special:Statistics or Special:Properties +* (c8a2f97) (Bug 51091) Rename and re-factor SMW\Api\Ask and SMW\Api\AskArgs + +### Removed features + +* (6f7625f) Remove Special:QueryCreator +* (5a3f6ed) (Bug 50755) Remove MigrationJob/SMWMigrate +* (f9cff2b) Remove smwfLoadExtensionMessages +* (a957596) SMW\JsonResultPrinter remove obsolete serialization + + +### Platform stability + +* Over 130 PHPUnit tests have been added +* Over 10 QUnit tests have been added +* The tests now [run on TravisCI](https://travis-ci.org/SemanticMediaWiki/SemanticMediaWiki) + * Compatibility is now ensured against all supported MediaWiki and PHP versions + * Compatibility is now ensured for all supported databases + +### Documentation + +The documentation bundled with the SMW source code has been updated. It can be found in the docs folder. + +### Extended translations + +As usual, translations have been extended thanks to the [Translatewiki.net project](https://translatewiki.net). +In addition, the core strings (SMW properties and datatypes) for Slovak have been updated. diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.0.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.0.md new file mode 100644 index 00000000..9a435394 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.0.md @@ -0,0 +1,127 @@ +# Semantic MediaWiki 2.0 + +Released August 4th, 2014. + +## Compatibility changes + +Semantic MediaWiki 2.0 is compatible with MediaWiki 1.19 up to MediaWiki 1.23, and possibly later +versions. Support for both MediaWiki 1.23 and MediaWiki 1.24 was improved compared to SMW 1.9. + +PHP compatibility remains the same as in SMW 1.9: all versions from PHP 5.3.2 to PHP 5.6.x. + + +For a full overview, see our [compatibility matrix](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/docs/COMPATIBILITY.md). + +## Quality and stability improvements + +A great deal of effort has been put into ensuring both existing and new features work well. +Not just at present, but also in future releases. And not just with MySQL and one version of +MediaWiki, but on all platforms we support. This dedication to quality has resulted in many +bugs being discovered and fixed, and makes future regressions much less likely. + +Continuous integration is now an integral part of the development process behind SMW. As of +the 2.0 release, SMW has over 2300 automated tests, which cover two thirds of the codebase. +These tests are run automatically for every change made to the code, on machines with different +databases, different versions of PHP, different SPARQL stores and different versions of MediaWiki. + +## Semantic Versioning + +As of the 2.0 release, Semantic MediaWiki adheres to the [Semantic Versioning standard](http://semver.org/). +This makes our version numbers more meaningful and makes it easier for administrators to determine +if a new release is relevant to them. + +## Improved SPARQLStore support + +[Semantic MediaWiki 1.6](http://www.semantic-mediawiki.org/wiki/SMW_1.6#Synchronizing_SMW_with_RDF_stores) +introduced support for data synchronization with RDF back-ends. SMW 2.0 makes this functionality a +first class citizen through many enhancements and stability improvements. + +* New and full support for [Jena Fuseki](http://jena.apache.org/) 1.0 +* Enhanced and full support for [Virtuoso](https://github.com/openlink/virtuoso-opensource) 6.1 +* Enhanced support for [4store](https://github.com/garlik/4store) 1.1 + +The [`smwgSparqlDatabase`](https://www.semantic-mediawiki.org/wiki/Help:$smwgSparqlDatabase) setting +introduced in 1.6 has been deprecated in favour of +[`$smwgSparqlDatabaseConnector`](https://www.semantic-mediawiki.org/wiki/Help:$smwgSparqlDatabaseConnector) +(#342) to avoid arbitrary class assignments in `$smwgSparqlDatabase` (now only used to assign custom +connectors). + +Unit and integration tests were given extra focus together with a continuous integration of +[Jena Fuseki](http://jena.apache.org/) (1.0.2) (#337) and [Virtuoso opensource 6.1](https://github.com/openlink/virtuoso-opensource) (#394) to ensure that compatibility and functional +parity are going hand in hand with the rest of SMW. (Unfortunately `4Store` currently does not run +on the continuous integration platform, for details see [garlik#110](https://github.com/garlik/4store/issues/110) +but tests have been run successfully with a local `4store` instance). + +At this moment, the only RDF store to be tested and to support [SPARQL 1.1](http://www.w3.org/TR/sparql11-query/) +is `Jena Fuseki` therefore other stores may not support all `query features`. For details to +the testing environment and its configuration, see the [README](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/src/SPARQLStore/README.md) +file. + +## Improved subobject support + +Support for subobjects has been added to the RDF export. This new capability is used by the RDF +store functionality to also synchronize subobjects. (#344) + +Subobjects now support sorting via the `@sortkey` annotation that stores an individual sortkey +per subobject. (#225) + +## Notable bug fixes + +* #279 Fixed undefined index in `DataTypeRegistry::getDefaultDataItemTypeId` +* #282 Output a message instead of an exception in `Special:WantedProperties` for unknown predefined properties +* #308 Fixed caching issue in `DataRebuilder` for duplicate title objects +* #312 Fixed fatal error in `CategoryResultPrinter` for when a mainlabel is hidden +* #322 Fixed file names containing spaces or non-ASCII characters for for downloadable result formats (csv, excel) +* #379 Modernized `dumpRDF.php` while deprecating the use of `SMW_dumpRDF.php` (bug 35679) +* #425 Deprecated `SMW_setup.php` in favour of `setupStore.php` +* #444 Fixed language namespace alias issue +* #420 Extended `ContentParser` to mitigate issues caused by the 62856 bug in MW 1.24+ +* #405 Added a compatibility fix to mitigate issues caused by the `RefreshLinksJob` in MW 1.23+ + +### SPARQLStore + +- #291 Fixed call to undefined method in `SPARQLStore` +- #338 Fixed exception in `ResultParser` for an invalid datatype (bug 62218) +- #385 Fixed '#' encoding for subobjects in `SMWExporter::findDataItemForExpElement` to enable `SPARQLStore` result display +- #387 Fixed `SPARQLStore` namespace query support (e.g `[[:+]]` ) +- #415 Fixed `SPARQLStore` usage for `rebuildConceptCache.php` and `rebuildPropertyStatistics.php` +- #460 Fixed `SPARQLStore` subobject sub query and pre-defined property query support + +## Behind the scenes + +SMW 2.0 continues to convert its classes to use PHP namespaces in order to separate responsibilities +(#398, #404, #407, #409, #410, #411, #412, #416, #417, #418, #419, #421) and to be able to support +[PSR-4](http://www.php-fig.org/psr/psr-4/) in future. + +* All `job` related classes of been moved to `SMW\MediaWiki\Jobs` +* All `hook` related classes of been moved to `SMW\MediaWiki\Hooks` +* All `api` related classes of been moved to `SMW\MediaWiki\Api` +* All `SPARQLStore` related classes now reside in `SMW\SPARQLStore` +* `SMWSparqlStore` and `SMWSparqlDatabase` where moved into the `SMW\SPARQLStore` namespace + +Other internal enhancements or changes include: + +* #278 Changed the `PropertyStatisticsTable` interface +* #289 Added [`CONTRIBUTING.md`](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/CONTRIBUTING.md) for better contributor guidance +* #307 Added `removeDuplicates` option to `UpdateJob` +* #310 Fixed autoloading for `QueryPrinterRegistryTestCase` +* #311 Removed `MediaWikiTestCase` dependency +* #315 Updated jquery.qTip2 from v2.0.0 to v2.2.0 (Mar 17 2014) +* #332 Added the number of pages and percentage done to report messages when rebuilding selected pages +* #366 Extended `Sql3StubSemanticData` to load suobjects on request and introduced a `__sob` datatype for subobjects +* #382 Extended interface to support `format=count` information in `QueryResult` +* #453 Added [`COMPATIBILITY.md`](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/docs/COMPATIBILITY.md) for better user guidance + +Deprecated classes or scripts: + +* `SMW_conceptCache.php` +* `SMW_dumpRDF.php` +* `SMW_refreshData.php` +* `SMW_setup.php` +* `SMWSparqlStore` +* `SMWSparqlDatabase` +* `SMWIResultPrinter` + +Removed classes or scripts: + +* `SMWParseData` diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.1.0.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.1.0.md new file mode 100644 index 00000000..ccf1dc36 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.1.0.md @@ -0,0 +1,92 @@ +# Semantic MediaWiki 2.1 + +Released on January 19th, 2015. + +## Highlights + +### Support for semantic queries in Special:Search + +This release adds support for semantic queries run directly from MediaWiki's standard search. You +can enable this feature by setting `$wgSearchType` to ["SMWSearch"](https://semantic-mediawiki.org/wiki/Help:SMWSearch). +The related configuration parameter [``$smwgFallbackSearchType``](https://semantic-mediawiki.org/wiki/Help:$smwgFallbackSearchType) +allows specifying which search engine to fall back to in case "SMWSearch" returns no results. (#450, #496, #505) + +### SPARQLStore improvements + +The SPARQLStore now supports concept queries (#696) and regex like queries (`[[Url::~http://*query=*]] OR [[Url::~*ccc*]]`) for Page and URL values (#679). + +Notable performance improvements and many other fixes (can be found in the bug fix list) have been +made to broaden the SPARQLStore support. + +### Enhanced platform support + +SMW has partially supported PostgreSQL for a long time. This new release brings SMW's PostgreSQL +support to the same level as MySQL and SQLite, making it the third fully supported relational database. + +HHVM (HipHop Virtual Machine) 3.3 or above is now supported along with all previously supported PHP +versions. + +Although earlier versions of SMW probably work with MediaWiki 1.24, this new release officially +supports it. + +## New features + +* #546 Concepts can now be nested (bug 15316) +* #537 Modernized [`Special:SearchByProperty`](https://semantic-mediawiki.org/wiki/Help:Special:Search_by_property) interface +* #613 Added `subobject` parameter to the `BrowseBySubject` API module and imporved resolving of circular redirects +* #620 Added `--page` as export option to the [`dumpRDF.php`](https://semantic-mediawiki.org/wiki/Help:DumpRDF.php) maintenance script +* #633 Made ouput decoding for uri's human readable (bug 35452) +* #643 Added `--runtime` option to [`rebuildData.php`](https://semantic-mediawiki.org/wiki/Help:RebuildData.php). It allows you to see how much time was spend and how much memory was used. +* #659 Added [``$smwgEnabledEditPageHelp``](https://semantic-mediawiki.org/wiki/Help:$smwgEnabledEditPageHelp) option that enables showing a contextual help text on the edit page +* #664 Enabled semicolon escaping for record-type values (`\;`) (bug T17732) +* #672 Added `Special:Log` support for events enabled in `smwgLogEventTypes` + +## Bug fixes + +* #500 Fixed the `SPAPRQLStore` to return a `FalseCondition` instead of an exception for not supported data types (e.g `Geo`) +* #520 Fixed the `SPAPRQLStore` query selection for subobjects used with a namespace condition +* #543 Removes invalid category value links to `SearchByProperty` on `Special:Browse` (bug 33449) +* #537 Fixed parameter encoding in `Special:SearchByProperty` for hyphens and spaces (bug 16150) +* #554 Enhanced concept pages to provide time and date of the last update +* #566 Fixed the `SPARQLStore` query result display for moved pages (a.k.a. "gost" pages) +* #601 Fixed movability for predefined property pages +* #615 Fixed data display inconsistency for pre-existing redirects +* #617 Fixed circular `UpdateJob` caused by redirects +* #619 Fixed exception in `dumpRDF.php` caused by resolving a subobject for a redirect +* #622 Fixed cache id mismatch for redirects in `SQLStore` +* #622 Fixed exception for when a `null` is returned by `ExportController::getSemanticData` +* #627 Enhanced `SPARQLStore` XML result parser to support `Virtuoso` singelton response +* #618 Fixed subobject disjunctive/conjunctive subquery handling +* #628 Fixed named subobject encoding in the `Exporter` to support accented characters +* #630 Fixed browse link generation for wikipages in `Special:Browse` +* #638 Fixed the hard-coded upper bound for the offset option of an inline query by replacing it with configuration parameter [```$smwgQUpperbound```](https://semantic-mediawiki.org/wiki/Help:$smwgQUpperbound) +* #638 Fixed `postgres` temporary table generation issue (bug 34855, #455, #462) +* #640 Fixed `QueryProcessor` to allow query conditions to contain `=` (bug 32955) +* #641 Removes service info links from the `Factbox` +* #654 Fixed broken field detection in record-type caused by html encoded strings (bug T23926) +* #656 Fixed `#REDIRECT` detection in MW 1.24+ +* #661 Fixed regex search `(~/!)` for page-type property values (bug T36665, T49073, T33151, T35854) +* #674 Fixed regex search support for uri-type property values +* #683 Fixed invalid `:smw-redi` marker when `#REDIRECT` is removed manually +* #694 Fixed probable race condition for `SQLStore`(`postgres`) when creating temporary tables +* #702 Fixed http header in `SPARQLStore` to be Sesame complaint + +## Internal changes + +* #486 Added continuous integration support for for `Jena Fuseki` 1.1.1 +* #487, #576, #600 Added an internal cache to improve `SPARQLStore` redirect and export lookup performance +* #512, #521 Added benchmark tests for different components such as job-queue, maintenance script, queries etc. +* #523 Disabled the Factbox display for a `delete action` and re-enable the Factbox for an undeleted page +* #532 Added `UrlEncoder` to recognize all special characters when creating a manual link to `Special:Browse` +* #534 Added a value hash to `SQLStore::fetchSemanticData` to ensure that only distinct values are displayed +* #557 Added `SMW::Store::BeforeQueryResultLookupComplete` and `SMW::Store::AfterQueryResultLookupComplete` hook +* #590, #596 Added `CompoundConditionBuilder` and `ConditionBuilderStrategyFinder` to the `SPARQLStore` +* #645 Added `RedirectInfoStore` to isolate access to redirect information and cache info requests +* #646 Improved error message handling for the `_num` data type +* #665 Replaced arbitrary DB access in `Store::updateData` with `PageUpdater::doPurgeParserCache` +* #667 Added `Database::beginTransaction` and `Database::commitTransaction` +* #670 Added `SMW::SQLStore::BeforeChangeTitleComplete` hook +* #673 Extended `DataValueFactory` to ignore `$wgCapitalLinks` settings for the property namespace +* #678 Added `PropertyRegistry` to remove global state from `DIProperty` +* #668 Changed `SQLStore` `iw` table field specification from `VARCHAR(32) binary` to `VARBINARY(32)` +* #707 Added continuous integration support for `openrdf-sesame` 2.7.14 diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.1.1.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.1.1.md new file mode 100644 index 00000000..130daeb4 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.1.1.md @@ -0,0 +1,9 @@ +# Semantic MediaWiki 2.1.1 + +Released on March 2nd, 2015. + +## Bug fixes + +* #861 Fixed owl property export declaration +* #863 Fixed missing interwiki encoding for the RDF export +* #864 Fixed empty searchlabel raw wikitext display for a QueryResultPrinter with limit=0 diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.1.2.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.1.2.md new file mode 100644 index 00000000..e62e56c2 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.1.2.md @@ -0,0 +1,9 @@ +# Semantic MediaWiki 2.1.2 + +Released on March 28th, 2015. + +## Bug fixes + +* #882 Fixed exception in `SMWExportController` caused by an empty reference +* #885 Fixed pre tag rendering in template output +* #896 Fixed empty string for boolean x-format output diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.1.3.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.1.3.md new file mode 100644 index 00000000..26dd2a96 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.1.3.md @@ -0,0 +1,7 @@ +# Semantic MediaWiki 2.1.3 + +Released on March 30th, 2015. + +## Bug fix + +* #946 Fixed variable name regression for the "list" format introduced with version 2.1.2 diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.2.0.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.2.0.md new file mode 100644 index 00000000..ba5ee37c --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.2.0.md @@ -0,0 +1,64 @@ +# Semantic MediaWiki 2.2 + +Released on May 9th, 2015. + +## New features + +* #770 Added the `--no-cache` option to `rebuildData.php` and the `--debug` option to `rebuildData.php` and `rebuildConceptCache.php` (refs #749, #766) +* #756 Added template support to the `#set` parser function +* #783 Added support for `wgCategoryCollation` setting in `CategoryResultPrinter` (#699, T40853) +* #829 Added the `--report-runtime` option to `rebuildConceptCache.php` +* #886 Extended rules on how an `ImportValue` need to contain a valid type definition +* #891 Enforced strict type declaration for properties with import references (type of the imported reference takes precedence over any user-defined type declaration) +* #892 Added support for `<swivt:file>` in order for a RDF export to point to a "real" file resource +* #893 Added information about "improper value for" to the statistics overview and as `API` parameter (`&errorcount`) +* #913 Fixed exception for usage of `Has subobject` as free annotation +* #914 Added restriction for "manual" annotation use to some pre-defined properties (e.g. `Has subobject`, `Has query`) +* #974 Added `named args` as parameter to `CategoryResultPrinter` +* #988 Added `sep` as parameter to the `TableResultPrinter` to define a separator for cell values + +## Enhancements + +* #958 Replaced defunct SMWRegsitry wiki registration on Special:SMWAdmin with a link to WikiApiary +* #976 Reduced the number of pages on which SMW JavaScript and CSS is loaded +* #994, #995 Made small performance improvements + +## Bug fixes + +* #556 Fixed Missing parentheses in `SQL` for disjunctions when temporary tables are not used by the `SQLStore` +* #764 Fixed DB error when a `#ask` query contains `order=random` for a `sqlite` or `postgres` DB platform (disabled `smwgQRandSortingSupport` for `postgres`) +* #860 Fixed escape character usage in `SPARQLStore`, `SQLStore` +* #860 Fixed handling of an empty result send by the `SPARQLStore` Sesame connector +* #861 Fixed owl property export declaration +* #863 Fixed missing interwiki encoding for the RDF export +* #864 Fixed empty searchlabel raw wikitext display for a `QueryResultPrinter` with `limit=0` +* #869 Fixed data update when moving a page to a non-enabled semantic namespace +* #870 Fixed `#set` where an error from a previous parse call could have affected succeeding `#set` error messages +* #882 Fixed exception in `SMWExportController` caused by an empty property reference +* #884 Fixed fetching of import vocabularies to be language independent +* #887 Fixed `pre` element rendering for the template "furtherresult" output link +* #896 Fixed empty caption for `false` when using the`#x` format option +* #928 Fixed exception in `SMWExportController` for use of `&stats` option +* #945 Fixed nesting of self-referenced concepts in a concept query +* #974 Fixed inconsistency when using `headers=plain` in `CategoryResultPrinter` also fixed the `__NOTOC__` hack + +## Internal changes + +* #373 Update `jquery.jstorage.js` (0.3.2 => 0.4.12) +* #494 Changes to the `SQLStore\QueryEngine` interface +* #711 Fetching annotations made by an `#ask` transcluded template +* #725 Moved psr-4 complaint classes into the top level 'src' folder +* #740 Added `serialization/serialization:~3.2` component dependency +* #771 Added `doctrine/dbal:~2.5` component dependency +* #772 Added `onoi/message-reporter:~1.0` component dependency +* #777 Moved all concept related code into a separate `ConceptCache` class +* #831 Added `onoi/cache:~1.0` component dependency +* #884, #983 Added `ControlledVocabularyImportContentFetcher`, `ImportValueParser` to isolate import vocabulary parsing from the `ImportValue` object +* #883 Added `CircularReferenceGuard` to monitor possible self/circular references in ask templates +* #914 Added `DIProperty::isUnrestrictedForUse` +* #924 Added `onoi/event-dispatcher:~1.0` component dependency +* #929 Added serialization to `ExpElement` objects +* #950 Renamed `PropertyTypeDiffFinder` to `PropertySpecDiffFinder` +* #951 Extended `UpdateDispatcherJob` to create `UpdateJob` chunks to avoid memory exhaustion +* #959 Added `ExpDataSerializer` and `ExpDataDeserializer` +* #984 Moved remaining part of `SMWSQLStore3QueryEngine` to `SMW\SQLStore\QueryEngine\QueryEngine` diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.2.1.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.2.1.md new file mode 100644 index 00000000..e44ba851 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.2.1.md @@ -0,0 +1,12 @@ +# Semantic MediaWiki 2.2.1 + +Released on June 2nd, 2015. + +## Bug fixes + +* Fixed "Notice: Undefined variable: dataItem" in `QueryEngine` +* #1031 CategoryResultPrinter to recognize offset for further results +* #1033 Fixed assumption that always an array is sent to `JobBase` for booleans +* #1038 Fixed Fatal error: Call to undefined method `SMWDIError::getString` +* #1046 Fixed RuntimeException in `UndeclaredPropertyListLookup` when a DB prefix is used +* #1051 Fixed call to `DIWikiPage::getText` in `ConceptDescriptionInterpreter` diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.2.2.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.2.2.md new file mode 100644 index 00000000..c6956d2f --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.2.2.md @@ -0,0 +1,8 @@ +# Semantic MediaWiki 2.2.2 + +Released on July 7th, 2015. + +## Bug fixes + +* #1067 Fixed return value of the `#set` parser +* #1081 Fixed mismatch of `owl:Class` for categories when used in connection with a vocabulary import diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.2.3.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.2.3.md new file mode 100644 index 00000000..3e16a10f --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.2.3.md @@ -0,0 +1,7 @@ +# Semantic MediaWiki 2.2.3 + +Released on October 11th, 2015. + +## Bug fixes + +* #1201 Fixed php-serialization issue for `SemanticData` diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.3.0.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.3.0.md new file mode 100644 index 00000000..91afe686 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.3.0.md @@ -0,0 +1,133 @@ +# Semantic MediaWiki 2.3 + +Released on October 25th, 2015. + + +## Highlight: Improved SPARQLStore support + +SMWs SPARQLStore has now reached full feature parity with the SQLStore. On top of that, various performance improvements where made to the SPARQLStore. + +The `$GLOBALS['smwgSparqlQFeatures']` configuration setting now supports these additional values: + +* #1001 `SMW_SPARQL_QF_REDI`: enable property/value redirects support in queries +* #1003 `SMW_SPARQL_QF_SUBP`: enable subproperty hierarchy support +* #1012 `SMW_SPARQL_QF_SUBC`: enable subcategory hierarchy support + +If your TDB back-end does not support SPARQL 1.1, this setting needs to be set to `SMW_SPARQL_QF_NONE`. + +* #1152 Added preference for use of canonical identifiers to support language agnostic category/property statements, (use `$GLOBALS['smwgExportBCNonCanonicalFormUse'] = true` to keep backwards compatibility until 3.x) +* #1158 Added basic support for `_geo` queries to the `SPARQLStore` +* #1159 Added limitation of the `aux` property usage in the Exporter (use `$GLOBALS['smwgExportBCAuxiliaryUse'] = true;` to keep backwards compatibility until 3.x) + +## New features and enhancements + +* #1042 Added progress indicator to `rebuildData.php` +* #1047 Extended context help displayed on `Special:Types` and subsequent type pages +* #1049 Improved MobileFrontend support +* #1053 Added a `CSS` rule to visually distinguish subobject links from "normal" links +* #1063 Added `$GLOBALS['smwgValueLookupCacheType']` to improve DB lookup performance though the use of a responsive cache layer (such as `redis`) and buffer repeated requests either from the API or page view to the back-end. +* #1066, #1075 It is now possible to use extra double colons in annotations. For instance `[[DOI::10.1002/123::abc]]` or `[[Foo:::123]]` +* #1097 Predefined property aliases are redirected to the base property +* #1107 The template support of #set now includes an automatically added `last-element` parameter +* #1106 Added `--skip-properties` flag to `rebuildData.php` +* #1106 `rebuildData.php` now first removes items marked for deletion +* #1129 Extended `~*` search pattern for `_ema` and `_tel` to allow for searches like `[[Has telephone number::~*0123*]]` and `[[Has email::~*123.org]]` +* #1147 The category result format now supports `columns=0`, which results in automatic column count selection +* #1171 Added SQL EXPLAIN output to the debug result format +* #1172 Added `@category` as parameter with a fixed assignment (`_INST`) to `#subobject` +* #1178 Added `~` and `!~` comparator support for values of type date + +## New experimental features + +These features are disabled by default and can be turned on using configuration. Additional logging +happens for these features until they mature from being an experimental feature in a future release. + +* #1035, #1063 Added `CachedValueLookupStore` as post-cached layer to improve DB read access (`$GLOBALS['smwgValueLookupCacheType']`, $GLOBALS['smwgValueLookupCacheLifetime']) +* #1116 Added $GLOBALS['smwgValueLookupFeatures'] setting to fain grain the cache access level, default is set to `SMW_VL_SD | SMW_VL_PL | SMW_VL_PV | SMW_VL_PS;` +* #1117 Added `EmbeddedQueryDependencyLinksStore` to track query dependencies and update altered queries using `ParserCachePurgeJob` for when `$GLOBALS['smwgEnabledQueryDependencyLinksStore']` is enabled +* #1135 Added `$GLOBALS['smwgPropertyDependencyDetectionBlacklist']` to exclude properties from dependency detection +* #1141 Added detection of property and category hierarchy dependency in `EmbeddedQueryDependencyLinksStore` + +## Bug fixes + +* #400 (#1222) Fixed `RuntimeException` in `SQLStore` caused by a DI type mismatch during a lookup operation +* #682 Fixed id mismatch in `SQLStore` +* #1005 Fixed syntax error in `SQLStore`(`SQLite`) for temporary tables on disjunctive category/subcategory queries +* #1033 Fixed PHP notice in `JobBase` for non-array parameters +* #1038 Fixed Fatal error: Call to undefined method `SMWDIError::getString` +* #1046 Fixed RuntimeException in `UndeclaredPropertyListLookup` for when a DB prefix is used +* #1051 Fixed call to undefined method in `ConceptDescriptionInterpreter` in `SQLStore` +* #1054 Fixed behavior for `#REDIRECT` to create the same data reference as `Special:MovePage` +* #1059 Fixed usage of `[[Has page::~*a*||~*A*]]` for `SPARQLStore` when `Has page` is declared as page type +* #1060 Fixed usage of `(a OR b) AND (c OR d)` as query pattern for the `SQLStore` +* #1067 Fixed return value of the `#set` parser +* #1074 Fixed duplicated error message for a `_dat` DataValue +* #1081 Fixed mismatch of `owl:Class` for categories when used in connection with a vocabulary import +* #1090 Fixed error on Special:Ask when using a format provided by Semantic Maps +* #1126 Fixed silent annotations added by the `Factbox` when content contains `[[ ... ]]` +* #1120 Fixed resource loading issue on Windows when using `$wgResourceLoaderDebug=true` +* #233 Fixed disabling of `$GLOBALS['wgFooterIcons']['poweredby']['semanticmediawiki']` +* #1137 Fixed re-setting of `smw-admin` user group permission to its default +* #1146 Fixed #set rendering of template supported output (refs #1067) +* #1096 Fixed inverse prefix for predefined properties that caused misinterpret `Concept` queries +* #1166 Fixed context awareness of `ParserAfterTidy` in connection with the `purge` action +* #1165 Fixed "duplicate key value violates unique constraint" for PostgreSQL on conjunctive and disjunctive queries +* #1182 Fixed further link to use the format parameter as specified by `#ask` +* #1207 Fixed usage of the `!~` comparator for properties that have a limited set of allowed values + +### Improved handling of removed entities in SQLStore + +In previous releases it could happen that deleted entities (subject, property) reappeared in queries even though they have been removed. This release introduces several changes to eliminate some of the issues identified. + +* #1100 introduced a deletion marker on entities that got deleted, making them no longer available to queries or special page display. +* #1127 Added `--shallow-update` to `rebuildData.php`, to only parse those entities that have a different last modified timestamp compared to that of the last revision. This enables to run `rebuildData.php` updates on deleted, redirects, and other out of sync entities. +* Solved #701 where an unconditional namespace query `[[Help:+]]` would display deleted subjects (in case those subjects were deleted) +* #1105 Added filter to mark deleted redirect targets with `SMW_SQL3_SMWDELETEIW` +* #1112 Added filter to mark outdated subobjects with `SMW_SQL3_SMWDELETEIW` +* #1151 Added removal of unmatched "ghost" pages in the ID_TABLE + +## Internal changes + +* #1018 Added `PropertyTableRowDiffer` to simplify computation of `SemanticData` diff's (relates to #682) +* #1039 Added `SemanticData::getLastModified` +* #1041 Added `ByIdDataRebuildDispatcher` to isolate `SMWSQLStore3SetupHandlers::refreshData` +* #1071 Added `SMW::SQLStore::AddCustomFixedPropertyTables` hook to simplify registration of fixed property tables by extensions +* #1068 Added setting to support recursive annotation for selected result formats (refs #1055, #711) +* #1086 Changed redirect update logic to accommodate the manual #REDIRECT (refs #895, #1054) +* Added `SMW::Browse::AfterIncomingPropertiesLookupComplete` which allows to extend the incoming properties display for `Special:Browse` +* Added `SMW::Browse::BeforeIncomingPropertyValuesFurtherLinkCreate` which allows to replace the further result incoming link in `Special:Browse` +* #1078 Renamed `ParserParameterFormatter` to `ParserParameterProcessor` and `ParameterFormatterFactory` to `ParameterProcessorFactory` +* #1102 Added `onoi/http-request:~1.0` dependency +* Decrease chunk size in `UpdateDispatcherJob` (refs #951) +* #1110 Extended `TurtleTriplesBuilder` to split larger turtle sets into chunks +* #1111 Added support for the atomic DB transaction mode to improve the rollback process in case of a DB transaction failure +* #1108 Added `CompositePropertyTableDiffIterator` which for the added `'SMW::SQLStore::AfterDataUpdateComplete'` returns ids that have been updated only (as diff of the update) +* #1119 Added `RequestOptionsProcessor` +* #1130 Added `DeferredRequestDispatchManager` to decouple jobs during an update +* #1133 Fixed MW 1.25/1.26 API tests +* #1145 Added `onoi/callback-container:~1.0` and removes all custom DIC code from SMW-core +* (964155) Added removal of whitespace for `DIBlob` values (" Foo " becomes "Foo") +* #1149 Added `InMemoryPoolCache` to improve performance for the `SPARQLStore` during turtle serialization + +## Contributors + +**Code contributors** + +* MWJames +* Jeroen De Dauw +* Karsten Hoffmeyer (kghbln) +* Felipe de Jong (jongfeli) +* Vitaliy Filippov (vitalif) +* paladox +* Amir E. Aharoni +* Joel K. Pettersson +* umherirrender +* Kunal Mehta (legoktm) +* TranslateWiki.net + +**Other contributors** + +* yoonghm +* cicalese +* bogota +* plegault3397 diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.3.1.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.3.1.md new file mode 100644 index 00000000..b1698e26 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.3.1.md @@ -0,0 +1,12 @@ +# Semantic MediaWiki 2.3.1 + +Released on January 4th, 2016. + +## Bug fixes + +* #1248 Fixed misplaced replacement of `_` in the `ImportValueParser` +* #1252 Added [`$smwgEnabledInTextAnnotationParserStrictMode`](https://www.semantic-mediawiki.org/wiki/Help:$smwgEnabledInTextAnnotationParserStrictMode) allowing to reenable (by disabling strict mode which by default is enabled) multi-property assignments in `[[ :: ]]` +* #1256 Added creation of object ID's that are not yet available in `EmbeddedQueryDependencyLinksStore` +* #1268 Fixed 1.26/1.27 API/RawMode MediaWiki output changes +* #1255 Fixed output regression (T121761) in connection with `#ask` and generated template HTML output +* #1321 Added [`$smwgSparqlRepositoryConnectorForcedHttpVersion`](https://semantic-mediawiki.org/wiki/Help:$smwgSparqlRepositoryConnectorForcedHttpVersion) setting to set a specific HTTP version in case of a observed cURL issue (#1306) diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.0.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.0.md new file mode 100644 index 00000000..abcfe992 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.0.md @@ -0,0 +1,200 @@ +# Semantic MediaWiki 2.4 + +Released on July 9th, 2016. + +## Highlights + +### Support for multiple languages + +Added support for [multilingual content](https://www.semantic-mediawiki.org/wiki/Localization_and_multilingual_content). +This includes the introduction of the [monolongual text datatype](https://www.semantic-mediawiki.org/wiki/Help:Type_Monolingual_text), +a new [special property to describe properties](https://www.semantic-mediawiki.org/wiki/Help:Special_property_Has_property_description) +and the new [Semantic Interlanguage Links extension](https://www.semantic-mediawiki.org/wiki/Extension:Semantic_Interlanguage_Links). + +### Pattern based constraints + +Added support for constraint specification using regular expressions (#1417). The use of `regular +expressions` and thus the `Allows pattern` property to express a constraint assignment is restricted +to users with the [`smw-patternedit`](https://www.semantic-mediawiki.org/wiki/Help:Permissions_and_user_rights) right. + +### Positional units + +It is now possible to specify which position a [custom unit](https://www.semantic-mediawiki.org/wiki/Help:Custom_units) +should have in [Corresponds to](https://www.semantic-mediawiki.org/wiki/Help:Special_property_Corresponds_to) annotations. +This means you can specify `[[Corresponds to::€ 1]]` instead of `[[Corresponds to::1 €]]`. You can find a +[small example](http://sandbox.semantic-mediawiki.org/wiki/Issue/1329_(Positional_unit_preference)) on the Sandbox. + +### Display precision + +You can now specify the precision used for display of numeric properties (i.e. those of type Number, +Quantity, Temperature). This is done using the +[Display precision of](https://www.semantic-mediawiki.org/wiki/Help:Special_property_Display_precision_of) +property. You can override this display precision per `#ask` query, by using `-p<digit>`. +You can [view the examples](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1335). + +### Enhanced date and time formatting + +Extended [date and time formatting](https://www.semantic-mediawiki.org/wiki/Help:Type_Date) +by supporting PHP's `DateTime` format rules. + +### Display Title storage + +MediaWiki's `{{DISPLAYTITLE:...}}` can now be stored as the +[Display title of](https://www.semantic-mediawiki.org/wiki/Help:Special_property_Display_title_of) +special property, so it can be used in queries. + + +## Compatibility changes + +Support was added for MediaWiki 1.26 and MediaWiki 1.27. SMW 2.3 has know issues with these versions +of MediaWiki, so you are highly encouraged to upgrade SMW if you plan to use one of them. While SMW +2.3 already had beta support for PHP 7, this release fully supports it. + +This release does not drop support for anything. It is however the last release to support PHP older +than 5.5 and MediaWiki older than 1.25. + +For more information, see the [compatibility overview](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/docs/COMPATIBILITY.md). + + +## New features and enhancements + +* [#498](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/498) Extended `rebuildData.php` to remove outdated entity references (see `PropertyTableIdReferenceDisposer`) +* [#1243](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1243) Made failed queries discoverable +* [#1246](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1246) Added support for `~`/`!~` on single value queries (example: `{{#ask: [[~Foo/*]] }}`) +* [#1267](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1267) Added the `browseByProperty` API module to fetch a property list or individual properties via the WebAPI +* [#1268](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1268) Restored compliance with MediaWiki's 1.26/1.27 WebAPI interface to ensure continued support for the `ask` and `askargs` output serialization +* [#1257](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1257) Changed import of recursive annotations (#1068) from the format to a query level using the `import-annotation` parameter +* [#1291](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1291) Added support for range queries such as `[[>AAA]] [[<AAD]]` +* [#1293](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1293) Added `_ERRC` and `_ERRT` as pre-defined properties to aid error analysis +* [#1299](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1299) Added dot named identifier restriction for subobject names containing a dot (`fooba.bar` reserved for extensions) +* [#1313](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1313) Added usage count information to property pages +* [#1321](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1321) Added [`$smwgSparqlRepositoryConnectorForcedHttpVersion`](https://semantic-mediawiki.org/wiki/Help:$smwgSparqlRepositoryConnectorForcedHttpVersion) setting to force a specific HTTP version in case of a #1306 cURL issue +* [#1290](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1290) Added support for properties and `prinrequests` to be forwarded to a redirect target if one exists +* [#1329](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1329) Added positional preference for units when declared in `Corresponds to` (¥ 500 vs 500 JPY) +* [#1350](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1350) Enlarged input field on special page "Browse" +* [#1335](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1335) Added possibility to specify a display precision for a numeric `datatype` by either denoting a [`Display precision of`](https://www.semantic-mediawiki.org/wiki/Help:Special_property_Display_precision_of) or using `-p<number of digits>` as `#ask` printout option +* [#1344](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1344) Added `MonolingualTextValue` and `LanguageCodeValue` +* [#1361](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1361) Added `--with-maintenance-log` option to `rebuildData.php`, `rebuildPropertyStatistics.php`, and `rebuildConceptCache.php` +* [#1381](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1381) Added localizable context help for properties using the predefined property `Has property description` (which is specified as `MonolingualText` type) +* [#1389](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1389) Added free date/time formatting support using the `-F[ ... ]` option +* [#1391](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1391) Made subobject directly browsable from/in the Factbox +* [#1396](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1396) Explicitly annotated years now have an `AC/CE` era indication +* [#1397](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1397) Added support for microseconds in `DITime` +* [#1401](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1401) Added support for parsing `年/月/日` date format in `DITime` +* [#1407](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1407) Added quick result download links to `Special:Ask` +* [#1410](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1410) Added support for `{{DISPLAYTITLE:title}}` caption using the [`Display title of`](https://www.semantic-mediawiki.org/wiki/Help:Special_property_Display_title_of) property +* [#1417](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1417) Added [`Allows pattern`](https://www.semantic-mediawiki.org/wiki/Help:Special_property_Allows_pattern) property to define a value constraint using regular expressions and the required `smw-patternedit`right to add those expressions +* [#1433](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1433) Added `--ignore-exceptions` and `exception-log` options to `rebuildData.php` while option `-v` is showing additional information about the processed entities +* [#1440](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1440) Added various changes to accommodate MW 1.27 +* [#1463](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1463) Added support for the [`Has uniqueness constraint`](https://www.semantic-mediawiki.org/wiki/Help:Special_property_Has_uniqueness_constraint) property trait +* [#1474](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1474) Added a search link for zero properties to the `Special:Properties` +* [#1483](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1483) Added statistics about [outdated entities](https://www.semantic-mediawiki.org/wiki/Help:Outdated_entities) to the `Special:Statistics` +* [#1542](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1542) Extended the query parser to support conditions with object values that contain `=` (#640) +* [#1545](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1545) Added `#LOCL` as `TimeValue` output format +* [#1570](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1570) Added ["Object ID disposal"](https://www.semantic-mediawiki.org/wiki/Help:Object_ID_disposal) `to Special:SMWAdmin` +* [#1572](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1572) Extended the query parser to support property chaining on subtypes +* [#1580](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1580) Added `#LOCL` as `BooleanValue` output format +* [#1591](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1591) Added `#LOCL` as `NumberValue` output format +* [#1626](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1626) Added `$GLOBALS['smwgQueryDependencyAffiliatePropertyDetectionlist']` to monitor affiliate properties required for initiating a query dependency update + + +## Bug fixes + +* [#541](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/541) Fixed duplicate column when "further results ..." are redirected to `Special:Ask` +* [#753](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/753) Fixed number parsing of non-zero lead decimal numbers (.1 vs 0.1) / (T40476) +* [#1244](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1244) Find redirect for a property when specified as a record field (in `PropertyListValue`) +* [#1248](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1248) Fixed misplaced replacement of `_` in the `ImportValueParser` +* [#1270](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1270) Fixed printout display of inverse properties +* [#1272](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1272) Fixed serialization of `_rec` type in the `QueryResultSerializer` +* [#1275](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1275) Fixed export of record type data when embedded in a subobject +* [#1286](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1286) Fixed support for sorting by category +* [#1287](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1287) Fixed exception for when `$smwgFixedProperties` contains property keys with spaces +* [#1289](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1289) Fixed redirect statement for resources matched to an import vocabulary (`SPARQL` query) +* [#1301](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1301) Fixed `count` query result discrepancy (to exclude redirect and deleted entities) +* [#1314](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1314) Fixed hidden annotation copy of `[[ :: ]]` text values when embedded in query results +* [#1318](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1318) Fixed possible `null` object in `AskParserFunction` when creating a `QueryProfile` +* [#1357](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1357) Fixed `|+align=...` usage for `format=table` +* [#1358](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1358) Fixed recognition of multi-byte boolean value +* [#1348](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1348) Fixed single year detection in `TimeValue` +* [#1414](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1414) Fixed exception caused by a missing message page on a `Service link` annotation +* [#1449](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1449) Fixed mapping of imported URI to an internal `DataItem` +* [#1450](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1450) Fixed export of concept +* [#1453](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1453) Fixed off/on display in text value +* [#1459](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1459) Fixed column display regression in `CategoryResultPrinter` for subobjects +* [#1466](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1466) Fixed remote resource path detection that appeared in connection with a non-default extension setup +* [#1473](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1473) Fixed exception caused by `ParameterInput` due to "HTML attribute value can not contain a list of values" +* [#1477](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1477) Fixed query result from `SPARQLStore` to filter redirects natively +* [#1489](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1489) Fixed fatal error in `RdfResultPrinter` due to namespace mismatch +* [#1496](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1496) Fixed concept handling for `postgres` +* [#1513](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1513) Fixed rendering of text properties containing wikitext lists +* [#1526](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1526) Fixed `_` handling for value strings submitted to the `Special:SearchByProperty` +* [#1550](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1550) Fixed `SPARQLStore` `XML` response parsing for strings that contain UTF-8 characters +* [#1562](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1562) Fixed fatal error in `FeedResultPrinter` due to usage of an interwiki assignment +* [#1568](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1568) Fixed usage of invalid characters/tags in property name +* [#1594](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1594) Fixed handling of numbers with scientific notation in `Special:SearchByProperty` +* [#1597](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1597) Fixed possible ID collision in `DependencyLinksTableUpdater` +* [#1598](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1598) Fixed content language setting for `InfoLinks` +* [#1589](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1589) Fixed display precision constraint during condition building +* [#1608](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1608) Fixed that a `#info` without a message will create an empty tooltip or when used as `<info />` causing a failure +* [#1610](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1610) Fixed a potential exception in the `postgres` implementation when creating temporary tables +* [#1628](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1628) Fixed exception when `NumberValue` tries to use a `NULL` as numeric value. +* [#1638](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1638) Fixed possible invalid property in case the label contains `[` + + +## Internal changes + +* [#1235](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1235) Improve query performance in `PropertyUsageListLookup` +* [#1023](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1023) Split the `DocumentationParserFunction` +* [#1264](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1264) Removed `pg_unescape_bytea` special handling for `postgres` in the `ResultPrinter` +* [#1276](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1276) Extended `QueryResultSerializer` (relevant for the API output) to export the raw output of a time related value +* [#1281](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1281) Extended `QueryResultSerializer` to export the internal property key +* [#1291](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1291) Added `DescriptionProcessor` to isolate code path from the `SMWQueryParser` +* [#1319](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1319) Switched from Sesame 2.7.14 to 2.8.7 in the CI environment +* [#1382](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1382) Added `DispatchingDataValueFormatter` and `ValueFormatterRegistry` +* [#1385](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1385) Added `StringValueFormatter` and `CodeStringValueFormatter` +* [#1388](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1388) Added `TimeValueFormatter` +* [#1421](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1421) Added `DeferredDependencyLinksUpdater` to avoid violations reported by `TransactionProfiler` in MW 1.26+ +* [#1417](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1417) Added `PermissionPthValidator` together with new the `smwcurator` group and `smw-patternedit` right +* [#1435](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1435) Added `DeferredCallableUpdate` (together with `$GLOBALS['smwgEnabledDeferredUpdate']`) to support MW's `DeferrableUpdate` interface (i.e. to support queuing DB related transactions) +* [#1445](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1445) Added `userlang` as `ParserOutput` option +* [#1451](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1451) Added `ExtraneousLanguage` interface +* [#1460](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1460) Requires PHP extension mbstring in `composer.json` +* [#1482](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1482) Added the `SMW::FileUpload::BeforeUpdate` hook +* [#1512](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1512) Fixed test suite to support PHP7 +* [#1575](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1575) Removed `smw_subobject` from `PropertyListLookup` query +* [#1591](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1591) Added `IntlNumberFormatter` +* [#1593](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1593) Added `NumberValueFormatter` +* [#1601](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1601) Added `InfoLinksProvider` +* [#1606](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1606) Disabled DB transactions in `QueryEngine` to avoid potential issues when creating temporary tables +* [#1626](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1626) Added `EntityIdListRelevanceDetectionFilter` and `TemporaryEntityListAccumulator` in #1627 +* [#1635](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1635) Switched from Fuseki 1.1.0 to 2.4.0 in the CI environment +* Most updates now occur in [deferred mode](https://www.semantic-mediawiki.org/wiki/Deferred_updates) +to conform with [T92357](https://phabricator.wikimedia.org/T92357) Extensions that wish to extend +data objects are encouraged to use hooks and avoid conflicts when updates are queued. + + +## Contributors + +* James Hong Kong +* Jeroen De Dauw +* Karsten Hoffmeyer +* Felipe de Jong +* Florian Schmidt +* Niklas Laxström +* Ahmad Gharbeia +* Stephan Gambke +* Amir E. Aharoni +* Siebrand Mazeland +* Cindy Cicalese +* Hangya +* Sébastien Beyou +* Aaron Schulz +* Jaider Andrade Ferreira +* Kunal Mehta +* Ori Livneh +* Peter Grassberger +* Reedy +* Vitaliy Filippov +* Wolfgang Fahl +* Alexander Gesinn +* TranslateWiki.net translators diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.1.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.1.md new file mode 100644 index 00000000..7012cd49 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.1.md @@ -0,0 +1,14 @@ +# Semantic MediaWiki 2.4.1 + +Released on July 12th, 2016. + +## Bug fixes + +* #1328 Fixed a "Undefined index: language" error in `#smwdoc` parser function +* #1713 Fixed a "Segmentation fault" when `QueryResultDependencyListResolver` tries to resolve a category/property hierarchy with a circular reference +* #1715 Fixed decoding of a single quotation mark in `DisplayTitlePropertyAnnotator` +* #1724 Fixed a possible `InvalidArgumentException` in connection with `SMW_DV_PVUC` by updating the `CachedPropertyValuesPrefetcher` version number +* #1726 Allows `QueryDependencyLinksStore` to execute `getDependencyListByLateRetrieval` even in cases of an intial empty list +* #1727 Fixed an issue when property names contain `<` or `>` symbols +* #1728 Fixed fatal error in `Special:SearchByProperty` on when the property name contains invalid characters +* #1731 Fixed possible error in the `SkinAfterContent` hook when a null object is used diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.2.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.2.md new file mode 100644 index 00000000..c4e38615 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.2.md @@ -0,0 +1,13 @@ +# Semantic MediaWiki 2.4.2 + +Released on November 13th, 2016. + +## Bug fixes + +* #1829 Only have the `DisplayTitlePropertyAnnotator` create an annotation in case `SMW_DV_WPV_DTITLE` is enabled +* #1883 Avoided mismatch in case `hasSubSemanticData` has been overridden as by `Sql3StubSemanticData` +* #1885 Fixed postgres bytea escape/unescape on blob fields +* #1887 Moved `Hooks:CanonicalNamespaces` to an earlier execution point +* #1897 Worked around deprecated/removed `DatabaseBase::getSearchEngine` +* #1901 Made `enableSemantics` call `NamespaceManager` +* #1911 Improved compatibility with MediaWiki 1.28+ diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.3.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.3.md new file mode 100644 index 00000000..832ef7fb --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.3.md @@ -0,0 +1,9 @@ +# Semantic MediaWiki 2.4.3 + +Released on November 28nd, 2016. + +## Bug fixes + +* #1975 Fixed alias definitions for namspace "Type" causing notices due to the namespace being undefined +* <code>fd6b4cf</code> Fixed a compatibility breaking short array syntax for PHP 5.3 +* <code>0ae3a3e</code> Added missing internal file loading diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.4.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.4.md new file mode 100644 index 00000000..27e1dcea --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.4.md @@ -0,0 +1,8 @@ +# Semantic MediaWiki 2.4.4 + +Released on December 14, 2016. + +## Bug fixes + +* #2078 Fixed error for MySQL 5.7 causing "SELECT list; this is incompatible with DISTINCT" +* #2089 Fixed error for MySQL 5.7 causing "UPDATE - SET; Data too long for column" diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.5.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.5.md new file mode 100644 index 00000000..5480b95f --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.5.md @@ -0,0 +1,11 @@ +# Semantic MediaWiki 2.4.5 + +Released on January 16th, 2017. + +## Bug fixes + +* <code>e3689e6</code> Fixed datatypes not being recognized on property pages +* #2124 Fixed to use `wfCgiToArray` to avoid deprecation notice for `SMWInfolink` +* #2156 Fixed Javascript error caused by `wikiScript` being undefined +* #2160 Fixed `ParserCachePurgeJob` to be avoided on an empty request +* #2166 Fixed `QueryDependencyLinksStore` to check for a null title diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.6.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.6.md new file mode 100644 index 00000000..a049b061 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.4.6.md @@ -0,0 +1,7 @@ +# Semantic MediaWiki 2.4.6 + +Released on February 15th, 2017. + +## Enhancement + +* #2235 Backport of #1758 - Add configuration parameter `$smwgQTemporaryTablesAutoCommitMode` allowing to create MySQL temp tables in auto commit mode diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.0.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.0.md new file mode 100644 index 00000000..17085429 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.0.md @@ -0,0 +1,209 @@ +# Semantic MediaWiki 2.5 + +Released on March 14, 2017. + +## Highlights + +### Full-text search support + +Support for [full-text search](https://www.semantic-mediawiki.org/wiki/Help:Full-text_search) was added using the native capabilities of the SQL backends "MySQL"/"MariaDB" (#1481) and "SQLite" (#1801) for the "Text", "URL" and "Page" datatypes. + +### Provenance data recording + +Qualifying facts using a simple [provenance model](https://www.semantic-mediawiki.org/wiki/Reference_and_provenance_data) is now supported (#1808) using existing mechanisms in defining a property specification together with a new ["Reference" datatype](https://www.semantic-mediawiki.org/wiki/Help:Type_Reference) ([video](https://youtu.be/t045qkf4YAo)). + +### Property chain and language filter support in print request + +[Property chain](https://www.semantic-mediawiki.org/wiki/Property_chains_and_paths) for conditions (e.g `[[Located in.Capital of::Foo]]`) was provided for some time, and now got extended (#1824) to supporting the syntax on print requests to retrieve values of a chain member that represent a page node. Values of datatype "Monolingual Text" can now use a language filter (#2037) to restrict the display of a value in a print request. + +### Edit protection + +[Edit protection](https://www.semantic-mediawiki.org/wiki/Edit_protection) to help avoid changes to properties or other data sensitive pages from alterations that may cause data invalidations (e.g. change of a property type, inconsistent specifications etc.) or process disruptions. This feature integrates with MediaWiki's page protection functionality. + +### Preferred property label support + +Semantic MediaWiki now supports the declaration of [preferred property labels](https://www.semantic-mediawiki.org/wiki/Preferred_property_label) (#1865) with the objective to show labels in a user context on special pages, query results, and factboxes instead of the canonical property label. + +### Query result cache + +[Caching of query results](https://www.semantic-mediawiki.org/wiki/Query_result_cache) (#1251) was added as experimental feature to minimize a possible impact of query processing during and after a page view. This change also includes a reevaluation (#2099, #2176) of the query hash (used as identifier) to ensure that cache fragmentation is reduced and duplicate queries can share the same cache across different pages. + +### Links in values + +Support for [links in values](https://www.semantic-mediawiki.org/wiki/Help:$smwgLinksInValues) for datatype "Text" was extended by use-cases and improved in performance as well as avoiding the former error-prone "PCRE-approach". + +### Fixed properties + +Support for [fixed properties](https://www.semantic-mediawiki.org/wiki/Help:Fixed_properties) was overhauled, fixed (#2135) and is no longer experimental. + +### Special page "SemanticMediaWiki" + +Special page ["SemanticMediaWiki"](https://www.semantic-mediawiki.org/wiki/Help:Special:SemanticMediaWiki) formerly known as special page "SMWAdmin" was modernized and extended (#2044, etc.) including a new [configuration setting](https://www.semantic-mediawiki.org/wiki/Help:$smwgAdminFeatures) allowing for a more fine-granded control over feature accessibilty (#2142). + +## Compatibility changes + +* Minimum requirement for PHP changed to version 5.5 and later +* Minimum requirement for MediaWiki changed to version 1.23 and later (1.27 and later recommended) +* Forward comatibility with MediaWiki 1.29+ adjustments which include #2149, #2198 + +## Upgrading + +This release requires to run `update.php` or `setupStore.php` to add an extra table column for the URI table (#1872) and a new table for the preferred label property (#1865). + +## New features and enhancements + +* [#1251](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1251) Added support to cache query results +* [#1418](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1418) Added recognition for image formatting options in query results +* [#1481](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1481) Added full-text `MySQL`/`MariaDB` search support to the `SQLStore` (see #1481 for limitations and features supported) +* [#1652](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1652) Added support for approximate search queries that contain a namespace `[[Help:~Abc*]]` +* [#1691](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1691) Added language fallback for special properties +* [#1708](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1708) Added the [External identifier](https://www.semantic-mediawiki.org/wiki/Help:Type_External_identifier) type +* [#1718](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1718) Added feature flag `SMW_DV_NUMV_USPACE` to allow preserving spaces in unit labels +* [#1747](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1747) Extended `InTextAnnotationParser` to check for a possible pipe syntax in combination with `::` +* [#1757](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1757) Added the [`$smwgQTemporaryTablesAutoCommitMode`](https://www.semantic-mediawiki.org/wiki/Help:$smwgQTemporaryTablesAutoCommitMode) setting to mitigate possible issues with temporary tables in `MySQL` for when `enforce_gtid_consistency=true` is set +* [#1756](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1756) Extended the display characteristics of `Special:Browse` to load content via the API back-end (legacy display can be retained by maintaining [`$smwgBrowseByApi`](https://www.semantic-mediawiki.org/wiki/Help:$smwgBrowseByApi) with `false`) +* [#1759](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1759) Improved `Special:Ask` error output +* [#1760](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1760) Improved handling of `MonolingualTextValue` in `Special:SearchByProperty` +* [#1761](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1761) Added language context support in a property page to recognize localized property type `[[Has type ...]]` annotations +* [#1768](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1768) Extended error display to be shown in a user language context +* [#1778](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1778) Export the canonical form of a special page (e.g. `Special:ExportRDF`, `Special:URIResolver`) +* [#1779](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1779) Added [`Special:ProcessingErrorList`](https://www.semantic-mediawiki.org/wiki/Help:Special:ProcessingErrorList) +* [#1793](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1793) Extended date type (`TimeValue`) with an `#LOCL@lang` output format to recognize a specific language tag +* [#1801](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1801) Added `SQLStore` full-text search support for `SQLite` +* [#1802](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1802) Extended parsing in `#set_recurring_event` to avoid a `00:00:00` time display +* [#1809](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1809) Added support for using a property name as index identifier in a print request for the `Record` type +* [#1808](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1808) Added support for recording [provenance data](https://www.semantic-mediawiki.org/wiki/Referenced_statement) +* [#1824](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1824) Added support for the [property chain](https://www.semantic-mediawiki.org/wiki/Property_chain) syntax (e.g. `?SomeProperty.Foo`) in a print request +* [#1838](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1838) Added time zone support in `TimeValue` together with the new `#LOCL#TZ` output format +* [#1854](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1854) Added unescaped output option for `format=json` +* [#1855](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1855) Added `@@@` as special annotation syntax to generate a link to a property (e.g `[[Foo::@@@]]` or `[[Foo::@@@en]]`) +* [#1865](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1865) Added support for [preferred property labels](https://www.semantic-mediawiki.org/wiki/Preferred_property_label) +* [#1872](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1872) Added support for retrieving and storing URIs longer than 255 characters +* [#1875](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1875) Added support for displaying a `title` attribute on tooltips for non JS environments +* [#1891](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1891) Added support for `JSON` typed annotation in `#set` and `#subobject` using the `@json` marker +* [#1927](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1927) Added [`$smwgSubPropertyListLimit`](https://www.semantic-mediawiki.org/wiki/Help:$smwgSubPropertyListLimit) to restrict selection of subproperties on the property page +* [#2007](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2007) Extended the `intro` and `outro` parameter to correctly display parsed links in `Special:Ask` +* [#2024](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2024) Added option `template arguments` in `format=template` to define the type of used parameters +* [#2027](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2027) Extended `format=table` to display an image (instead of a link) in `Special:Ask` +* [#2036](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2036) Added print request option for text values to reduce the length of a text output (e.g. `|?Has text#20`) +* [#2037](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2037) Added `|+lang=` as print request filter to specify a language for a `Monolingual text` result instance +* [#2068](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2068) Extended the `#info` tooltip to work on multiple form sections +* [#2108](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2108) Extended the `smw.dataItem.time` JS component to support historic dates +* [#2109](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2109) Extended `Special:Browse` to distinguish between machine and human generate links +* [#2113](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2113) Extended the [uniqueness constraint](https://www.semantic-mediawiki.org/wiki/Help:Special_property_Has_uniqueness_constraint) to apply a stricter validation on competing annotations +* [#2118](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2118) Added a button to `Special:Ask` to copy the query to the clipboard +* [#2135](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2135) Changed and fixed the behaviour of the [`$smwgFixedProperties`](https://www.semantic-mediawiki.org/wiki/Help:$smwgFixedProperties) setting for [fixed properties](https://www.semantic-mediawiki.org/wiki/Help:Fixed_properties) to ensure consistent typing +* [#2137](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2137) Extended the display of statistics in `Special:Statistics` +* [#2139](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2139) Added the display of Semantic MediaWiki related job statistics under the subsection of the [`Special:SemanticMediaWiki`](https://www.semantic-mediawiki.org/wiki/Help:Special:SemanticMediaWiki) page +* [#2142](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2142) Added `$smwgAdminFeatures` to support `PropertyStatisticsRebuildJob` and `FulltextSearchTableRebuildJob` from the `Special:SemanticMediaWiki` (formally known as `Special:SMWAdmin`) page, the `smwgAdminRefreshStore` setting was deprecated +* [#2153](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2153) Changed the behaviour of the [`$smwgLinksInValues`](https://www.semantic-mediawiki.org/wiki/Help:$smwgLinksInValues) setting to allow using the `Obfuscator` (`SMW_LINV_OBFU`) approach instead of `PCRE` to match links in values (e.g. `[[Has text::[[Lorem ipsum]] dolor sit amet, [[Has page::consectetur adipiscing elit]]]]`) +* [#2157](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2157) Extended the property page to show [redirects (synonyms)](https://www.semantic-mediawiki.org/wiki/Redirects) directly +* [#2173](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2173) Added support for prettified `JSON` output in the `CodeStringValueFormatter` +* [#2176](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2176) Added an experimental feature [`smwgQFilterDuplicates`](https://www.semantic-mediawiki.org/wiki/Help:$smwgQFilterDuplicates) to filter duplicate query segments +* [#2204](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2204) Extended `Special:UnusedProperties` and `Special:WantedProperties` to provide an input form +* [#2207](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2207) Added [`smwgExportResourcesAsIri`](https://www.semantic-mediawiki.org/wiki/Help:$smwgExportResourcesAsIri) to allow exporting resources as IRIs +* [#2209](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2209) Extended parsing of interface messages to support additional `smwgEnabledSpecialPage` pages +* [#2221](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2221) Added possibility to show a general message on each property page (`smw-property-introductory-message`) or for a specific type of property (`smw-property-introductory-message-user`, `smw-property-introductory-message-special`) +* [#2227](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2227) Added warning, error, and info messages for incomplete requirements on a property page +* [#2232](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2232) Added support for [Is edit protected](https://www.semantic-mediawiki.org/wiki/Help:Special_property_Is_edit_protected) property together with `$wgRestrictionLevels` (#2249) +* [#2243](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2243) Added property and concept namespace to the `$wgContentNamespaces` and `$wgNamespacesToBeSearchedDefault` setting +* [#2244](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2244) Added [`Special:PropertyLabelSimilarity`](https://www.semantic-mediawiki.org/wiki/Help:Special:PropertyLabelSimilarity) to help reporting syntactic similarities between property labels +* [#2253](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2253) Added `#-hl` output formatting option to highlight search tokens within a result set +* [#2270](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2270) Added query parameters recording in the [query profiler](https://www.semantic-mediawiki.org/wiki/Help:Query_profiler) +* [#2281](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2281) Added check to detect a divergent type specification for an imported vocabulary +* [#2282](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2282) Added [`$smwgPropertyInvalidCharacterList`](https://www.semantic-mediawiki.org/wiki/Help:$smwgPropertyInvalidCharacterList) to define character validation rules for property labels +* [#2285](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2285) Added [`SMW_HTTP_DEFERRED_SYNC_JOB`](https://www.semantic-mediawiki.org/wiki/Help:$smwgEnabledHttpDeferredJobRequest) option to execute secondary updates synchronously +* [#2289](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2289) Added a [contents importer](https://www.semantic-mediawiki.org/wiki/Help:Contents_importer) to support importing of additional data during the setup process +* [#2290](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2290) Added [query reference](https://www.semantic-mediawiki.org/wiki/Query_reference) links section to `Special:Browse` +* [#2295](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2295) Added [`Allows value list`](https://www.semantic-mediawiki.org/wiki/Help:Special_property_Allows_value_list) to maintain a list of allowed values using a `NS_MEDIAWIKI` reference page +* [#2301](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2301) Added [`$smwgSparqlReplicationPropertyExemptionList`](https://www.semantic-mediawiki.org/wiki/Help:$smwgSparqlReplicationPropertyExemptionList) to suppress replication for selected properties to a `SPARQL` endpoint +* [#2325](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2325) Added `#-ia` as print request output option for the text datatype +* [#2331](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2331) Added [`$smwgResultFormatsFeatures`](https://www.semantic-mediawiki.org/wiki/Help:$smwgResultFormatsFeatures) to control available features for specific `ResultFormatter` and includes (`SMW_RF_TEMPLATE_OUTSEP` to support the #2022 changes) +* Many new translations for numerous languages by the communtity of [translatewiki.net](https://translatewiki.net/w/i.php?title=Special%3AMessageGroupStats&x=D&group=mwgithub-semanticmediawiki&suppressempty=1) +* New translation for special properties, datatypes, magic words, date formats and aliases for Catalan and German by Semantic MediaWiki community members + +## Bug fixes + +* [#1258](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1258) Fixed "named args" parameter use in further results link +* [#1328](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1328) Fixed a "Undefined index: language" error in `#smwdoc` parser function +* [#1419](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1419) Fixed Feed result printer ouput for empty results +* [#1709](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1709) Fixed a potential "Lock wait timeout exceeded; try restarting transaction" in connection with `--procs` +* [#1713](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1713) Fixed a "Segmentation fault" for when `QueryResultDependencyListResolver` tries to resolve a category/property hierarchy with a circular reference +* [#1715](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1715) Fixed decoding of a single quotation mark in `DisplayTitlePropertyAnnotator` +* #1724 Fixed a possible `InvalidArgumentException` in connection with `SMW_DV_PVUC` by updating the `CachedPropertyValuesPrefetcher` version number +* #1727 Fixed an issue when property names contain `<` or `>` symbols +* #1728 Fixed fatal error in `Special:SearchByProperty` on when the property name contains invalid characters +* #1731 Fixed possible error in the `SkinAfterContent` hook when a null object is used +* #1744 Fixed special page "Searchbyproperty" not working correctly with "-" sign +* #1775 Fixed time offset recognition +* #1817 Disabled `DataValue` constraint validation when used in a query context +* #1823 Fixed annotation of `Display title of` when `SMW_DV_WPV_DTITLE` is disabled +* #1880 Fixed handling of the `bytea` type in `postgres` for a blob field +* #1886 Fixed disappearance of the `Property` namespace in connection with extensions that use `wfLoadExtension` +* #1922 Fixed `InfoLinksProvider` to avoid `LOCL` info links +* #1926 Fixed `PrintRequest` to recognize the spant tag in labels +* #1935 Fixed "Error: 42P10 ERROR: ... ORDER BY expressions must appear in select list" for PostgreSQL +* #1957 Fixed `SMWSQLStore3Writers::getSubobjects` using the wrong DBKey in case of predefined properties +* [#1963](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/1963) Fixed by relying on #2153 +* #1977 Fixed Unexpected general modules for Resource Loader +* #1978 Fixed `Tablebuilder` to avoid index creation on an unaltered schema definition +* #1985 Fixed a potential fatal error in `MaintenanceLogger` for when `$wgMaxNameChars` doesn't match an expected name length +* [#2000](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2000) Fixed label and caption sanitization +* [#2022](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2022) Fixed the usage of the sep parameter for format "template" +* #2061 Fixed strict comparison `===` for strings in `PropertyTableRowDiffer` +* #2070 Filter invalid entity display from `Special:Concepts` +* #2071 Prevent extensions to register already known canonical property labels and hereby avoid a possible ID mismatch +* #2076 Fixed issue for Gregorian and Julian calendars having a year 0 +* #2078 Fixed issue with "SELECT list; this is incompatible with DISTINCT" for MySQL 5.7+ +* #2089 Fixed issue with "UPDATE - SET; Data too long for column" for MySQL 5.7+ +* #2093 Avoid removal of existing data by #REDIRECT in target +* #2107 Fixed `NamespaceManager::init` to set SMW_NS* default settings +* #2127 Fixed a call to a the member function `getHash()` on nulll +* [#2182](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2182) Fixed display of special properties in `Special:UnusedProperties` +* [#2183](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2183) Fixed display of properties with no explicit datatype in `Special:UnusedProperties` +* #2188 Fixed error in special page "RDFExport" with non-latin instance names +* #2202 Added guard against error "Invalid or virtual namespace -1 given" +* [#2228](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2228) Fixed text output for the table format in `Special:Ask` +* [#2294](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2294) Avoid a possible `Parser::lock` during an `UpdateJob` + +## Internal changes + +* #1511 Removed I18n shim originally required for MediaWiki < 1.23 +* #1726 Allows `QueryDependencyLinksStore` to execute `getDependencyListByLateRetrieval` even in cases of an intial empty list +* #1750 Added `TableBuilder` to replace `SMWSQLHelpers` +* #1780 Added `ResourceBuilder` and `DispatchingResourceBuilder` +* #1791 Added `PropertyRegistry::registerPropertyDescriptionByMsgKey` +* #1776 Added `QueryEngine` and `StoreAware` interface +* [#1848](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1848) Added `ExtraneousLanguage` to handle Semantic MediaWiki specific `i18n` content in a `JSON` format, removed the `PHP` language files +* #1940 Added `Installer` and `TableSchemaManager` to replace `SMWSQLStore3SetupHandlers` +* [#2118](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2118) Added the `onoi/shared-resources~0.3` dependency +* [#2201](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2201) Changed normalization of spaces to `_` instead of `%20` in `DIUri` +* [#2214](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2214) Added `LinksProcessor` and `SemanticLinksParser` +* [#2217](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2217) Added `QuerySegmentListBuildManager` +* [#2275](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2275) Added the `onoi/callback-container:~2.0` dependency +* [#2282](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2282) Added `DataValueServiceFactory` and `DataValueServices.php` to allow injection of services into a `DataValue` instance + +## Settings and configurations + +[Settings and configurations](https://www.semantic-mediawiki.org/w/index.php?title=Special:Ask&x=-5B-5BHas-20configuration%3A%3A%2B-5D-5D-20-5B-5BHas-20minimum-20version%3A%3A2.5.0-5D-5D%2F-3FHas-20configuration-20parameter-20name%3DConfiguration-20parameter%2F-3FHas-20description%3DDescription&format=broadtable&limit=50&link=all&headers=show&mainlabel=-&searchlabel=...%20further%20results&class=sortable%20wikitable%20smwtable&offset=) added with 2.5.0. + +## Contributors + +* 688 - James Hong Kong +* 59 - Karsten Hoffmeyer +* 51 - Jeroen De Dauw +* 37 - Niklas Laxström +* 14 - translatewiki.net +* 5 - Maciej Brencz +* 4 - Felipe de Jong +* 4 - Siebrand Mazeland +* 2 - Alex Winkler +* 2 - Stephan Gambke +* 2 - Toni Hermoso Pulido +* 1 - Amir E. Aharoni +* 1 - Felipe Schenone +* 1 - Jaider Andrade Ferreira +* 1 - James Forrester +* 1 - Justin Du +* 1 - Sébastien Beyou +* 1 - Virginia Cepeda diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.1.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.1.md new file mode 100644 index 00000000..4d1f1e1c --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.1.md @@ -0,0 +1,51 @@ +# Semantic MediaWiki 2.5.1 + +Released on April 22, 2017. + +## New feature + +* [#2357](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2357) as `ec3810d` Added [deprecation notices](https://www.semantic-mediawiki.org/wiki/Help:Special:SemanticMediaWiki/Deprecation_notices) system (#2357, #2384, #2401) to `Special:SemanticMediaWiki` in support for the upcoming 3.0 release + +## Enhancements + +* [#2356](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2356) as `c781b02` Extended [`smwgEnabledHttpDeferredJobRequest`](https://www.semantic-mediawiki.org/wiki/Help:$smwgEnabledHttpDeferredJobRequest) to allows `SMW_HTTP_DEFERRED_LAZY_JOB` (#2356) +* [#2358](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2358) as `769ca88` Enforces "Property" and "Concept" canonical namespaces +* [#2367](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2367) as `ec6d5c1` Added a more verbose error message for failed [allows values](https://www.semantic-mediawiki.org/wiki/Help:Special_property_Allows_value_list) +* [#2386](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2386) as `cd31a79` Extended the [contents importer](https://www.semantic-mediawiki.org/wiki/Help:Contents_importer) to support the MediaWiki's XML format +* [#2387](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2387) as `6d11e5a` Improved the display of `Special:Browse` in connection with mobile devices and the `MobileFrontend` extension +* [#2388](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2388) as `74afabe` Ensured the content for the full-text search is in sync with the "SemanticData" primary data update +* [#2414](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2414) as `3e32ad3` Add support for the display of [query references](https://www.semantic-mediawiki.org/wiki/Help:Query_reference) on a subobject +* [#2417](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2417) as `55b3d99` Add a more verbose error message to the "WikiPageValue" + +## Bug fixes and internal code changes + +* [#2351](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2351) as `8a9b94d` Fixed `[` encoding in `Highlighter` to allows for some `#info` post-processing +* [#2353](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2353) as `2414cb8` Fixed "Undefined index: HTTP_ACCEPT" in Special:URIResolver +* [#2354](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2354) as `21ee86c` Fixed a "Out of range value ..." in DB strict mode caused by the "PropertyStatisticsTable" +* [#2359](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2359) as `ed5686a` Fixed a "SubSemanticData::copyDataFrom ... null given" message +* [#2361](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2361) as `85b2386` Fixed `EntityIdDisposerJob::dispose` to use an int value +* [#2363](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2363) as `bad1460` Fixed pre-process of title content in the `Highlighter` +* [#2365](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2365) as `f5a30dd` Added update marker to track and avoid having `refreshLinksPrioritized` (MW 1.29+) to issue store updates +* [#2373](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2373) as `8a37d42` Added detection of `SMW off/on` for annotations within system messages +* [#2374](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2374) as `6ddb4c6` Added detection of property max count to `Special:PropertyLabelSimilarity` +* [#2377](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2377) as `5d51d2c` Fixed "Uncaught Error: Unknown dependency: jquery.ui.autocomplete" in `Special:Browse` when displayed by the `MobileFrontend` extension +* [#2385](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2385) as `727b825` Fixed display if unparsed error text in wikitext display +* [#2389](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2389) as `b1800eb` Fixed counting of links in `ParserCachePurgeJob` +* [#2393](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2393) as `013da5a` Added `PageUpdater::isHtmlCacheUpdate` to disable `HTMLCacheUpdateJob ` due to [T154427](https://phabricator.wikimedia.org/T154427) +* [#2397](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2397) as `2af43cb` Fixed `SemanticData::getPropertyValues` to always return an indexed array +* [#2405](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2405) as `982f1dc` Fixed normalization of error messages in the `API` output +* [#2406](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2406) as `7d4a0f5` Fixed duplicate detection for sort conditions in `prop.chain` notations in connection with [`$smwgQFilterDuplicates`](https://www.semantic-mediawiki.org/wiki/Help:$smwgQFilterDuplicates) +* [#2410](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2410) as `d2cb5b7` Fixed the appearance of an `index` parameter in the `further results` link in connection with the `+|lang` printout parameter +* [#2412](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2412) as `d6aca45` Fixed order of parameters in `Special:Ask` on the event of a `further results` link that contains `+|...` parameters +* [#2413](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2413) as `d017a15` Fixed ID creation of temporary queries in `UniquenessConstraintValueValidator` when a uniqueness constraint isn't cached +* [#2415](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2415) as `88e8884` Fixed URI value encoding for the [`External identifier`](https://www.semantic-mediawiki.org/wiki/Help:Type_External_identifier) type + +## Deprecations + +* [#2362](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2362) as `4c004e4` Deprecated [`$smwgAdminRefreshStore`](https://www.semantic-mediawiki.org/wiki/Help:$smwgAdminRefreshStore) in favor of +[`$smwgAdminFeatures`](https://www.semantic-mediawiki.org/wiki/Help:$smwgAdminFeatures) to be removed with SMW 3.1.0 +* [#2364](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2364) as `aba22d8` Fixed inconsistent list name parameter settings : + * [`$smwgQueryDependencyPropertyExemptionList`](https://www.semantic-mediawiki.org/wiki/Help:$smwgQueryDependencyPropertyExemptionList) +instead of now deprecated `$smwgQueryDependencyPropertyExemptionlist` to be removed with SMW 3.1.0 and + * [`$smwgQueryDependencyAffiliatePropertyDetectionList`](https://www.semantic-mediawiki.org/wiki/Help:$smwgQueryDependencyAffiliatePropertyDetectionList) +instead of now deprecated `$smwgQueryDependencyAffiliatePropertyDetectionlist` to be removed with SMW 3.1.0 diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.2.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.2.md new file mode 100644 index 00000000..1d073c8f --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.2.md @@ -0,0 +1,22 @@ +# Semantic MediaWiki 2.5.2 + +Released on May 17, 2017. + +## Enhancements + +* [#2449](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2449) as `8783268` Made property pages show the source name of the redirect (synonym) without a `DisplayTitle` formatter +* Many new translations for numerous languages by the communtity of [translatewiki.net](https://translatewiki.net/w/i.php?title=Special%3AMessageGroupStats&x=D&group=mwgithub-semanticmediawiki&suppressempty=1) + +## Bug fixes and internal code changes + +* [#2413](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2413) as `313d08e` Enforced `NO_DEPENDENCY_TRACE` on queries with namespace `NS_SPECIAL` +* [#2426](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2426) as `595efea` Removed duplicate entry for `$smwgFulltextSearchPropertyExemptionList` +* [#2434](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2434) as `bb6ef9a` Made `ParserAfterTidy` to check "readOnly" mode +* [#2438](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2438) as `ba2c6e7` Made `ArticlePurge` add a safeguard to flush query result cache +* [#2444](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2444) as `8c9c4c3` Fixed `NamespaceManager` to avoid reset of user settings +* [#2446](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2446) as `6697da4` Added safeguard against duplicate ID creation +* [#2448](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2448) as `60cd466` Added usage of `forcedUpdate` on redirect jobs +* [#2450](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2450) as `4adfd2d` Fixed `QueryDependencyLinksStore` to avoid `ORDER BY/GROUP BY` on select +* [#2451](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2451) as `8a9bef2` Fixed "ext.smw.dataItem.time.js" to construct a UTC date object +* [#2457](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2457) as `5619b55` Fixed `JulianDay` values to use a consistent format +* [#2463](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2457) as `3f7f47e` Made `SMWSql3SmwIds` set legacy cache only on success diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.3.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.3.md new file mode 100644 index 00000000..e65bdad2 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.3.md @@ -0,0 +1,35 @@ +# Semantic MediaWiki 2.5.3 + +Released on July 8, 2017. + +## Enhancements + +* [#2534](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2534) as `d7077b8` Added [`$smwgLocalConnectionConf`](https://www.semantic-mediawiki.org/wiki/Help:$smwgLocalConnectionConf) configuration parameter together with respective functionality allowing for modifications on connection providers in environments with multiple relational databases +* Many new translations for numerous languages by the communtity of [translatewiki.net](https://translatewiki.net/w/i.php?title=Special%3AMessageGroupStats&x=D&group=mwgithub-semanticmediawiki&suppressempty=1) + +## Bug fixes and internal code changes + +* [#2379](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2379) as `7c98b4a` Removed `ContentParser::forceToUseParser` from tests +* [#2459](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2459) as `a7b3f00` Switched Travis CI integration test to use Ubuntu Trusty operating system environment +* [#2460](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2460) as `3b6e30d` Made `ArticleDelete` restrict the pool of properties in update dispatcher +* [#2472](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2472) as `03e0b8c` Added debug output to Travis CI integration tests +* [#2473](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2473) as `9f78042` Replaced `isSupportedLanguage` with `isKnownLanguageTag` to allow for any known language usage +* [#2474](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2474) as `d1ba666` Fixed limit when the number of results is greater as the `$smwgQMaxLimit` or in `$smwgQMaxInlineLimit` where it is reset to the default value despite the global limitation +* [#2475](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2475) as `a3499b6` Fixed behavior in case of `$wgCapitalLinks = false;` by restricting property name uppercase conversion to special properties only +* [#2477](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2477) as `c12fec7` Fixed `UpdateDispatcherJob` to check for null title +* [#2478](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2478) as `681b0fc` Tidyed `QueryToken` +* [#2481](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2481) as `7c3900f` Made `RequestOptions` cast "int" on `limit` and `offset` +* [#2482](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2482) as `2ff92bd` Added TransactionalDeferredCallableUpdate +* [#2491](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2491) as `ca36069` Provided `ChunkedIterator` to avoid possible out of memory situations in cases where outdated entities reach a unhandable level +* [#2493](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2493) as `409025d` Prevended unintended override of `PropertyTablePrefix` in hook +* [#2496](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2496) as `fb3d604` Normalized message value arguments +* [#2500](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2500) as `3edb303` Made "Special:Browse" avoid API request on legacy setting +* [#2502](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2502) as `a527bbe` Provided POST purge link to avoid confirmation by users using action "purge" +* [#2512](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2512) as `86f9733` Made `DataRebuilder` to report progress on disposed entities +* [#2518](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2518) as `a851f8d` Prevended "PHP Notice: A non well formed numeric value encountered" on `Title::touched` +* [#2522](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2522) as `36cec82` Set a comma as default for `valuesep` with the "template" format +* [#2524](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2524) as `36cec82` Ensured that only marked `isDeferrableUpdate` can use a `transactionTicket` +* [#2526](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2526) as `9d3e0f2` Prevented failing test in `QueryDependencyLinksStoreTest` +* [#2527](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2527) as `f72df04` Made `BooleanValue` always recognize canonical boolean string +* [#2530](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2530) as `ad32a26` Made `InternalParseBeforeLinks` cast `$smwgEnabledSpecialPage` setting late +* `2bf07c3` Removed update marker on delete event diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.4.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.4.md new file mode 100644 index 00000000..b6a3d67b --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.4.md @@ -0,0 +1,15 @@ +# Semantic MediaWiki 2.5.4 + +Released on August 7, 2017. + +## Enhancements + +* [#2547](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2547) as `b527e3c` Added type `parser-html` to `JSONScript` testing to allow assertions on HTML structure +* Many new translations for numerous languages by the communtity of [translatewiki.net](https://translatewiki.net/w/i.php?title=Special%3AMessageGroupStats&x=D&group=mwgithub-semanticmediawiki&suppressempty=1) + +## Bug fixes and internal code changes + +* [#2563](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2563) as `f17f90f` Made `'HtmlValidator'` check for `'CssSelectorConverter'` +* [#2568](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2568) as `c8d6718` Made each parameter of the template calls created by the template format start on a new line +* [#2579](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2579) as `39b074b` Fixed class `'SMW\DataItemException'` not found +* [#2590](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2590) as `61ea7e0` **SECURITY** Made "Special:SemanticMediaWiki" ("Special:SMWAdmin") to check `'wpEditToken'` diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.5.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.5.md new file mode 100644 index 00000000..979e5e88 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.5.md @@ -0,0 +1,11 @@ +# Semantic MediaWiki 2.5.5 + +Released on October 25, 2017. + +## Bug fixes and internal code changes + +* [#2672](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2672) as `e17160e` Changes obfuscator to use `[` instead of `[` for the links in values detection +* [#2692](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2692) as `5ddd9ca` Fixes "EventListenerRegistry.php: Call to a member function getArticleID() on null" +* [#2767](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2767) as `848ed0c` Forces data updates on template refreshs +* [#2773](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2773) as `55b6b72` Adds in MediaWiki's default script parameters in non-standard setups +* [#2780](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2780) as `4bc0d5f` Brings additional checks for namespaces that are enabled for links and annotations diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.6.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.6.md new file mode 100644 index 00000000..8eb1e719 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.6.md @@ -0,0 +1,10 @@ +# Semantic MediaWiki 2.5.6 + +Released on February 14, 2018. + +## Bug fixes and internal code changes + +* [#2855](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2855) as `5acfd1a` Fixes link type relating to special page "Browse" +* [#2856](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2856) as `2db4d30` Fixes link type relating to special page "ExportRDF" +* [#2941](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2941) as `4ebb529` Removes deprecated `ApiBase::dieUsage` +* [#2986](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2986) as `9a8d1c8` Makes the "External identifier" (`_eid`) datatype use HTML format in references diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.7.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.7.md new file mode 100644 index 00000000..d988628d --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.7.md @@ -0,0 +1,11 @@ +# Semantic MediaWiki 2.5.7 + +Released on August 9, 2018. + +## Bug fixes and internal code changes + +* [#3038](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2855) as `4ebb125` Removes deprecated `ParserOptions::setEditSection()` +* [#3176](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3176) as `6de5e42` Removes deprecated `wfBCP47()` +* [#3211](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3211) as `6196919` Makes `-3D` decode in parameter list to allow the usage of equal signs +* [#3221](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3221) as `954ff20` Converts `log-show-hide-{$type}` system messages to `logeventslist-{$type}-log` +* [#3222](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3222) as `dae4dd5` Fixes the `Title` class to check for the NULL case for "illegal" characters diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.8.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.8.md new file mode 100644 index 00000000..a1492bba --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-2.5.8.md @@ -0,0 +1,13 @@ +# Semantic MediaWiki 2.5.8 + +Released on September 7, 2018. + +## Enhancements + +* #[3322](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/3322) as `d9b3bcf` Improves `UpdateDispatcherJob` selection of subjects on `forcedUpdate` +* #[3341](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/3341) as `726f54b` Adds support for installation via MediaWiki's "install.php" script + +## Bug fixes and internal code changes + +* #[3177](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/3177) as `ad23b16` Removes deprecated "jquery.json" module +* #[3386](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/3386) as `a24965c` Fixes encode/decode issues for special property "External formatter URI" diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-3.0.0.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-3.0.0.md new file mode 100644 index 00000000..3a4a3bb9 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-3.0.0.md @@ -0,0 +1,375 @@ +# Semantic MediaWiki 3.0 + +Released on October 11, 2018. + +## Highlights + +This release brings many highlights: + +### User interface changes + +Several user interface changes are deployed to make user facing front-end components more intutive and mobile-friendly by improving the responsiveness on small screens including: + +* Special page "Ask" ([#2891](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2891), [#2893](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2893), [#2898](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2898), [#3415](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3415)) – including further enhancements, most notably input assistance on input fields ([#2699](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2699)), comprehensive input help ([#2907](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2907)) and compact links ([#3017](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3017)) +* Special page "Browse" ([#2891](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2891), [#2875](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2875)) – including further enhancements, grouping of properties ([#2874](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2874)) and compact links ([#3017](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3017)) +* Special page "SemanticMediaWiki" ([#3218](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3218)) +* Property pages – boxed pagination ([#3236](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3236)), tabbed navigation ([#3308](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3308)) including usage count information ([#3440](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3440)) and custom tabs ([#3416](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3416)) +* Concept pages – boxed pagination ([#3236](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3236)), tabbed navigation ([#3308](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3308)) and custom tabs ([#3416](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3416)) +* Factbox ([#2906](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2906)) +* Special page "Concepts" ([#3333](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3333)) + +### List formats and template format rework + +The "list" formats (`list`, `ol` and `ul`) and the `template` format were completely reworked with the latter being renamed to `plainlist` [(#3130)](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3130) now being the default result format if no result format was explicitly specifed for the query. Most notably dedicated separators for values, properties and result "rows" (`sep`, `propsep`, `valuesep`) were introduced as well as class attributes to HTML elements of "list", "ol" and "ul" formats were added to facilitate easy indidual styling. Note that the `plainlist` format does not apply these additional class attributes. + +**See the [migration guide](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/docs/technical/migration-guide-3.0.md#list-formats-incl-list-ol-ul-template) for a comprehensive overview of the changes done.** + +### Search and query + +Local-specific (ICU) sorting and collation is now possible for pages as well as values of datatype "Page" [(#2065)](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2065) facilitated via configuration parameter [`$smwgEntityCollation`](https://www.semantic-mediawiki.org/wiki/Help:$smwgEntityCollation) [(#2429).](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2429) + +Special page "Search" now provides and additional search form accessible via the "Extended" selector in case the ["SMWSearch" feature](https://www.semantic-mediawiki.org/wiki/Help:SMWSearch) was enabled [(#3126).](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3126) with custom search forms definable in the new "smw/schema" namespace [(#3431).](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3431) + +It is now possible to define [remote sources which can be queried](https://www.semantic-mediawiki.org/wiki/Help:Remote_request) using special page "Ask" or doing inline queries [(#3167).](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3167) + +### Performance + +Various effort have been put into improving the performance of the software, most notably with these three code changes: +[#3142](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3142), [#3261](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3261) and [#3286](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3286) with the latter facilitating less expensive paging limits on various user facing special pages via configuration parameter [`$smwgPagingLimit`](https://www.semantic-mediawiki.org/wiki/Help:$smwgPagingLimit). + +## Upgrading + +Even though Semantic MediaWiki now supports the extension registration approach with "extension.json" (#1732), `enableSemantics` remains the sole point of activiation for SMW itself to ensure that data and objects are prepared in advanced and users do not have to modify any existing settings in their "LocalSettings.php" file. + +This release requires (#2065, #2461, #2499) to run the "setupStore.php" or "update.php" script and a missing upgrade process will redirect users to an [error message](https://www.semantic-mediawiki.org/wiki/Help:Upgrade) to remind him or her of a required action. Note that running the schema update may take quite long (minutes on a medium sized site, many hours on a large site). + +**Note that SMW requires write access to the code directory meaning that you currently cannot update. This will be fixed in the following relase allowing to configure an alternative directory for this purpose.** + +After the upgrade, please check the "Deprecation notices" section on special page "SemanticMediaWiki" to adapt and modify listed deprecated settings. + +If you are still using maintenance scripts identifiable by the "SMW_" prefix you must now migrate to the new maintenance script names. See the help pages on [maintenance scrips](https://www.semantic-mediawiki.org/wiki/Help:Maintenance_scripts) for further information. + +[#3198](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3198) switched to PHP 5.6 as minimum requirement as well as to MediaWiki 1.27 as minimum requirement. + +**Please also carefully read the section on breaking changes and deprecations further down in these release notes. We have also prepared a [migration guide](https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki_3.0.0/Migration_guide) for you.** + +## Miscellaneous + +Semantic MediaWiki no longer provides file releases [(See #3347).](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3347) If command line access to the webspace is not available or if the hoster imposes restrictions on required functionality an [individual file release](https://github.com/SemanticMediaWiki/IndividualFileRelease) will have to be created. + +## New features and enhancements + +### Setup + +* [#1732](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1732) Added support for "extension.json" +* [#2916](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2916) Added supplements jobs during the installation process +* [#3095](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3095) Added database upgrade check with ".smw.json" + +### Store + +* [#2461](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2461) Improved performance on fetching incoming properties +* [#2882](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2882) Added detection of duplicate entities upon storage +* [#2516](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2516) Added an optimization run during the installation process (`setupStore.php`) for SQL tables managed by Semantic MediaWiki +* [#2065](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2065) Added entity specific collation support with help of the [`$smwgEntityCollation`](https://www.semantic-mediawiki.org/wiki/Help:$smwgEntityCollation) setting +* [#2499](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2499) Added [`$smwgFieldTypeFeatures`](https://www.semantic-mediawiki.org/wiki/Help:$smwgFieldTypeFeatures) with `SMW_FIELDT_CHAR_NOCASE` to enable case insensitive search queries +* [#2536](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2536) Added `SMW_FIELDT_CHAR_LONG` as flag for `$smwgFieldTypeFeatures` to extend the indexable length of blob and uri fields to max of 300 chars +* [#2823](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2823) Added `SMW_QSORT_UNCONDITIONAL` +* [#3080](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3080) Added warm up caching for the ID lookup +* [#3142](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3142) Replaced `DISTINCT` with `GROUP BY` in `SQLStore::getPropertySubjects` +* [#3261](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3261) Added support for index hint in `DataItemHandler` to enforce specific index selection +* [#3314](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3314) Moved the `FIXED_PROPERTY_ID_UPPERBOUND` from 50 to 500 to increase the range for fixed property IDs +* [#3353](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3353) Added support in SQLite to drop fields without the need to delete and restore the entire store +* [#3360](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3360) In MySQL/MariaDB increase ID field size from "int(8)" to "int(11)". Postgres and SQLite have no size restriction. +* [#3390](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3390) Adds the `smw_rev` field to the `smw_object_ids` table to track an entity instance and its associated revision ID (represents the raw content) +* [#3397](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3397) MediaWiki removed `Database::nextSequenceValue` in commit wikimedia/mediawiki@0a9c55b#diff-278465351b7c14bbcadac82036080e9f. SMW added this functionality back for the sake of Postgres. + +#### ElasticStore + +* [#3054](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3054) Added `ElasticStore` to use Elasticsearch as query backend + - #3237, #3241, #3245, #3247, #3249, #3250, #3253 +* [#3152](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3152) Added extra debug query parameter (score_set, q_engine) to special page "Ask" + +### Search + +* [#2738](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2738) Added information whether `SMWSearch` search mode is enabled or not for special page "Search" +* [#3006](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3006) Disabled default autocompletion for terms starting with `[[` in special page "Search" for the `SMWSearch` type +* [#3096](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3096) Added section title display support to indicate subobjects +* [#3126](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3126) Added extended power profile form +* [#3143](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3143) Hides namespace section and add auto-discovery +* [#3145](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3145) Added simplified term parser to `SMWSearch` (see #3157, #3281) +* [#3234](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3234) Added support for displaytitle in `SearchResult` +* [#3237](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3237) Added support for highlights from external search engine, if available +* [#3419](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3419) Add search autocompletion options when `$wgSearchType = 'SMWSearch';`: + * `in:Foo bar` equivalent to `[[~~*Foo bar*]]` + * `phrase:Foo bar` equivalent to `[[~~"Foo bar"]]` + * `has:Foo bar` equivalent to `[[Foo bar::+]]` + +### Query + +* [#2398](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2398) Added `#ask` and `#show` parser function support for `@deferred` output mode (see also #3257) +* [#2476](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2476) Added [`$smwgQExpensiveThreshold`](https://www.semantic-mediawiki.org/wiki/Help:$smwgQExpensiveThreshold) and [`$smwgQExpensiveExecutionLimit`](https://www.semantic-mediawiki.org/wiki/Help:$smwgQExpensiveExecutionLimit) to count and restrict expensive `#ask` and `#show` functions on a per page basis +* [#2953](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2953) Added support for natural sort (`n-asc`, `n-desc`) of printout column values +* [#2662](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2662) Added `+depth` as syntax component for a condition to restrict the depth of class and property hierarchy queries +* [#2558](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2558) Added `like:` and `nlike:` comparator operator for approximate queries +* [#2572](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2572) Added `@annotation` as special processing mode to embedded `#ask` queries +* [#2673](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2673) Added the `Query state` special property to be able to track an internal state when a `#ask` uses `@annotation` or `@deferred` as special execution mode. In addition to internal usage, one can also now find all deferred queries with `{{#ask: [[Query state::200]] |format=ul }}` +* [#2873](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2873) Added support for `in:` as expression to the #ask syntax +* [#3125](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3125) Added support for `phrase:` as expression + +#### Result formats + +* [#2420](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2420) Added support for a datatable output in the `format=table` (and `broadtable`) result printer +* [#2515](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2515) Added support for `#LOCL#TO` date formatting to display a [local time](https://www.semantic-mediawiki.org/wiki/Local_time) offset according to a user preferrence +* [#2677](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2677) Added `+width` as parameter to the `format=table` (and `broadtable`) result printer +* [#2690](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2690) Added the `type` parameter to `format=json` in support for a simple list export +* [#2718](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2718) Added ad-hoc export for the `format=table` datatable +* [#2824](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2824) Added `bom` as parameter to `format=csv` +* [#2826](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2826) Added `valuesep` as parameter to `format=csv` to define a value separator +* [#2822](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2822) Added add `merge` parameter to `format=csv` +* [#2844](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2844) Renamed output formatter `#-ia` to `#-raw` +* [#3024](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3024) Added `format=templatefile` to support individual export formats defined using MediaWiki templates +* [#3009](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3009) Added `#tick` and `#num` output formatter to boolean value type +* [#3011](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3011) Added the [`$smwgDefaultOutputFormatters`](https://www.semantic-mediawiki.org/wiki/Help:$smwgDefaultOutputFormatters) setting to declare default output formatter for a type or property +* [#1315](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1315) Added support for media files to the `feed` printer +* [#3130](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3130) Reworked `list` format +* [#3162](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3162) Added support for `{{DISPLAYTITLE}}` to the `feed` printer +* [#3136](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/3136) Added `class` parameter to `list` format + +### API + +* [#2696](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2696) Added a new `smwbrowse` API module ([#2717](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2717), [#2719](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2719), [#2721](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2721)) +* [#3052](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3052) Added `api_version` to ask, askargs API +* [#3129](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3129) Added API `pvalue` browse module +* [#3381](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3381) Added API `psubject` browse module + +### Misc + +* [#794](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/794) Added `SMW_PARSER_UNSTRIP` to [`$smwgParserFeatures`](https://www.semantic-mediawiki.org/wiki/Help:$smwgParserFeatures) enabling to use unstripped content on a text annotation +* [#2348](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2348) Allow showing annotations even if they are improper for datatype "Text" +* [#2435](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2435) Added filtering of invisible characters (non-printable, shyness etc.) to armor against incorrect annotations +* [#2453](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2453) Changed the approach on how referenced properties during an article delete are generated to optimize the update dispatcher +* [#2471](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2471) Added [`SMW_CAT_REDIRECT`](https://www.semantic-mediawiki.org/wiki/Help:$smwgCategoryFeatures) option to allow finding redirects on categories +* [#2494](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2494) Added [`$smwgChangePropagationProtection`](https://www.semantic-mediawiki.org/wiki/Help:$smwgChangePropagationProtection) and changed the approach on how property modifications are propagated +* [#2543](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2543) Extended [`EditPageHelp`](https://www.semantic-mediawiki.org/wiki/Help:$smwgEnabledEditPageHelp) to be disabled using a user preference +* [#2561](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2561) Added listing of improper assignments to the property page for an easier visual control +* [#2595](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2595) Improved the content navigation in special page "SemanticMediaWiki" +* [#2600](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2600) Added [`$smwgCreateProtectionRight`](https://www.semantic-mediawiki.org/wiki/Help:$smwgCreateProtectionRight) setting to control the creation of new properties and hereby annotations as part of the [authority mode](https://www.semantic-mediawiki.org/wiki/Help:Authority_mode) +* [#2615](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2615) Added `filter=unapprove` to special page "WantedProperties" +* [#2632](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2632) Added [uniqueness violation](https://www.semantic-mediawiki.org/wiki/Help:Property_uniqueness) check on the property page for the property label used +* [#2699](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2699) Added an [input assistance](https://www.semantic-mediawiki.org/wiki/Help:Input_assistance) for the condition textbox on special page "Ask" +* [#2726](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2726) Added entity [input assistance](https://www.semantic-mediawiki.org/wiki/Help:Input_assistance) for editors and the input field on special page "Search" ([#2756](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2756)) +* [#2776](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2776) Added tracking of changes to categories (see 2495) +* [#2785](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2785) Added new styling to property page value list +* [#2796](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2796) Allows "rendering of HTML" on special page "Ask" when using `|headers=plain` in queries +* [#2801](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2801) Added `--skip-optimize` and `--skip-import` to `setupStore.php` (see 2516) +* [#2803](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2803) Filter categories from transcluded content in `format=embedded` +* [#2815](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2815) Added `#nowiki` support for external identifier type +* [#2820](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2820) Added check on declarative property usage +* [#2840](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2840) Added [`$smwgPropertyReservedNameList`](https://www.semantic-mediawiki.org/wiki/Help:$smwgPropertyReservedNameList) to define reserved property names +* [#2842](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2842) Added [`$smwgURITypeSchemeList`](https://www.semantic-mediawiki.org/wiki/Help:$smwgURITypeSchemeList) to restrict valid URI scheme +* [#2861](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2861) Added restriction for a property name that contains a CR, LF +* [#2867](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2867) Added singular, plural category canonical check +* [#2874](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2874) Added grouping support for properties to special page "Browse" +* [#2875](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2875) Changed the theme on special page "Browse" to `smwb-theme-light` +* [#2878](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2878) Added value filter to the property page +* [#2883](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2883) Added function to special page "SemanticMediaWiki" to find duplicate entities +* [#2889](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2889) Added method to make subobject sortkeys distinguishable +* [#2891](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2891) Added flex (responsive) mode to special page "Ask" and special page "Browse" div table +* [#2893](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2893) Changed special page "Ask" appearance ([#2898](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2898)) +* [#2895](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2895) Changed display of named subobject caption to appear without an underscore +* [#2906](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2906) Added flex (responsive) mode to the factbox +* [#2907](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2907) Added modal help to special page "Ask" +* [#2913](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2913) Added a job queue watchlist feature and the [`$smwgJobQueueWatchlist`](https://www.semantic-mediawiki.org/wiki/Help:$smwgJobQueueWatchlist) setting +* [#2922](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2922) Added `SMW_BROWSE_SHOW_SORTKEY` flag to the [`$smwgBrowseFeatures`](https://www.semantic-mediawiki.org/wiki/Help:$smwgBrowseFeatures) setting +* [#2930](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2930) Added limit to value selection on the property page +* [#2932](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2932) Added ["removeDuplicateEntities.php"](https://www.semantic-mediawiki.org/wiki/Help:Maintenance_script_removeDuplicateEntities.php) script to remove duplicate entities +* [#2933](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2933) Added [`$smwgDefaultLoggerRole`](https://www.semantic-mediawiki.org/wiki/Help:$smwgDefaultLoggerRole) setting to define logging granularity for Semantic MediaWiki +* [#2973](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2973) Set initial stats entry for non-fixed predefined properties +* [#3017](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3017) Added the [`$smwgCompactLinkSupport`](https://www.semantic-mediawiki.org/wiki/Help:$smwgCompactLinkSupport) setting to compact links produced by special page "Ask" and special page "Browse" +* [#3019](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3019) Added experimental support for the `SMW_NS_RULE` namespace +* [#3020](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3020) Added the [keyword](https://www.semantic-mediawiki.org/wiki/Help:Type_Keyword) (`_keyw`) type +* [#3029](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3029) Added function to keep updated entities in-memory to improve rebuild performance +* [#3088](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3088) Modernized special page "Page property" +* [#3167](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3167) Added support for `RemoteRequest` to share and consolidate query results from remote sources +* [#3284](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3284) Added the `--dispose-outdated` flag to the "rebuildData.php" maintenance script +* [#3289](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3289) Added support for the JSON format in the `Allows value list` definition +* [#3292](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3292) Added support for bounded intervals, ranges in `Allows value` for number and quantity types +* [#3293](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3293) Added tanslation page annotation (`_TRANS`) support +* [#3308](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3308) Extended content representation on property and concept pages using tabs +* [#3318](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3318) Added `smwgPostEditUpdate` to manage post edit event handling for seconday updates via the API interface +* [#3319](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3319) Sets an extra parser key for queries that contain a self-reference to improve the result display after an edit event +* [#3339](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3339) Added support for uniqueness validation in records/references +* [#3416](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3416) Added support for `<section>` on property pages to put user-defined content into SMW-defined tabs +* [#3415](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3415) Added "compact view" to hide query on special page "Ask" +* [#3429](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3429) Changed default submit method of special page "Ask" to POST. Submit method can be modified by setting `$smwgSpecialAskFormSubmitMethod` to `SMW_SASK_SUBMIT_GET`, `SMW_SASK_SUBMIT_REDIRECT`, or explicitly setting the default `SMW_SASK_SUBMIT_POST`. +* [#3431](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3431) Moved namespace "Rule" to namespace "smw/schema" +* [#3436](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3436) When an entity is deleted, check for possible open references and keep the ID in case it has a residual reference by turning it into a simple object instance (setting `smw_rev` and `smw_proptable_hash` to null) +* [#3440](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3440) Changed property pages to show the property usage count in the tab +* [#3441](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3441) Added flags to maintenance script "rebuildData.php": + * `--revision-mode`: Skip entities where its associated revision matches the latests referenced revision of an associated page + * `--force-update`: Force an update even when an associated revision is known +* [#3443](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3443) Changed job queue job names from `SMW\` prefix to `smw.` prefix. Example: `SMW\UpdateJob` -> `smw.update` + +## Bug fixes + +* [#481](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/481) Fixed "further results" link with special page "Ask" and templates +* [#502](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/502) Fixed template with named arguments use in #show +* [#839](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/839) Fixed and extended special page "Ask" to be more maintainable +* [#2001](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2001) Fixed issue with `smw_subobject` and the generation of duplicate entities +* [#2505](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2505) Fixed hard-coded default value for `format=csv` +* [#2586](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2586) Fixed class assignments for empty cells in `format=table` +* [#2621](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2621) Fixed sort/order field behaviour in special page "Ask" +* [#2652](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2652) Fixed handling of multiple checkbox parameter in special page "Ask" +* [#2817](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2817) Fixed Fix preg_replace ... unmatched parentheses +* [#2871](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2871) Fixed PHP 7.2 `each` use in `SearchResultSet` +* [#2881](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2881) Fixed display of display dispatched ID in `DataRebuilder` +* [#2884](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2884) Fixed "Cannot use object of type MappingIterator as array" +* [#2896](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2896) Fixed display of inverse indicator for translated predefined properties +* [#2902](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2902) Fixed "LBFactory::getEmptyTransactionTicket ... does not have outer scope" +* [#2909](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2909) Fixed use of `LBFactory::getEmptyTransactionTicket` +* [#2915](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2915) Fixed connection instantiation +* [#2917](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2917) Fixed "DataItemException ... Unserialization failed: the string ..." +* [#2919](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2919) Fixed fetching all entities during a delete +* [#2958](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2958) Fixed to mark subobject entities as done in `ExportController` +* [#2963](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2963) Fixed recognition of `$wgDBadminuser` in maintenance script "setupStore.php" +* [#2969](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2969) Fixed PHP 7.2 "Warning: count(): Parameter must be an array or an object that implements Countable" issue +* [#3000](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3000) Fixed fetching namespace aliases +* [#3010](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3010) Fixed breaking links in an abbreviated text by the `StringValueFormatter` +* [#3025](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3025) Fixed storage of query information during a `preview` activity +* [#3026](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3026) Fixed replacement of `smw_proptable_hash` during setup +* [#3031](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3031) Fixed duplicate entry `smw_prop_stats` exception +* [#3033](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3033) Fixed "The supplied ParserOptions are not safe ... set $forceParse = true" during the upload of files +* [#3049](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3049) Fixed concept selection +* [#3067](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3067) Fixed processing of simple links containing `|` during the in-text annotation parsing +* [#3076](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3076) Fixed factbox magic works +* [#3082](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3082) Fixed use of `ParserOptions::setEditSection` for MW 1.31 +* [#3107](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3107) Fixed recognition of `::=` in `LinksProcessor ` +* [#3134](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/3134) Escape `/` in property names +* [#3144](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3144) Return IDs as integer when matching all entities +* [#3336](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3336) Fixed issue in special page "Ask" with sort parameter where the first parameter is left empty +* [#3322](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/3322) Fixed issue in `UpdateDispatcherJob` with selecting unrelated entities +* [#3336](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3336) Fixed special page "Ask" to recognize first empty sort parameter as page title, e.g. `|sort=,Has foo` +* [#3375](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3375) Fixed error "Invalid sort: title. Must be one of: relevance". MediaWiki default sort type is only `relevance`. SMW added `title`, `recent`, and `best`. +* [#3389](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3389) Fixed "Error: 23505 ERROR: duplicate key value violates unique constraint "smw_new_pkey"" by setting SQL temporary table `id` field to type `SERIAL` instead of `INTEGERY PRIMARY KEY` +* [#3393](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3393) Fixed MW 1.31+ highlighter issue causing extra inline `<p>` which added newlines to display +* [#3413](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/3413) Fixed a performance issue for maintenance script "rebuildData.php" by doing `SELECT` on pages+namespaces rather than just pages. + +## Breaking changes and deprecations + +* [#1345](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/1345) Setting multiple values to the `#set` and `#subobject` paser functions using pipe `|` is deprecated. Use the `+sep` parameter instead. +* [#2495](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2495) `Store::getPropertySubjects` and `Store::getAllPropertySubjects` will return an `Iterator` instead of just an array +* [#2588](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2588) Removed special page "SemanticStatistics" +* [#2611](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2611) Removed the user preference `smw-ask-otheroptions-collapsed-info` +* [#2640](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2640) Removed `$smwgAutocompleteInSpecialAsk` +* [#2659](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2659) Removed deprecated constant `SMWDataItem::TYPE_STRING` (replaced by `SMWDataItem::TYPE_BLOB`) +* [#2696](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2696) Soft deprecate the `browsebyproperty` API module, the new `smwbrowse` should be used instead +* [#2705](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2705) Removed usages of deprecated `ResultPrinter::getParameters` +* [#2724](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2724) Added `$smwgUseComparableContentHash` and will be removed with 3.1 to help migrating subobject hash generation +* [#2730](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2730) Replaced `$smwgCacheUsage` settings +* [#2732](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2732) Replaced `$smwgQueryProfiler` settings +* [#2748](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2748) Removed `ContextSource` from `ResultPrinter` instances +* [#2750](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2750) Removed `$smwgSparqlDatabaseMaster` and `$smwfGetSparqlDatabase` +* [#2752](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2752) Renamed `$smwgSparqlDatabaseConnector` to `$smwgSparqlRepositoryConnector` +* [#2761](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2761) Renamed `$smwgDeclarationProperties` +* [#2768](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2768) Changed default setting for `$smwgSparqlRepositoryConnector` +* [#2788](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2788) Resources are now being exported as Internationalized Resource Identifiers (IRI) by default. +* [#2790](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2790) Removed deprecated entry points for maintenance scripts +* [#2802](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2802) Consolidated `$smwgParserFeatures` setting +* [#2806](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2806) Consolidated `$smwgCategoryFeatures` setting +* [#2821](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2821) Consolidated `smwgQSortFeatures` setting +* [#2841](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2841) Replaced `$smwgLinksInValues` with the `SMW_PARSER_LINV` flag now maintained in `$smwgParserFeatures`, PCRE option has been removed +* [#2880](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2880) Migrated special property message keys to new naming schema +* [#2899](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2899) Removed `$smwgScriptPath` +* [#2927](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2927) Removed `SEMANTIC_EXTENSION_TYPE` flag +* [#2944](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2944) Removed deprecated methods in `SMW\DIProperty` +* [#2961](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2961) Renamed `smwAddToRDFExport` hook +* [#2995](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2995) Updated old namespace in Spanish +* [#3164](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3164) Removed `SMW_NS_TYPE` ns and `$smwgHistoricTypeNamespace` +* [#3231](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3231) Consolidated `$smwgPagingLimit` setting +* [#3267](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3267) Removed `SMWQueryProcessor::getSortKeys` +* [#3285](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3285) Deprecated API module `BrowseBySubject`, use `smwbrowse` instead +* [#3307](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3307) Replaced `smwgCacheType` with `smwgMainCacheType` +* [#3315](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3315) Consolidated `smwgSparqlEndpoint` sparql endpoint setting +* [#3366](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3366) Replaced deprecated alias `SMWDIProperty` with `DIProperty` in `SMWDataValue` +* [#3364](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3364) Removed long-deprecated static functions `SMWWikiPageValue::makePage` and `SMWWikiPageValue::makePageFromTitle` +* [#3363](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3363) Removed deprecated `ResultPrinter::$m_params`. Use `ResultPrinter::$params` instead. +* [#3399](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3399) Removed several functions deprecated since SMW 1.9 from `SMW\DataValueFactory` +* [#3401](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3401) Removed long-deprecated functions `ResultPrinter::textDisplayParameters` and `ResultPrinter::exportFormatParameters` +* [#3403](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3403) Removed long-deprecated function `SMWResultArray::getNextObject` +* [#3405](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3405) Removed long-deprecated SMWDIString +* [#3406](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3406) Removed long-deprecated function `SMWRecordValue::getDV` +* [#3407](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3407) Removed deprecated global function `smwfIsSemanticsProcessed` + +## Other changes + +* [#2342](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2342) Added the display of invalid data value annotations for datatype "Text" +* [#2485](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2485) Disabled updates by the `QueryDependencyLinksStore` on a 'stashedit' activity +* [#2491](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2491) Added `ChunkedIterator` to `DataRebuilder` to avoid OOM situations in case of a large update queue +* [#2535](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2535) Fixed property namespace (`_wpp`) display in `WikiPageValue` +* [#2540](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2540) Added type `parser-html` to [`JSONScript`](https://www.semantic-mediawiki.org/wiki/Help:Integration_tests) testing to allow assertions on HTML structure +* [#2591](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2591) Discontinued reading MediaWiki `job` table, use the `JobQueue::getQueueSizes` instead +* [#2609](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2609) Added check to special page "Ask" to require JavaScript +* [#2631](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2631) Disabled purge button while JS resources are still loaded +* [#2650](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2650) Replaced some styles in special page "Ask" +* [#2653](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2653) Fixed `broadtable` width with the "MobileFrontend" extension +* [#2676](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2676) Added support for column default values in the `TableBuilder` +* [#2680](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2680) Added `null_count` column to `PropertyStatisticsTable` +* [#2691](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2691) Replaced `#info` icon set +* [#2698](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2698) Added persistent caching to the `HierarchyLookup` +* [#2714](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2714) Added `SMW::GetPreferences` hook +* [#2727](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2727) Moved parameter processing from `QueryProcessor` to `ParamListProcessor` +* [#2745](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2745) Moved `ResultPrinter` base class +* [#2747](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2747) Moved `TableResultPrinter` +* [#2751](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2751) Added `RecursiveTextProcessor` to isolate `$wgParser` access in `ResultPrinter` +* [#2765](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2765) Added `SMW::Setup::AfterInitializationComplete` hook +* [#2774](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2774) Moved `SMWQueryParser` to `SMW\Query\Parser` +* [#2783](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2783) Added `JsonSchemaValidator` +* [#2785](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2785) Moved `PropertyPage` and `ConceptPage` +* [#2845](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2845) Extended use of cached hierarchy instance +* [#2847](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2847) Introduced different approach to update query dependencies +* [#2888](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2888) Introduced `Setup::initExtension` to allow an early registration of `SpecialPage_initList` and `ApiMain::moduleManager` hooks +* [#2908](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2908) Refactored the `ConnectionProvider` +* [#2928](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2928) Moved `SQLStore::fetchSemanticData` to `SemanticDataLookup` +* [#2972](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/2972) Added `SMW::SQLStore::EntityReferenceCleanUpComplete` hook +* [#3032](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3032) Added the `SMW::LinksUpdate::ApprovedUpdate` and `SMW::Parser::ChangeRevision` hook +* [#3061](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3061) Added detection of changes emitted by the `BlockIpComplete`, `UnblockUserComplete`, and `UserGroupsChanged` hook +* [#3063](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3063) Moved import files to data folder +* [#3070](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3070) Added `SMW::Admin::TaskHandlerFactory` hook +* [#3131](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3131) Added `CONTENT_MODEL_RULE` to be able to do schema validation before a save sometime in the future. Switching to an alternate model at a later stage would only create headaches. +* [#3138](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3138) Fixed use of `$wgExtensionDirectory` to find SMW's "extension.json" +* [#3146](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3147) Moved table hash cache handling +* [#3160](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3160) Moved `FeedExportPrinter` and added integration test +* [#3260](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3260) Moved `SMWSQLStore3::changeSMWPageID` +* [#3275](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3275) Moved `SMWSQLStore3Readers::getPropertySubjects` +* [#3282](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3282) Moved `SMWSQLStore3Readers::getProperties` +* [#3384](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3384) Isolated the handling of "ALTER SEQUENCE ..." for Postgres +* [#3432](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3432) Moved `SMW\CategoryResultPrinter` to `SMW\Query\ResultPrinters\CategoryResultPrinter` + +## Contributors + +- 1036 - James Hong Kong +- 147 - translatewiki.net for the translator community +- 120 - Karsten Hoffmeyer +- 50 - Jeroen De Dauw +- 13 - Stephan Gambke +- 7 - Kumioko +- 6 - Iván +- 6 - Zoran Dori +- 4 - James Montalvo +- 4 - Máté Szabó +- 2 - Jaider Andrade Ferreira +- 2 - Josef Konrad +- 2 - TK-999 +- 1 - Amir E. Aharoni +- 1 - C. Scott Ananian +- 1 - Kunal Mehta +- 1 - Peter Grassberger +- 1 - Prateek Saxena +- 1 - Stephan +- 1 - Thiemo Kreuz +- 1 - Timo Tijhof +- 1 - Toni Hermoso Pulido +- 1 - ka7 +- 1 - matthew-a-thompson +- 1 - salle +- 1 - غلامحسین حق دوست diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-3.0.1.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-3.0.1.md new file mode 100644 index 00000000..7cdbfea1 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-3.0.1.md @@ -0,0 +1,39 @@ +# Semantic MediaWiki 3.0.1 + +Released on January 25, 2019. + +## Enhancements +* [#3566](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3566) as `af04255`: Extended the array of permissive URI schemes of [configuration parameter `$smwgURITypeSchemeList`](https://www.semantic-mediawiki.org/wiki/Help:$smwgURITypeSchemeList) +* [#3596](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3596) as `a6ccc2a`: Added [`$smwgConfigFileDir` configuration parameter](https://www.semantic-mediawiki.org/wiki/Help:$smwgConfigFileDir) allowing to specify the location for the [setup information file](https://www.semantic-mediawiki.org/wiki/Help:Setup_information_file) +* [#3597](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3597) as `c92b2ca`: Extended and improved information on the ["Upgrade Error Screen"](https://www.semantic-mediawiki.org/wiki/Help:Upgrade/Upgrade_and_setup_consistency) and made it localizable +* [#3611](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3611) as `8f1177a`: Added ["populateHashField.php" maintenance script](https://www.semantic-mediawiki.org/wiki/Help:Maintenance_script_populateHashField.php) to decouple mass conversions of database field "smw_hash" in the "smw_objects_ids" database table when upgrading the database for large wikis +* Many new translations for numerous languages by the communtity of [translatewiki.net](https://translatewiki.net/w/i.php?title=Special%3AMessageGroupStats&x=D&group=mwgithub-semanticmediawiki&suppressempty=1) + +## Bug fixes and internal code changes +* [#3565](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3565) as `6f24bf6`: Added missing system message for the "templatefile" format +* [#3572](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3572) as `70f629e`: Fixed `HtmlForm::getForm` to support a string as result on special page "Ask" +* [#3573](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3573) as `a59c76c`: Modified tests to avoid "Call to a member function getSchema() on null" for MediaWiki 1.32 and later +* [#3578](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3578) as `484a4b5`: Made indexer apply `pg_unescape_bytea` for bytea/blob values on postgres +* [#3584](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3584) as `1205b87`: Added pipe detection in printrequest labels (`[[ ... | ... ]]`) +* [#3585](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3585) as `5d6d6ff`: Fixed "`strpos()`: Non-string needles ..." for PHP 7.3 and later +* [#3586](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3586) as `53655ed`: Fixed `#set_recurring_event` parser function to respect related configuration parameters and their settings +* [#3595](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3595) as `e9ed65e`: Fixed invalid user names using the mandatory interwiki prefix for MediaWiki 1.31 and later by unlinking them +* [#3599](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3599) as `732ef23`: Fixed "`fputcsv` ... delimiter must be a single character" for the "csv" format +* [#3607](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3607) as `4d9e5a7`: Fixed `#set_recurring_event` parser function to cause "Call to undefined method `SMWDIError::getJD()`" +* [#3608](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3608) as `b17526d`: Fixed "QueryResultSerializer" to handle `_qty` on chained properties +* [#3609](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3609) as `c005c6f`: Restored use of `$wgDBTableOptions` configuration parameter +* [#3616](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3616) as `4b0cfb7`: Made `isCapitalLinks` be set in `_wpg` description context +* [#3617](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3617) as `9152f94`: Made "SemanticDataLookup", use `DISTINCT` for non subject items +* [#3622](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3622) as `cfbd338`: Fixed `#set_recurring_event` parser function to allow monthly events start on a 30th and 31st of a month +* [#3628](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3628) as `e587291`: Improved commandline prompts for maintenance script "populateHashField.php" +* [#3630](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3630) as `79aee30`: Added extra _uri validation for `http:///` +* [#3631](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3631) as `0903c1b`: Fixed `ResultFormatNotFoundException` on untrimmed format strings +* [#3632](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3632) as `24d8bae`: Changed to using `0x003D` instead of `-3D` to encode `=` +* [#3633](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3633) as `f70339a`: Made the container subject be used as context to check uniqueness constaints +* [#3634](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3634) as `711e365`: Made "WikiPageValue" use the provided fixed namespace +* [a5a4a0d](https://github.com/SemanticMediaWiki/SemanticMediaWiki/commit/a5a4a0d1b05eb622749fe59a1d2be4be699aaed4) as `bea16a5`: Fixed "PHP Notice: Uncommitted DB writes (transaction from ...)" +* [8bc4443](https://github.com/SemanticMediaWiki/SemanticMediaWiki/commit/8bc4443a6a48682e74e94a014adfcd91cb6104a5) as `5a729d4`: Fixed `get_headers` can return `false` +* [8ca1ec0](https://github.com/SemanticMediaWiki/SemanticMediaWiki/commit/8ca1ec05ef56144b1991c0381696a52687e39ed4) as `93cf100`: Made "PHP Warning: Class '`SMW\CategoryResultPrinter`' not found in ... Aliases.php" be avoided + +## See also +* [RELEASE NOTES](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/3.0.x/docs/releasenotes/RELEASE-NOTES-3.0.0.md) for Semantic MediaWiki 3.0.0 diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-3.0.2.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-3.0.2.md new file mode 100644 index 00000000..36557b5c --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-3.0.2.md @@ -0,0 +1,24 @@ +# Semantic MediaWiki 3.0.2 + +Released on April 11, 2019. + +## Enhancements + +* [#3682](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3682) as `f5d0cab`: Removed `IsFileCacheable` hook and improves file caching +* [#3856](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3854) as `767c981`: Switched setting of configuration parameter "$smwgCompactLinkSupport" to "false" + +## Bug fixes and internal code changes + +* [#3742](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3742): Fixed raw output of templated message particles +* [#3771](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3771) as `b7a78e0`: Removed `doPostOutputShutdown` +* [#3772](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3772) as `79e4adb`: Fixed "... expects parameter 1 to be a valid callback ..." +* [#3775](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3775) as `3b0d83c`: Made data type "Equivalent URI" non declarative +* [#3847](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3847) as `d088204`: Fixed warning "a non-numeric value" was encountered +* [#3854](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3854) as `d05671e`: Provided a new test case for "display title" +* [#3859](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3859): Updated "InfolinkTest" +* [#3863](https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/3863): Fixed resource loading by replacing `localpath` with `localBasePath` +* [0ed4bbf7](https://github.com/SemanticMediaWiki/SemanticMediaWiki/commit/0ed4bbf75e7ee9989d2ac84437d3733b52885eb8): Updated "EventHandlerTest" + +## See also +* [RELEASE NOTES](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/3.0.x/docs/releasenotes/RELEASE-NOTES-3.0.0.md) for Semantic MediaWiki 3.0.0 +* [RELEASE NOTES](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/3.0.x/docs/releasenotes/RELEASE-NOTES-3.0.1.md) for Semantic MediaWiki 3.0.1 diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-old.md b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-old.md new file mode 100644 index 00000000..25c3381d --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/releasenotes/RELEASE-NOTES-old.md @@ -0,0 +1,723 @@ +These are the release notes of SMW up to version 1.5.6. +For version 1.6 and later, see the dedicated files in this directory. + +== SMW 1.5.6 == + +* Automatic refresh of pages after parsing their semantic data. +* Fixed several bugs including non-functional concept caching, + correct internationalization support for categories and concepts + in queries and types display on Special:Types for MW >= 1.18. + +== SMW 1.5.5 == + +* Support for Turtle syntax (e.g. use "syntax=turtle" as a parameter to + when calling Special:ExportRDF. +* New query format "rdf" to export query results to RDF; the "syntax" + parameter can be set to "rdfxml" or "turtle" to specify a syntax. +* Fixed several bugs, including whitespace problems in queries using the + list format, an issue with large offset values and DatatypeProperties + being declared as ObjectProperties. +* More modular export code (split one file into 3), simplifies + manipulation and maintenance. + +== SMW 1.5.4 == + +* Fixed several bugs, including problems with #declare, the extra options + on Special:Ask and the style of the factbox and tables when using MW 1.17. +* Various style and documentation improvements and translation updates. + +== SMW 1.5.3 == + +* Compatibility with MediaWiki 1.17 +* Added << and >> comparators for strict comparisons. Also added ≤ and ≥ for + non-strict comparisons. And introduced $smwStrictComparators setting that + allows changing the behavior of < and > to doing strict comparisons. +* Various style and documentation improvements and translation updates. + +== SMW 1.5.2 == + +* 'Printouts' textarea in Special:Ask now has autocompletion on property + names. +* SMW now has it's own copy of the jQuery and jQuery UI libraries. +* Added a number of hooks to allow further customization by extensions. +* 'Semantic' extension type that can be used by extensions to SMW to be + grouped together on Special:Version and other pages listing extensions. +* Various bugfixes, style and documentation improvements and translation updates. + +== SMW 1.5.1 == + +* Added query comparator "!~" that works like the negation of "~", i.e. that + retrieves exactly those values to which the provided pattern (with * and ?) + does not match. +* Updated OWL/RDF export to include more data (modification dates, and page + namespaces). Changed export ontology to no longer use OWL AnnoationProperties + since OWL 2 DL supports property values also for classes/properties. +* Improvements in code style and structure, following general MediaWiki + conventions. Most notably, the file to include for loading SMW now is + SemanticMediaWiki.php in the base directory (including the old Settings.php + will still work). +* Preparation of future "SMWLight" release for wikis that want to enable users + to add property values to pages, but which do not want to include complex + query features. +* Added a nmber of hooks to improve compatibility with extensions. +* Various bugfixes, and translation updates. + +== SMW 1.5.0 == + +* The former multi-valued/n-ary properties are now supported by a dedicated + datatype Record. Wikis that use the old style of these properties need to + update affected property pages as described at + http://semantic-mediawiki.org/wiki/SMW_1.5.0 +* The Type:Geographic_coordinates has been moved from SMW to the SemanticMaps + extension. Wikis that use this datatype need to install this extension to get + it back. +* The "like" comparator ~ in inline queries is now enabled by default. To use + the former setting, use $smwgQComparators = '<|>|!'; in your LocalSettings.php. +* A new datatype, "Telephone number", has been introduced for validating phone + numbers based on RFC 3966. Only global phone numbers are accepted, and no + vanity numbers (those containing letters) are allowed. Use Type:String if + you want to store more general strings as telephone numbers. +* Support for additional parameters for ?printouts in inline queries, specified + by |+parameter=value after the printout. Currently supported are + * limit: set the maximum number of values for this printout + * order: order values ascending or descending + * align: right/center/left alignment for printouts in tables + * index: directly address one value of a multi-valued (n-ary) property +* Support for inverse properties: use "-" in front of property names anywhere to + refer to the inverse direction of a property. Works in browsing interfaces, + queries, and query output directives. In queries only for properties of Type:Page. +* New configuration options $smwgUseCategoryHierarchy and $smwgCategoriesAsInstances + to configure how MediaWiki categories should be interpreted by SMW. +* Compatibility with new MediaWiki skin "Vector" and with MediaWiki 1.16. +* Removed support for backwards compatibility to SMW <1.0 ($smwgSMWBetaCompatible). +* The page Special:Ask was overhauled to include inputs for entering values + for the selected format's parameters, and to use Ajax where possible +* To that end, each format's query printer now includes a getParameters() + function that supplies the name and attributes of each the format's parameters +* "before" and "after" hooks for updateData() and deleteSubject() were added +* A hook was added for deleteSemanticData() as well + +== SMW 1.4.3 == + +See http://semantic-mediawiki.org/wiki/SMW_1.4.3 + +* A new query format, 'category', that displays values in the style of a + MediaWiki category page +* A new 'columns' parameter for the 'ol' and 'ul' formats +* The 'csv' format now prints a header row by default +* The "::~" comparator in queries can now also be used for properties of type + Geographical coordinate, to find points within a certain distance +* Using "-" as an output format for query printouts, or leaving the formatting + string empty now leads to printout values being returned as plain, unformatted + values. Recall that the general format for printouts in #ask is as follows: + ?propertyname # format = label +* New special property "Has improper value for" can be used to track input errors + (links pages where error happened to properties for which improper data was given). +* New configuration parameter $smwgMaxNonExpNumber to set the maximal number that + SMW will normally display without using scientific exp notation. Defaults to + 1000000000000000. +* New configuration parameter $smwgMaxPropertyValues to control number of values + that are shown for each page in the listing on Property pages. Defaults to 3. +* Now a set of stores can be added, e.g. virtual stores, and then the new #ask + parameter "source" is used to rout to a specific store. +* Labels for inverse properties can be used to improve the output of the Browse + special page. +* The #ask parameter "headers" can now be given the value "plain" to get query + results that show the printout label (e.g. property name) but without a link. +* Special:PageProperty now shows all values of a property when omitting the subject. +* Numerous bugfixes + +== SMW 1.4.2 == + +See http://semantic-mediawiki.org/wiki/SMW_1.4.2 + +* Improved performance. Significantly improved memory usage on common + operations. +* Initial support for running SMW on PostgreSQL (testing needed). +* The query formats 'vcard' and 'icalendar' have been moved to the Semantic + Result Formats extension to make the SMW core more light-weight +* SMW_refreshData.php now supports parameter --page to specify one or more + pages to be updated (instead of using ID ranges) +* Various bugfixes +* Extended translations + +== SMW 1.4.1 == + +See http://semantic-mediawiki.org/wiki/SMW_1.4.1 + +* Improved parsing support for Type:Date, fixing some open issues +* Various bugfixes +* Extended translations + +== SMW 1.4.0 == + +See http://semantic-mediawiki.org/wiki/SMW_1.4.0 + +* Easier installation, upgrade, repair: + Special:SMWAdmin now has a control for refreshing the wiki data online. +* Better Type:Date + ** much larger range of dates, covering all of human history + ** internationalisation, support for localised date formats in input + ** support for single year numbers in dates + ** incomplete dates handled properly +* Query for page modification date using Property:Modification_date +* Full integration of "special properties" such as Property:Has_type + ** can be queried in #ask, and printed in printouts + ** usable in all browsing interfaces + ** display uses of properties on property page +* Improved parsing process + ** avoid data loss in unusual circumstances + ** much better compatibility with other parser extensions +* Shorter and cleaner code +* Extended translations +* Many bugfixes + +== Semantic MediaWiki 1.3 == + +See http://semantic-mediawiki.org/wiki/SMW_1.3 + +* New design of Special:Browse: more concise and less cluttered +* Fuzzy search on Special:SearchByProperty: if an exact value is not found + or yields only few results, pages with close-by values are also shown. +* Better result browsing on concept pages. Such pages now look like category + pages and show results in columns. +* New mechanism for pre-computing concepts for very fast result display even + fomr complicated queries. Relevant for wikis with large amounts of data. + Details are documented at + http://semantic-mediawiki.org/wiki/Help:Concept_caching +* Extended translations, support for aliases for special pages (translated + names used in URLs). +* Various bugfixes and internal improvements for performance and robustness. + +== Semantic MediaWiki 1.2.2 == + +Minor release with bugfixes: +* in rare cases undelete would create errors on pages +* inverse links for binary properties were displayed wrongly +* some additional checks to make parsing more reliable + +== Semantic MediaWiki 1.2.1 == + +See http://semantic-mediawiki.org/wiki/SMW_1.2.1 + +* New sub-property display for property pages +* Improved number parsing, admitting arbitrary spaces in numbers + (required for French) +* Extended translations +* Update job generation actually works now +* Query format "csv" to export data as file of comma-separated values +* Prevent crashes for very long property values (due to PHP PCRE) +* Various other bugfixes + + +== Semantic MediaWiki 1.2 == + +See http://semantic-mediawiki.org/wiki/SMW_1.2 + +* New SMW storage backend (SMWSQLStore2) + ** faster for queries and page display/rendering + ** full equality support built-in, no performance impact + ** support for disjunctions in queries (keyword "OR") +* vCard export for query results +* Improved semantic query syntax and processing + ** shortcut query syntax #show for displaying properties of + single pages, e.g. {{#show: Berlin | ?population}} + ** property chains like [[property1.property2::value]] + ** more detailed control of which query features to support + (see setting $smwgQFeatures in SMW_Settings.php) +* Support for custom sortkey to control alphabetic sorting of + all pages, using MediaWiki's {{DEFAULTSORTKEY: custom key}} +* Support for semantic interwiki links (e.g. [[property::meta:Test]]) +* Stored queries on Concept: pages (concepts as "dynamic categories"), + see http://semantic-mediawiki.org/wiki/Help:Concepts +* Automated updates: changes in templates and property definitions + are automatically applied to affected pages (after some time) +* Extended maintenance scripts + ** delete an existing (now unused) SMW store with SMW_setup --delete + ** select SMW storage engine to use for scripts with option -b <Store> + ** SMW_dumpRDF now supports restriction to concepts or concepts+categories +* SMW <1.0 features disabled by default (remove obsolete features), + can be re-enabled with $smwgSMWBetaCompatible. +* Compatible with Semantic Forms 1.2.3 and MediaWiki 1.13 (current devel + version) + + +== Semantic MediaWiki 1.1.2 == + +* Security update to avoid vulnerabilities on sites that use PHP + superglobals + +== Semantic MediaWiki 1.1.1 == + +* Improved iCalendar support: more efficient processing, better heuristic + for giving dates, formatting bugfixes +* Bugfix for Special:SearchByProperty (form-based search failed) +* Minor bugfixes for RSS generation +* Bugfix for Special_Ask in MediaWiki 1.11 with template formatting +* Maintenance scripts now accept the MW_INSTALL_PATH environment variable + +== Semantic MediaWiki 1.1 == + +* Support for formatted results on Special:Ask. "Further results" links + from inline queries now preserve format. +* New iCalendar export for inline queries (format=icalendar) +* Query results can now be sorted by more than one property (just separate + property names with "," in sort parameter) +* Initial support (beta) for synching external RDF stores with SMW. + This also provides support for wiki-based SPARQL query services, see + http://semantic-mediawiki.org/wiki/Help:SPARQL_endpoint +* More robust link generation code; even long query texts and links + that contain very special characters are built properly. +* Extended translations. Completely new Arab translation. +* New SMW registry http://semantic-mediawiki.org/wiki/Special:SMWRegistry + to replace hand-crafted list of "sites using SMW". +* Various bugfixes. For example: + ** Enumerated properties (allows value) for Type:Page works now. + ** Page moves are handled more reliably + +== Semantic MediaWiki 1.0.1 == + +* Extended translations, new Italian translation +* minor bugfixes, fixed RSS links for long description texts + +== Changes in SMW1.0 as compared to SMW0.7 == + +* Simplified semantic annotations: just one kind of annotation ("Property"). +* Significant speedup (both server and network load substantially reduced, + faster RDF export, more efficient query result formatting). +* Prettier and easier to understand interfaces: + ** New tooltips for warnings and additional information. + ** Simplified factbox layout, with all properties in alphabetic order. + ** Inline warnings to simplify trouble shooting with annotations. + ** Improved, more helpful and informative warning and error messages. + ** Highlighting for built-in elements. E.g. built-in types are visually + distinguished from arbitrary types; useful as visual feedback. + ** Error/warning reporting for (inline) queries. +* More powerful output formatting for semantic querying: + ** new {{#ask:...}} parser function syntax for inline queries, fully + compatible with MediaWiki templates, template parameters, and parser + functions of other extension + ** more readable inline query structure in #ask parser function, + printouts separated from query + ** semantic RSS feeds making feeds from query results via "format=rss" + ** new printout format "?Category:Name" for #ask + ** option to hide main column by setting "mainlabel=-", and reinserting + via print request "?" (only for #ask) +* More expressivity for semantic querying: + ** support for subproperties, + ** improved equality resolution (redirects), + ** support for disjunctions, + ** inequality check for datavalues ("[[property::!value]]") + ** optional pattern matching for string values ("[[property::~Semant*]]") + ** automatic sorting on sort-parameter (no additional condition needed) +* New/improved datatypes: + ** Type:Page for explicitly specifying properties that are "relations" + ** better media support in Type:Page: special treatment of Image: and Media: + ** Type:Number as universal replacement for Type:Integer and Type:Float + ** Type:URL as universal replacement for old Type:URL and Type:URI + ** Type:Geographic coordinates completely rewritten. More input formats + supported, more liberal parsing to accept most inputs + ** special property "allows value" works for all types + ** display units are now easier to select via property "display units" + ** Improved data display: URL-links and tooltips work for queries results + and on special pages +* Improved special pages: + ** simpler interface for Special:Ask, hide query when using "further results" link + ** hints and warning for property usage/declaration in Special:Properties + ** extra information and warnings for types on Special:Types + ** Special:SemanticStatistics as faster replacement for earlier "ExtendedStatistics" +* Better internationalisation: + ** updates in all translation files + ** new translations to Dutch, Chinese (tw/ch), Korean (beta) + ** alias strings for all SMW elements; English labels are allowed in all + languages, names of old SMW elements still work as aliases for their + replacements. +* New experimental n-ary properties, allowing property values to consist of + a list of entries. +* Ontology import re-enabled (simple annotation import) +* Maintenance script SMW_refreshData now can rebuild all SMW data structures, fixing + even exotic database problems on most sites. +* New maintenance script for announcing site to Semantic Web crawlers. +* Support for upcoming MediaWiki 1.12 +* Improved APIs and various new hooks to simplify the life of SMW extension developers. +* Many bugfixes. + +Other changes for SMW1.0 include: +* Type:Enum became obsolete, since all types now suppport "allows value", but it + remains an alias for Type:String. +* Some configuration options for LocalSettings.php have changed. Read INSTALL + for details on how to upgrade from your old installation. + + +== Semantic MediaWiki post 1.0RC3 == + +* Support for dynamic, query-generated RSS-feeds via query format "rss". +* Optional query feature for pattern matching in Type:String property values. +* Correct dynamic sorting of result tables, even for dates and numerical values. +* Thumbnail images when displaying property values from Image namespace. +* Simplified use of "sort" parameter in queries. +* Support for upcoming MediaWiki 1.12 (major parser changes). +* More efficient link generation in query results. Link all query results by + default now. +* Maintenance script SMW_refreshData now can rebuild all SMW data structures, + fixing even exotic database problems on most sites. +* New maintenance script for announcing site to Semantic Web crawlers. +* Various bugfixes. + +== Semantic MediaWiki 1.0RC3 == + +* New method for integrating inline queries via #ask parser function, separation of + query and printout requests, full compatibility with templates. +* New layout for Special:Ask to reflect #ask structure. +* New printout option: "?Category:Name" to ask for membership in that category. +* Re-enabled service links (e.g. use [[provides service::online maps]] on any page of + a property to Type:Geographic coordinates). +* Re-enabled Type:Boolean. +* Prototype translation for Korean (still alpha). +* Various minor bugfixes. + +== Semantic MediaWiki 1.0RC2 == + +* Experimental Postgres support. +* More liberal parsing for geographic coordinates, most user inputs accepted now. +* Improved URL datatype: better linking behavior, tolerant towards Unicode-URLs. +* Significantly improved performance for RDF export. +* Complete translations for Fr, Zh-tw, and Zh-ch added. +* Various minor bugfixes. + +== Semantic MediaWiki 1.0RC1 == + +* Simplified semantic annotations: just one kind of annotation ("Property"). +* Significant speedup (both server and network load substantially reduced). +* Prettier and easier to understand interfaces: + ** New tooltips that work on both normal and special pages. + ** Simplified factbox layout, with all properties in alphabetic order. + ** Inline warnings to simplify trouble shooting with annotations. + ** Improved, more helpful and informative warning and error messages. + ** Highlighting for built-in elements. E.g. built-in types are visually + distinguished from arbitrary types; useful as visual feedback. + ** Error/warning reporting for (inline) queries. +* Alias strings for all SMW elements. English labels are allowed in all + languages, names of old SMW elements still work as aliases for their + replacements. +* More expressivity for semantic querying: + ** support for subproperties, + ** improved equality resolution (redirects), + ** support for disjunctions, + ** inequality check for datavalues ("[[property::!value]]") +* New/improved datatypes: + ** Type:Page for explicitly specifying properties that are "relations" + ** Type:Number as universal replacement for Type:Integer and Type:Float + ** Type:URL as universal replacement for old Type:URL and Type:URI + ** Type:Geographic coordinates completely rewritten. More input formats + supported now (e.g. coordinates without "," separating Lat and Long) + ** special property "allows value" works for all types + ** display units are now easier to select via property "display units" + ** Improved data display: linked URLs and tooltips work for queries and + special pages +* Improved maintenance special pages: + ** Hints and warning for property usage/declaration in Special:Properties + ** Extra information and warnings for types on Special:Types + ** Special:SemanticStatistics as faster replacement for earlier "ExtendedStatistics" +* New experimental n-ary properties, allowing property values to consist of + a list of entries. +* Ontology import re-enabled (simple annotation import) +* Dutch translation added (by Siebrand Mazeland) +* Improved APIs and various new hooks to simplify the life of SMW extension developers. +* Many bugfixes. + +Other changes for the RC1 include: +* No more support for Type:Boolean. Will be re-enabled later. +* Type:Enum became obsolete, since all types now suppport "allows value", but it + remains an alias for Type:String. +* Service links are not working in this Release Candidate yet, especially coordinate + values do not link to maps yet. This will reappear before SMW1.0 final. + + +== Semantic MediaWiki 0.7 == + +* New browsing interface for semantic data: Special:Browse +* Improved simple searching interfaces, making the old Special:Searchtriple + obsolete by various new interlinked special pages. +* New formatting options for inline queries: +** Template-based formatting for formats "list" and "template" +** Transclusion of result articles with format "embedded" +** Counting query results with format count. +* New datatype for enumerated string values (Type:Enum). +* Pages of attributes and relations now list all uses of these properties. +* Pages of types now list all attributes using a type. +* New Special:WantedRelations showing relations that are used but have no page. +* Improved support for arbitrary symbols in string values, including wiki links + and HTML entities (now correct in RDF). +* Improved headers for query tables, with sort icon and link to attribute/relation + separated. +* Added maintenance script to rebuild semantic data, thus fixing any inconsistencies + in the semantic database that may have occurred earlier or due to text-only imports + of pages. +* Translations to further languages, including Hebrew (right-to-left). +* New cleaner storage implementation, allowing to run MediaWiki parsertests with the + option $smwgDefaultStore = SMW_STORE_TESTING; in LocalSettings.php. +* MediaWiki-1.10-Ready ;-) +* Simplified installation (no more manual patching with MediaWiki 1.10). +* Many bugfixes. + +== Semantic MediaWiki 0.6 == + +* New Special:Ask for directly browsing query results and for testing queries. +* New output format "timeline" for inline queries that deal with dates. Available + parameters are: timelinestart (name of start date attribute), timelineend (name + of end date attribute, if any), tiemlinesize (CSS-encoded height), timelinebands + (comma-separated list of bands such as DAY, WEEK, MONTH, YEAR, ...), and + timelineposition (one of start, end, today, middle). +* Complete RDF export is now possible with a maintenance script, which can e.g. be + run periodically on a server to create RDF files. +* New "service links" feature: any attribute can provide configurable links to + online services. As a special case, the map-services of geo-coordinates are now + fully configurable. +* Inline queries now link to life search for further results if not all results + were shown inline. +* The formatting code for inline queries was rewritten to become more powerful. + For instance, multi-property outputs in list format will never produce empty + parentheses now. +* RDF-export code is cleaner and some further OWL DL incompatibilities are caught. +* RDF-export now can generate browsable RDF (with backlinks) even for Category + pages. +* Improved headers for sorting tables. Sort icon now visible even if no text is + shown in header. +* Many bugfixes. + +== Semantic MediaWiki 0.5 == + +* Customised datatypes for unit conversion: it is now possible to create customised + linear unit conversions by appropriate statements on type articles. This also + enables full localisation of all units of measurement. +* Customized display of units: every attribute can now decide which units to display + in factbox and query results. Internally, values are still normalised, but users + can adjust the view to the most common description of some attribute. +* Support for importing vocabularies from external ontologies. For instance, elements + of the wiki can now be mapped to the FOAF ontology during export. The import is + controlled by whitelist-like message articles. +* New attribute datatypes for URLs and URIs, some of which can be exported in RDF as + ObjectProperties. A blacklist is used to prevent technically problematic URIs from + being used there (e.g. most don't want to use OWL language elements as data). +* New attribute datatype for temperature, since this cannot be defined by a linear + custom unit conversion. +* Improved Special:Relations and Special:Attributes, including a quicklink to searching + occurrences of some annotation. +* Unit support for inline queries. Desired output unit can be adjusted through query. +* Improved code layout, using object-orientation features of PHP5. +* Many bugfixes. + +== Semantic MediaWiki 0.4.3.2 == + +This fixes another small bug that prevented the limit parameter in queries to work +properly. + +== Semantic MediaWiki 0.4.3.1 == + +This fixes a small but critical bug that prevented queries for non-numeric attribute +values to work properly. + +== Semantic MediaWiki 0.4.3 == + +Semantic MediaWiki 0.4.3 is an intermediate release that greatly improves the +performance and features of inline queries. It also includes some major code +cleanups and various bugfixes. + +An updated documentation of the current inline queries is (soon) to be found at +http://semantic-mediawiki.org/wiki/Help:Inline_queries + +== Semantic MediaWiki 0.4 == + +Semantic MediaWiki 0.4 includes the following new features: + +* Support for inline queries: it is now possible to <ask> queries in + articles, the answers of which are included into the displayed page. + Conjunctions and nesting of queries is supported. Datatype queries + for values above or below some threshold are possible. Outputs can be + displayed in many different formats, including bulleted and numbered + lists, tables with intercative (JScript) sorting (credits go to + Stuart Langridge for www.kryogenix.org/code/browser/sorttable/), and + plain text. See http://semantic-mediawiki.org/wiki/Help:Inline_queries + for documentation. +* Improved output for Special:Relations and Special:Attributes: usage of + relations and attributes is now counted +* Improved ontology import feature, allowing to import ontologies and to + update existing pages with new ontological information +* Experimental support for date/time datatype +* More datatypes with units: mass and time duration +* Support for EXP-notation with numbers, as e.g. 2.345e13. Improved number + formatting in infobox. +* Configurable infobox: infobox can be hidden if empty, or switched off + completely. This also works around a bug with MediaWiki galeries. +* Prototype version of Special:Types, showing all available datatypes with + their names in the current language setting. +* "[[:located in::Paris]]" will now be rendered as "located in [[Paris]]" +* More efficient storage: changed database layout, indexes for fast search +* Code cleaned up, new style guidelines +* Bugfixes, bugfixes, and some more bugfixes + +Semantic MediaWiki 0.4 has not been tested on MediaWiki below 1.6.1 and might +fail to operate correctly in this case. Some functions explicitly use code +that was introduced in 1.6. + +== Semantic MediaWiki 0.3 == + +Changes by mak (0.3, 06 Apr 2006): + +* Compatibility updates for MediaWiki 1.6 + +Changes by denny/mak (0.3, 25 Mar 2006): + +* Internal: improved management of special properties +* RDF export: OWL conformant export of all available content data, including category information +* RDF export: recursive export, "streaming" +* UI: further internationalization, internationalized float number format (decimal separator) +* UI: new infobox section for recognized special properties +* new Specials to show all relations/attibutes +* new experimental Special to import data from existing OWL/RDF ontologies +* new special property "equivalent URI" that allows to map wiki concepts to URIs in other ontologies + +Changes by kai/mak (0.3preview, 15 Mar 2006): + +* Internal: new internal storage management; cleaner, more flexible, and more efficient +* Internal: new internal type registration API +* Internal: new internal management for special properties (e.g. 'has type') +* Internationalization: almost complete; namespaces, special properties (e.g. 'has type'), datatype labels +* RDF export: support for multiple mimetypes (rdf+xml and xml); needed for Piggybank +* RDF export: support for bulk export +* RDF export: XSD datatypes and correct instance classification (rdf:type) +* UI: extended Special:SMWAdmin to convert data from old internal datatable to new format +* UI: duplicate attribute values eliminated in infobox +* UI: types can switch off quicksearch links +* UI: more human-oriented error mesages ;-) +* UI: service links for infobox and search +* new datatype for geographic coordinates, accepting many kinds of coordinate inputs, and providing links to standard mapsources +* Simple semantic search supports imprecise search again + +Changes by mak (0.2c, 9 Mar 2006): + +* added basic language support functionality +* improved installation process (SMW_LocalSettings.php, simpler patching for Setup.php) + +Changes by mak (0.2c, 1 Mar 2006): + +* RDF Export enabled +* more CSS and an icon to show RDF download link on pages + +Changes by kai/mak (0.2c, Feb 2006): + +* Added new custom stylesheet and JScript (kai/mak) +* New JScript tooltips (kai) +* New style for infobox search items (mak) + +Changes by mak (0.2c, Feb 2006): + +* Added new Special:SMWAdmin that allows relatively painless upgrade + from versions <=0.2 where no namespaces were used. +* Added support for moving pages with its stored triples. +* BUGFIX: triples in articles with SQL-hostile symbols (e.g. ') are + now working. + +== Semantic MediaWiki 0.2b == + +Changes by mak (0.2b, Jan 2006): +* Changed directory structure for more clarity, easier installation + and upgrade. +* Now using custom namespaces for Relations, Attributes, and Types, + and their talks. +* Semantic features can be switched on or off for each namespace + individually. +* Registered extension for MediaWiki's "Special:Version". +* BUGFIX: Configuration now takes fixed servername to use in storing + URIs. Before, different access methods (e.g. direct IP vs. servername) + generated different URIs. +* BUGFIX: Attributes that could not be parsed now do not generate + triples with empty object in our database. + +Changes by mak (0.2a, 4 Dec 2005): +* Attribute values are now correctly stored and retrieved. +* Special SearchTriple greatly enhanced, such that queries for + attributes become possible (including unit conversion). +* Links from attributes in infobox to the new search form. +* Major code cleanup: SMW_AttributeStore.php now is called + SMW_SemanticData.php and managemes all types of semantic + data, including printout and storage. SMW_Hooks.php was freed + of all code with similar purpose. Look-up of attribute types + was moved from SemanticData to Datatype. + +Changes by mak (0.1b, 1 Dec 2005): +* Reworked internal data representation. All information now is + properly encoded in URIs and decoded for display. This is an + important prerequisite for storing attributes and auxilliary + triples, which otherwise could not be distinguished from the + relational information. +* New Special SearchTriple to replace the current SearchSemantic, + which is currently only half functional since it believes that + the database contains only simple names for articles, but not + full URIs. +* Minor adjustments in handling of namespaces: namespaced aritcles + now properly work as subjects and are displayed with namespace in + in the infobox. + +Changes by mak (0.1b, 19 Nov 2005): + +* New type management; attributes can now be declared by creating + relations of type "has type" inside their articles (Attribute:X). + Possible targets are the builtin types (Type:String, Type:Geographic + length, etc.). +* New internal method SMWGetTriples for directly retrieving triples + from the storage. Accepts subject, predicate, object pairs, where + any two can be left out. +* Improved layout for infoboxes. + +Changes by mak (0.1b, 13 Nov 2005): + +* added support for separator "," in data numbers, +* added tooltips for unit conversion. + +Changes by mak (0.1b, 17 Oct 2005): + +* added attribute support [[attribute name:=value|alternative text]]; + currently, parsing these within the article works, including an + info box at the bottom; however, assignment from attributes to + datatypes is still hardcoded and attribute-annotations are neither + stored as triples nor are they supported in search, +* added basic type support for STRING, INTEGER, and FLOAT, +* added framework for unit conversion and first unit support: unit + conversion is achieved by callback functions, so that adding types + for new units boils down to writing a single unit conversion function, +* code split into several files for easier colaboration of developers, +* new naming convention "SMW"-prefix for all top level code elements of + the extension, +* moved main storage methods to SMW_Storage.php, this should simplify + the conversion to another storage backend (triplestore), +* moved stripping of semantic relations to SMW_Stripsemantics.php; + if this feature is desired, this file needs to be updated slightly + (also to include semantic attributes) and its methods connected to + their appropriate hooks as done in 0.1 + +Changes by mak (0.1a, 4 Oct 2005): + +* moved parsing process to ParserAfterStrip to support <nowiki>; it + has to be done even later to support template inclusion properly, +* changed process of storing/retrieving: no more stripping of semantic + relations before saving -- the annotations now appear exactly where + the user has put them, keeping them easier to read and maintain, +* parse only once: saving is based on the relations that were retrieved + during the earlier call of parse(); for this to work, saving needs to + be deferred -- it is currently done at ArticleSaveComplete [should + there be a dedicated hook for deferred saving?], +* enabled removal of semantic links on article deletion, +* changed layout of semantic links factsheet, including some neat grouping + feature. + +== Semantic MediaWiki 0.1 == + +This is a pre-alpha version of the Semantic MediaWiki extensions. +It includes: + +* support for typed links [[link type::link target|link label]], +* rendering of fact sheet on semantic relations at article bottom, +* Special:SearchSemantic (alpha), featuring autocompletion for + link types. diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/README.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/README.md new file mode 100644 index 00000000..e2d68464 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/README.md @@ -0,0 +1,37 @@ +This document contains resources that can improve the understanding on "How Semantic MediaWiki +works" from an implementation and development point of view. + +If you are new to SMW development, have a look at the: + +* [Programmer's guide](https://www.semantic-mediawiki.org/wiki/Programmer%27s_guide) +* [Architecture guide](https://www.semantic-mediawiki.org/wiki/Architecture_guide) +* [Developer hub](https://www.semantic-mediawiki.org/wiki/Developer_hub) and [Coding conventions](https://www.semantic-mediawiki.org/wiki/Coding_conventions) +* [Code snippets](code-snippets/README.md) + +## Overview + +- [List of hooks](hooks.md) provided by Semantic MediaWiki +- Running [unit](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/tests/phpunit/README.md), integration, and [JSONScript](https://github.com/SemanticMediaWiki/SemanticMediaWiki/tree/master/tests/phpunit/Integration/JSONScript) tests +- [api.md](api.md) provides an overview for available API modules +- [`Importer`](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/src/Importer/README.md) contains a summary about the process and technical background of the content importer +- [`Lang`](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/src/Lang/README.md) +- [`Serializers`](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/docs/technical/doc.serializers.md) contains information about the Semantic MediaWiki serializers +- [`ext.smw.suggester`](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/res/smw/suggester/README.md) on how to register additional tokens or context objects +- [`SMWSearch`](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/src/MediaWiki/Search/README.md) `Special:Search` integration + +### Store implementations + +- SQLStore + - [Overview](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/src/SQLStore/README.md) + - [QueryEngine](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/src/SQLStore/QueryEngine/README.md) + - [Installer](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/docs/technical/doc.installer.md) contains a simplified schema about the `Installer` and `TableBuilder` interface + +- SPARQLStore + - [Overview](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/src/SPARQLStore/README.md) + +- ElasticStore + - [Overview](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/src/Elastic/README.md) + +### Migration guide + +- [2.5.x to 3.0.0](https://github.com/SemanticMediaWiki/SemanticMediaWiki/blob/master/docs/technical/migration-guide-3.0.md) contains information about the migration from 2.x to 3.x diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/api.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/api.md new file mode 100644 index 00000000..1f6c6dec --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/api.md @@ -0,0 +1,175 @@ +This file contains details about [Semantic MediaWiki's API][smwapi] for external use with a description +of available interfaces. For more details on MediaWiki's WebAPI, it is recommended to read this [website][mwapi]. + +## api.php?action=ask +The `Ask API` allows you to do ask queries against Semantic MediaWiki using the MediaWiki API and get results back serialized in one of the formats it supports. + +The ask module supports one parameter, query, which takes the same string you'd feed into an `#ask` parser function, but urlencoded. + +> api.php?action=ask&query=[[Modification date::%2B]]|%3FModification date|sort%3DModification date|order%3Ddesc&format=jsonfm + +## api.php?action=askargs +The `Askargs API` module aims to take arguments in un-serialized form, so with as little ask-specific syntax as possible. It supports 3 arguments: + +* `conditions`: The query conditions, ie the requirements for a subject to be included +* `printouts`: The query printeouts, ie the properties to show per subject +* `parameters`: The query parameters, ie all non-condition and non-printeout arguments + +> api.php?action=askargs&conditions=Modification date::%2B&printouts=Modification date¶meters=|sort%3DModification date|order%3Ddesc&format=jsonfm + +#### Output serialization +```php +{ + "query-continue-offset": 50, + "query": { + "printrequests": [ + { + "label": "", + "typeid": "_wpg", + "mode": 2, + "format": false + }, + { + "label": "Modification date", + "typeid": "_dat", + "mode": 1, + "format": "" + } + ], + "results": { + "Main Page": { + "printouts": { + "Modification date": [ + "1381456128" + ] + }, + "fulltext": "Main Page", + "fullurl": "http:\/\/localhost:8080\/mw\/index.php\/Main_Page", + "namespace": 0, + "exists": true + }, + ... + }, + "meta": { + "hash": "a9abdb34024fa8735f6b044305a48619", + "count": 50, + "offset": 0 + } + } +} +``` + +## api.php?action=smwinfo +An interface to access statistical information about the properties, values etc.. + +> api.php?action=smwinfo&format=json&info=proppagecount|propcount + +The following parameters are available and may be concatenate using the "|" character. +* `proppagecount`: The total number of properties registered with a page. +* `declaredpropcount`: The total number of properties with a datatype assigned. +* `usedpropcount`: The total number of properties with at least one values assigned. +* `propcount`: The total number of property values assinged. +* `errorcount`: The total number of property values invalidly assinged. +* `querycount`: The total number of queries. +* `querysize`: The total size of all queries. +* `formatcount`: The query formats and their respective total usage count. +* `subobjectcount`: The total number of subobjects. +* `conceptcount`: The total number of concepts. + +#### Output serialization + +```php +{ + "info": { + "proppagecount": 40, + "formatcount": { + "table": 14, + "list": 3, + "broadtable": 1 + } + } +} +``` +The parameter "formatcount" will output an array of used formats together with its count information. + +## api.php?action=browsebysubject +An interface to browse facts (the equivalent of `Special:Browse`) of a subject (wikipage) including special properties and subobjects. + +> api.php?action=browsebysubject&subject=Main%20Page +> api.php?action=browsebysubject&subject=Main%20Page&subobject=_QUERYa0856d9fbd9e495af0963ecc75fcef14 + +#### Output serialization +```php +{ + "query": { + "subject": "Main_Page#0##", + "data": [ + { + "property": "Foo", + "dataitem": [ + { + "type": 2, + "item": "Bar" + } + ] + } + ... + ], + "sobj": [ + { + "subject": "Main_Page#0##_QUERYa0856d9fbd9e495af0963ecc75fcef14", + "data": [ + { + "property": "_ASKDE", + "dataitem": [ + { + "type": 1, + "item": "1" + } + ] + }, + ... + ] + ... + } + ], + "serializer": "SMW\Serializers\SemanticDataSerializer", + "version": 0.1 + } +} +``` + +## api.php?action=browsebyproperty +An interface to browse properties (the equivalent of `Special:Properties`). + +> api.php?action=browsebyproperty +> api.php?action=browsebyproperty&limit=100&format=json&property=name + +#### Output serialization + +```php +{ + "xmlns:Foaf": "http://xmlns.com/foaf/0.1/", + "query": { + "Foaf:name": { + "label": "Foaf:name", + "isUserDefined": true, + "usageCount": 2 + }, + "Has_common_name": { + "label": "Has common name", + "isUserDefined": true, + "usageCount": 1 + } + }, + "version": 0.1, + "meta": { + "limit": 100, + "count": 2, + "isCached": true + } +} +``` + +[mwapi]: https://www.mediawiki.org/wiki/API:Main_page "API:Main_page" +[smwapi]: https://www.semantic-mediawiki.org/wiki/Help:API "Help:API" diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/README.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/README.md new file mode 100644 index 00000000..21362938 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/README.md @@ -0,0 +1,10 @@ + +## Examples and code snippets + +* [register.datatype.md](register.datatype.md) Shows how to register a new dataType/dataValue +* [approve.update.md](approve.update.md) Shows how to alter the data representation in Semantic MediaWiki with the help of selected hooks in connection with the `ApprovedRevs` extension + +### Using hooks + +* [hook.datatype.inittypes.md](hook.datatype.inittypes.md) Shows how to register a new dataType/dataValue using the the `SMW::DataType::initTypes` hook +* [hook.pagecontentsavecomplete.md](hook.pagecontentsavecomplete.md) Creating subobjects using the `PageContentSaveComplete` hook (see [#2974](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2974)) diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/approve.update.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/approve.update.md new file mode 100644 index 00000000..1be387b5 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/approve.update.md @@ -0,0 +1,90 @@ +For certain user scenarios it may be necessary to refuse or alter an update by changing the revision used as basis for what the semantic data should represent. + +Please ensure that when changes are applied to [log][log] those to make them recoverable. See [`$wgLogTypes`][wgLogTypes] on how to add and use an appropriate type and action description. + +## Example + +The following can be used in connection with the `ApprovedRevs` extension to alter the data representation in Semantic MediaWiki. + +### SMW::LinksUpdate::ApprovedUpdate + +Check whether the current revision ID used by SMW is the one expected as approved version and if not, refuse its usage by returning `false` to signal that the update should be declined. + +```php +use Hooks; +use ApprovedRevs; +use LogPage; +use Xml; + +Hooks::register( 'SMW::LinksUpdate::ApprovedUpdate', function( $title, $latestRevID ) { + + if ( !class_exists( 'ApprovedRevs' ) || ( $approvedRevID = ApprovedRevs::getApprovedRevID( $title ) ) === null ) { + return true; + } + + if ( $approvedRevID != $latestRevID ) { + static $logged = []; + + // Only log the action once in case LinksUpdate is called several + // times by MediaWiki::preOutputCommit/RefreshLinksJob + if ( isset( $logged[$latestRevID . ':' . $approvedRevID] ) ) { + return false; + } + + $log = new LogPage( 'myType' ); + $rev_url = $title->getFullURL( [ 'oldid' => $approvedRevID, 'diff' => $latestRevID ] ); + + $rev_link = Xml::element( + 'a', + [ 'href' => $rev_url ], + $approvedRevID + ); + + $log->addEntry( 'myType', $title, '', [ $rev_link ] ); + $logged[$latestRevID . ':' . $approvedRevID] = true; + + return false; + } + + return true; +} ); +``` + +### SMW::Parser::ChangeRevision + +During a `UpdateJob` or `rebuildData.php` script execution, SMW always chooses the latest available revision to represent its data. Use the hook to change the revision when the approved revision is different from what the parser is going to use as basis for the update process. + +```php +use Hooks; +use ApprovedRevs; +use LogPage; +use Xml; +use Revision; + +Hooks::register( 'SMW::Parser::ChangeRevision', function( $title, &$revision ) { + + if ( !class_exists( 'ApprovedRevs' ) || ( $approvedRevID = ApprovedRevs::getApprovedRevID( $title ) ) === null ) { + return true; + } + + // Forcibly change the revision to match the approved version + $currentRevision = $revision; + $revision = Revision::newFromId( $approvedRevID ); + + $log = new LogPage( 'myType' ); + $rev_url = $title->getFullURL( array( 'oldid' => $approvedRevID ) ); + + $rev_link = Xml::element( + 'a', + [ 'href' => $rev_url ], + $approvedRevID + ); + + $log->addEntry( 'myType', $title, '', [ $rev_link ] ); + + return true; +} ); +``` + +[log]: https://www.mediawiki.org/wiki/Manual:Logging_to_Special:Log +[wgLogTypes]: https://www.mediawiki.org/wiki/Manual:$wgLogTypes diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/hook.datatype.inittypes.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/hook.datatype.inittypes.md new file mode 100644 index 00000000..67316e65 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/hook.datatype.inittypes.md @@ -0,0 +1,59 @@ +## Register new datatype + +This example shows how to register a new dataType/dataValue in Semantic MediaWiki and the convention for the datatype key is to use `___` as leading identifer to distinguish them from those defined by Semantic MediaWiki itself. + +### SMW::DataType::initTypes + +```php +use Hooks; +use Foo\DataValues\FooValue; + +Hooks::register( 'SMW::DataType::initTypes', function ( $dataTypeRegistry ) { + + $dataTypeRegistry->registerDatatype( + FooValue::TYPE_ID, + FooValue::class, + DataItem::TYPE_BLOB + ); + + $dataTypeRegistry->setOption( + 'foovalue.SomeSetting', + 42 + ); + + return true; +}; +``` + +### DataValue representation + +```php +class FooValue extends DataValue { + + /** + * DV identifier + */ + const TYPE_ID = '___foo_bar'; + + /** + * @see DataValue::parseUserValue + * @note called by DataValue::setUserValue + * + * @param string $value + */ + protected function parseUserValue( $userValue ) { + ... + } +} +``` + +### Usage + +```php +$fooValue = DataValueFactory::getInstance()->newTypeIdValue( + '___foo_bar', + 'Bar' +) + +$fooValue->getShortWikiText(); +```
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/hook.fileupload.beforeupdate.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/hook.fileupload.beforeupdate.md new file mode 100644 index 00000000..04c7c55b --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/hook.fileupload.beforeupdate.md @@ -0,0 +1,28 @@ +## SMW::FileUpload::BeforeUpdate hook + +SMW 2.4 + +```php +use SMW\DataItemFactory + +$GLOBALS['wgHooks']['SMW::FileUpload::BeforeUpdate'][] = function ( $filePage, $semanticData ) { + + $dataItemFactory = new DataItemFactory(); + + $property = $dataItemFactory->newDIProperty( '___ext_file_sha1' ); + + $semanticData->addPropertyObjectValue( + $property, + $dataItemFactory->newDIBlob( $filePage->getFile()->getSha1() ) + ); + + $property = $dataItemFactory->newDIProperty( '___ext_file_size' ); + + $semanticData->addPropertyObjectValue( + $property, + $dataItemFactory->newDIBlob( $filePage->getFile()->getSize() ) + ); + + return true; +}; +```
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/hook.pagecontentsavecomplete.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/hook.pagecontentsavecomplete.md new file mode 100644 index 00000000..59d68ce6 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/hook.pagecontentsavecomplete.md @@ -0,0 +1,99 @@ + +## PageContentSaveComplete hook + +[#2974](https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues/2974) Creating subobjects using the `PageContentSaveComplete` hook + +```php +use Hooks; +use ParserOutput; +use SMW\ApplicationFactory; +use SMW\DataValueFactory; +use SMWContainerSemanticData as ContainerSemanticData; +use SMWDIContainer as DIContainer; +use SMW\DIWikiPage; +use SMW\DIProperty; + +Hooks::register( 'PageContentSaveComplete', function( $wikiPage, $user, $content, $summary, $isMinor, $isWatch, $section, $flags, $revision, $status, $baseRevId, $undidRevId ) { + + $applicationFactory = ApplicationFactory::getInstance(); + $mwCollaboratorFactory = $applicationFactory->newMwCollaboratorFactory(); + + /** + * Initialize the ParserOuput object + */ + $editInfoProvider = $mwCollaboratorFactory->newEditInfoProvider( + $wikiPage, + $revision, + $user + ); + + $parserOutput = $editInfoProvider->fetchEditInfo()->getOutput(); + + if ( !$parserOutput instanceof ParserOutput ) { + return true; + } + + $parserData = $applicationFactory->newParserData( + $wikiPage->getTitle(), + $parserOutput + ); + + // Subject Foo ... + $subject = $parserData->getSubject(); + + // Contains the wikitext, JSON or whatever is stored for this content model + $nativeData = $content->getNativeData(); + + // Identify the content as unique + $subobjectName = '_MYCUSTOMPREFIX' . md5( $nativeData ); + + $subject = new DIWikiPage( + $subject->getDBkey(), + $subject->getNamespace(), + $subject->getInterwiki(), + $subobjectName + ); + + // Build the subobject by using a separate container object + $containerSemanticData = new ContainerSemanticData( + $subject + ); + + /** + * Start doing all the work required after this + */ + + // If one knows the details you can add it directly + $containerSemanticData->addPropertyObjectValue( + new DIProperty( 'PropertyIWantToUse' ), + new DIWikiPage( 'SomeTextItem', NS_MAIN ) + ); + + // If you don't know the type, use the DataValueFactory (see available methods) + $dataValue = DataValueFactory::getInstance()->newDataValueByText( + 'AnotherPropertyIWantToUse', + '123' + ); + + $containerSemanticData->addDataValue( + $dataValue + ); + + /** + * Done + */ + + // This part is used to add the subobject the the main subject + // Page: Foo -> gets a _MYCUSTOMPREFIX.... attached + $parserData->getSemanticData()->addPropertyObjectValue( + new DIProperty( DIProperty::TYPE_SUBOBJECT ), + new DIContainer( $containerSemanticData ) + ); + + $parserData->pushSemanticDataToParserOutput(); + + return true; + +} ); + +```
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/match.property.values.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/match.property.values.md new file mode 100644 index 00000000..87fd6761 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/match.property.values.md @@ -0,0 +1,63 @@ +Examples listed in this document require SMW 2.5. + +```php +use SMW\ApplicationFactory; + +$applicationFactory = ApplicationFactory::getInstance(); +$queryFactory = $applicationFactory->getQueryFactory(); + +$dataItemFactory = $applicationFactory->getDataItemFactory(); + +$dataValue = $applicationFactory->getDataValueFactory()->newDataValueByProperty( + $dataItemFactory->newDIProperty( 'Foo' ), + 'Bar' +); +``` +```php +$requestOptions = $queryFactory->newRequestOptions(); +$requestOptions->setLimit( 42 ); + +// Find subjects that match [[Foo::Bar]] and limit the return results to 42 +$subjectList = $applicationFactory->getStore()->getPropertySubjects( + $dataValue->getProperty(), + $dataValue->getDataItem(), + $requestOptions +); +``` +```php +$requestOptions = $queryFactory->newRequestOptions(); +$requestOptions->setLimit( 42 ); + +// Find all subjects that have a Property:Foo assigned and limit the return results to 42 +$subjectList = $applicationFactory->getStore()->getAllPropertySubjects( + $dataValue->getProperty(), + $requestOptions +); +``` +```php +$descriptionFactory = $queryFactory->newDescriptionFactory(); + +// Query [[Foo::+]] with a limit of 42 matches +$description = $descriptionFactory->newSomeProperty( + $dataValue->getProperty(), + $descriptionFactory->newThingDescription() +); + +$query = $queryFactory->newQuery( $description ); +$query->setLimit( 42 ); + +$queryResult = $applicationFactory->getStore()->getQueryResult( $query ); +``` +```php +$descriptionFactory = $queryFactory->newDescriptionFactory(); + +// [[Foo::Bar]] with a limit of 42 matches +$description = $descriptionFactory->newFromDataValue( + $dataValue +); + +$query = $queryFactory->newQuery( $description ); +$query->setLimit( 42 ); + +$queryResult = $applicationFactory->getStore()->getQueryResult( $query ); +``` diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/phpunit.test.property.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/phpunit.test.property.md new file mode 100644 index 00000000..c20eb457 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/phpunit.test.property.md @@ -0,0 +1,69 @@ +## Setup a "Text" type property + +```php +$property = new DIProperty( 'Foo' ); +$property->setPropertyTypeId( '_txt' ); + +// Using a dedicated property to created a DV +$dataValue = DataValueFactory::getInstance()->newDataValueByProperty( + $property, + 'Some text' +); + +$this->assertInstanceof( + '\SMWStringValue', + $dataValue +); + +$this->assertEquals( + 'Some text', + $dataValue->getDataItem()->getString() +); +``` + +## Using the MockBuilder + +```php +$store = $this->getMockBuilder( '\SMW\Store' ) + ->disableOriginalConstructor() + ->getMockForAbstractClass(); + +$store->expects( $this->at( 0 ) ) + ->method( 'getPropertyValues' ) + ->will( $this->returnValue( array( + new DIWikiPage( 'SomePropertyOfTypeBlob', SMW_NS_PROPERTY ) ) ) ); + +$store->expects( $this->at( 1 ) ) + ->method( 'getPropertyValues' ) + ->with( + $this->equalTo( new DIWikiPage( 'SomePropertyOfTypeBlob', SMW_NS_PROPERTY ) ), + $this->anything(), + $this->anything() ) + ->will( $this->returnValue( array( + \SMWDIUri::doUnserialize( 'http://semantic-mediawiki.org/swivt/1.0#_txt' ) ) ) ); + +// Inject the store as a mock object due to DIProperty::findPropertyTypeID finding the +// type dynamically when called without explicit declaration +ApplicationFactory::getInstance()->registerObject( 'Store', $store ); + +// Create a DV from a string value instead of using a dedicated typed +// property (used by #set, #subobject since the user input is a string and not +// a typed object) +$dataValue = DataValueFactory::getInstance()->newDataValueByText( + 'SomePropertyOfTypeBlob', + 'Some text' +); + +$this->assertInstanceof( + '\SMWStringValue', + $dataValue +); + +$this->assertEquals( + 'Some text', + $dataValue->getDataItem()->getString() +); + +// Reset instance to avoid issues with tests that follow hereafter +ApplicationFactory::getInstance()->clear(); +``` diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/query.description.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/query.description.md new file mode 100644 index 00000000..a816bbfb --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/query.description.md @@ -0,0 +1,40 @@ +```php +$descriptionFactory = new DescriptionFactory(); + +// Equivalent to [[Category:Foo]] +$classDescription = $descriptionFactory->newClassDescription( + new DIWikiPage( 'Foo', NS_CATEGORY ) +); +``` + +```php +// Equivalent to [[:+]] +$namespaceDescription = $descriptionFactory->newNamespaceDescription( + NS_MAIN +); +``` + +```php +// Equivalent to [[Foo::+]] +$anyValueForSomeProperty = $descriptionFactory->newSomeProperty( + new DIProperty( 'Foo' ), + new ThingDescription() +); +``` + +```php +// Equivalent to [[:+]][[Category:Foo]][[Foo::+]] +$description = $descriptionFactory->newConjunction( array( + $namespaceDescription, + $classDescription, + $anyValueForSomeProperty +) ); +``` + +```php +// Equivalent to [[Category:Foo]] OR [[Foo::+]] +$description = $descriptionFactory->newDisjunction( array( + $classDescription, + $anyValueForSomeProperty +) ); +```
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/query.someproperty.of.type.number.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/query.someproperty.of.type.number.md new file mode 100644 index 00000000..e3ea8cc5 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/query.someproperty.of.type.number.md @@ -0,0 +1,71 @@ +## Match distinct numeric property value + +```php +{{#ask: [[NumericProperty::1111]] + |?NumericProperty +}} +``` + +```php +// Create property instance +$property = new DIProperty( 'NumericProperty' ); +$property->setPropertyTypeId( '_num' ); + +$dataItem = new DINumber( 1111 ); + +$dataValue = DataValueFactory::getInstance()->newDataValueByItem( + $dataItem, + $property +); +``` + +```php +// Create and store the SemanticData object in order to be able to match a value +$subject = new DIWikiPage( 'Foo', NS_MAIN ) + +$semanticData = new SemanticData( $subject ); + +$semanticData->addDataValue( + $dataValue +); + +ApplicationFactory::getInstance()->getStore()->updateData( + $semanticData +); +``` + +```php +// Create a description that represents the condition +$descriptionFactory = new DescriptionFactory(); + +$description = $descriptionFactory->newSomeProperty( + $property, + $descriptionFactory->newValueDescription( $dataItem ) +); + +$propertyValue = DataValueFactory::getInstance()->newPropertyValueByLabel( + 'NumericProperty' +); + +$description->addPrintRequest( + new PrintRequest( PrintRequest::PRINT_PROP, null, $propertyValue ) +); + +// Create query object +$query = new Query( + $description +); + +$query->querymode = Query::MODE_INSTANCES; +``` + +```php +// Try to match condition against the store +$queryResult = ApplicationFactory::getInstance()->getStore()->getQueryResult( $query ); + +// PHPUnit +$this->assertEquals( + 1, + $queryResult->getCount() +); +```
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/register.datatype.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/register.datatype.md new file mode 100644 index 00000000..2f6649a5 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/register.datatype.md @@ -0,0 +1,66 @@ +## Register new datatype + +This example shows how to register a new dataType/dataValue in Semantic MediaWiki. + +* [Datatype](https://www.semantic-mediawiki.org/wiki/Help:Datatype) +* [DataValue](https://www.semantic-mediawiki.org/wiki/Help:DataValue) + +### Type registration + +All IDs must start with an underscore, two underscores indicate a truly internal +(non user-interacted type), three underscores should be used by an extension. + +`TypesRegistry::getDataTypeList` expects that the following information are provided: + +* A type id (e.g. `FooValue::TYPE_ID`) +* An associated class +* An item type (storage type) +* A declaration whether it is a subData type (e.g subobject) or not +* Whether a type is browsable or not + +<pre> +return array( + // ... + FooValue::TYPE_ID => [ FooValue::class, DataItem::TYPE_WIKIPAGE, false, false ], +); +</pre> + +<pre> +class FooValue extends DataValue { + + /** + * DV identifier + */ + const TYPE_ID = '_foo'; + + /** + * @see DataValue::parseUserValue + * + * @param string $value + */ + protected function parseUserValue( $userValue ) { + ... + } + +} +</pre> + +### Label registration + +By default, DataTypes (Date, URL etc.) are registered with a corresponding property +of the same name to match the expected semantics. For an exemption, see +`smwgDataTypePropertyExemptionList`. + +Find `i18n/extra/en.json` and extend the canonical description (which is English) with something like: + +<pre> + "dataTypeLabels":{ + "_foo": "SomeType" + ... + }, + "dataTypeAliases":{ + "SomeType": "_foo" + "ExtraAlias": "_foo" + ... + }, +</pre> diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/semanticdata.access.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/semanticdata.access.md new file mode 100644 index 00000000..adb14ed6 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/semanticdata.access.md @@ -0,0 +1,71 @@ +## Add semantic data to in-memory (#1202) + +To avoid having competing data being stored at a different point in time +during a request aimed for the same subject, property value assignments are collected +and stored in-memory before the finale `Store::updateData` process will +be invoked once. + + +```php +// Create in-memory ParserOutput transfer object +$parserData = ApplicationFactory::getInstance()->newParserData( + $parser->getTitle(), + $parser->getOutput() +); + +$subject = $parserData->getSubject(); +$property = new DIProperty( 'SomeProperty' ); + +// Add individual instances of a value for a known property +foreach ( $values as $value ) { + $dataValue = DataValueFactory::getInstance()->newDataValueByProperty( + $property, + trim( $value ), // Text value + false, + $subject + ); + + $parserData->addDataValue( $dataValue ); +} + +// Add individual instances of a value for a property only known by +// its textual representation +foreach ( $values as $value ) { + $dataValue = DataValueFactory::getInstance()->newDataValueByText( + $property, + trim( $value ), // Text value + false, + $subject + ); + + // Adds the object to the SemanticData container you could also use + // $parserData->getSemanticData()->addPropertyObjectValue( ...) + $parserData->addDataValue( $dataValue ); +} + +// Ensures that objects are pushed to the ParserOutput +$parserData->pushSemanticDataToParserOutput(); +``` + +## Access semantic data currently stored in-memory + +```php +// Create in-memory ParserOutput transfer object +$parserData = ApplicationFactory::getInstance()->newParserData( + $parser->getTitle(), + $parser->getOutput() +); + +// Access to the data store in-memory +$semanticData = $parserData->getSemanticData(); +``` + +## Read semantic data from DB + +```php +$subject = new DIWikiPage( 'Foo', NS_MAIN ); + +$semanticData = ApplicationFactory::getInstance()->getStore->getSemanticData( + $subject +); +```
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/store.subobject.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/store.subobject.md new file mode 100644 index 00000000..6d967737 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/code-snippets/store.subobject.md @@ -0,0 +1,73 @@ +## Using Subobject + +```php +$subject = new DIWikiPage( 'Foo', NS_MAIN ); + +$subobject = new Subobject( $subject->getTitle() ); +$subobject->setEmptyContainerForId( 'SomeSubobject' ); + +$dataValue = DataValueFactory::getInstance()->newDataValueByText( + 'SomeProperty, + 'SomeValue' +); + +$subobject->addDataValue( + $dataValue +); +``` + +```php +// Create and store SemanticData object and add the subobject +$semanticData = new SemanticData( $subject ); + +$semanticData->addPropertyObjectValue( + $subobject->getProperty(), + $subobject->getContainer() +); + +ApplicationFactory::getInstance()->getStore()->updateData( + $semanticData +); +``` + +## Using DIContainer + +```php +$subject = new DIWikiPage( 'Foo', NS_MAIN ); + +// Internal subobject reference +$subobjectName = 'SomeSubobject'; + +$containerSubject = new DIWikiPage( + $subject->getDBkey(), + $subject->getNamespace(), + $subject->getInterwiki(), + $subobjectName +); + +// Create container to host property values assignments +// for the particular subobjectName +$containerSemanticData = new ContainerSemanticData( $containerSubject ); + +$dataValue = DataValueFactory::getInstance()->newDataValueByText( + 'SomeProperty, + 'SomeValue' +); + +$containerSemanticData->addDataValue( + $dataValue +); +``` +```php +// Create and store SemanticData object and add the subobject +$semanticData = new SemanticData( $subject ); + +$semanticData->addPropertyObjectValue( + new DIProperty( '_SOBJ' ), + new DIContainer( $containerSemanticData ) +); + +ApplicationFactory::getInstance()->getStore()->updateData( + $semanticData +); +```
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/doc.installer.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/doc.installer.md new file mode 100644 index 00000000..4c5efa85 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/doc.installer.md @@ -0,0 +1 @@ +
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/doc.serializers.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/doc.serializers.md new file mode 100644 index 00000000..58ded396 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/doc.serializers.md @@ -0,0 +1,133 @@ +This document contains information about Semantic MediaWiki serializers. + +## Components + +### Serializer and Deserializer +Interfaces provided by the [Serialization extension][serialization] which describes specific serialize/deserialze public methods. + +### SerializerFactory +A factory class that assigns registered serializers to an object and identifies an unserializer based on the invoked array. A serialized record has a reference to the generator (serializer) class which will automatically be used during unserialization. Each record includes a version number to compare the data model used and enable a consistency check before an attempt to unserialize a record. + +```php +$foo = new Foo( ... ); +$serialized = SerializerFactory::serialize( $foo ); +$unserialized = SerializerFactory::deserialize( $serialized ); +``` + +### SemanticDataSerializer +Implements the Serializer interface for the SMW\SemanticData object. + +#### Data model +```php +"subject": -> Subject serialization, +"data": [ + { + "property": -> Property serialization, + "dataitem": [ + { + "type": -> DataItemType, + "item": -> DataItem serialization + } + ] + } +] +"sobj": [ + { + "subject": ..., + "data": [ + { + "property": ..., + "dataitem": [ + { + "type": ..., + "item": ... + } + ] + }, + }, +], +"serializer": -> Class of the generator and entry point for the un-serializer, +"version": -> Number to compare structural integrity between serialization and un-serialization +``` +#### Example +For a page called "Foo" that contains <code>[[Has property::Bar]]</code>, <code>{{#subobject:|Has subobjects=Bam}}</code>, <code>{{#ask:[[Has subobjects::Bam]]}}</code>, the Serializer will output: + +```php +"subject": "Foo#0##", +"data": [ + { + "property": "Has_property", + "dataitem": [ + { + "type": 9, + "item": "Bar#0##" + } + ] + }, + { + "property": "_ASK", + "dataitem": [ + { + "type": 9, + "item": "Foo#0##_QUERYc8606da8f325fc05aa8e8b958821c3b4" + } + ] + }, + ... + { + "property": "_SOBJ", + "dataitem": [ + { + "type": 9, + "item": "Foo#0##_fc4b104aabf80eb06429e946aa8f7070" + } + ] + } +], +"sobj": [ + { + "subject": "Foo#0##_QUERYc8606da8f325fc05aa8e8b958821c3b4", + "data": [ + { + "property": "_ASKDE", + "dataitem": [ + { + "type": 1, + "item": "1" + } + ] + }, + }, + ... + { + "subject": "Foo#0##_fc4b104aabf80eb06429e946aa8f7070", + "data": [ + { + "property": "Has_subobjects", + "dataitem": [ + { + "type": 9, + "item": "Bam#0##" + } + ] + }, + { + "property": "_SKEY", + "dataitem": [ + { + "type": 2, + "item": "Foo" + } + ] + } + ] + } +], +"serializer": "SMW\\Serializers\\SemanticDataSerializer", +"version": 0.1 +``` + +### QueryResultSerializer +Implements the SerializerInterface for the SMWQueryResult object. + +[serialization]: [https://github.com/wikimedia/mediawiki-extensions-Serialization] diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/doxygen.php b/www/wiki/extensions/SemanticMediaWiki/docs/technical/doxygen.php new file mode 100644 index 00000000..8f9192b9 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/doxygen.php @@ -0,0 +1,196 @@ +<?php + +die("Not a valid entry point\n"); + +/** + * This file does not hold any code. It is used mainly during the doxygen + * auto-documentation process + * + * @file + */ + +/** + * @mainpage Introduction + * + * Welcome to the auto-generated Semantic MediaWiki code documentation + * + * For information about how to install or configure Semantic MediaWiki, + * please visit the main site: + * + * https://www.semantic-mediawiki.org/ + */ + +/** + * This file does not hold any code. It is used mainly during the doxygen + * auto-documentation process + * + * @file + */ + +/** + * This group contains members that are related to the Semantic MediaWiki Api + * + * @defgroup Api Api + * @ingroup SMW + */ + +/** + * This group contains members that are related to the Store interface + * + * @defgroup Store Store + * @ingroup SMW + */ + +/** + * This group contains members that are related to the SQLStore implementation + * + * @defgroup SQLStore SQLStore + * @ingroup Store + */ + +/** + * This group contains members that are related to the Collector interface + * + * @defgroup Collector Collector + * @ingroup Store + */ + +/** + * This group contains members that are related to message, error, and parameter + * formatting + * + * @defgroup Formatter Formatter + * @ingroup SMW + */ + +/** + * This group contains members that are related to hooks, hook events, and + * hook registrations + * + * @see https://www.mediawiki.org/wiki/Manual:Hooks + * @see https://semantic-mediawiki.org/wiki/Hooks + * + * @defgroup FunctionHook FunctionHook + * @ingroup SMW + */ + +/** + * This group contains members that are related to parser hooks and functions + * + * @defgroup ParserFunction ParserFunction + * @ingroup SMW + */ + +/** + * This group contains members that are related to special pages + * + * @see https://www.mediawiki.org/wiki/Manual:Special_pages + * + * @defgroup SpecialPage SpecialPage + * @ingroup SMW + */ + +/** + * This group contains members that are related to jobs + * + * @defgroup Job Job + * @ingroup SMW + */ + +/** + * This group contains members that are related to maintenance scripts + * + * @defgroup Maintenance Maintenance + * @ingroup SMW + */ + +/** + * This group contains members that are related to utility classes and support + * functions + * + * @defgroup Utility Utility + * @ingroup SMW + */ + +/** + * This group contains members that are related to supporting the Observer + * + * @defgroup Observer Observer + * @ingroup Utility + */ + +/** + * This group contains members that are related to supporting the Dependency + * Injection Framework + * + * @defgroup DependencyInjection Dependency Injection + * @ingroup Utility + */ + +/** + * This group contains members that are related to building of Dependency + * Injection objects + * + * @defgroup DependencyBuilder Dependency Builder + * @ingroup DependencyInjection + */ + +/** + * This group contains members that are related for requesting a Dependency + * Injection + * + * @defgroup DependencyRequestor Dependency Requestor + * @ingroup DependencyInjection + */ + +/** + * This group contains members that are related for speficcation of Dependency + * Objects + * + * @defgroup DependencyContainer Dependency Container + * @ingroup DependencyInjection + */ + +/** + * This group contains members that are related to handler classes (including + * object handler, hooks handler, instance handler etc.) + * + * @defgroup Handler Handler + * @ingroup Utility + */ + +/** + * This group contains members that are related to unit tests + * + * @defgroup Test Test + * @ingroup SMW + */ + +/** + * This group contains members that are related to the QueryPrinter unit tests + * + * @defgroup QueryPrinterTest QueryPrinterTest + * @ingroup Test + */ + +/** + * This group contains members that are related to the maintenance script unit + * tests + * + * @defgroup MaintenanceTest MaintenanceTest + * @ingroup Test + */ + +/** + * This group contains members that are related to the Store unit tests + * + * @defgroup StoreTest StoreTest + * @ingroup Test + */ + +/** + * This group contains members that are related to the SQLStore unit tests + * + * @defgroup SQLStoreTest SQLStoreTest + * @ingroup StoreTest + */ diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/hooks.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/hooks.md new file mode 100644 index 00000000..b89bfefb --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/hooks.md @@ -0,0 +1,405 @@ +This document contains details about event handlers (also known as [Hooks][hooks]) provided by Semantic MediaWiki to enable users to extent and integrate custom specific solutions. + +Implementing a hook should be made in consideration of the expected performance impact for the front-end (additional DB read/write transactions etc.) and/or the back-end (prolonged job backlog etc.) process. + +# List of available hooks + +## 1.9 + +- `SMW::Factbox::BeforeContentGeneration` to replace or amend text elements shown in a Factbox. See also `$smwgFactboxUseCache` settings.<sup>Use of `smwShowFactbox` was deprecated with 1.9</sup> +- `SMW::Job::updatePropertyJobs` to add additional update jobs for a property and related subjects.<sup>Use of `smwUpdatePropertySubjects` was deprecated with 1.9</sup> +- `SMW::DataType::initTypes` to add additional DataType support.<sup>Use of `smwInitDatatypes` was deprecated with 1.9</sup> +- `SMW::SQLStore::updatePropertyTableDefinitions` to add additional table definitions during initialization. + +## 2.1 + +### SMW::Store::BeforeQueryResultLookupComplete + +* Version: 2.1 +* Description: Hook to return a `QueryResult` object before the standard selection process is started and allows to suppress the standard selection process completely by returning `false`. +* Reference class: `SMW_SQLStore3.php` + +<pre> +\Hooks::register( 'SMW::Store::AfterQueryResultLookupComplete', function( $store, $query, &$queryResult, $queryEngine ) { + + // Allow default processing + return true; + + // Stop further processing + return false; +} ); +</pre> + +### SMW::Store::AfterQueryResultLookupComplete + +* Version: 2.1 +* Description: Hook to manipulate a `QueryResult` after the selection process. +* Reference class: `SMW_SQLStore3.php` + +<pre> +\Hooks::register( 'SMW::Store::AfterQueryResultLookupComplete', function( $store, &$queryResult ) { + + return true; +} ); +</pre> + +### SMW::Property::initProperties + +* Version: 2.1 +* Description: Hook to add additional predefined properties (`smwInitProperties` was deprecated with 2.1) +* Reference class: `SMW\PropertyRegistry` + +<pre> +\Hooks::register( 'SMW::Property::initProperties', function( $propertyRegistry ) { + + return true; +} ); +</pre> + +### SMW::SQLStore::BeforeDeleteSubjectComplete + +* Version: 2.1 +* Description: Hook is called before the deletion of a subject is completed +* Reference class: `SMW_SQLStore3_Writers.php` + +<pre> +\Hooks::register( 'SMW::SQLStore::BeforeDeleteSubjectComplete', function( $store, $title ) { + + return true; +} ); +</pre> + +### SMW::SQLStore::AfterDeleteSubjectComplete + +* Version: 2.1 +* Description: Hook is called after the deletion of a subject is completed +* Reference class: `SMW_SQLStore3_Writers.php` + +<pre> +\Hooks::register( 'SMW::SQLStore::AfterDeleteSubjectComplete', function( $store, $title ) { + + return true; +} ); +</pre> + +### SMW::SQLStore::BeforeChangeTitleComplete + +* Version: 2.1 +* Description: Hook is called before change to a subject is completed +* Reference class: `SMW_SQLStore3_Writers.php` + +<pre> +\Hooks::register( 'SMW::SQLStore::BeforeChangeTitleComplete', function( $store, $oldTitle, $newTitle, $pageId, $redirectId ) { + + return true; +} ); +</pre> + +## 2.2 + +### SMW::Parser::BeforeMagicWordsFinder + +* Version: 2.2 +* Description: Hook allowing to extend the magic words list that the `InTextAnnotationParser` should search for the wikitext. +* Reference class: `\SMW\InTextAnnotationParser` + +<pre> +\Hooks::register( 'SMW::Parser::BeforeMagicWordsFinder', function( array &$magicWords ) { + + return true; +} ); +</pre> + +## 2.3 + +### SMW::SQLStore::BeforeDataRebuildJobInserts + +* Version: 2.3 +* Description: Hook to add update jobs while running the rebuild process.<sup>Use of `smwRefreshDataJobs` was deprecated with 2.3</sup> +* Reference class: `\SMW\SQLStore\EntityRebuildDispatcher` + +<pre> +\Hooks::register( 'SMW::SQLStore::BeforeDataRebuildJobInsert', function( $store, array &$jobs ) { + + return true; +} ); +</pre> + +### SMW::SQLStore::AddCustomFixedPropertyTables + +* Version: 2.3 +* Description: Hook to add fixed property table definitions +* Reference class: `\SMW\MediaWiki\Specials\Browse\ContentsBuilder` + +<pre> +\Hooks::register( 'SMW::SQLStore::AddCustomFixedPropertyTables', function( array &$customFixedProperties, &$propertyTablePrefix ) { + $customFixedProperties['Foo'] = '_Bar'; + + return true; +} ); +</pre> + +### SMW::Browse::AfterIncomingPropertiesLookupComplete + +* Version: 2.3 +* Description: Hook to extend the incoming properties display for `Special:Browse` +* Reference class: `\SMW\MediaWiki\Specials\Browse\ContentsBuilder` + +<pre> +\Hooks::register( 'SMW::Browse::AfterIncomingPropertiesLookupComplete', function( $store, $semanticData, $requestOptions ) { + + return true; +} ); +</pre> + +### SMW::Browse::BeforeIncomingPropertyValuesFurtherLinkCreate + +* Version: 2.3 +* Description: Hook to replace the standard `SearchByProperty` with a custom link to an extended list of results (return `false` to replace the link) +* Reference class: `\SMW\MediaWiki\Specials\Browse\ContentsBuilder` + +<pre> +\Hooks::register( 'SMW::Browse::BeforeIncomingPropertyValuesFurtherLinkCreate', function( $property, $subject, &$propertyValue ) { + + return true; +} ); +</pre> + +### SMW::SQLStore::AfterDataUpdateComplete + +* Version: 2.3 +* Description: Hook to add processing after the update has been completed and provides `ChangeOp` to identify entities that have been added/removed during the update. (`SMWSQLStore3::updateDataAfter` was deprecated with 2.3) + +<pre> +\Hooks::register( 'SMW::SQLStore::AfterDataUpdateComplete', function( $store, $semanticData, $changeOp ) { + + return true; +} ); +</pre> + +## 2.4 + +### SMW::FileUpload::BeforeUpdate + +* Version: 2.4 +* Description: Hook to add extra annotations before the `Store` update is triggered + +<pre> +\Hooks::register( 'SMW::FileUpload::BeforeUpdate', function( $filePage, $semanticData ) { + + return true; +} ); +</pre> + +## 2.5 + +### SMW::Job::AfterUpdateDispatcherJobComplete + +* Version: 2.5 +* Description: Hook allows to add extra jobs after `UpdateDispatcherJob` has been processed. +* Reference class: `\SMW\MediaWiki\Jobs\UpdateDispatcherJob` + +<pre> +\Hooks::register( 'SMW::Job::AfterUpdateDispatcherJobComplete', function( $job ) { + + // Find related dependencies + $title = $job->getTitle(); + + return true; +} ); +</pre> + +### SMW::SQLStore::Installer::AfterCreateTablesComplete + +* Version: 2.5 +* Description: Hook allows to add extra tables after the creation process as been finalized. +* Reference class: `\SMW\SQLStore\Installer` + +<pre> +\Hooks::register( 'SMW::SQLStore::Installer::AfterCreateTablesComplete', function( $tableBuilder, $messageReporter ) { + + // Output details on the activity + $messageReporter->reportMessage( '...' ); + + // See documentation in the available TableBuilder interface + $tableBuilder->create( ... ); + + return true; +} ); +</pre> + +### SMW::SQLStore::Installer::AfterDropTablesComplete + +* Version: 2.5 +* Description: Hook allows to remove extra tables after the drop process as been finalized. +* Reference class: `\SMW\SQLStore\Installer` + +<pre> +\Hooks::register( 'SMW::SQLStore::Installer::AfterDropTablesComplete', function( $tableBuilder, $messageReporter ) { + + // Output details on the activity + $messageReporter->reportMessage( '...' ); + + // See documentation in the available TableBuilder interface + $tableBuilder->drop( ... ); + + return true; +} ); +</pre> + +## 3.0 + +### SMW::GetPreferences + +* Version: 3.0 +* Description: Hook allows to add extra preferences that are ordered on the Semantic MediaWiki user preference tab +* Reference class: `\SMW\MediaWiki\Hooks\GetPreferences` + +<pre> +\Hooks::register( 'SMW::GetPreferences', function( $user, &$preferences ) { + + + return true; +} ); +</pre> + +### SMW::Setup::AfterInitializationComplete + +* Version: 3.0 +* Description: Hook allows to modify global configuration after initialization of Semantic MediaWiki is completed +* Reference class: `\SMW\Setup` + +<pre> +use Hooks; + +Hooks::register( 'SMW::Setup::AfterInitializationComplete', function( &$vars ) { + + // #2565 + unset( $GLOBALS['wgGroupPermissions']['smwcurator'] ); + + return true; +} ); +</pre> + +### SMW::Exporter::Controller::AddExpData + +* Version: 3.0 +* Description: Hook allows to add additional RDF data for a selected page (was `smwAddToRDFExport`) +* Reference class: `SMWExportController` + +<pre> +use Hooks; + +Hooks::register( 'SMW::Exporter::Controller::AddExpData', function( DIWikiPage $subject, &$expDataList, $hasRecursionDepth, $withBacklinks ) { + + // $expData = new ExpData( ... ); + // $expDataList[] = $expData; + + return true; +} ); +</pre> + +### SMW::SQLStore::EntityReferenceCleanUpComplete + +* Version: 3.0 +* Description: Hook allows to get information about which entities have been removed +* Reference class: `PropertyTableIdReferenceDisposer` + +<pre> +use Hooks; + +Hooks::register( 'SMW::SQLStore::EntityReferenceCleanUpComplete', function( $store, $id, $subject, $isRedirect ) { + + return true; +} ); +</pre> + +### SMW::LinksUpdate::ApprovedUpdate + +* Version: 3.0 +* Description: Hook allows to suppress an update where for example the `latestRevID` is not the revision that is approved an should not be used for the `SemanticData` representation. +* Reference class: `SMW\MediaWiki\Hooks\LinksUpdateConstructed` + +If you do suppress a revision, please log the event and make it visible to a user (or administrator) that an update was refused. + +<pre> +use Hooks; + +Hooks::register( 'SMW::LinksUpdate::ApprovedUpdate', function( $title, $latestRevID ) { + + // If you need to decline an update + // return false; + + return true; +} ); +</pre> + +### SMW::Parser::ChangeRevision + +* Version: 3.0 +* Description: Hook allows to forcibly change a revision used during content parsing as in case of the `UpdateJob` execution or when running `rebuildData.php`. +* Reference class: `SMW\ContentParser` + +If you do alter a revision, please log the event and make it visible to a user (or administrator) that it was changed. + +<pre> +use Hooks; + +Hooks::register( 'SMW::Parser::ChangeRevision', function( $title, &$revision ) { + + // Set a revision + // $revision = \Revision::newFromId( $id ); + + return true; +} ); +</pre> + +### SMW::Admin::TaskHandlerFactory + +* Version: 3.0 +* Description: Hook allows to extend available `TaskHandler` in `Special:SemanticMediaWiki` +* Reference class: `SMW\MediaWiki\Specials\Admin\TaskHandlerFactory` + +<pre> +use Hooks; + +Hooks::register( 'SMW::Admin::TaskHandlerFactory', function( &$taskHandlers, $store, $outputFormatter, $user ) { + + // Instance of TaskHandler + // $taskHandlers[] = new FooTaskHandler(); + + return true; +} ); +</pre> + +### SMW::DataUpdater::ContentProcessor + +* Version: 3.0 +* Description: Hook allows to extend the `SemanticData` with information from the `Content` object +* Reference class: `SMW\DataUpdater` + +<pre> +use Hooks; + +Hooks::register( 'SMW::DataUpdater::ContentProcessor', function( $semanticData, $content ) { + + if ( $content->getModel() === ' ... ' ) { + // $data = $content->getNativeData(); + // ... + // $semanticData->addPropertyObjectValue( ... ); + } + + return true; +} ); +</pre> + +## Other available hooks + +Subsequent hooks should be renamed to follow a common naming practice that help distinguish them from other hook providers. In any case this list needs details and examples. + +* `SMWParamFormat`, SMWResultFormat +* `\SMW\Store`, SMWStore::updateDataBefore (SMW::Store::BeforeDataUpdateComplete) +* `\SMW\Store`, SMWStore::updateDataAfter (SMW::Store::AfterDataUpdateComplete) +* `SMWSQLStore3Writers`, SMWSQLStore3::updateDataBefore (SMW::SQLStore::BeforeDataUpdateComplete) + +[hooks]: https://www.mediawiki.org/wiki/Hooks "Manual:Hooks" diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/jsduck.categories.json b/www/wiki/extensions/SemanticMediaWiki/docs/technical/jsduck.categories.json new file mode 100644 index 00000000..ee644218 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/jsduck.categories.json @@ -0,0 +1,83 @@ +[ + { + "name": "General", + "groups": [ + { + "name": "Instance", + "classes": ["smw"] + } + ] + }, + { + "name": "DataModel", + "groups": [ + { + "name": "Factory", + "classes": [ + "smw.Data" + ] + }, + { + "name": "General", + "classes": [ + "smw.dataItem*", + "smw.dataValue*" + ] + } + ] + }, + { + "name": "Api", + "groups": [ + { + "name": "General", + "classes": ["smw.Api*"] + }, + { + "name": "Query", + "classes": ["smw.Query*"] + } + ] + }, + { + "name": "Utilities", + "groups": [ + { + "name": "General", + "classes": ["smw.util*"] + }, + { + "name": "Support", + "classes": ["smw.setting*","smw.async*"] + }, + { + "name": "Formats", + "classes": ["smw.formats*"] + } + ] + }, + { + "name": "Test", + "groups": [ + { + "name": "QUnit", + "classes": ["QUnit", "QUnit.assert"] + } + ] + }, + { + "name": "Upstream", + "groups": [ + { + "name": "jQuery", + "classes": ["jQuery", "jQuery.Event", "jQuery.Promise", "jQuery.Deferred", "jQuery.jqXHR", "QUnit"] + }, + { + "name": "JavaScript", + "classes": [ + "Array", "Boolean", "Date", "Function", "Number", "Object", "RegExp", "String" + ] + } + ] + } +]
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/jsduck.json b/www/wiki/extensions/SemanticMediaWiki/docs/technical/jsduck.json new file mode 100644 index 00000000..824916dc --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/jsduck.json @@ -0,0 +1,11 @@ +{ + "--title": "Semantic MediaWiki Code Documentation", + "--categories": "../docs/jsduck.categories.json", + "--warnings": ["-no_doc"], + "--builtin-classes": true, + "--external": "HTMLDocument,Window", + "--":[ + "../resources/docs", + "../resources/smw" + ] +}
\ No newline at end of file diff --git a/www/wiki/extensions/SemanticMediaWiki/docs/technical/migration-guide-3.0.md b/www/wiki/extensions/SemanticMediaWiki/docs/technical/migration-guide-3.0.md new file mode 100644 index 00000000..590bd815 --- /dev/null +++ b/www/wiki/extensions/SemanticMediaWiki/docs/technical/migration-guide-3.0.md @@ -0,0 +1,67 @@ +# Migration guide + +This document contains migration information both for users and administratiors as well as developers when upgrading from Semantic MediaWiki 2.5.x to Semantic MediaWiki 3.0.x. Please consult the respective RELEASE-NOTES when upgrading from an earlier version of Semantic MediaWiki. + +## Users and administrators + +### List formats (incl. list, ol, ul, template) + +* Wrapped components of the `list` format in HTML elements +* Added class attributes to HTML elements of `list`, `ol` and `ul` formats to facilitate styling +* Added `plainlist`format +* `template` format becomes alias of the `plainlist` format +* `template` parameter is used when present, even if format is not `template` +* Standardized parameters to templates: All standard parameters start with a `#` +* Dedicated separators for values, properties and result "rows": `sep`, `propsep`, `valuesep` +* Removed final list separator (", and") +* Removed `?` as prefix for template arguments +* Removed `template arguments` parameter +* Removed `columns` parameter + +For details also see the [change description.](https://gist.github.com/s7eph4n/277e7804fe04954df7d1e15ae874b0d0) + +### Maintenance scripts + +- If you are still using maintenance scripts starting with the `SMW_` prefix you must now migrate to the new maintenance spript names. See the help pages on [maintenance scrips](https://www.semantic-mediawiki.org/wiki/Help:Maintenance_scripts) for further information. + +### Resources export + +- Resources are now being exported as Internationalized Resource Identifiers (IRI). + This means that the URIs are now being exported using Universal Coded Character Set (UCS) instead of American Standard Code for Information Interchange (ASCII). See the help page on configuration parameter [`$smwgExportResourcesAsIri`](https://www.semantic-mediawiki.org/wiki/Help:$smwgExportResourcesAsIri) for further information. + +## Developers + +### Removed classes and methods + +- Removed `DIProperty::findPropertyID`, deprecated since 2.1, use PropertyRegistry::findPropertyIdByLabel +- Removed `DIProperty::getPredefinedPropertyTypeId`, deprecated since 2.1, use PropertyRegistry::getPropertyValueTypeById +- Removed `DIProperty::findPropertyLabel`, deprecated since 2.1, use PropertyRegistry::findPropertyLabelById +- Removed `DIProperty::registerProperty`, deprecated since 2.1, use PropertyRegistry::registerProperty +- Removed `DIProperty::registerPropertyAlias`, deprecated since 2.1, use PropertyRegistry::registerPropertyAlias +- Deprecated `PropertyValue::makeUserProperty`, use DataValueFactory::getInstance()->newPropertyValueByLabel; +- Removed `PropertyValue::makeProperty`, use DataValueFactory + +### Hooks + +- Renamed `smwAddToRDFExport` to `SMW::Exporter::Controller::AddExpData` + +### Store + +- `Store::getPropertySubjects` is to return an `Iterator` hence an `array` type check should be avoided and if necessary +use `iterator_to_array` to transform a result instance into a standard array + +#### Register predefined property + +<pre> +\Hooks::register( 'SMW::Property::initProperties', function( $propertyRegistry ) { + + $propertyRegistry->registerProperty( '__FOO', '_txt', 'Foo' ); + + $propertyRegistry->registerPropertyDescriptionByMsgKey( + '__FOO', + 'a-mediawiki-msg-key-with-a-description' + ); + + return true; +} ); +</pre> |