oraclemediawiki

Install the Collection 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.

The Collection extension allows you to organize personal selections of pages in a collection. To do it, the extension uses a public render server where the jobs are sent and processed.

Please keep in mind that if your Mediawiki installation is not public (it is a local installation or it can’t be accessed from the Internet), you will need to install your own Render Server. The Collection developers have some suggestions about it here.

To install the Collection plugin, please follow the steps below depending on your installation type.

Approach A: Bitnami installations using system packages

  • Download the latest Collection version from the official Mediawiki extension page.

  • Uncompress the downloaded file in the Mediawiki extensions directory. The command below should create the Collection directory in the Mediawiki extensions directory:

    $ tar -xzf Collection-*.tar.gz -C /opt/bitnami/mediawiki/extensions
    
  • Add the Collection plugin to the Mediawiki LocalSettings.php file:

    $ echo 'require_once "$IP/extensions/Collection/Collection.php";' >> /opt/bitnami/mediawiki/LocalSettings.php
    

Once you have completed all the steps above, you should see new options in the MediaWiki menu:

MediaWiki Collection extension

If you already have your own Renderserver, remember to add the URL in /opt/bitnami/mediawiki/LocalSettings.php, as below:

$wgCollectionMWServeURL = "http://RENDERSERVER_IP:PORT";

Approach B: Self-contained Bitnami installations

  • Download the latest Collection version from the official Mediawiki extension page.

  • Uncompress the downloaded file in the Mediawiki extensions directory. The command below should create the Collection directory in the Mediawiki extensions directory:

    $ tar -xzf Collection-*.tar.gz -C /opt/bitnami/apps/mediawiki/htdocs/extensions
    
  • Add the Collection plugin to the Mediawiki LocalSettings.php file:

    $ echo 'require_once "$IP/extensions/Collection/Collection.php";' >> /opt/bitnami/apps/mediawiki/htdocs/LocalSettings.php
    

Once you have completed all the steps above, you should see new options in the MediaWiki menu:

MediaWiki Collection extension

If you already have your own Renderserver, remember to add the URL in /opt/bitnami/apps/mediawiki/htdocs/LocalSettings.php, as below:

$wgCollectionMWServeURL = "http://RENDERSERVER_IP:PORT";
Last modification June 30, 2020