Zuletzt bearbeitet vor 3 Wochen
von Margit Link-Rodrigue

Referenz:ContentTransfer: Unterschied zwischen den Versionen

Margit Link-Rodrigue (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
Markierung: Quelltext-Bearbeitung 2017
Margit Link-Rodrigue (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
Markierung: Quelltext-Bearbeitung 2017
Zeile 23: Zeile 23:


===Konfiguration===
===Konfiguration===
Folgende Information ist nötig, um Seiten zwischen Wikis zu transferieren:


'''<source-instance-name>'''
Bei On-Premise BlueSpice farm installationen ist die Funktion bereits aktiviert.
 
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>'''
 
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.
 
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:
<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 lang="text">
$wgContentTransferTargets['MeinWiki'] = [
    "url" => "http://172.16.200.23/MeinWikiName/api.php",
    "user" => "Snow@Schneewittchen",
    "password" => "uuicqdv9mubfrepbpqu1bvsl5957cpa9",
#  "draftNamespace" => "Draft",
    "pushToDraft" => false,
    "displayText" => "Mein Wiki",
];
</syntaxhighlight>
Um die Auswahl verschiedener Transfer-Benutzer zu ermöglichen, wird folgende Syntax verwendet:<syntaxhighlight lang="text">
$wgContentTransferTargets = [ 'privatewikiname' => [
    "url" => "http://target/api.php", // URL to the target wiki's API endpoint
    "users" => [
        [
            "user" => "Uname1@bot", // Bot username
            "password" => "dvauaeersp02ds6s8n88bbrsj3asuuk", // Bot password
        ],
        [
            "user" => "Uname2@bot", // Bot username
            "password" => "dvauaeersp02ds6s8n88bbrsj3asuuk", // Bot password
        ]
    ],
    "draftNamespace" => "Draft", // Name for the NS to be used as draft ("Draft" is automatically created by "MergeArticles" ext)
    "pushToDraft" => true // Whether to push to draft. If false will push directly to target pages
] ];
</syntaxhighlight>Beim Transfer ist es dann möglich, einen Transfer-Benutzer anzugeben:
[[Datei:Referenz:contenttransfer-multipleusers.png|alternativtext=mehrere Transfer Benutzer stehen zur Auswahl|zentriert|mini|350x350px|mehrere Transfer Benutzer stehen zur Auswahl]]
{{Hinweisbox|boxtype=note|Note text=Nach der Konfiguration muß die Datei update.php ausgeführt werden.}}


=== Zusätzliche Einstellungen ===
=== Zusätzliche Einstellungen ===

Version vom 2. Juni 2025, 06:24 Uhr

alle Erweiterungen

Übersicht
Beschreibung: Kopiert Wikiseiten in ein Zielwiki. (ab v3.2)
Status: stable Abhängigkeit: BlueSpice
Entwickler: HalloWelt Lizenz: GPL v3
Typ: BlueSpice Kategorie: Qualitätssicherung
Edition: BlueSpice farm Version:

Funktionen / Anwendung[Bearbeiten | Quelltext bearbeiten]

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[Bearbeiten | Quelltext bearbeiten]

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

Zusätzliche Einstellungen[Bearbeiten | Quelltext bearbeiten]

$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[Bearbeiten | Quelltext bearbeiten]

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

Zertifikate[Bearbeiten | Quelltext bearbeiten]

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.

Rechte[Bearbeiten | Quelltext bearbeiten]

Um Seiten von einem Quell- in ein Zielwiki transferieren zu können, benötigen benutzer die "content-transfer" Berechtigung. Diese ist standardmäßig in der admin-Rolle enthalten.


PDF-Ausschluss - Start

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

PDF-Ausschluss - Ende