Reference:MergeArticles: Difference between revisions

Latest revision as of 13:09, 23 July 2025


Overview
Description:	Allows merging comparing and merging articles
State:	stable	Dependency:	BlueSpice
Developer:	HalloWelt	License:	GPL-3.0-only
Type:	BlueSpice	Category:	Quality Assurance
Edition:	BlueSpice farm (deactivated)	Version:
View user help page

Features

MergeArticles allows you to merge revisions of a wiki page.

If a page in BlueSpice farm is transferred to other wiki instances via the ContentTransfer extension or via BlueSpiceTranslationTransfer, the page can be saved in a draft namespace for further processing. Users then manually merge the page with an existing page revision.

Activation

Activation is done in LocalSettings.php or in a Docker container: bluespice/post-init-settings.php)

Activating the draft namespace for all non-language wikis (i.e., wikis named DE, EN, NL, etc.)

$GLOBALS['wgExtensionFunctions'][] = static function() {
    foreach( $GLOBALS['wgContentTransferTargets'] as $instanceName => $config ) {
        if ( isset( $GLOBALS['bsgTranslateTransferTargets'][strtolower( $instanceName )] ) ) {
            // Skip language variant wikis
            continue;
        }
        $GLOBALS['wgContentTransferTargets'][$instanceName]['pushToDraft'] = true;
    }
};

Activating the draft namespace all wikis. PushToDraft possible values for TranslationTransfer:

"regular" - page is pushed directly on the first translation, and to the "draftNamespace" on all next translations.
"always" - page is always pushed to the "draftNamespace" after translation.

$GLOBALS['wgExtensionFunctions'][] = static function() {
    foreach( $GLOBALS['wgContentTransferTargets'] as $instanceName => $config ) {
        $GLOBALS['wgContentTransferTargets'][$instanceName]['pushToDraft'] = true;
    }
    foreach( $GLOBALS['bsgTranslateTransferTargets'] as $instanceName => $config ) {
        $GLOBALS['bsgTranslateTransferTargets'][$instanceName]['pushToDraft'] = 'regular';
        #$GLOBALS['bsgTranslateTransferTargets'][$instanceName]['pushToDraft'] = 'always';
        $GLOBALS['bsgTranslateTransferTargets'][$instanceName]['draftNamespace'] = 'Draft';
    }
};

More info about working with the draft namespace can be found on the MergeArticles help page.

Technical Information

Technical details for BlueSpice cloud can differ in some cases.

Requirements

MediaWiki: 1.43.0

Integrates into

MergeArticles

Special pages

MergeArticles

Permissions

Name	Description	Role
merge-articles	Merge pages	admin

Configuration

Name	Value
MADraftFilePrefix	'Draft_'
MAEnableBetaFeatures	false
MAUseLineByLineDiff	false

API Modules

ma-discard-draft
ma-merge-page-existing
ma-merge-page-new
ma-set-related-titles

PDF exclude - start

To submit feedback about this documentation, visit our community forum.

PDF exclude - end

@@ Line 1: / Line 1: @@
-{{BSExtensionInfobox
+{{BSExtensionInfo
-|desc=Merge corresponding pages in wiki instances.
+|removed=No
 |status=stable
 |developer=HalloWelt
 |type=BlueSpice
-|edition=BlueSpice Farm (deactivated)
+|edition=BlueSpice farm (deactivated)
 |compatible=BlueSpice
 |category=Quality Assurance
-|license=GPL v3
+|features=MergeArticles allows you to merge revisions of a wiki page.
-|active=No
-}}
+If a page in BlueSpice farm is transferred to other wiki instances via the [[Reference:ContentTransfer{{!}}ContentTransfer]] extension or via [[Reference:BlueSpiceTranslationTransfer{{!}}BlueSpiceTranslationTransfer]], the page can be saved in a draft namespace for further processing. Users then manually merge the page with an existing page revision.
-{{wcagCheck}}
-The extension '''MergeArticles''' makes it possible to merge two corresponding wiki pages in different wiki instances.
+== Activation ==
+Activation is done in [[mediawikiwiki:Manual:LocalSettings.php{{!}}LocalSettings.php]] or in a Docker container: <code>bluespice/<mark>post</mark>-init-settings.php)</code>
-__TOC__
+Activating the draft namespace for all non-language wikis (i.e., wikis named DE, EN, NL, etc.)
+<syntaxhighlight lang="php">
+$GLOBALS['wgExtensionFunctions'][] = static function() {
+    foreach( $GLOBALS['wgContentTransferTargets'] as $instanceName => $config ) {
+        if ( isset( $GLOBALS['bsgTranslateTransferTargets'][strtolower( $instanceName )] ) ) {
+            // Skip language variant wikis
+            continue;
+        }
+        $GLOBALS['wgContentTransferTargets'][$instanceName]['pushToDraft'] = true;
+    }
+};
+</syntaxhighlight>
-==Usage / Features==
+Activating the draft namespace all wikis. ''PushToDraft'' possible values for TranslationTransfer:
-If a page is moved to another wiki using the ContentTransfer extension, the page is saved in a special namespace in the target wiki. From there, the page can be compared and merged with the last version in the target wiki.
-==Technical information==
-===Configuration===
-===Rights (permissions)===
+* "regular" - page is pushed directly on the first translation, and to the "draftNamespace" on all next translations.
+* "always" - page is always pushed to the "draftNamespace" after translation.
-===Requirements===
+<syntaxhighlight lang="php">
-{{PAGENAME}} requires [[Reference:BlueSpiceFoundation|BlueSpiceFoundation]].
+$GLOBALS['wgExtensionFunctions'][] = static function() {
+    foreach( $GLOBALS['wgContentTransferTargets'] as $instanceName => $config ) {
+        $GLOBALS['wgContentTransferTargets'][$instanceName]['pushToDraft'] = true;
+    }
+    foreach( $GLOBALS['bsgTranslateTransferTargets'] as $instanceName => $config ) {
+        $GLOBALS['bsgTranslateTransferTargets'][$instanceName]['pushToDraft'] = 'regular';
+        #$GLOBALS['bsgTranslateTransferTargets'][$instanceName]['pushToDraft'] = 'always';
+        $GLOBALS['bsgTranslateTransferTargets'][$instanceName]['draftNamespace'] = 'Draft';
+    }
+};
+</syntaxhighlight>
-[[Category:Extension]]
+More info about working with the draft namespace can be found on the [[Manual:Extension/MergeArticles{{!}}MergeArticles help page]].
+|desc=Merge corresponding pages in wiki instances.
+|license=GPL v3
+|active=No
+}}
+{{wcagCheck}}
 {{Translation}}