bchmediawiki

Install the Semantic Bundle extension

NOTE: We are in the process of modifying the file structure and configuration for many Bitnami stacks. On account of these changes, the file paths stated in this guide may change depending on whether your Bitnami stack uses native Linux system packages (Approach A), or if it is a self-contained installation (Approach B). To identify your Bitnami installation type and what approach to follow, run the command below:

 $ test ! -f "/opt/bitnami/common/bin/openssl" && echo "Approach A: Using system packages." || echo "Approach B: Self-contained installation."

The output of the command indicates which approach (A or B) is used by the installation, and will allow you to identify the paths, configuration and commands to use in this guide. Refer to the FAQ for more information on these changes.

Semantic Bundle (abbreviated as SB) is a pre-packaged bundle of extensions for use with wikis that are based around the Semantic MediaWiki extension. It is a suitable alternative if you cannot run Composer to install or upgrade SMW (1.9+) and a number of other extensions that require Composer, such as Maps (3.0+).

Follow these steps:

  • Change to the MediaWiki directory. Depending on the installation type, run the following commands:

    • Approach A (Bitnami installations using system packages):

      $ cd /opt/bitnami/mediawiki
      
    • Approach B (Self-contained Bitnami installations):

      $ cd /opt/bitnami/apps/mediawiki/htdocs
      
  • Install the Semantic Bundle extension with Composer:

    $ COMPOSER=composer.local.json composer require --no-update mediawiki/semantic-bundle
    $ composer update mediawiki/semantic-bundle --no-dev -o
    
  • Change to the extension directory and create the configuration file:

    $ cd /opt/bitnami/mediawiki/extensions/SemanticBundle
    $ cp SemanticBundleSettings.sample.php SemanticBundleSettings.php
    
  • Enable the required configuration for Semantic Bundle in the LocalSettings.php file:

    NOTE: You need to use your own MediaWiki domain instead of example.com.

    enableSemantics( 'example.org' );
    require_once __DIR__ . '/extensions/SemanticBundle/SemanticBundle.php';
    
  • Run the update script which will automatically create the necessary database tables that this extension needs.

    $ php maintenance/update.php
    

    If the last command (update.php) wasn’t successful, try updating from the browser following these steps.

If you get a warning like this:

Warning: This development build of composer is over 30 days old. It is recommended to update it by running "/opt/bitnami/php/bin/composer.phar self-update" to get the latest version.

Execute the suggested command and try the steps again. Refer to this page for more information.

Last modification June 30, 2020