Referenz:ContentTransfer: Unterschied zwischen den Versionen

Versionsgeschichte interaktiv durchsuchen

Aktuelle Version vom 29. Oktober 2025, 12:40 Uhr

Übersicht
Beschreibung:	Ermöglicht das Verschieben von Inhalten von einem Wiki in ein anderes
Status:	stable	Lizenz:	GPL-3.0-only
Entwickler:	HalloWelt	Distribution:	BlueSpice
Kategorie:	Qualitätssicherung	Edition:	BlueSpice farm, BlueSpice cloud +
Benutzer-Hilfeseite ansehen

Funktion

ContentTransfer kopiert neue oder existierende Wikiseiten in ein anderes Wiki.

Benutzer mit der entsprechenden Berechtigung können bis zu 200 Seiten pro Transfer von einem Wiki in den gleichen Namensraum eines Zielwikis kopieren.

Je nach Einstellungen, die über die Spezialseite ContentTransfer, ausgewählt wurden, werden folgende Dateien kopiert:

die ausgewählten Wikiseiten
die verbundenen Kategorienseiten
die Buchseite, die mit Wikiseiten verbunden ist
die Vorlagen, die mit Wikiseiten verbunden sind
angehängte Dateien

Konfiguration

Bei On-Premise BlueSpice farm Installationen ist die Funktion bereits aktiviert.

Zusätzliche Einstellungen

$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

Anforderungen

ContentTransfer benötigt BlueSpiceFoundation. Bereits im Zielwiki existierende Seiten können optional über MergeArticles zusammengeführt werden.

Zertifikate

Wenn selbstsignierte Zertifikate verwendet werden (und keine ausgehenden Verbindungen erlaubt sind), muss

$GLOBALS['wgWikiFarmConfig_internalServer'] = 'http://wiki-web:9090';

in data/bluespice/pre-init-settings.php konfiguriert werden.

Übertragungsberechtigungen in Ziel-Namensräumen mit Sonderverrechtung

Bei besonderen Berechtigungskonzepten kann es erforderlich sein, einen Benutzer mit den entsprechenden Transfer-Berechtigungen zu definieren, damit die Übertragung über diesen Benutzer und nicht über den Standardbenutzer ContentTransferBot erfolgt, der möglicherweise keine Schreibberechtigungen für die Ziel-Namensräume besitzt. Der definierte Benutzer kann dann allen benutzerdefinierten Wiki-Gruppen hinzugefügt werden, die über die erforderlichen Namensraumberechtigungen verfügen.

php extensions/BlueSpiceWikiFarm/src/Maintenance/CreateAccessToken.php --sfr=Foo --for-user=WikiSysop

Technische Information[Bearbeiten | Quelltext bearbeiten]

Voraussetzungen[Bearbeiten | Quelltext bearbeiten]

MediaWiki: 1.43.0

Integriert in[Bearbeiten | Quelltext bearbeiten]

ContentTransfer

Spezialseiten[Bearbeiten | Quelltext bearbeiten]

ContentTransfer

Rechte[Bearbeiten | Quelltext bearbeiten]

Name	Beschreibung	Rollen
content-transfer	Übertragen von Inhalten auf andere Wikis	admin

Konfiguration[Bearbeiten | Quelltext bearbeiten]

Name	Wert
ContentTransferAllowTalkNamespaces	false
ContentTransferEnableBetaFeatures	false
ContentTransferIgnoreInsecureSSL	false
ContentTransferOnlyContentNamespaces	false
ContentTransferPageLimit	200
ContentTransferTargets	array ( )

API Modules[Bearbeiten | Quelltext bearbeiten]

content-transfer-do-push-single
content-transfer-get-pages
content-transfer-purge-pages
content-transfer-push-info

Hooks[Bearbeiten | Quelltext bearbeiten]

LoadExtensionSchemaUpdates

PDF-Ausschluss - Start

Feedback zur Dokumentation ist im Community-Forum möglich.

PDF-Ausschluss - Ende

@@ Zeile 1: / Zeile 1: @@
-{{BSExtensionInfobox
+{{BSExtensionInfo
-|desc=Kopiert Wikiseiten in ein Zielwiki. (ab v3.2)
 |status=stable
 |developer=HalloWelt
 |type=BlueSpice
-|edition=BlueSpice Farm (deaktiviert)
+|edition=BlueSpice farm, BlueSpice cloud
-|active=Nein
 |compatible=BlueSpice
 |category=Qualitätssicherung
-|license=GPL v3
+|features='''ContentTransfer''' kopiert neue oder existierende Wikiseiten in ein anderes Wiki.
-}}
-'''ContentTransfer''' kopiert neue oder existierende Wikiseiten in ein anderes Wiki.
 Benutzer mit der entsprechenden Berechtigung können bis zu 200 Seiten pro Transfer von einem Wiki in den gleichen Namensraum eines Zielwikis kopieren.
@@ Zeile 16: / Zeile 12: @@
 Je nach Einstellungen, die über die Spezialseite ContentTransfer, ausgewählt wurden, werden folgende Dateien kopiert:
-*die ausgewählten Wikiseiten
+* die ausgewählten Wikiseiten
-*die verbundenen Kategorienseiten
+* die verbundenen Kategorienseiten
-*die Buchseite, die mit Wikiseiten verbunden ist
+* die Buchseite, die mit Wikiseiten verbunden ist
-*die Vorlagen, die mit Wikiseiten verbunden sind
+* die Vorlagen, die mit Wikiseiten verbunden sind
-*angehängte Dateien<br />
+* angehängte Dateien<br />
-==Technische Information==
-{{Box Note|boxtype=important|Note text=Die Erweiterung ist standardmäßig deaktiviert und muss erst in der 060-ContentTransfer unter settings.d - oder in der LocalSettings.custom.php im Installationsordner aktiviert werden (also nicht nur in einer einzelnen Farm-Instanz).
-wfLoadExtension('ContentTransfer');}}
-===Konfiguration===
-Folgende Information ist nötig, um Seiten zwischen Wikis zu transferieren:
-'''<source-instance-name>'''
-Name des Quellwikis. Dies muss der Ordnername aus <code>/opt/mediawiki/w/_sf_instances/</code> sein.
-'''<target-instance-descriptive-name>'''
-Beschreibungsname des Zielwikis. Das ist normalerweise der Name der Instanz (also <target-instance-name>), kann aber zur besseren Verständlichkeit frei gewählt werden. Kann keine Leerzeichen enthalten.
-'''<target-instance-name>'''
-Name der Zielwiki-Instanz.
-Dies muss der Ordnername aus <code>/opt/mediawiki/w/_sf_instances/</code> sein. Der Name läßt sich auch aus der url der Wiki-Instanz auslesen.
-'''<target-instance-label>'''
-Der Anzeigename für das Zielwiki (kann auch Leerzeichen enthalten). Diese Angabe ist optional und kann auskommentiert werden.
-'''<servername>'''
-Server-url
-'''<<span class="mw-lingo-term ve-pasteProtect" data-lingo-term-id="fabcaa97871555b68aa095335975e613" data-hasqtip="2" style="box-sizing: inherit; border-bottom: 1px dotted rgb(187, 187, 255); cursor: default;" data-ve-attributes="{&quot;style&quot;:&quot;box-sizing: inherit; border-bottom: 1px dotted rgb(187, 187, 255); cursor: default;&quot;}">bot</span>-username-provided>'''
-[[Datei:Referenz:Bot permissions.png|alternativtext=Bot-Berechtigungen|mini|Bot-Berechtigungen]]
-Ein Benutzername in Form von  <code style="box-sizing: inherit; font-family: monospace, Courier; font-size: 13.5px; padding: 1px 4px; color: black; background-color: rgb(249, 249, 249); border-radius: 2px; border: 1px solid rgb(221, 221, 221);" data-ve-attributes="{&quot;style&quot;:&quot;box-sizing: inherit; font-family: monospace, Courier; font-size: 13.5px; padding: 1px 4px; color: black; background-color: rgb(249, 249, 249); border-radius: 2px; border: 1px solid rgb(221, 221, 221);&quot;}"><username>@<id></code>.
-Der Bot-Benutzer wird im Zielwiki auf der Seite <code style="box-sizing: inherit; font-family: monospace, Courier; font-size: 13.5px; padding: 1px 4px; color: black; background-color: rgb(249, 249, 249); border-radius: 2px; border: 1px solid rgb(221, 221, 221);" data-ve-attributes="{&quot;style&quot;:&quot;box-sizing: inherit; font-family: monospace, Courier; font-size: 13.5px; padding: 1px 4px; color: black; background-color: rgb(249, 249, 249); border-radius: 2px; border: 1px solid rgb(221, 221, 221);&quot;}">Special:BotPasswords</code> angelegt. Klicken Sie "Erstellen". Danach wird eine Seite mit den Bot-Berechtigungen angezeigt. Aktivieren Sie folgende Einstellungen:
-*Massenbearbeitungen
-*Vorhandene Seiten bearbeiten
-*Geschützte Seiten bearbeiten
-*Seiten erstellen, bearbeiten, verschieben
-*Neue Dateien hochladen
-*Dateien hochladen, ersetzten und verschieben
-'''<bot-password-provided>'''
-Das Passwort wird im Wiki generiert und muss dann entsprechend verwendet werden.
+=== Konfiguration ===
-Mit der nötigen Info öffnen Sie  <code>/opt/mediawiki/w/_sf_instances/<source-instance-name>/LocalSettings.custom.php</code> . Fügen Sie folgenden Block hinzu:
+Bei On-Premise BlueSpice farm Installationen ist die Funktion bereits aktiviert.
- <span class="nv">$wgContentTransferTargets</span><span class="p">[</span><span class="s1">'<target-instance-descriptive-name>'</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span>
-     <span class="s2">"url"</span> <span class="o">=></span> <span class="s2">"https://<servername>/<target-instance-name>/api.php"</span><span class="p">,</span>
-     <span class="s2">"user"</span> <span class="o">=></span> <span class="s2">"<bot-username-provided>"</span><span class="p">,</span>
-     <span class="s2">"password"</span> <span class="o">=></span> <span class="s2">"<bot-password-provided>"</span><span class="p">,</span>
-     <span class="s2">"draftNamespace"</span> <span class="o">=></span> <span class="s2">"Draft"</span><span class="p">,</span>
-     <span class="s2">"pushToDraft"</span> <span class="o">=></span> <span class="k">true</span><span class="p">,</span>
-     <span class="s2">"displayText"</span> <span class="o">=></span> <span class="s2">"<target-instance-label>"</span><span class="p">,</span>
- <span class="p">];</span>
-Wenn ContentTransfer ohne die Erweiterung [[Referenz:MergeArticles|MergeArticles]] benutzt wird, müssen die entsprechenden Angaben zu "Drafts" deaktiviert werden:<syntaxhighlight lang="text">
-# "draftNamespace" => "Draft",
-"pushToDraft" => false,
-</syntaxhighlight>Beispiel:<syntaxhighlight>
-$wgContentTransferTargets['MeinWiki'] = [
-    "url" => "http://172.16.200.23/MeinWikiName/api.php",
-    "user" => "Snow@Schneewittchen",
-    "password" => "uuicqdv9mubfrepbpqu1bvsl5957cpa9",
- #  "draftNamespace" => "Draft",
-    "pushToDraft" => false,
-    "displayText" => "Mein Wiki",
-];
-</syntaxhighlight>{{Box Note|boxtype=note|Note text=Nach der Konfiguration muß die Datei update.php ausgeführt werden.}}
 === Zusätzliche Einstellungen ===
@@ Zeile 96: / Zeile 28: @@
   <span class="nv">$wgContentTransferAllowTalkNamespaces</span> <span class="o">=</span> <span class="k">false</span><span class="p">;</span> <span class="c1">// Allow talk namespaces to be selected in filters</span>
-===Anforderungen===
+=== Anforderungen ===
-{{PAGENAME}} benötigt [[Referenz:BlueSpiceFoundation|BlueSpiceFoundation]]. Bereits im Zielwiki existierende Seiten können optional über [[Referenz:MergeArticles|MergeArticles]] zusammengeführt werden.<br />
+{{PAGENAME}} benötigt [[Referenz:BlueSpiceFoundation|BlueSpiceFoundation]]. Bereits im Zielwiki existierende Seiten können optional über [[Referenz:MergeArticles|MergeArticles]] zusammengeführt werden.
+=== Zertifikate ===
+Wenn selbstsignierte Zertifikate verwendet werden (und keine ausgehenden Verbindungen erlaubt sind), muss
+<syntaxhighlight lang="text">
+$GLOBALS['wgWikiFarmConfig_internalServer'] = 'http://wiki-web:9090';
+</syntaxhighlight>
+in <code>data/bluespice/pre-init-settings.php</code> konfiguriert werden.
+=== Übertragungsberechtigungen in Ziel-Namensräumen mit Sonderverrechtung ===
+Bei besonderen Berechtigungskonzepten kann es erforderlich sein, einen Benutzer mit den entsprechenden Transfer-Berechtigungen zu definieren, damit die Übertragung über diesen Benutzer und nicht über den Standardbenutzer ''ContentTransferBot erfolgt, der möglicherweise keine Schreibberechtigungen für die Ziel-Namensräume besitzt. Der definierte Benutzer kann dann allen benutzerdefinierten Wiki-Gruppen hinzugefügt werden, die über die erforderlichen Namensraumberechtigungen verfügen.''
+<syntaxhighlight lang="php">
+php extensions/BlueSpiceWikiFarm/src/Maintenance/CreateAccessToken.php --sfr=Foo --for-user=WikiSysop
+</syntaxhighlight>
+|desc=Kopiert Wikiseiten in ein Zielwiki.
+|license=GPL v3
+}}
 {{Translation}}
-[[Category:Extension]]