Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/professionalwiki/semanticbundle

Allows to install and load Semantic MediaWiki and associated extensions in one go
https://github.com/professionalwiki/semanticbundle

bundle mediawiki mediawiki-extension mediawiki-installation semantic semantic-mediawiki smw

Last synced: 3 months ago
JSON representation

Allows to install and load Semantic MediaWiki and associated extensions in one go

Awesome Lists containing this project

README 

        
# Semantic Bundle



![Latest Stable Version](https://img.shields.io/packagist/v/mediawiki/semantic-bundle.svg)

![Total Download Count](https://img.shields.io/packagist/dt/mediawiki/semantic-bundle.svg)



Bundle extension that installs and loads Semantic MediaWiki and associated extensions.



This bundle is for everyone who wants to get the full Semantic MediaWiki experience without

individually install all extensions or figure out what those extensions are in the first place.



Semantic Bundle is maintained by [Professional Wiki]. Contact us for [MediaWiki development], [managed wiki hosting], or [MediaWiki support], including [Semantic MediaWiki support].



## Bundled extensions



* **[Semantic MediaWiki](https://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki)** – Allows storing structured data in pages and querying it

* **[Semantic Compound Queries](https://www.mediawiki.org/wiki/Extension:Semantic_Compound_Queries)** – Provides a parser function that displays multiple semantic queries at the same time

* **[Semantic Extra Special Properties](https://www.mediawiki.org/wiki/Extension:Semantic_Extra_Special_Properties)** – Adds extra special properties to all pages

* **[Semantic Result Formats](https://www.mediawiki.org/wiki/Extension:Semantic_Result_Formats)** – Provides additional formats for semantic queries

* **[Maps](https://www.mediawiki.org/wiki/Extension:Maps)** – Allows embedding of dynamic maps, geocoding, and geospatial operations

* **[Mermaid](https://www.mediawiki.org/wiki/Extension:Mermaid)** – Provides a parser function to generate diagrams and flowcharts with the help of the mermaid script language

* **[Modern Timeline](https://www.mediawiki.org/wiki/Extension:Modern_Timeline)** – Provides a modern timeline visualization for Semantic MediaWiki as a result format

* **[Page Forms](https://www.mediawiki.org/wiki/Extension:Page_Forms)** – Allows editing pages via user-defined forms



Only in Semantic Bundle 5.0 and earlier:



* **[Semantic Breadcrumb Links](https://www.mediawiki.org/wiki/Extension:Semantic_Breadcrumb_Links)** – Allows building breadcrumb links using semantic annotations

* **[Semantic Cite](https://www.mediawiki.org/wiki/Extension:Semantic_Cite)** – Allows managing citation resources using semantic annotations

* **[Semantic Interlanguage Links](https://www.mediawiki.org/wiki/Extension:Semantic_Interlanguage_Links)** – Allows creating and managing interlanguage links with semantic annotations

* **[Semantic Meta Tags](https://www.mediawiki.org/wiki/Extension:Semantic_Meta_Tags)** – Allows extending the meta elements in the HTML header of a page with content generated from semantic annotations



## Semantic Bundle Versions



	

		Semantic Bundle

		Supported PHP

		Supported MediaWiki

		Bundled SMW

	

    

		6.1.0

		7.4 - 8.2

		1.35 - 1.41

		~4.2.0

	

    

		6.0.0

		7.4 - 8.1

		1.35 - 1.38

		~4.0.1

	

	

		5.0.0

		7.1 - 7.4

		1.31 - 1.35

		~3.2.0

	



## Installation



Semantic Bundle is installed using [Composer](https://getcomposer.org) with

[MediaWiki's built-in support for Composer](https://www.mediawiki.org/wiki/Composer).



### Step 1/3: composer update



Change to the base directory of your MediaWiki installation and execute these two commands:

```

COMPOSER=composer.local.json composer require --no-update mediawiki/semantic-bundle:~6.1

```

```

composer update mediawiki/semantic-bundle --no-dev -o

```  

### Step 2/3: modify LocalSettings.php



Add the following two lines to the end of your

["LocalSettings.php" file](https://www.mediawiki.org/wiki/Manual:LocalSettings.php):



```php

require_once __DIR__ . '/extensions/SemanticBundle/SemanticBundle.php';

enableSemantics( 'example.org' );

```



Update the `enableSemantics` line with your domain name.

For more information, see the

[enableSemantics documentation](https://www.semantic-mediawiki.org/wiki/Help:EnableSemantics).



### Step 3/3: run update.php



Run the [update.php script](https://www.mediawiki.org/wiki/Manual:Update.php)

from the base directory of your MediaWiki installation: 



    php maintenance/update.php



### Verify everything went alright



Check the "Special:Version" page on your wiki. If it lists Semantic MediaWiki, the installation was successful. 



Finally, please consider [sponsoring the project].



## How this works



This section provides extra background to people familiar with the MediaWiki

extension registration mechanism. Understanding that it is not required to use Semantic Bundle.



Semantic Bundle pulls all relevant Semantic MediaWiki extensions via Composer by defining

them as dependencies in its `require` section. By including `SemanticBundle.php`, you enable these

extensions since `SemanticBundle.php` calls `wfLoadExtensions`, just like you would have if you

had installed them individually.



If you want only to load some of the extensions, you can call `wfLoadExtensions` yourself instead

of including `SemanticBundle.php`.



## Update/version policy



Like these included extensions, Semantic Bundle follows [semantic versioning](https://semver.org/).

This means that we avoid breaking changes in all but our major versions.



In other words, if you install version `~42.0` of Semantic Bundle, you can run `composer update` at any

later time without worrying a breaking change will be included. No extensions will be removed, no extensions

will be added, and no extensions will be upgraded to a new version with breaking changes.



To get the latest set of extensions included by Semantic Bundle, make sure your "composer.local.json"

file contains the latest version of the Semantic Bundle.



## Version history



### Semantic Bundle 6.1.0 (2024-07-25)



* Added support for PHP 8.2

* Added support for MediaWiki 1.39 up to 1.41

* Upgraded Semantic MediaWiki from ^4.0.1 to ^4.2.0

* Upgraded Semantic Result Formats from ^4.0.1 to ^4.2.0

* Upgraded Semantic Extra Special Properties from ^3.0.1 to ^3.0.5

* Upgraded Maps from ^9.0.7 to ^10.2.0

* Upgraded Page Forms ^5.0.0 to 5.6.3



### Semantic Bundle 6.0.1 (2022-04-09)



* Fixed loading of Semantic MediaWiki



### Semantic Bundle 6.0.0 (2022-04-08)



* Raised minimum PHP version from 7.1 to 7.4 and added support for PHP 8.0

* Raised minimum MediaWiki version from 1.31 to 1.35 and added support for MediaWiki 1.36 up to 1.38

* Removed Semantic Breadcrumb Links

* Removed Semantic Cite

* Removed Semantic Interlanguage Links

* Removed Semantic Meta Tags

* Upgraded Semantic MediaWiki from ^3.2 to ^4.0.1

* Upgraded Semantic Result Formats from ^3.0 to ^4.0.1

* Upgraded Maps from ^7.20.1 to ^9.0.7

* Upgraded Mermaid from ^2.1.1 to ^3.1.0

* Upgraded Semantic Extra Special Properties from ^2.0 to ^3.0.1



### Semantic Bundle 5.0.0 (2021-08-05)



* Upgraded Page Forms from ~4.6 to ~5.0



### Semantic Bundle 4.0.0 (2020-11-02)



* Removed Semantic Glossary



### Semantic Bundle 3.2.0 (2020-09-13)



* Upgraded Semantic MediaWiki from ~3.1.0 to ~3.2.0



### Semantic Bundle 3.1.2 (2020-03-17)



* Fixed defect in 3.1.1 that made Composer ignore that release



### Semantic Bundle 3.1.1 (2020-03-15)



* Fixed compatibility with MediaWiki 1.31 (by preventing the installation of Mermaid newer than 2.0.x)



### Semantic Bundle 3.1.0 (2020-01-26)



* Upgraded Maps from ~7.4.0 to ~7.15



### Semantic Bundle 3.0.1 (2019-10-29)



* Fixed double loading of Semantic MediaWiki that happened in some cases



### Semantic Bundle 3.0.0 (2019-09-24)



* Upgraded Semantic MediaWiki from ~3.0.0 to ~3.1.0



### Semantic Bundle 2.0.0 (2019-09-09)



* Upgraded Semantic Interlanguage Links from ~1.5 to ~2.0



### Semantic Bundle 1.0.0 (2019-09-05)



* Initial release for MediaWiki 1.31.x and Semantic MediaWiki 3.0.x



[Professional Wiki]: https://professional.wiki/

[sponsoring the project]: https://github.com/sponsors/JeroenDeDauw

[MediaWiki development]: https://professional.wiki/en/mediawiki-development

[managed wiki hosting]: https://professional.wiki/en/hosting

[MediaWiki support]: https://professional.wiki/en/professional-mediawiki-support

[Semantic MediaWiki support]: https://professional.wiki/en/semantic-mediawiki-services