Reference:ContentTransfer

Extension: ContentTransfer

Overview
Description:	Copies new or existing wiki pages into a different wiki. (v3.2 and up)
State:	stable	Dependency:	BlueSpice
Developer:	HalloWelt	License:	GPL v3
Type:		Category:	Quality Assurance
Edition:	BlueSpice Farm (deactivated)
View help page

Features

ContentTransfer copies new or existing wiki pages in a different wiki on the same farm.

Usage / Features

Users Users with the appropriate authorization can copy up to 200 pages per transfer form one from a wiki to the same namespace in of a selected target wiki. This extension usually requires BlueSpice Farm.

Depending on the settings selected on the ContentTransfer special page, the following files are copied:

• the selected wiki pages
• the related category pages
• the book page associated with wiki pages
• the templates associated with wiki pages
• attached files

Technical information

Important! The extension is deactivated by default and must first be activated in 060-ContentTransfer under settings.d - or in the LocalSettings.custom.php in the installation folder (not just in a single farm instance):

wfLoadExtension ('ContentTransfer');

Configuration

To setup the "Push and Merge" mechanism for wiki instances within the farm you need the following informationThe following information is necessary to transfer content between two wiki instances:

<source-instance-name>

The name

Name of the

Wiki instance that acts as the source of the "push"

source wiki. This

must be

is the directory name from /opt/mediawiki/w/_sf_instances/ .

<target-instance-name>

The name

Name of the

Wiki instance that acts as the target of the "push"

target wiki. This

must be

is the directory name from /opt/mediawiki/w/_sf_instances/

<servername>

<username-provided-by>

. It can be extracted from the url of the wiki instance.

<target-instance-label>

The display name for the target wiki. It can contain empty spaces. This information is optional and can be commented out.

<servername>

Server-url

<bot-username-provided>

A user name in the form of <username>@<id>.

Must first

Has to be generated

using

from Special:BotPasswords

on the target instance

<password-provided-by>

An automatically generated password of that particular user

When provided with the required information, please open the file . The bot user has to be created in the target wiki.

<bot-password-provided>

The password is created in the wiki and needs to be used in the settings below.

With all this info, open /opt/mediawiki/w/_sf_instances/<source-instance-name>/LocalSettings.custom.php and add .

Add the following info:

                $wgContentTransferTargets['<target-instance-name>'] = [
    "url" => "https://<servername>/<target-instance-name>/api.php",
    "user" => "<username<bot-providedusername-by>provided>",
    "password" => "<password<bot-providedpassword-byprovided>",
    "draftNamespace" => "Draft",
    "pushToDraft" => true,
    "displayText" => "<target-instance-name>label>",
];

            

If ContentTransfer is used without the extension MergeArticles, the information about drafts has to be deactivated in the settings block:

                # "draftNamespace" => "Draft", 
"pushToDraft" => false,

            

Example:

                $wgContentTransferTargets['MeinWiki'] = [
    "url" => "http://172.16.200.23/MeinWikiName/api.php",
    "user" => "Snow@Schneewittchen",
    "password" => "uuicqdv9mubfrepbpqu1bvsl5957cpa9",
 #  "draftNamespace" => "Draft",
    "pushToDraft" => false,
    "displayText" => "Mein Wiki",
];

            

Additional settings:

                $wgContentTransferIgnoreInsecureSSL = false; // Ignore invalid SSL certificates (for test systems)
$wgContentTransferPageLimit = 200; // Max number of pages to be allowed at one 
$wgContentTransferOnlyContentNamespaces = true; // Only allow content namespaces to be selected in filters
$wgContentTransferAllowTalkNamespaces = false; // Allow talk namespaces to be selected in filters

            

Requirements

ContentTransfer requires BlueSpiceFoundation. To merge wiki pages Pages that already exist in the target namespacewiki, can be merged using the extension MergeArticles is necessary.