Provides extra special properties to Semantic MediaWiki.
Go to file
ZoruaFox 5993cb630f
Merge branch 'SemanticMediaWiki:master' into master
2024-05-05 02:54:35 +08:00
.github Create FUNDING.yml 2023-12-14 17:53:46 +01:00
data Update the underlying schema for SMW 3.2. (#150) 2024-05-03 17:35:44 +02:00
docs Property type: record (formally page). 2022-02-07 11:13:19 +07:00
i18n Localisation updates from https://translatewiki.net. 2024-04-22 14:12:50 +02:00
src Remove creation of dynamic property (#225) 2024-01-10 20:24:45 +01:00
tests replace deprecated `SMWStore::updateDataBefore` hook with `SMW::Store::BeforeDataUpdateComplete`, CI: AR 1.8.1 → 1.8.2 2023-04-06 13:56:10 +02:00
.dockerignore CI with make/docker-compose 2023-03-23 15:23:16 +01:00
.gitignore remove .env 2023-07-05 12:08:40 +02:00
.jshintignore Add DefinitionReader 2014-04-19 08:56:04 +09:00
COPYING Update COPYING 2015-01-06 23:44:10 +01:00
Dockerfile fix smw install smwgConfigFileDir 2023-07-05 12:01:58 +02:00
Makefile remove releasing section since not needed here 2023-07-05 12:17:19 +02:00
README.md fix CI badge 2023-03-24 09:12:39 +01:00
RELEASE-NOTES.md Update RELEASE-NOTES.md 2023-12-26 00:24:31 +01:00
codecov.yml Update codecov.yml 2021-11-20 13:32:05 +01:00
composer.json Update composer.json 2024-04-10 12:17:34 +08:00
docker-compose-ci.yml WIP commit 2023-07-05 11:57:57 +02:00
docker-compose-dev.yml WIP commit 2023-07-05 11:57:57 +02:00
docker-compose.yml WIP commit 2023-07-05 11:57:57 +02:00
env.template WIP commit 2023-07-05 11:57:57 +02:00
extension.json Update extension.json 2023-12-26 00:23:08 +01:00
phpunit.xml.dist Add additional properties for AR (#98) 2018-02-03 13:25:14 +00:00

README.md

Semantic Extra Special Properties

CI codecov Latest Stable Version Packagist download count

Semantic Extra Special Properties is a Semantic MediaWiki extension that adds some extra special properties.

Requirements

  • PHP 7.3 or later
  • MediaWiki 1.35 or later, tested up to MediaWiki 1.39
  • Semantic MediaWiki 3.1 or later, tested up to SMW 4.1

Installation

The recommended way to install Semantic Extra Special Properties is using Composer with MediaWiki's built-in support for Composer.

Note that the required extension Semantic MediaWiki must be installed first according to the installation instructions provided.

Step 1

Change to the base directory of your MediaWiki installation. If you do not have a "composer.local.json" file yet, create one and add the following content to it:

{
	"require": {
		"mediawiki/semantic-extra-special-properties": "~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-extra-special-properties": "~3.0"

Remember to add a comma to the end of the preceding line in this section.

Step 2

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.

Step 3

Add the following line to the end of your "LocalSettings.php" file:

wfLoadExtension( 'SemanticExtraSpecialProperties' );

Step 4

Add the configuration parameters to the "LocalSettings.php" file according to your requirements below the call to wfLoadExtension added in step 4.

Step 5

This step may be skipped in case you are installing this extension for the first time to the respective wiki. If this extension is being upgraded from an version earlier than 2.0.0 you have to change your configruation in the "LocalSettings.php" file according to the consise migration guide.

Step 6

Run the "update.php" maintenance script to ensure that property tables are properly initialized.

Usage

The annotation process for predefined properties is mostly done in the background and therefore does not need any special interaction from a user but "LocalSettings.php" for SESP need to be enabled.

For details about available configruation parameters, please have a look at the configuration document.

Exif property names

You might want to check the labels for Exif properties. They are defined in MediaWiki core and being reused by SESP. It is possible that property names you already use will be prefedinied properties after activation of SESP. On the sepcial page "System messages" you can search for all messages with the prefix "Exif". One example: there is the message Exif-source that has the label "Source". If you use a property labeled "Source" already, you should change MediaWiki:Exif-source from "Source" to "Exif-source".

Contribution and support

If you have remarks, questions, or suggestions, please send them to semediawiki-users@lists.sourceforge.net. You can subscribe to this list here.

If you want to contribute work to the project please subscribe to the developers mailing list and have a look at the contribution guildline. A list of people who have made contributions in the past can be found here.

Tests

This extension provides unit and integration tests that are run by a continuous integration platform but can also be executed using composer phpunit from the extension base directory.

License

GNU General Public License 2.0 or later

Release notes

View the release notes