Adm:Einrichtung Wikis MW1.23: Unterschied zwischen den Versionen

Aus Salzwiki
Zur Navigation springen Zur Suche springen
 
(299 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 17: Zeile 17:
Zur Konfiguration der Standardspracheinstellung siehe unter [[Adm:Einrichtung_Wikis_MW1.23#Spracheinstellungen|Wiki-Konfiguration -> Spracheinstellungen]]
Zur Konfiguration der Standardspracheinstellung siehe unter [[Adm:Einrichtung_Wikis_MW1.23#Spracheinstellungen|Wiki-Konfiguration -> Spracheinstellungen]]


== Apache-Webserver ==
== Installationen ==
 
=== Server und Anwendungen ===
 
# Betriebssystem Windows-Server 2012 R2
# Webserver Apache 2.4.29 mit OpenSSL und anderen Zusatzmodulen
#* 64-Bit ohne XAMPP
#* 32-Bit von XAMPP
# Datenbank-Server (MySQL/)MariaDB 10.1.30
#* 64-Bit ohne XAMPP
#* 32-Bit von XAMPP
# Datenbank-Management-Anwendung phpMyAdmin
# Scriptsprache PHP ThreadSafe (für Apache unter Windows) mit Zusatzmodulen
#* 64-Bit ohne XAMPP
#* 32-Bit von XAMPP 7.2.1/7.2.2
#* Zusatzmodul php-imagick (TS => PECL)
#** 64-Bit
#** 32-Bit
# Statistik-Anwendung Webalizer 2.23-08
#* 32-Bit
# XAMPP-Paket 7.2.1/7.2.2 wegen notwendiger Bestandteile davon
#* 32-Bit
# Wikisystem MediaWiki 1.27.4 LTS mit Erweiterungen und Zusatz-Software
# GhostScript (für MediaWiki), AGPL statt GPL seit Version 9.07
#* AGPL Version 9.22 (2017-10-04) statt GPL-Version 9.10 (2013-09-02) bei https://www.ghostscript.com/
#** 64-Bit-Version gs922w64.exe ohne XAMPP-Anwendungen
#** 32-Bit-Version gs922w32.exe für XAMPP-Anwendungen
#* GPL bis Version 9.10 (2013-09-02) bei https://sourceforge.net/projects/ghostscript/
#** 64-Bit-Version gs910w64.exe ohne XAMPP-Anwendungen
#** 32-Bit-Version gs910w32.exe für XAMPP-Anwendungen
# ImageMagick (für MediaWiki)
#* Version 7.0.7-25-Q16-[HDRI-]x64-dll.exe ohne XAMPP-Anwendungen
#* Version 7.0.7-25-Q16-[HDRI-]x86-dll.exe für XAMPP-Anwendungen 32-Bit
#* Version 6.9.3-8-Q16-x64-dll.exe ohne XAMPP-Anwendungen
#* Version 6.9.3-8-Q16-x86-dll.exe für XAMPP-Anwendungen 32-Bit
# php-imagick
#* neue 64-Bit-Version statt 3.2.0RC1-5.6-zd-bv22-c86_peewit.zip ohne XAMPP-Anwendungen
#* neue 32-Bit-Version statt 3.2.0RC1-5.6-zd-bv22-c86_peewit.zip für XAMPP-Anwendungen
# MiKTeX 2.9.5870
# <del>Statistik-Anwendung Piwik</del>
 
==== Programme unter Systemsteuerung Windows Server 2012 R2 ====
 
===== Für MediaWiki 1.27.4 LTS =====
 
* GPL Ghostscript 9.22
* ImageMagick 7.0.7-25 Q16 HDRI dll (dynamic)
* Microsoft Visual C++ 2017 Redistributable [VC15]
** (x64) - 14.13.26020.0
** (x86) - 14.13.26020.0 <del>14.11.25325.0</del>
* MikTeX 2.9
 
===== Für MediaWiki 1.23.11 LTS =====
 
* GPL Ghostscript 9.10
* ImageMagick 6.9.3-8 Q16 (32-bit) (2016-04-10)
* Microsoft Visual C++ 2008 Redistributable - x64 9.0.30729.6161
* Microsoft Visual C++ 2008 Redistributable - x86 9.0.30729.4148
* Microsoft Visual C++ 2008 Redistributable - x86 9.0.30729.6161
* Microsoft Visual C++ 2012 Redistributable (x86) - 11.0.61030 Update 4
* MikTeX 2.9
 
==== Programme unter Systemsteuerung Windows Server 2008 32 Bit ====
 
===== Für MediaWiki 1.23.11 LTS und 1.16 =====
 
* GPL GhostScript 8.70
* ImageMagick 6.5.9-0 Q16 (2010-01-01)
* Microsoft .Net Framework 3.5 Language Pack SP1 - DEU
* Microsoft .Net Framework 3.5 SP1
* Microsoft .Net Framework 4.5.2
* Microsoft Visual C++ 2008 Redistributable - x86 9.0.30729.4148
* Microsoft Visual C++ 2012 Redistributable (x86) - 11.0.61030 Update 4
* MikTeX 2.8
* MSXML 4.0 SP2 (KB954430)
* MSXML 4.0 SP2 (KB973688)
* OggVideoTools Ogg Video Tools
* XAMPP 1.7.1
 
=== Verzeichnisse und Dateien ===
 
==== Mit XAMPP ====
 
XAMPP 5.6.30 und 5.6.14-0:
* anonymous
* apache
** conf\extra\httpd-xampp.conf
** error\XAMPP_FORBIDDEN.html.var
* cgi-bin
* contrib
* FileZillaFTP
* htdocs
** Dateien: index.php, favicon.ico
** dashboard
** webalizer
** xampp
** Wiki-Verzeichnisse
* install
* licenses
* locale
* mailoutput
* mailtodisk
* MercuryMail
* mysql
** mysql_installservice.bat, mysql_uninstallservice.bat, resetroot.bat
** bin\my.ini
* perl
* php
* phpmyadmin
* sendmail
* src
* tmp
* tomcat
* webalizer
* webdav
* Dateien:
** apache_start.bat, apache_stop.bat, ... mysql_start.bat, mysql_stop.bat, ...
** setup_xampp.bat
** xampp-control.exe, xampp_start.exe, xampp_stop.exe
** xampp-control.ini, xampp-control.log
 
XAMPP 5.6.30:
* htdocs
** Dateien: bitnami.css, applications.html
** img
 
XAMPP 5.6.14-0:
* security
 
==== Ohne XAMPP ====
 
* apache
* htdocs
** Angepasste Datei: index.php
** Neu erstelltes Verzeichnis mit Datei: \info\phpinfo.php
** Wiki-Verzeichnisse
* mysql
* php
* phpmyadmin
* tmp
* Neu erstellte Dateien:
** mysql_start.bat
** mysql_stop.bat
 
=== Installationen mit XAMPP ===
 
Das XAMPP-Paket ist als gepackte Datei, entweder zip oder 7z, zu verwenden, um eine Installation im System zu verhindern.
 
Nach dem Entpacken des XAMPP-Pakets ist
* im Verzeichnis "D:\xampp\" das Unterverzeichnis "Apache24\" umzubenennen in "apache\"
* die Datei "D:\xampp\setup_xampp.bat" auszuführen, um in den Konfigurationsdateien die Pfade für "D:\xampp\..." anpassen zu lassen.
 
Bei der Installation von XAMPP werden nicht erforderliche Anwendungen auf dem Server gespeichert, z. B.:
* FileZilla
* mailoutput
* mailtodisk
* MercuryMail
* sendmail
* Tomcat
* Webalizer
* Webdav


=== Konfiguration allgemein ===
==== XAMPP absichern ====


==== conf-Dateien mit und ohne XAMPP ====
===== Verzeichniszugriff für "dashboard" einrichten =====


Verzeichnispfade anpassen von "C:/Apache24" zu "D:/xampp/apache"
Um das Verzeichnis "dashboard", das als localhost-Startverzeichnis im Browser geladen wird, vor öffentlichen Zugriffen zu schützen, wird die allgemeine Startseiten-Datei "index.php" angepasst und werden 2 Dateien angelegt.
* Datei "apache\conf\httpd.conf
* Verzeichnis "apache\conf\extra\": httpd-autoindex.conf, httpd-dav.conf, httpd-manual.conf, httpd-multilang-errordoc.conf, httpd-ssl.conf, httpd-vhosts.conf
* XAMPP-Konfiguration "apache\conf\extra\httpd-xampp.conf"
* phpMyAdmin-Konfiguration ohne XAMPP "apache\conf\extra\httpd-phpmyadmin.conf"


==== httpd.conf mit und ohne XAMPP ====
Anpassung bei der allgemeinen Startseiten-Datei:
* "xampp\htdocs\index.php" umbenennen zu "xampp\htdocs\index_original.php"
* Datei "index.php" erstellen mit Verweisen zu den Wikis
* Dtaei "index_localhost.php" erstellen für Zugriff auf das Verzeichnis "dashboard"


Bei einer Installation von Apache, PHP, phpMyAdmin und MariaDB ohne XAMPP werden die Verwendung von PHP und die Berechtigungen nicht in der Datei "\conf\extra\httpd-xampp.conf" festgelegt, sondern in den Dateien "httpd.conf" und "\conf\extra\httpd-phpmyadmin.conf".
Die beiden neuen Dateien für Zugangsberechtigungen:
* "xampp\htdocs\dashboard\.htaccess"
* "xampp\security\dashboard.htpasswd"


Neu erstellte Datei "index.php":
<pre>
<pre>
ServerRoot "D:/xampp/apache"
<!DOCTYPE>
Listen 80
<html>
...
<head>
LoadModule acces_compat_module modules/mod_access_compat.so
<title>SalzWiki SaltWiki RepositoryWiki</title>
LoadModule actions_module modules/mod_actions.so
</head>
LoadModule alias_module modules/mod_alias.so
<body>
LoadModule allowmethods_module modules/mod_allowmethods.so
<?php
LoadModule asis_module modules/mod_asis.so
if(!empty($_SERVER['HTTPS']) && ('on'==$_SERVER['HTTPS'])){
LoadModule auth_basic_module modules/mod_auth_basic.so
  $prot = 'https://';
LoadModule authn_core_module modules/mod_authn_core.so
}
LoadModule authn_file_module modules/mod_authn_file.so
else{
LoadModule authz_core_module modules/mod_authz_core.so
  $prot = 'http://';
LoadModule authz_groupfile_module modules/mod_authz_groupfile.so
}
LoadModule authz_host_module modules/mod_authz_host.so
?>
LoadModule authz_user_module modules/mod_authz_user.so
<ul>
LoadModule autoindex_module modules/mod_autoindex.so
  <li><a href="<?php echo $prot; ?>salzwiki.de" title="SalzWiki">SalzWiki: www.salzwiki.de</a></li>
LoadModule dir_module modules/mod_dir.so
  <li><a href="<?php echo $prot; ?>saltwiki.net" title="SaltWiki">SaltWiki: www.saltwiki.net</a></li>
LoadModule env_module modules/mod_env.so
  <li><a href="<?php echo $prot; ?>repository.hawk-hhg.de" title="RepositoryWiki">RepositoryWiki: repository.hawk-hhg.de</a></li>
LoadModule include_module modules/mod_include.so
</ul>
LoadModule isapi_module modules/mod_isapi.so
</body>
LoadModule log_config_module modules/mod_log_config.so
</html>
LoadModule mime_module modules/mod_mime.so
</pre>
LoadModule negotiation_module modules/mod_negotiation.so
 
LoadModule rewrite_module modules/mod_rewrite.so
Neu erstellte Datei "index_localhost.php":
#LoadModule session_module modules/mod_session.so
<pre>
#LoadModule session_cookie_module modules/mod_session_cookie.so
<?php
#LoadModule session_crypto_module modules/mod_session_crypto.so
if($_SERVER['HTTP_HOST']=="localhost"){
LoadModule setenvif_module modules/mod_setenvif.so
  #var_dump($_SERVER['HTTP_HOST']);
LoadModule ssl_module modules/mod_ssl.so
  header('Location: http://'.$_SERVER['HTTP_HOST'].'/dashboard/');
LoadModule status_module modules/mod_status.so
}
...
else{
ServerAdmin webmaster@hornemann-institut.de
  header('Location: http://'.$_SERVER['HTTP_HOST'].'/index.php');
ServerName localhost:80
}
...
?>
DocumentRoot D:/xampp/htdocs
</pre>
...
 
<IfModule dir_module>
Datei ".htaccess" mit "/" statt "\" in der Pfadangabe unter Windows wie bei Linux:
  DirectoryIndex index.php index.shtml index.html index.htm \
<pre>
                default.php default.shtml default.html default.htm \
AuthType Basic
                home.php home.shtml home.html home.htm
AuthName "XAMPP Dashboard"
</IfModule>
AuthUserFile "../security/dashboard.htpasswd"
...
Require valid-user
<Files ".ht*">
</pre>
  Require all denied
 
</Files>
Datei "dashboard.htpasswd", wobei "username" und "passwort" hier nur exemplarisch angegeben sind:
<pre>
username:passwort
</pre>
</pre>


==== httpd.conf für PHP ohne XAMPP ====
=== Installationen ohne XAMPP ===


Bei einer Installation von Apache, PHP, phpMyAdmin und MariaDB ohne XAMPP werden die Verwendung von PHP und die Berechtigungen nicht in der Datei "\conf\extra\httpd-xampp.conf" festgelegt, sondern in den Dateien "httpd.conf" und "\conf\extra\httpd-phpmyadmin.conf".
Die Server und Anwendungen werden wie bei einer XAMPP-Installation in ein Verzeichnis "D:\xampp\" installiert.


<pre>
Sofern Apache, MySQL/MariaDB, PHP, phpMyAdmin und gegebenenfalls Webalizer aus einem XAMPP-Paket verwendet werden, sind Angaben in den Konfigurationsdateien sowie in den batch-Dateien für Starts und Stopps anzupassen.
...
LoadModule php5_module D:/xampp/php/php5apache2_4.dll


<IfModule php5_module>
Es ist im Verzeichnis "D:\xampp\htdocs\" ein Unterverzeichnis "info\" anzugelegen, in das die Datei "phpinfo.php" aus dem XAMPP-Verzeichnis "dashboard\" kopiert wird. Im Verzeichnis "htdocs\" wird die XAMPP-Datei "index.php" dahingehend angepasst, dass die Weiterleitung nicht zum Verzeichnis "/dashboard/", sondern zur Datei "/info/phpinfo.php" führt und dass in der letzten Zeile im Textbereich das Wort "XAMPP" entfernt wird.
AddHandler application/x-httpd-php .php
PHPIniDir "D:/xampp/php"
</IfModule>
...
<IfModule mime_module>
  ...
  # For PHP
  AddType text/html .php
</IfModule>
...
# phpMyAdmin settings
Include "conf/extra/httpd-phpmyadmin.conf"
...
</pre>


==== httpd.conf für XAMPP ====
Die Dienste für Apache und MySQL müssen per Kommandozeile, die als Administrator zu öffnen ist, installiert werden, damit sie bei einem Windows-Server-Neustart ebenfalls neu gestartet werden


Bei einer Installation mit XAMPP werden die Verwendung von PHP und die Berechtigungen in der Datei "\conf\extra\httpd-xampp.conf" festgelegt und in der Datei "httpd.conf" in Z.250 hinzugefügt.
== Apache-Webserver ==


Der Apache-Webserver ist als Dienst zu installieren, damit er nach Rechner-Neustarts durch Windows-Updates automatisch gestartet werden kann.
=== Konfiguration für HTTPS ===
Es sind für HTTPS mit Verschlüsselung folgende Änderungen gegenüber HTTP ohne Verschlüsselung erforderlich:
* Server-Zertifikat
** Zertifikat von einer anerkannten Zertifizierungsstelle erstellen lassen
** Anpassung einiger Zertifikat-Dateien für Apache unter Windows
* Domain-Adresse für das Repositorium
* Apache-Konfiguration
** für Virtuelle Hosts mit Port 443 in der Datei "...\apache\extra\httpd-vhosts.conf"
** für Deaktivierung des Passphrasen-Dialogs in der Datei "...\apache\extra\httpd-ssl.conf"
* MediaWiki-Konfigurationsdatei "LocalSettings.php"
** eigene PHP-Variable für das bei der Anfrage verwendete Protokoll
** CreativeCommons-URLs mit https
==== Server-Zertifikat ====
Das Server-Zertifikat wird vom Rechenzentrum der Hochschule beim DFN beantragt.
===== Zertifikat-Domains =====
Das Zertifikat muss folgende Domain-Adressen abdecken:
* salzwiki.de, www.salzwiki.de
* saltwiki.net, www.saltwiki.net
* repository.hawk-hhg.de, salzwiki.hawk-hhg.de, saltwiki.hawk-hhg.de
===== Zertifikat-Dateien =====
Die Zertifikat-Dateien haben folgende Bezeichnungen:
* **öffentlicher Schlüssel**: "cert-***.pem" wird umbenannt in "salzwiki_cert_pem.crt"
* **Zertifikate-Kette**
** "salzwiki.de.pem" enthält zwischen den Zertifikate-Blöcken Hinweise zum jeweiligen Zertifikat und kann von Apache nicht verwendet werden
** "salzwiki_chain_pem.crt" wird als Kopie von "salzwiki.de.pem" ohne die Hinweise zwischen den Blöcken erstellt
* privater Schlüssel
** "salzwiki.de.key" ist mit einem Passwort geschützt und kann von Apache unter Windows nicht verwendet werden
** "salzwiki.de.nopw.key" wird als Kopie von "salzwiki.de.key" ohne Passwortschutz erstellt
Um die Datei mit dem privaten Schlüssel ohne Passwortschutz verwenden zu können, müssen die Zugriffsrechte für das Verzeichnis "...\apache\conf\ssl.key\" erhöht werden. Das Verzeichnis darf nur vom Webserver ausgelesen werden können und nur mit Admin-Rechten zugänglich sein. Die Windows-Gruppe "Benutzer" muss von der Vererbung der übergeordneten Verzeichnisse befreit und aus den Verzeichnis-Berechtigungen entfernt werden.
Für die Erzeugung der Datei mit dem privaten Schlüssel ohne Passwortschutz kann die Datei "...\apache\bin\openssl.exe" verwendet werden, wenn der Webserver aus dem "XAMPP"-Paket installiert ist. Hierzu die geschützte Schlüsseldatei in dasselbe Verzeichnis einfügen, die Kommandozeile mit Admin-Rechten öffnen und folgenden Befehl eingeben:
<pre>
<pre>
...
openssl x509 -in salzwiki.de.key -out salzwiki.de.nopw.key
# XAMPP settings
Include "conf/extra/httpd-xampp.conf"
...
</pre>
</pre>


=== Verzeichnisauflistungen verhindern  ===
Die Zertifikate-Dateien werden in folgenden Unterverzeichnissen von "...\apache\conf\" gespeichert:
* ssl.crt
** salzwiki_cert_pem.crt
** salzwiki_chain_pem.crt
* ssl.key
** salzwiki.de.key
** salzwiki.de.nopw.key


Um Auflistungen von Dateien und Verzeichnissen im Browser zu verhindern, ist die Angabe "-Indexes" in der Konfigurationsdatei "apache\conf\httpd.conf" Z.227ff und Z.246ff erforderlich:
==== Apache-Konfiguration ohne Passphrasen-Dialog ====
 
Um unter Windows den Apache-Webserver bei Seitenaufrufen an der Passwort-Abfrage zu hindern ist in der Datei "httpd-ssl.conf" der Passphrasen-Dialog wie folgt auszukommentieren:
<pre>
<pre>
<Directory />
#SSLPassPhraseDialog builtin
  Options -Indexes +FollowSymLinks
  AllowOverride none
  Require all denied
</Directory>
...
<Directory "/xampp/htdocs">
  Options -Indexes +FollowSymLinks +Includes -ExecCGI
  AllowOverride All
  Require all granted
</Directory>
</pre>
</pre>


=== Verzeichniszugriff per Authentifizierung ===
==== Wiki-Konfiguration für Übertragungsprotokoll ====


Um den Zugriff auf bestimmte Verzeichnisse per Browser nur für bestimmte Anmeldenamen mit Passwort zu erlauben, sind Angaben in folgenden Konfigurationsdateien erforderlich:
In der Datei "LocalSettings.php" wird bei Z.33ff eine Abfrage, welches Protokoll (http oder https) beim jeweiligen Seitenaufruf verwendet wird, eingefügt. Das Ergebnis wird in einer Variablen gespeichert und an mehreren Stellen in der Datei eingesetzt:
<pre>
## The protocol and server name to use in fully-qualified URLs
if($_SERVER['HTTPS']==="on" OR !empty($_SERVER['HTTPS'])){$protokoll = "https";}
else{$protokoll = "http";}
$wgServer = $protokoll."://".$_SERVER['SERVER_NAME'];
</pre>


* "xampp\apache\conf\httpd.conf"
=== Konfiguration für IP oder Domain ===
* "xampp\apache\conf\extra\httpd-default.conf"
* für phpMyAdmin ohne XAMPP
** "xampp\phpMyAdmin\.htaccess"
** "xampp\security\phpmyadmin.htpasswd"
* für XAMPP
** "xampp\htdocs\dashboard\.htaccess"
** "xampp\security\dashboard.htpasswd"


==== Datei "httpd.conf" ====
"SalzWiki" und "Salt"Wiki" wurden ursprünglich durch Weiterleitungen von den "1&1"-Servern über folgende IP-Adressen eines "HAWK"-Servers zur Verfügung gestellt:
Z.288ff und Z.520f
* salzwiki.de => 193.175.110.91/salzwiki
<pre>
* saltwiki.net => 193.175.110.91/saltwiki
<Files ".ht*">
 
  Require all denied
Das Repositorium war ohne Domain nur direkt über folgende IP-Adresse eines "HAWK"-Servers verfügbar:
<Files>
* 193.175.110.91/repository
...
 
# XAMPP settings
Für eine Nutzung der Wikis per "HTTPS" mit SSL-Server-Zertifikat müssen Domain-Adressen statt IP-Adressen verwendet werden. Hierfür wurde bei den über "1&1" gehosteten Domains der DNS-Eintrag vom "1&1"-Server zum "HAWK"-Server geändert und die Weiterleitung aufgehoben.
Include "conf/extra/httpd-xampp.conf"
 
# phpMyAdmin settings
Damit bei der Anmeldung im Repositorium vom Browser keine Sicherheitswarnung wegen eines fehlenden Server-Zertifikats erscheint, ist eine eigene Domain-Adresse für das Repositorium notwendig. Weil der Vertrag mit "1&1" keine Subdomains vorsieht, wurde hierfür bei der HAWK die Subdomain "repository.hawk-hhg.de" eingerichtet.
Include "conf/extra/httpd-phpmyadmin.conf"
 
</pre>
==== Konfiguration für IP ====
 
Sofern die Wikis mit der IP-Adresse verwendet werden, sind keine besonderen Anpassungen in den Apache-Konfigurationsdateien erforderlich, abgesehen von den Unterschieden zwischen einer Installation mit oder ohne "XAMPP".
 
==== Konfiguration für Domain ====
 
Sofern die Wikis mit den Domain-Adressen und "HTTPS" verwendet werden, sind Definitionen in folgenden Apache-Konfigurationsdateien im Unterverzeichnis "\extra\" erforderlich:
* httpd-vhosts.conf für Virtual Hosts
* httpd-ssl.conf eventuell für Anpassung der Standard-SSL-Konfiguration
 
===== Virtual Hosts =====
 
Mehrere Domain-Adressen mit unterschiedlichen Inhalten auf einem Server werden als Virtual Hosts (VHosts) in der Datei "httpd-vhosts.conf" verwaltet.
 
Der zuerst definierte VHost ist der Standard-Server, beispielsweise "localhost", für Test-Wikis ohne Domain-Adresse und für nicht definierte Adressen mit dem Standard-Port 80 für "HTTP". Danach folgen die Definitionen für die Domain-Adressen und ihre Alias-Adressen mit dem Standard-Port 80 für "HTTP":
* localhost (inkl. 193.175.110.91/salzwiki_draft, 193.175.110.91/saltwiki_draft, 193.175.110.91/repository_draft)
* salzwiki.de alias www.salzwiki.de und salzwiki.hawk-hhg.de
* saltwiki.net alias www.saltwiki.net und saltwiki.hawk-hhg.de
* repository.hawk-hhg.de
* subdomain-name.localhost


==== Datei "httpd-default.conf" ====
Für HTTPS-Verbindungen mit Port 443 erhalten folgende Domain-Adressen ebenfalls einen Eintrag in dieser VHosts-Datei – nicht in der Datei "httpd-ssl.conf":
Z.45
* localhost (mit selbst erstelltem SSL-Server-Zertifikat)
<pre>AccessFileName .htaccess</pre>
* salzwiki.de alias www.salzwiki.de und salzwiki.hawk-hhg.de
* saltwiki.net alias www.saltwiki.net und saltwiki.hawk-hhg.de
* repository.hawk-hhg.de


==== Datei ".htaccess" ohne XAMPP ====
====== Subdomains für localhost ======
"\xampp\phpMyAdmin\.htaccess"
<pre>
AuthType Basic
AuthName "phpMyAdmin"
AuthUserFile "../security/phpmyadmin.htpasswd"
Require valid-user
</pre>


==== Datei ".htaccess" mit XAMPP ====
Subdomains für "localhost" können als "ServerAlias" oder für lokale Tests als "ServerName" festgelegt werden. Hierfür ist zusätzlich die "hosts"-Datei von Windows im Verzeichnis "C:\Windows\System32\drivers\etc\" zu ergänzen:
"\xampp\dashboard\.htaccess"
<pre>
<pre>
AuthType Basic
# Für Tests des Hornemann Instituts der HAWK eingefügt 2017-05-23
AuthName "XAMPP Dashboard"
193.175.110.91  szw.localhost
AuthUserFile "../security/dashboard.htpasswd"
193.175.110.91  stw.localhost
Require valid-user
193.175.110.91  rpw.localhost
193.175.110.91  salzwiki.localhost
193.175.110.91  saltwiki.localhost
193.175.110.91  repository.localhost
</pre>
</pre>


==== Datei "htpasswd" ====
====== Umstellung von IP-Adresse zu Domain-Adresse ======


* ohne XAMPP: "\xampp\security\phpmyadmin.htpasswd"
Bei einer Umstellung von IP-Adresse zu Domain-Adresse ändert sich das "root"-Verzeichnis von "htdocs" zum jeweiligen Wiki-Unterverzeichnis, das bei der VHost-Definition angegeben ist. Deshalb werden beim Standard-VHost für die bisher verwendeten Wiki-IP-Adressen Weiterleitungen zu den Wiki-Domain-Adressen eingerichtet, weil bei einer solchen Umstellung auch in den Wiki-Konfigurationsdateien "LocalSettings.php" in Z.30 der Pfad bei "$wgScriptPath" zu einem leeren String zu ändern ist:
* mit XAMPP "\xampp\security\dashboard.htpasswd"
<pre>
<pre>
username:password
$wgScriptPath = ""; #"/salzwiki"; #"/saltwiki"; #"/repository";
</pre>
</pre>
Vergleich zwischen IP-Adresse und Domain-Adresse:
* SalzWiki
** IP-Adresse: salzwiki.de als Weiterleitung zu "193.175.110.91/salzwiki/" mit $wgScriptPath = "/salzwiki";
** Domain-Adresse: salzwiki.de als DNS-Eintrag zu "193.175.110.91" bei "1&1" mit Apache-VHost-Verzeichnis "/salzwiki" und mit $wgScriptPath = "";
* SaltWiki
** IP-Adresse: saltwiki.net als Weiterleitung zu "193.175.110.91/saltwiki/" mit $wgScriptPath = "/saltwiki";
** Domain-Adresse: saltwiki.net als DNS-Eintrag zu "193.175.110.91" bei "1&1" mit Apache-VHost-Verzeichnis "/saltwiki" und mit $wgScriptPath = "";
* Repository ohne Domain-Adresse
** IP-Adresse: "193.175.110.91/repository/" mit $wgScriptPath = "/repository";
* Repository mit Domain-Adresse
** IP-Adresse: repository.hawk-hhg.de als Weiterleitung zu "193.175.110.91/repository/" mit $wgScriptPath = "/repository";
** Domain-Adresse: repository.hawk-hhg.de als DNS-Eintrag zu "193.175.110.91" bei der HAWK mit Apache-VHost-Verzeichnis "/repository" und mit $wgScriptPath = "";


== XAMPP absichern ==
====== VHost-Definitionen ======


=== Verzeichniszugriff für "dashboard" einrichten ===
Für HTTPS ist das öffentliche Ketten-Zertifikat "salzwiki_chain_pem.crt" als Standard-Zertifikat in der Direktive "SSLCertificateFile" anzugeben und die Direktive "SSLCertificateChainFile" auszukommentieren, weil sonst die Browser bei der Überprüfung hängen bleiben, wenn nicht gerade der Apache-Dienst im Task-Manager neu gestartet wurde.


Um das Verzeichnis "dashboard", das als localhost-Startverzeichnis im Browser geladen wird, vor öffentlichen Zugriffen zu schützen, werden 2 Dateien angelegt:
Für HTTPS dürfen die Angaben für ServerName und ServerAlias keine Port-Angabe enthalten, weil "Google Chrome" sonst das Zertifikat als unsicher deklariert.
* "xampp\htdocs\dashboard\.htaccess"
* "xampp\security\dashboard.htpasswd"


Datei ".htaccess" mit "/" statt "\" in der Pfadangabe unter Windows wie bei Linux:
Einzutragende Definitionen in der Datei "httpd-vhosts.conf":
<pre>
<pre>
AuthType Basic
# Standard-VHost HTTP
AuthName "XAMPP Dashboard"
<VirtualHost *:80>
AuthUserFile "../security/dashboard.htpasswd"
ServerName localhost
Require valid-user
##ServerAlias 193.175.110.91
ServerAdmin service@salzwiki.de
DocumentRoot "D:/xampp/htdocs/"
ErrorLog "logs/error.log"
CustomLog "logs/access.log" combined
RewriteEngine On
RewriteCond %{REQUEST_URI} /salzwiki
RewriteCond %{REQUEST_URI} !=/salzwiki_
RewriteRule "^/salzwiki/(.*)$" "http://salzwiki.de/$1" [R=301,L]
RewriteCond %{REQUEST_URI} /saltwiki
RewriteCond %{REQUEST_URI} !=/saltwiki_
RewriteRule "^/saltwiki/(.*)$" "http://saltwiki.net/$1" [R=301,L]
# Weiterleitung, sobald eine Subdomain repository.hawk-hhg.de eingerichtet ist
RewriteCond %{REQUEST_URI} /repository
RewriteCond %{REQUEST_URI} !=/repository_
RewriteRule "^/repository/(.*)$" "http://repository.hawk-hhg.de/$1" [R=301,L]
</VirtualHost>
# Standard-VHost HTTPS
<VirtualHost *:443>
ServerName localhost
ServerAdmin service@salzwiki.de
DocumentRoot "D:/xampp/htdocs"
<Directory "D:/xampp/htdocs">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
</Directory>
ErrorLog "logs/error.log"
TransferLog "logs/access.log"
CustomLog "logs/ssl_request.log" "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
RewriteEngine On
RewriteCond %{HTTP_HOST} salzwiki.localhost
RewriteRule "^(.*)$" "https://salzwiki.de$1" [R=301,L]
RewriteCond %{REQUEST_URI} /repository
RewriteCond %{REQUEST_URI} !=/repository_
RewriteRule "^(.*)$" "http://193.175.110.91/$1" [R=301,L]
# Weiterleitung, sobald eine Subdomain repository.hawk-hhg.de eingerichtet ist
RewriteCond %{REQUEST_URI} /repository
RewriteCond %{REQUEST_URI} !=/repository_
RewriteRule "^/repository/(.*)$" "https://repository.hawk-hhg.de/$1" [R=301,L]
SSLEngine on
SSLCertificateFile "conf/ssl.crt/server.crt"
SSLCertificateKeyFile "conf/ssl.key/server.key"
</VirtualHost>
# SalzWiki-VHost HTTP
<VirtualHost *:80>
ServerName salzwiki.de
ServerAlias www.salzwiki.de salzwiki.hawk-hhg.de salzwiki.localhost
ServerAdmin service@salzwiki.de
DocumentRoot "D:/xampp/htdocs/salzwiki"
<Directory "D:/xampp/htdocs/salzwiki">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
</Directory>
ErrorLog "logs/error_salzwiki.log"
CustomLog "logs/access_salzwiki.log" combined
RewriteEngine On
RewriteCond %{HTTP_HOST} salzwiki.localhost
RewriteRule "^(.*)$" "http://193.175.110.91/salzwiki$1" [R=301,L]
RewriteCond %{REQUEST_URI} /repository
RewriteCond %{REQUEST_URI} !=/repository_
RewriteRule "^(.*)$" "http://193.175.110.91/$1" [R=301,L]
</VirtualHost>
# SalzWiki-VHost HTTPS
<VirtualHost *:443>
ServerName salzwiki.de
ServerAlias www.salzwiki.de salzwiki.hawk-hhg.de salzwiki.localhost
ServerAdmin service@salzwiki.de
DocumentRoot "D:/xampp/htdocs/salzwiki"
<Directory "D:/xampp/htdocs/salzwiki">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
</Directory>
ErrorLog "logs/error_salzwiki.log"
TransferLog "logs/access_salzwiki.log"
CustomLog "logs/ssl_request.log" "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
RewriteEngine On
RewriteCond %{HTTP_HOST} salzwiki.localhost
RewriteRule "^(.*)$" "https://salzwiki.de$1" [R=301,L]
RewriteCond %{REQUEST_URI} /repository
RewriteCond %{REQUEST_URI} !=/repository_
RewriteRule "^(.*)$" "http://193.175.110.91/$1" [R=301,L]
SSLEngine on
SSLCertificateFile "conf/ssl.crt/salzwiki_chain_pem.crt"
#SSLCertificateFile "conf/ssl.crt/salzwiki_cert_pem.crt"
SSLCertificateKeyFile "conf/ssl.key/salzwiki.denopw.key"
#SSLCertificateChainFile "conf/ssl.crt/salzwiki_chain_pem.crt"
#SSLCertificateFile "conf/ssl.crt/server.crt"
#SSLCertificateKeyFile "conf/ssl.key/server.key"
</VirtualHost>
# SaltWiki-VHost HTTP
<VirtualHost *:80>
ServerName saltwiki.net
ServerAlias www.saltwiki.net saltwiki.hawk-hhg.de saltwiki.localhost
ServerAdmin service@saltwiki.net
DocumentRoot "D:/xampp/htdocs/saltwiki"
<Directory "D:/xampp/htdocs/saltwiki">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
</Directory>
ErrorLog "logs/error_saltwiki.log"
CustomLog "logs/access_saltwiki.log" combined
RewriteEngine On
RewriteCond %{HTTP_HOST} saltwiki.localhost
RewriteRule "^(.*)$" "http://193.175.110.91/saltwiki$1" [R=301,L]
RewriteCond %{REQUEST_URI} /repository
RewriteCond %{REQUEST_URI} !=/repository_
RewriteRule "^(.*)$" "http://193.175.110.91/$1" [R=301,L]
</VirtualHost>
# SaltWiki-VHost HTTPS
<VirtualHost *:443>
ServerName saltwiki.net
ServerAlias www.saltwiki.net saltwiki.hawk-hhg.de saltwiki.localhost
ServerAdmin service@saltwiki.net
DocumentRoot "D:/xampp/htdocs/saltwiki"
<Directory "D:/xampp/htdocs/saltwiki">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
</Directory>
ErrorLog "logs/error_saltwiki.log"
TransferLog "logs/access_saltwiki.log"
CustomLog "logs/ssl_request.log" "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
RewriteEngine On
RewriteCond %{HTTP_HOST} saltwiki.localhost
RewriteRule "^(.*)$" "https://saltwiki.net$1" [R=301,L]
RewriteCond %{REQUEST_URI} /repository
RewriteCond %{REQUEST_URI} !=/repository_
RewriteRule "^(.*)$" "http://193.175.110.91/$1" [R=301,L]
SSLEngine on
SSLCertificateFile "conf/ssl.crt/salzwiki_chain_pem.crt"
#SSLCertificateFile "conf/ssl.crt/salzwiki_cert_pem.crt"
SSLCertificateKeyFile "conf/ssl.key/salzwiki.denopw.key"
#SSLCertificateChainFile "conf/ssl.crt/salzwiki_chain_pem.crt"
#SSLCertificateFile "conf/ssl.crt/server.crt"
#SSLCertificateKeyFile "conf/ssl.key/server.key"
</VirtualHost>
# Repositorium-VHost HTTP
<VirtualHost *:80>
ServerName repository.hawk-hhg.de
ServerAlias repository.localhost
ServerAdmin service@salzwiki.de
DocumentRoot "D:/xampp/htdocs/repository"
<Directory "D:/xampp/htdocs/repository">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
</Directory>
ErrorLog "logs/error_repository.log"
CustomLog "logs/access_repository.log" combined
# Weiterleitung, solange keine Subdomain repository.hawk-hhg.de eingerichtet ist
RewriteEngine On
RewriteCond %{HTTP_HOST} repository.localhost [OR]
RewriteCond %{HTTP_HOST} repository.hawk-hhg.de
RewriteRule "^(.*)$" "http://193.175.110.91/repository$1" [R=301,L]
</VirtualHost>
# Repositorium-VHost HTTPS
<VirtualHost *:443>
ServerName repository.hawk-hhg.de
ServerAlias repository.localhost
ServerAdmin service@salzwiki.de
DocumentRoot "D:/xampp/htdocs/repository"
<Directory "D:/xampp/htdocs/repository">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
</Directory>
ErrorLog "logs/error_repository.log"
TransferLog "logs/access_repository.log"
CustomLog "logs/ssl_request.log" "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
# Weiterleitung, solange keine Subdomain repository.hawk-hhg.de eingerichtet ist
#RewriteEngine On
#RewriteCond %{HTTP_HOST} repository.localhost [OR]
#RewriteCond %{HTTP_HOST} repository.hawk-hhg.de
#RewriteRule "^(.*)$" "https://193.175.110.91/repository$1" [R=301,L]
SSLEngine on
SSLCertificateFile "conf/ssl.crt/salzwiki_chain_pem.crt"
#SSLCertificateFile "conf/ssl.crt/salzwiki_cert_pem.crt"
SSLCertificateKeyFile "conf/ssl.key/salzwiki.denopw.key"
#SSLCertificateChainFile "conf/ssl.crt/salzwiki_chain_pem.crt"
#SSLCertificateFile "conf/ssl.crt/server.crt"
#SSLCertificateKeyFile "conf/ssl.key/server.key"
</VirtualHost>
 
######## Beginn Draft-Wikis für Tests ########
<VirtualHost *:80>
ServerName szw.localhost
ServerAdmin service@salzwiki.de
DocumentRoot "D:/xampp/htdocs/salzwiki_draft"
<Directory "D:/xampp/htdocs/salzwiki_draft">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
</Directory>
ErrorLog "logs/error_salzwiki_draft.log"
CustomLog "logs/access_salzwiki_draft.log" combined
RewriteEngine On
RewriteCond %{HTTP_HOST} szw.localhost
RewriteRule "^(.*)$" "http://193.175.110.91/salzwiki_draft$1" [R=301,L]
</VirtualHost>
<VirtualHost *:80>
ServerName stw.localhost
ServerAdmin service@saltwiki.net
DocumentRoot "D:/xampp/htdocs/saltwiki_draft"
<Directory "D:/xampp/htdocs/saltwiki_draft">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
</Directory>
ErrorLog "logs/error_saltwiki_draft.log"
CustomLog "logs/access_saltwiki_draft.log" combined
RewriteEngine On
RewriteCond %{HTTP_HOST} stw.localhost
RewriteRule "^(.*)$" "http://193.175.110.91/saltwiki_draft$1" [R=301,L]
</VirtualHost>
<VirtualHost *:80>
ServerName rpw.localhost
ServerAdmin service@salzwiki.de
DocumentRoot "D:/xampp/htdocs/repository_draft"
<Directory "D:/xampp/htdocs/repository_draft">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
</Directory>
ErrorLog "logs/error_repository_draft.log"
CustomLog "logs/access_repository_draft.log" combined
RewriteEngine On
RewriteCond %{HTTP_HOST} rpw.localhost
RewriteRule "^(.*)$" "http://193.175.110.91/repository_draft$1" [R=301,L]
</VirtualHost>
######## Ende Draft-Wikis für Tests ########
</pre>
</pre>


Datei "dashboard.htpasswd", wobei "username" und "passwort" hier nur exemplarisch angegeben sind:
=== conf-Dateien mit und ohne XAMPP ===
 
Konfigurationsdateien mit Verzeichnispfaden:
* Datei "apache\conf\httpd.conf
* Dateien im Verzeichnis "apache\conf\extra\"
** httpd-autoindex.conf
** httpd-dav.conf
** httpd-manual.conf
** httpd-multilang-errordoc.conf
** httpd-ssl.conf
** httpd-vhosts.conf
* XAMPP-Konfiguration "apache\conf\extra\httpd-xampp.conf"
 
=== Apache ohne XAMPP ===
 
Für die Nutzung von Apache ohne XAMPP ist zu berücksichtigen, dass der Apache-Webserver für Windows nicht bei [http://httpd.apache.org/docs/current/platform/windows.html#down apache.org] erhältlich ist. Es empfiehlt sich die Verwendung des Apache aus einem [https://www.apachefriends.org/index.html?ModPagespeed=noscript XAMPP-Paket von apachefriends.org]. Eventuell können auch die Portable-Versionen von [https://sourceforge.net/projects/apachehttpportable/ ApacheHTTPD_PHP_Portable_2.4.6] und [https://sourceforge.net/projects/apache2portable/ portable-apache-2.2.17-win32-x86] verwendet werden.
 
==== Verzeichnisumbenennung ====
 
Sofern das Verzeichnis für Apache "Apache24" lautet, wird es in "apache" umbenannt.
 
Die Pfadangaben in den Konfigurationsdateien mit der Dateiendung "conf" und in den batch-Dateien für Starts und Stopps mit der Dateiendung "bat" sind anschließend an die Bezeichnung "apache" anzupassen.
 
==== Apache als Dienst installieren ====
 
Nachdem die Kommandozeile als Administrator geöffnet wurde, den Apache-Dienst installieren:
<pre>
<pre>
username:passwort
D:
cd xampp\apache\bin
httpd -k install
</pre>
</pre>


=== Verzeichniszugriff für bestimmte Rechner-IPs ===
==== Start und Stopp im Produktivbetrieb ====
 
Unter "Systemsteuerung => System und Sicherheit => Verwaltung => Dienste" prüfen, ob der Dienst "Apache2.4" den Starttyp "Automatisch" aufweist, damit er nach einem Rechner-Neustart automatisch gestartet wird.


Das XAMPP-Sicherheitskonzept ab XAMPP 1.8 erlaubt den Zugriff per Browser auf bestimmte Verzeichnisse wie "phpmyadmin" nur noch vom Server aus ("Require local").
Um den Apache-Dienst zu starten oder anzuhalten, wird unter "Verwaltung => Dienste" nach Auswahl des Dienstes "Apache2.4" entweder im Menü unter "Aktion" oder mit der rechten Maustaste im Kontextmenü der jeweilige Vorgang ausgewählt.


Um von einem Rechner aus, der sich in einem bestimmten Netz befindet oder per VPN mit einer bestimmten IP verbunden ist, per Browser die Verzeichnisse nicht nur mit "localhost" aufrufen zu können, müssen zusätzliche Angaben mit "Require ip ..." erfolgen:
==== Start und Stopp im Testbetrieb ====


Datei "xampp\apache\conf\extra\httpd-xampp.conf" Z.108ff
Der Apache-Webserver kann entweder mit Hilfe des Apache-Monitors oder per Kommandozeile gestartet und angehalten werden:
<pre>
<pre>
# New XAMPP security concept
NET start Apache2.4
&lt;LocationMatch "^/(?i:(?:xampp|security|licenses|phpmyadmin|webalizer|server-status|server-info))"&gt;
 
  Require local
cd D:\xampp\
  Require ip 193.175.110
apache\bin\pv -f -k httpd.exe -q
  Require ip 172.16.100.2
&lt;/LocationMatch&gt;
</pre>
</pre>


== Suchmaschinen  ==
=== Konfiguration allgemein ===


=== robots.txt ===
Bei einer Installation von Apache ohne XAMPP werden die Verwendung von PHP und die Berechtigungen etwas anders als bei einer Installation mit XAMPP festgelegt. Die Haupt-Konfiguration unterscheidet sich je nach Installation wie folgt:
* ohne XAMPP: in der Datei "apache\conf\httpd.conf"
* mit XAMPP: zusätzlich in der Datei "apache\conf\extra\httpd-xampp.conf"


Damit Test-Wikis während der Erprobungsphase, das Repositorium und verschiedene Wiki-Unterverzeichnisse nicht von Suchmaschinen durchsucht werden, wird eine Datei "robots.txt" im Verzeichnis "htdocs" gespeichert.
==== httpd.conf mit und ohne XAMPP ====
<br/>Damit kein Robot irgendetwas liest:
<pre>User-agent: *
Disallow:</pre>


Angaben nach dem Upgrade auf MW1.23 am 26.02.2016, damit Robots nur das jeweilige Hauptverzeichnis von SalzWiki und SaltWiki und sonst nichts durchsuchen:
<pre>
<pre>
# robots.txt für Salzwiki und Saltwiki, damit Robots weder Unterverzeichnisse noch das Repositorium noch Test-Wikis durchsuchen
ServerRoot "D:/xampp/apache"
User-agent: *
Listen 80
Disallow:/dashboard/
...
Disallow:/webalizer/
LoadModule acces_compat_module modules/mod_access_compat.so
Disallow:/xampp/
LoadModule actions_module modules/mod_actions.so
Disallow:/salzwiki/cache/
LoadModule alias_module modules/mod_alias.so
Disallow:/salzwiki/docs/
LoadModule allowmethods_module modules/mod_allowmethods.so
Disallow:/salzwiki/extensions/
LoadModule asis_module modules/mod_asis.so
Disallow:/salzwiki/images/
LoadModule auth_basic_module modules/mod_auth_basic.so
Disallow:/salzwiki/includes/
LoadModule authn_core_module modules/mod_authn_core.so
Disallow:/salzwiki/languages/
LoadModule authn_file_module modules/mod_authn_file.so
Disallow:/salzwiki/maintenance/
LoadModule authz_core_module modules/mod_authz_core.so
Disallow:/salzwiki/mw-config/
LoadModule authz_groupfile_module modules/mod_authz_groupfile.so
Disallow:/salzwiki/resources/
LoadModule authz_host_module modules/mod_authz_host.so
Disallow:/salzwiki/serialized/
LoadModule authz_user_module modules/mod_authz_user.so
Disallow:/salzwiki/skins/
LoadModule autoindex_module modules/mod_autoindex.so
Disallow:/salzwiki/tests/
LoadModule dir_module modules/mod_dir.so
Disallow:/saltwiki/cache/
LoadModule env_module modules/mod_env.so
Disallow:/saltwiki/docs/
LoadModule include_module modules/mod_include.so
Disallow:/saltwiki/extensions/
LoadModule isapi_module modules/mod_isapi.so
Disallow:/saltwiki/images/
LoadModule log_config_module modules/mod_log_config.so
Disallow:/saltwiki/includes/
LoadModule mime_module modules/mod_mime.so
Disallow:/saltwiki/languages/
LoadModule negotiation_module modules/mod_negotiation.so
Disallow:/saltwiki/maintenance/
LoadModule rewrite_module modules/mod_rewrite.so
Disallow:/saltwiki/mw-config/
#LoadModule session_module modules/mod_session.so
Disallow:/saltwiki/resources/
#LoadModule session_cookie_module modules/mod_session_cookie.so
Disallow:/saltwiki/serialized/
#LoadModule session_crypto_module modules/mod_session_crypto.so
Disallow:/saltwiki/skins/
LoadModule setenvif_module modules/mod_setenvif.so
Disallow:/saltwiki/tests/
LoadModule ssl_module modules/mod_ssl.so
Disallow:/repository/
LoadModule status_module modules/mod_status.so
Disallow:/salzwiki_draft/
...
Disallow:/saltwiki_draft/
ServerAdmin webmaster@hornemann-institut.de
Disallow:/repository_draft/
ServerName localhost:80
Disallow:/salz_salt_repo/
...
Disallow:/mediawiki_1_23_11/
DocumentRoot D:/xampp/htdocs
...
<IfModule dir_module>
  DirectoryIndex index.php index.shtml index.html index.htm \
                default.php default.shtml default.html default.htm \
                home.php home.shtml home.html home.htm
</IfModule>
...
<Files ".ht*">
  Require all denied
</Files>
</pre>
</pre>


Im  jeweiligen Wiki-Hauptverzeichnis:
==== httpd.conf ohne XAMPP ====
<pre>
# Robots sollen keine Unterverzeichnisse durchsuchen
User-agent: *
Disallow:/cache/
Disallow:/docs/
Disallow:/extensions/
Disallow:/images/
Disallow:/includes/
Disallow:/languages/
Disallow:/maintenance/
Disallow:/mw-config/
Disallow:/resources/
Disallow:/serialized/
Disallow:/skins/
Disallow:/tests/
</pre>


=== Setzen von Keywords für den Head-Bereich eines Wikis ===
Bei einer Installation von Apache ohne XAMPP werden die Verwendung von PHP und die Berechtigungen nicht in der Datei "\conf\extra\httpd-xampp.conf", sondern in der Datei "httpd.conf" wie folgt festgelegt.


Hierzu ist in der Datei "LocalSettings.php" die Funktion "efSetKeywords()" mit den entsprechenden Keywords einzufügen. Hier am Beispiel von SaltWiki. Diese sind jedoch nur bei Zugang über die IP-Adresse und nicht über den Frame von 1&1 sichtbar. Damit Keywords über den Frame sichtbar sind, sind diese für unseren Zugang bei 1&1 bei der Einrichtung der Website mit anzugeben. Dasselbe gilt für "description".
<pre>
...
#### aus "/extras/httpd-xampp.conf"
LoadFile "/xampp/php/php5ts.dll"
LoadFile "/xampp/php/libpq.dll"
...
#### aus "/extras/httpd-xampp.conf"
LoadModule php5_module D:/xampp/php/php5apache2_4.dll
...
#### aus "/extras/httpd-xampp.conf"
<IfModule env_module>
  SetEnv MIBDIRS "/xampp/php/extras/mibs"
  SetEnv MYSQL_HOME "\\xampp\\mysql\\bin"
  SetEnv OPENSSL_CONF "/xampp/apache/bin/openssl.cnf"
  SetEnv PHP_PEAR_SYSCONF_DIR "\\xampp\\php"
  SetEnv PHPRC "\\xampp\\php"
  SetEnv TMP "\\xampp\\tmp"
</IfModule>
...
<IfModule mime_module>
  ...
  #AddType text/html .shtml
  #AddOutputFilter INCLUDES .shtml
  #### Fuer PHP aus "/extras/httpd-xampp.conf"
  AddType text/html .php
  #AddType text/html .php .phps
</IfModule>
...
#### aus "/extras/httpd-xampp.conf"
<IfModule php5_module>
  PHPIniDir "/xampp/php"
  #PHPIniDir "D:/xampp/php"
</IfModule>
...
# XAMPP settings
#Include "conf/extra/httpd-xampp.conf"
...
#### aus "/extras/httpd-xampp.conf"
<FilesMatch "\.php$">
  SetHandler application/x-httpd-php
</FilesMatch>
#<FilesMatch "\.phps$">
#  SetHandler application/x-httpd-php-source
#</FilesMatch>


<pre>##Setzen von keywords
#### aus "/extras/httpd-xampp.conf" abgewandelt
function efSetKeywords(){
<LocationMatch "^/(?i:(?:phpmyadmin|info))">
  global $wgOut;
  Require local
  $wgOut->addKeyword( 'salt' );
   Require ip 193.175.110.
  $wgOut->addKeyword( 'desalination' );
   Require ip 10.104.5.
  $wgOut->addKeyword( 'salt decay' );    
  Require ip 172.16.100.2
  $wgOut->addKeyword( 'cultural heritage' );    
</LocationMatch>
  $wgOut->addKeyword( 'salt damage' );
  $wgOut->addKeyword( 'conservation' );
}
</pre>
</pre>


== E-Mail-Versand  ==
==== httpd.conf für XAMPP ====


Die HAWK-Outlook-Adressen können nicht für den Versand per SMTP als Absender verwendet werden, sondern nur als Zieladresse.
Bei einer Installation mit XAMPP werden die Verwendung von PHP und die Berechtigungen in der Datei "\conf\extra\httpd-xampp.conf" festgelegt, welche in der Datei "httpd.conf" in Z.250 eingebunden wird.


Die Datei "localSettings.php" wurde in den Verzeichnissen
<pre>
 
...
*salzwiki/  
# XAMPP settings
*repository/
Include "conf/extra/httpd-xampp.conf"
*saltwiki/
...
</pre>


folgendermaßen für E-Mail-Versand angepasst:
=== Verzeichnisauflistungen verhindern ===


'''Salzwiki/Repositorium'''
Um Auflistungen von Dateien und Verzeichnissen im Browser zu verhindern, ist die Angabe "-Indexes" in der Konfigurationsdatei "apache\conf\httpd.conf" Z.227ff und Z.246ff erforderlich:
<pre>
<pre>
## E-Mail-Versand angepasst 15.01.2016 G. Werner
<Directory />
$wgEmergencyContact = "salzwiki.fb@hawk-hhg.de";
  Options -Indexes +FollowSymLinks
$wgPasswordSender = "service@salzwiki.de";
  AllowOverride none
$wgSMTP = array(
  Require all denied
'host' =&gt; "smtp.1und1.de",
</Directory>
'IDHost' =&gt; "1und1.de",
...
'port' =&gt; "587",
<Directory "/xampp/htdocs">
'auth' =&gt; true,
  Options -Indexes +FollowSymLinks +Includes -ExecCGI
'username' =&gt; "service@salzwiki.de",
  AllowOverride All
'password' =&gt; "********"
  Require all granted
);
</Directory>
$wgEnotifUserTalk = true; # UPO
$wgEnotifWatchlist = true; # UPO
$wgEmailAuthentication = true;
</pre>
</pre>


'''Saltwiki'''
=== Verzeichniszugriff per Authentifizierung ===
<pre>
 
## E-Mail-Versand angepasst 15.01.2016 G. Werner
Um den Zugriff auf bestimmte Verzeichnisse per Browser nur für bestimmte Anmeldenamen mit Passwort zu erlauben, sind Angaben in folgenden Konfigurationsdateien erforderlich:
$wgEmergencyContact = "saltwiki.fb@hawk-hhg.de";
 
$wgPasswordSender = "service@saltwiki.net";
* "xampp\apache\conf\httpd.conf"
$wgSMTP = array(
* "xampp\apache\conf\extra\httpd-default.conf"
'host' =&gt; "smtp.1und1.de",
* für phpMyAdmin ohne XAMPP
'IDHost' =&gt; "1und1.de",
** "xampp\phpMyAdmin\config.inc.php"
'port' =&gt; "587",
* für XAMPP
'auth' =&gt; true,
** "xampp\htdocs\dashboard\.htaccess"
'username' =&gt; "service@saltwiki.net",
** "xampp\security\dashboard.htpasswd"
'password' =&gt; "********"  
 
);
==== Apache-Datei "httpd.conf" ====
$wgEnotifUserTalk = true; # UPO
Z.288ff und Z.520f
$wgEnotifWatchlist = true; # UPO
<pre>
$wgEmailAuthentication = true;
<Files ".ht*">
  Require all denied
<Files>
...
# XAMPP settings
Include "conf/extra/httpd-xampp.conf"
</pre>
</pre>


== Externe Links ==
==== Apache-Datei "httpd-default.conf" ====


Damit externe Links in einem neuen Fenster geöffnet werden, ist in die "localsettings.php" einzufügen:
Z.45
<pre>AccessFileName .htaccess</pre>


##Externe links erscheinen in einem neuen Fenster
==== XAMPP-Dashboard-Datei ".htaccess" ====
$wgExternalLinkTarget = '_blank';
 
== Datenbank-Fehler ==


Falls ein Hinweis "A database query error has occured" angezeigt wird, kann man sich weitere Angaben anzeigen lassen, indem man in der Datei "LocalSettings.php" unten einfügt:
Datei "\xampp\dashboard\.htaccess"
<pre>
<pre>
$wgShowSQLErrors = 1;
AuthType Basic
AuthName "XAMPP Dashboard"
AuthUserFile "../security/dashboard.htpasswd"
Require valid-user
</pre>
</pre>


== Versionshinweise ==
==== XAMPP-Dashboard-Datei "htpasswd" ====
 
Datei "\xampp\security\dashboard.htpasswd":
<pre>
username:password
</pre>


=== Betriebssystem und Wiki-Serversysteme ===
=== Verzeichniszugriff für bestimmte Rechner-IPs ===


* Beim Testserver mit Windows Server 2012R2 Datacenter wird auf XAMPP verzichtet und werden folgende Einzelsysteme eingerichtet:
Um von einem Rechner aus, der sich in einem bestimmten Netz befindet oder per VPN mit einer bestimmten IP verbunden ist, per Browser die Verzeichnisse nicht nur mit "localhost" aufrufen zu können, müssen zusätzliche Angaben mit "Require ip ..." erfolgen; die Fehlermeldung für einen unzulässigen Aufruf wird mit "ErrorDocument ..." erzeugt.
** Apache 2.4.20 für Windows und VC11 von http://www.apachelounge.com, alternativ von http://www.apachehaus.com im Verzeichnis "D:\xampp\apache\"
** MariaDB 10.0.17 Server mit libmysql - mysqlnd5.0.11dev Client von http://ftp.hosteurope.de/mirror/archive.mariadb.org/ oder https://downloads.mariadb.org/mariadb/+releases/ bzw. http://archive.mariadb.org/mariadb-10.0.17/
** PHP 5.6.14 für Windows und VC11 von http://windows.php.net/downloads/releases/archives/ im Verzeichnis "D:\xampp\php\"
** phpMyAdmin 4.5.0.2
* Beim Produktivserver mit Windows Server 2008 SP2 (Standard Edition) wird XAMPP 5.6.14.0 verwendet


=== Datenbanksystem ===  
==== Verzeichniszugriff für IPs mit XAMPP ====


* MySQL-Upgrade von Version 5.1 zu Version 5.6 ist nur möglich über Version 5.5
Das XAMPP-Sicherheitskonzept ab XAMPP 1.8 erlaubt den Zugriff per Browser auf bestimmte Verzeichnisse wie "phpmyadmin" nur noch vom Server aus ("Require local").
* XAMPP hat zuletzt in Version 1.8.2-6 die MySQL-Version 5.5.x, danach die Version 5.6
* XAMPP hat bis Version 5.5.28 bzw. 5.6.12 als Datenbanksystem MySQL, danach MariaDB
* XAMPP hat in Version 5.6.14.0 die MariaDB-Version 10.0.x, aber in Version 5.6.14.3 die MariaDB-Version 10.1.x


=== XAMPP ===
Beispiel XAMPP 5.6.14, Datei "xampp\apache\conf\extra\httpd-xampp.conf" Z.108ff
<pre>
# New XAMPP security concept
&lt;LocationMatch "^/(?i:(?:xampp|security|licenses|phpmyadmin|webalizer|server-status|server-info))"&gt;
  Require local
  Require ip 193.175.110
  Require ip 10.104.5
  Require ip 172.16.100.2
  ErrorDocument 403 /error/XAMPP_FORBIDDEN.html.var
&lt;/LocationMatch&gt;
</pre>


==== XAMPP 5.6.14.3 ====
==== Verzeichniszugriff für IPs ohne XAMPP ====
* PHP 5.6.14 32Bit
* VC11 MS Visual C++ 2012 redistributable x86 Update 4
* <b>MariaDB 10.1</b>.8 Win32 (Server), libmysql - mysqlnd 5.0.11dev (Client)
* Apache 2.4.17 Win32
* phpMyAdmin 4.5.1, Zeichensatz MySQL-Verbindung utf8mb4_unicode_ci
* OpenSSL 1.0.2d
* XAMPP Control Panel 3.2.2


==== XAMPP 5.5.30/5.6.14.0 ====
Beispiel ohne XAMPP, Datei "xampp\apache\conf\httpd.conf" am Ende:
* PHP 5.5.30/5.6.14 32Bit + Pear, MS VC11 x86 32Bit ThreadSafe
<pre>
* VC11 MS Visual C++ 2012 redistributable x86 Update 4
&lt;LocationMatch "^/(?i:(?:info|phpmyadmin))"&gt;
* <b>MariaDB 10.0</b>.17 Win32 (Server), libmysql - mysqlnd 5.0.11dev (Client)
  Require local
* Apache 2.4.17 Win32
  Require ip 193.175.110
* phpMyAdmin 4.5.0.2, Zeichensatz MySQL-Verbindung utf8mb4_unicode_ci
  Require ip 10.104.5
* OpenSSL 1.0.2d
  Require ip 172.16.100.2
* XAMPP Control Panel 3.2.1
&lt;/LocationMatch&gt;
</pre>


==== XAMPP 5.5.28/5.6.12 ====
=== Server-Software auf Fehlerseiten nicht anzeigen ===
* PHP 5.5.28/5.6.12 + Pear, MS VC11 x86 32Bit ThreadSafe
* MySQL 5.6.26-Community
* Apache 2.4.16 Win32
* phpMyAdmin 4.4.14
* openSSL 1.0.1i


==== XAMPP 1.8.2-6 ====
Standardmäßig werden auf den Fehlerseiten folgende Details des Webservers angezeigt:
* PHP 5.4.31, MS VC9
* Webserver-Bezeichnung "Apache"
* MySQL 5.5.32-Community
* Webserver-Version
* Apache 2.4.4 Win32
* Betriebssystem-Art "Win32"
* phpMyAdmin 4.0.4
* OpenSSL-Version
* openSSL 0.9.8y mit OpenSSL-Bug "Heartbleed"


==== XAMPP 1.8.0 ====
Um dies aus Sicherheitsgründen zu unterbinden, ist in der Datei "D:\xampp\apache\error\include\bottom.html" im span-Element für die Variable "SERVER_SOFTWARE" hinter dem öffnenden HTML-Kommentar ein Leerzeichen einzufügen:
Neues Sicherheitskonzept: Zugriff per Browser auf Verzeichnisse wie "phpmyadmin" nur noch direkt vom Server aus ("Require local")
<pre>
<span><!-- #echo var="SERVER_SOFTWARE" --></span>
</pre>


==== XAMPP 1.7.1 ====
== Datenbank-Server ==
* PHP 5.2.9, MS Visual C++ 2008 redistributable x86 9.0...
* MySQL 5.1.33-Community Client 5.0.51a
* Apache 2.2.11 Win32
* phpMyAdmin 3.1.3.1


=== MediaWiki ===
Der MySQL-Datenbank-Server ist als Dienst zu installieren, damit er nach Rechner-Neustarts durch Windows-Updates automatisch gestartet werden kann.


==== MW Version 1.25 ====
=== MySQL/MariaDB ohne XAMPP ===


* Skins
Nachdem die Kommandozeile als Administrator geöffnet wurde, den MySQL-Dienst installieren:
** "Autodiscovery mechanism" entfällt
<pre>
** Die Skin-Datei "MonoBookSW.php" anpassen an die neue Version, siehe https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery#Migration_guide
D:
* Datei "LocalSettings.php" anpassen
cd xampp\mysql\bin
** $wgDisableCounters entfällt; für Seitenbesuchszahlen ist die Erweiteerung "HitCounters" erforderlich
mysqld --install
** Skin-Registrierung
</pre>
** Erweiterungen-Registrierung
 
==== Start und Stopp im Produktivbetrieb ====
 
Unter "Systemsteuerung => System und Sicherheit => Verwaltung => Dienste" prüfen, ob der Dienst "mysql" den Starttyp "Automatisch" aufweist, damit er nach einem Rechner-Neustart automatisch gestartet wird.
 
Um den mysql-Dienst zu starten oder anzuhalten, wird unter "Verwaltung => Dienste" nach Auswahl des Dienstes "mysql" entweder im Menü unter "Aktion" oder mit der rechten Maustaste im Kontextmenü der jeweilige Vorgang ausgewählt.
 
==== Start und Stopp im Testbetrieb ====
 
Für Testzwecke aus dem XAMPP-Paket folgende Dateien in das Verzeichnis "D:\xampp\" kopieren:
* mysql_start.bat
* mysql_stop.bat
 
Auf dem Desktop jeweils eine Verknüpfung zu den beiden bat-Dateien anlegen.


Skin-Registrierung
Der MySQL-Server kann per Batch-Datei oder Kommandozeile gestartet und angehalten werden:
<pre>
<pre>
wfLoadSkin("MonoBook"); //statt require_once "$IP/skins/MonoBook.php";
D:
cd xampp\mysql\
bin\mysqld.exe --defaults-file=mysql\bin\my.ini
 
D:
cd xampp\mysql
bin\mysqld.exe -q
del data\%computername%.pid
</pre>
</pre>


Erweiterungen-Registrierung
== PHP ==
<pre>
wfLoadExtension("Cite"); //statt require_once "$IP/extensions/Cite/Cite.php";
</pre>


==== MW Version 1.24 ====
=== PHP-Versionen ===


* Logo-Speicherort geändert von "skins/common/images/" zu "resources/assets/" bzw. "images/..."
==== PHP 7.2.2 ====
* Bisher mitgelieferte Skins sind nicht mehr enthalten; die jeweiligenSkins-php-Dateien und Ordner sind gegebenenfalls aus dem Verzeichnis "skins/" zu entfernen:
** CologneBlue.php, cologneblue
** Modern.php, modern
** MonoBook.php, monobook
** Vector.php, vector
* Datei "LocalSettings.php" eventuell an neue Skin-Registrierung anpassen
<pre>
require_once "$IP/skins/MonoBookSW.php"; //statt $wgDefaultSkin = "monobooksw";
</pre>
* Nicht mehr unterstützt wird "register_globals => Bei PHP vor Version 5.4 in der Datei "php.ini" angeben "register_globals=Off"
* Erweiterung "OggHandler" wird nicht mehr unterstützt


==== MW Version 1.23 ====
* Core-Erweiterung "Cite" erzeugt Fehler "Umcommitted DB writes"
* Core-Erweiterung "ImageMap" erzeugt Fehler "Fatal exception of type MWException"


* Skins werden anders eingebunden
==== PHP 7.1 ====
** Das jeweilige Skin-Unterverzeichnis sollte wie die php-Datei die Groß-Klein-Schreibweise berücksichtigen ("monobooksw/" => "MonoBookSW/")
** Kleinbuchstaben bei $wgDefaultSkin = "monobooksw"; in der Datei "LocalSettings.php"
** Die Skin-php-Datei, z. B. "MonoBookSW.php", ist nicht mehr im Verzeichnis "skins/", sondern im Unterverzeichnis, z. B. "skins/MonoBookSW/"
** Die Skin-Datei "MonoBookSW.php" anpassen an die neue Version, siehe www.mediawiki.org/wiki/Manual:Skin_autodiscovery#Migration_guide
* "Autodiscovery mechanism" für "Core Skins" gilt als "deprecated" und schreibt Warnungen in die Log-Dateien. Folgende Dateien und Ordner sind gegebenenfalls aus dem Verzeichnis "skins/" zu entfernen:
** Chick.php, chick
** Nostalgia.php, nostalgia
** Simple.php, simple
** Standard.php, standard
*  "The info page action, which provides useful statistics for any given page, has been improved and turned on by default."
* Bei "Spezialseiten" wird die "ISBN-Suche" unter "Daten und Werkzeuge" statt unter "Andere Spezialseiten" angezeigt.
* $wgPasswordSenderName wurde abgeschafft; der Name für die E-Mail-Adresse von $wgPasswordSender kann nur noch in der Seite "MediaWiki:Emailsender" angepasst werden


==== MW Version 1.21 ====
Laut https://wiki.php.net/internals/windows/compiler soll PHP 7.1 zwar mit VC14 und VC15 funktionieren, doch wird dies nicht offiziell unterstützt.


* implementierte Erweiterungen
==== PHP 7.0 ====
** Cite
** ImageMap
** TitleBlacklist
** SpamBlacklist
** Interwiki bzw. SpecialInterwiki u. a.
* Änderungen
** Die Funktion "wfLoadExtensionMessages()" existiert nicht  mehr, wird aber von BibManager REL1_23 verwendet und muss auskommentiert werden


==== MW Version 1.20 ====
Das Support-Ende für PHP 7.0 ist früher als für PHP 5.6.


* PHP 5.3.2 oder neuer ist erforderlich
=== php.ini ===
* Erweiterungen, die Elemente der neuen Version voraussetzen
** ApprovedRevs
** Cite u. a.


==== MW Version 1.19 ====
==== Module ====


* $wgEnableCreativeCommonsRdf für "LocalSettings.php" wird nicht mehr unterstützt; stattdessen gibt es eine Erweiterung [http://www.mediawiki.org/wiki/Extension:CreativeCommonsRdf|"CreativeCommonsRdf"], die Beta-Status hat (2015-09-21).
Folgende Module sind aktiviert:
* bz2
* curl
* gd2
* gettext
* mbstring
* exif ; Must be after mbstring
* mysql
* mysqli
* openssl
* pdo_mysql
* pdo_sqlite
* soap
* sockets
* sqlite3
* xmlrpc
* xsl


* In der revision-Tabelle ist eine neue Spalte "rev_sha1" hinzugekommen, die in der alten Verison vor einem Update hinzugefügt werden muss; siehe [http://www.mediawiki.org/wiki/Manual:FAQ|Mediawiki FAQ] Punkt 3.2, [http://www.mediawiki.org/wiki/Manual:Revision_table|Mediawiki Manual Revision_table] und http://www.mediawiki.org/wiki/Thread:Project:Support_desk/upgrade_problems:_1.11_--_1.21:<pre>ALTER TABLE /*$wgDBprefix*/revision ADD rev_sha1 varbinary(32) NOT NULL default '';</pre>
==== php-Konfiguration ====


==== MW Version 1.18 ====
engine = On
short_open_tag = On
allow_call_time_pass_reference = Off
safe_mode = Off
expose_php = Off
error_reporting = E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED
enable_dl = On
file_uploads = On
allow_url_fopen = On
allow_url_include = Off


* MySQL 5.0.2 oder neuer ist erforderlich
== phpMyAdmin ==
* mehr Genderneutralität bei Sprachdateien
* implementierte Erweiterungen:
** ConfirmEdit
** ParserFunctions mit Control Structure Functions ohne Loops
** RenameUser
** Nuke u. a.
* Neue Erweiterung "Math", bisher Datei "\includes\math.php", siehe https://www.mediawiki.org/wiki/Texvc/de, verwendet "texvc", welches 3 Zusatzprogramme benötigt:
** ocaml
** LaTeX
** dvipng


==== MW Version 1.17 ====
=== Fehler bei Konto-Erstellung ===


* PHP 5.2.3 oder neuer ist erforderlich
In phpMyAdmin 4.6.5.2 ist ein Bug, der eine Fehlermeldung erzeugt, wenn versucht wird, ein neues Datenbank-Nutzungskonto zu erstellen, weil im Verzeichnis "D:\xampp\mysql\" die Unterverzeichnisse "lib\plugin\ fehlen:
* neuer Installationsvorgang
<pre>
* Kategoriensortierung geändert
SHOW PLUGINS SONAME LIKE '%_password_check%'
* Interwiki-Verweise werden in gesonderten Tabellen gespeichert
MySQL meldet:
* Standard-Skin "vector" statt "monobook"
#1018 - Verzeichnis von 'D:\xampp\mysql\lib\plugin\' nicht lesbar (Fehler: 2 "No such file or directory")
* neue Variable $wgPasswordSenderName (existiert nur bis Version 1.22)
</pre>
 
Die Lösung besteht darin, im Verzeichnis "D:\xampp\mysql\" die Unterverzeichnisse "lib\plugin\" zu erstellen.


= SalzWiki  =
==== phpMyAdmin-Datei "config.inc.php" ====


== Datenbank mittels XAMPP und phpmyAdmin anlegen ==
Um die Anmeldung bei der Nutzung von "phpMyAdmin" per HTTP-Authentifizierung durchzuführen, sind folgende Angaben in der Konfigurationsdatei ab Z.18 erforderlich:
<pre>
/* Authentication type and info */
#$cfg['Servers'][$i]['auth_type'] = 'config';
$cfg['Servers'][$i]['auth_type'] = 'http';
#$cfg['Servers'][$i]['user'] = 'root';
#$cfg['Servers'][$i]['password'] = '';
$cfg['Servers'][$i]['extension'] = 'mysqli';
$cfg['Servers'][$i]['AllowNoPassword'] = true;
</pre>
 
Anmeldename und Passwort werden bei der HTTP-Anmeldung mit den Einträgen in der Tabelle "user" der Datenbank "mysql" verglichen.


Seit der Version 1.16.1 kann die jeweilige Datenbank statt mit phpMyAdmin während der Installation mittels Browser (/[wikiverzeichnis]/config/index.php) angelegt werden, sofern der Superuser-Account (Datenbank-Hauptadministrator) bekannt ist:
=== Test mit phpMyAdmin-Datei ".htaccess" ===


=== salzwiki ===
Datei "\xampp\phpMyAdmin\.htaccess"
<pre>Database name: salzwiki
<pre>
Benutzer: SW_sawi
AuthType Basic
Host: localhost
AuthName "phpMyAdmin"
Global Rechte: all privileges
AuthUserFile "../security/phpmyadmin.htpasswd"
Grant: ja
Require valid-user
database table prefix: sw_
</pre>
</pre>


=== repository ===
Datei "\xampp\security\dashboard.htpasswd":
<pre>Database name: repository
<pre>
Benutzer: SW_repo
username:password
Host: localhost
Global Rechte: all privileges
Grant: ja
database table prefix: sr_
</pre>
</pre>


=== saltwiki ===
== Statistik-Anwendung Piwik ==
<pre>Database name: saltwiki
 
Benutzer: SW_sawi
Zusätzlich zu "Piwik" ist die MW-Erweiterung [https://www.mediawiki.org/wiki/Extension:Piwik_Integration "Piwik Integration"] erforderlich oder muss der Code in der Datei "MonoBook.php" hinter dem Footer-Bereich mit dem "Piwik"-Code ergänzt werden.
Host: localhost  
 
Global Rechte: all privileges
Die Anwendung "Piwik" wird im Verzeichnis "xampp\htdocs\analytics\piwik\" zuerst auf dem Test-Server installiert.
Grant: ja
 
database table prefix: sw_
Die Administration von "Piwik" erfolgt im Browser über die Adresse "localhost/analytics/piwik/index.php".
 
Die Datei "...\htdocs\robots.txt" ist zu ergänzen:
<pre>
Disallow:/analytics/
</pre>
</pre>


== Mediawiki Installieren  ==
Die Apache-Konfiguration ist dahingehend anzupassen, dass die Verzeichnisse "analytics\" und "piwik\" nach dem Vorbild von "phpmyadmin\" nur lokal erreichbar sind.
 
=== Installationshinweise ===
 
Bei der Installation gibt es eine Warnung zur PHP-Konfiguration, wenn in der Datei "php.ini" nicht "always_populate_raw_post_data=-1" gesetzt ist. Dieser Parameter gilt als "deprecated" und entfällt mit PHP 7.0.0, weshalb sein Wert auf "-1" gesetzt werden soll.
 
Für die Installation per Browser muss JavaScript (JS) aktiviert sein oder muss mit dem Firefox-Plugin "Firebug" im HTML-Code bei select-Elementen die CSS-Definition "display:none;" entfernt werden. Ohne JS oder CSS-Anpassung fehlt
* bei der Datenbank-Konfiguration der Adapter
* bei der Website-Konfiguration die Zeitzone


*Für die jeweiligen Wikis einen entsprechenden Wiki- und Verzeichnisnamen festlegen: "salzwiki", "repository", "saltwiki".
Es wird empfohlen, für die "piwik"-Datenbank ein eigenes Nutzungskonto, das nur für diese Datenbank Berechtigungen hat, zu verwenden. Die Datenbank-Einrichtung von "Piwik" per Browser-Installation schlägt jedoch fehl, wenn das hierfür verwendete neue Benutzungskonto für "MySql" nicht existiert. Das Konto und die Datenbank sind deshalb vorab mit "phpMyAdmin" zu erstellen.
*Die Dateien und Verzeichnisse aus der tar.gz-Datei in das jeweilige Wiki-Verzeichnis entpacken:
<pre>"D:\xampp\htdocs\[wikiverzeichnisname]\"</pre>
*Nach Installationsanweisung das jeweilige Wiki installieren; hierzu im Browser die Adresse "D:\xampp\htdocs\[wikiverzeichnisname]\config\index.php" aufrufen.
**Contact e-mail: service@salzwiki.hawk-hhg.de
**Language: Je nach Wiki Deutsch oder English
**Copyright/license: Creative Commons
**Admin username: Hornemann
**Object caching: No
**E-Mail
***E-mail features: enabled
***User-to-user e-mail: enabled
***E-mail notification: enabled for discussion pages nad watchlists
***E-mail address authentication: enabled
**Datenbank
***Database type: MySQL
***Database host: localhost
***Database name: [wikiname]
***DB username: hschwarz (besser: hi_wiki_1)
***Superuser account: yes
***Superuser name: root
***Database table prefix: sw_ (SalzWiki, Saltwiki) bzw. sr_ (Repositorium)
***Storage Engine: InnoDB
***Database character set: MySQL 4.1/5.0 binary


=== Lizenz für das jeweilige Wiki  ===
=== Konfiguration ===


Die Lizenzkonfiguration in der Datei "LocalSettings.php" bearbeiten:
Die Piwik-System-Konfigurationsdatei "config.ini.php" befindet sich im Verzeichnis "...\analytics\piwik\config\".
*Salzwiki
 
<pre>
==== Benutzungskonten ====
## For attaching licensing metadata to pages, and displaying an
 
## appropriate copyright notice / icon. GNU Free Documentation
Standardmäßig gibt es folgende Benutzungskonten:
## License and Creative Commons licenses are supported so far.
* [SuperUserName], Alias [...], Hauptadministrator WAHR
$wgRightsPage = ""; # Set to the title of a wiki page that describes your license/copyright
* anonymous, Alias anonymous, Ansicht deaktiviert (rot), Administrator N/A
## Deutsch
** Kein Zugriff: "Für alle Websites anwenden" deaktiviert (rot)
$wgRightsUrl = "http://creativecommons.org/licenses/by-nc-sa/3.0/de/";
** Kein Zugriff: "SalzWiki" bzw. "SaltWiki" bzw. "Repository" aktiviert (grün)
$wgRightsText = "Namensnennung-Nicht-kommerziell-Weitergabe unter gleichen Bedingungen 3.0 Deutschland";
 
// bei MW 1.23
Zusätzlich zum Hauptadmin-Konto wird für die Ansicht der Statistiken und für die Erstellung von Statistik-Berichten ein Benutzungskonto für Beschäftigte des Hornemann Instituts eingerichtet, womit es folgende Konten gibt:
$wgRightsIcon = "{$wgStylePath}/common/images/cc-by-nc-sa.png";
 
# $wgRightsCode = "<nowiki>[</nowiki>license_code<nowiki>]</nowiki>"; # Not yet used
* Hauptadministration
* Statistiknutzung
* anonymous
 
===== Konto für Hauptadministration =====
 
Das Nutzungskonto "SW_piwik" für die Hauptadministration wird bei der Installation von "Piwik" erstellt.
 
Der <b>E-Mail-Versand</b> wird unter "Einstellungen => System => Allgemeine Einstellungen => E-Mail-Server-Einstellungen" konfiguriert und sieht in der Piwik-System-Konfigurationsdatei "...\piwik\config\config.ini.php" wie folgt aus, nachdem :
<pre>
[mail]
transport = "smtp"
port = "587"
host = "smtp.1und1.de"
type = "Login"
username = "service@salzwiki.de"
password = "***"
encryption = "ssl"
</pre>
</pre>
*Saltwiki und Repositorium
 
Damit als Absender nicht "noreply@localhost" gesendet wird, muss folgende Zeile in der Konfigurationsdatei im Abschnitt "[mail]" hinzugefügt werden:
<pre>
<pre>
## For attaching licensing metadata to pages, and displaying an
defaultHostnameIfEmpty = "salzwiki.de"
## appropriate copyright notice / icon. GNU Free Documentation
## License and Creative Commons licenses are supported so far.
$wgRightsPage = ""; # Set to the title of a wiki page that describes your license/copyright
## English und Repositorium
$wgRightsUrl = "http://creativecommons.org/licenses/by-nc-sa/3.0/";
$wgRightsText = "Attribution-Noncommercial-Share Alike 3.0 Unported";
// bei MW 1.23
$wgRightsIcon = "{$wgStylePath}/common/images/cc-by-nc-sa.png";
# $wgRightsCode = "<nowiki>[</nowiki>license_code<nowiki>]</nowiki>"; # Not yet used
</pre>
</pre>


=== Style/Skin  ===
===== Konto für Statistiknutzung =====
 
Mit dem Hauptadmin-Konto wird unter "Einstellungen => System => Benutzer" ein Konto "Hornemann" erstellt. Dabei ist darauf zu achten, dass oben bei "Zugriffsverwaltung" nicht nur eines der Wikis, sondern "Für alle Websites anwenden" ausgewählt ist.
 
Das Konto hat folgende Einstellungen:
* Benutzer Hornemann, Alias H.I.-SW-Statistik
* E-Mail webmaster@hornemann-institut.org
* Kein Zugriff deaktiviert (rot)
* Ansicht
** "Für alle Websites anwenden" aktiviert (grün), wird nach Auswahl einer Seite wie "SalzWiki" bei der Rückkehr deaktiviert (rot)
** "SalzWiki" bzw. "SaltWiki" bzw. "Repository" aktiviert (grün)
* Administrator deaktiviert (rot)
* Hauptadministrator deaktiviert (rot)
 
==== Statistik-Berichte ====
 
Für jedes Wiki wird ein eigener Bericht jeweils vom Typ HTML und PDF erstellt:
* SalzWiki
** HTML
** PDF
* SaltWiki
** HTML
** PDF
* Repository
** HTML
** PDF
 
Bei dem Konto für die Statistiknutzung wird unter "Einstellungen => Persönlich => E-Mail-Berichte" festgelegt, welche Art von Bericht wann per E-Mail übermittelt wird.


==== MW 1.23 LTS MonoBook ====
* Website: SalzWiki|SaltWiki|Repository
* Beschreibung: Monatlicher Statistikbericht
* Segment: Alle Besuche
* Zeitplan: Monatlich
* Uhrzeit: 1|2 (1 Uhr für HTML, 2 Uhr für PDF)
* Versand via: E-Mail
* Berichtsformat: HTML|PDF
* Bericht senden an: An mich senden
* Anzeigeoptionen: Tabellen und Graphen für alle Berichte anzeigen
* Beinhaltete Statistiken
** Alle Websites: Dashboard aller Websites
** Verweise: Verweisart, Alle Verweise, Suchbegriffe, Suchmaschinen Websites, Soziale Netzwerke
** Besucher: Besucherüberblick, Benutzer, Gerätetyp, Gerätemodell, Gerätemarke, Bildschirmauflösungen, Betriebssystem-Versionen, Browser, Browser-Version, Land, Kontinent, Region, Browsersprache, Stadt, Besuchslänge, Seiten pro Besuch
** Aktionen: Aktionen - Kernmetriken, Seiten URL, Einstiegsseiten, Ausstiegsseiten, Ausgehende Verweise, Downloads


Das Design für das Salzwiki basiert wegen der Hintergrundgrafik und der links angeordneten Footer-Icons weiter auf dem Stil (Skin) "Monobook", obwohl der Stil seit MW 1.17 von "Vector" als Standardstil abgelöst wurde. Dazu wird die Original-Datei "MonoBook.php" wegen der veralteten Auto-discovery-Funktion, die "Monobook" bei MW 1.23 LTS noch hat, als Kopie namens "MonoBook_Original.php" im Verzeichnis "skins\monobook\" gespeichert.
== Statistik-Anwendung Webalizer ==


In der Datei "LocalSettings.php" heißt die entsprechende Zuweisung dann <br> <nowiki>$wgDefaultSkin = "monobook";</nowiki>.
Webalizer gibt es bei www.webalizer.org nicht für Windows, sondern nur als DOS-Quellcode, zuletzt in der Version 2.23-08 von 2013. Andere Varianten wie die der Firma "Stone Steps Inc." basieren auf Version 2.01-10. Die aktuellste Windows-Variante ist in XAMPP enthalten, beispielsweise in XAMPP 5.6.14 als Webalizer Version 2.23-04 vermutlich mit Stand März 2011.


Zusätzlich sind darunter folgende Zeilen erforderlich:
Installiert wird die XAMPP-Variante.
<pre>
  // CC-Icon rechts unten für "MonoBook" angepasst 2015-09-28:
  $wgFooterIcon_copyright['copyright'] = array(
    "src" => $wgRightsIcon, // Icon
    "url" => $wgRightsUrl,
    "alt" => $wgRightsText,
    //"height" => "", // Icon-Höhe
    //"width" => "" // Icon-Breite
  );
  unset($wgFooterIcons['copyright']);
  $wgFooterIcons_r['poweredby'] = array_merge($wgFooterIcon_copyright,$wgFooterIcons['poweredby']);
  // für "MonoBook" und "Vector" ergänzt
  ## FOOTER-Icons links, wobei der erste Schlüssel zu <li id="footer-...ico"> verarbeitet wird
  $wgFooterIcons_l['copyright']['hornemanninstitut'] = array(
    "src" => "$wgScriptPath/images/common/HI.png", // Icon
    "url" => "http://www.hornemann-institut.de",
    "alt" => "Hornemann Institut",
    //"height" => "", // Icon-Höhe
    //"width" => "" // Icon-Breite
  );
  $wgFooterIcons_l['copyright']['hawk'] = array(
    "src" => "$wgScriptPath/images/common/hawk.png", // Icon
    "url" => "http://www.hawk-hhg.de",
    "alt" => "HAWK HHG",
    //"height" => "", // Icon-Höhe
    //"width" => "" // Icon-Breite
  );
  $wgFooterIcons_l['copyright']['dfg'] = array(
    "src" => "$wgScriptPath/images/common/DFG.jpg", // Icon
    "url" => "http://www.dfg.de",
    "alt" => "DFG",
    //"height" => "", // Icon-Höhe
    //"width" => "" // Icon-Breite
  );
  // für "Vector"
  #$wgFooterIcons_r = $wgFooterIcons;
  unset($wgFooterIcons);
  $wgFooterIcons = array_merge($wgFooterIcons_l, $wgFooterIcons_r);
</pre>


==== MW 1.23 LTS Vector ====
=== Log-Format ===


Bei der Verwendung von "Vector" wird die Original-Datei "skins\Vector.php" wegen der veralteten Auto-discovery-Funktion, die "Vector" bei MW 1.23 LTS noch hat, als Kopie namens "Vector_Original.php" im Verzeichnis "skins\vector\" gespeichert.
Als Log-Format wird das Standardformat CLF ("NCSA Common Log Format" bzw. "NCSA Combined Log Format") für die Auswertung der Apache-Log-Datei "access.log" verwendet, siehe auch https://en.wikipedia.org/wiki/Common_Log_Format. Es enthält folgende Angaben:
  * IP-Adresse des anfordernden Hosts
  * Ungenutzt für RFC-1413-Identität
  * Nutzername aus einer HTTP-Authentifizierung, ansonsten "-"
  * Zeitstempel (Datum, Uhrzeit und UTC-Abweichung)
  * Übermittlungsart, angeforderte Adresse und Übertragungsprotokoll mit Version, z. B. "GET /index.php HTTP/1.1"
  * HTTP-Statuscode
  * Menge der gesendeten Daten in Byte, ansonsten "-" (bei Umleitungen usw.)
  * Ausgangsadresse des anfordernden Hosts
  * Systemangaben zum anfordernden Host wie Browser mit Version und Betriebssystem mit Version
  * Cookie


In der Datei "LocalSettings.php" heißt die entsprechende Zuweisung dann <br> <nowiki>$wgDefaultSkin = "vector";</nowiki>.
==== Common Log Format ====
 
host rfc931 username date:time request statuscode bytes


Im Verzeichnis "vector/components/footer.less" wird für die eigenen Icons im Footer unten links die Definition von "#footer-icons" kopiert und umbenannt in "#footer-icons-left" und folgendermaßen angepasst:
==== Combined Log Format ====
<pre>
/* SalzWiki eingefügt 2015-09-28 */
#footer-icons-left {
  float: left;
  li {
    float: left;
    margin-right: 0.5em;
    line-height: 2em;
    text-align: left;
  }
}
</pre>


Im Verzeichnis "vector/images/" wird die Datei "headbg.jpg" für ein eigenes Hintergrundbild eingefügt.
host rfc931 username date:time request statuscode bytes referrer user_agent cookie


Im Verzeichnis "vector/components/common.less" wird für das Hintergrundbild "body" folgendermaßen angepasst:
=== Konfiguration ===
<pre>
body {
  /* SalzWiki eingefügt 2015-09-28 */
  background: #F9F9F4 url("headbg.jpg");
  /*background-color: @menu-background-color*/
}
</pre>


==== HAWK-Design ====
Für jedes Wiki wird eine eigene Statistik-Konfigurationsdatei erstellt:
* salzwiki.conf
* saltwiki.conf
* repository.conf


Für Anpassungen der StyleSheets an das HAWK-Design siehe [[Adm:HAWK-Design]].
In diesen Dateien wird jeweils festgelegt, welche Webserver-Log-Datei ausgewertet wird und in welchem Verzeichnis die Auswertung gespeichert wird.


=== Logo  ===
Wenn bei der Apache-Webserver-Konfiguration jedes Wiki als virtueller Host eine eigene Log-Datei zugewiesen bekommen hat, können diese VHost-Log-Dateien ausgewertet werden, ansonsten muss die allgemeine Log-Datei ausgewertet werden:
* allgemeine Log-Datei: "access.log"
* gesonderte VHost-Log-Dateien
** "access_salzwiki.log"
** "access_saltwiki.log"
** "access_repository.log"


Die Datei für das Logo links oben ist hochzuladen und in der Datei "LocalSettings.php" zuzuweisen:
Welches Wiki ausgewertet wird, erfolgt über die Angabe der Host-Namen mit "IgnoreSite" und "IncludeSite":
*Salzwiki
<pre>
<pre>
##Logo MW1.23
# Internet-Adresse für Wiki:
$wgLogo = $wgScriptPath."/images/common/Logo_Salz.png";
IgnoreSite  *
# für Seiten inkl. Mediadateien aus dem Repositorium
IncludeSite 193.175.110.91
# für Seiten ohne Mediadateien aus dem Repositorium
#IncludeSite 193.175.110.91/salzwiki/
#IncludeSite 193.175.110.91/saltwiki/
IncludeSite salzwiki.de
IncludeSite www.salzwiki.de
IncludeSite salzwiki.hawk-hhg.de
#IncludeSite saltwiki.net
#IncludeSite www.saltwiki.net
#IncludeSite saltwiki.hawk-hhg.de
#IncludeSite repository.hawk-hhg.de
</pre>
</pre>
*Saltwiki
 
Die Auswertung für das jeweilige Wiki betrifft nur Aufrufe der index-Datei und der Dateien in den hexadezimal benannten Unterverzeichnissen im Verzeichnis "\wikiname\images\". Diese URLs werden folgendermaßen mit "IgnoreURL" und "IncludeURL" angegeben:
<pre>
<pre>
##Logo MW1.23
# Pfad für Wiki
$wgLogo = $wgScriptPath."/images/common/Logo_Salt.png";
IgnoreURL  *
IncludeURL /index.php*
IncludeURL /images/0/*
IncludeURL /images/1/*
IncludeURL /images/2/*
IncludeURL /images/3/*
IncludeURL /images/4/*
IncludeURL /images/5/*
IncludeURL /images/6/*
IncludeURL /images/7/*
IncludeURL /images/8/*
IncludeURL /images/9/*
IncludeURL /images/a/*
IncludeURL /images/b/*
IncludeURL /images/c/*
IncludeURL /images/d/*
IncludeURL /images/e/*
IncludeURL /images/f/*
IncludeURL /wikiname/index.php*
IncludeURL /wikiname/images/0/*
IncludeURL /wikiname/images/1/*
IncludeURL /wikiname/images/2/*
IncludeURL /wikiname/images/3/*
IncludeURL /wikiname/images/4/*
IncludeURL /wikiname/images/5/*
IncludeURL /wikiname/images/6/*
IncludeURL /wikiname/images/7/*
IncludeURL /wikiname/images/8/*
IncludeURL /wikiname/images/9/*
IncludeURL /wikiname/images/a/*
IncludeURL /wikiname/images/b/*
IncludeURL /wikiname/images/c/*
IncludeURL /wikiname/images/d/*
IncludeURL /wikiname/images/e/*
IncludeURL /wikiname/images/f/*
</pre>
</pre>
*Repositorium
 
Folgende Definitionen sind zusätzlich erforderlich:
<pre>
<pre>
##Logo MW1.23
LogFile Pfadangabe/logdateiname
$wgLogo = $wgScriptPath."/images/common/Logo_Repo.png";
LogType clf
OutputDir Pfadangabe/wikiname
HistoryName wikiname.hist
Incremental yes
IncrementalName wikiname.current
ReportTitle Usage Statistics for
HostName wikiname
HTMLExtension html
PageType htm*
PageType php*
#UseHTTPS no
#DNSCache dns_cache.db
#DNSChildren 20
Quiet no
ReallyQuiet no
GMTTime no
VisitTimeout 1800
CountryGraph yes
GraphLegend yes
GraphLines 10
TopURLs 20
TopReferrers 20
TopAgents 10
TopCountries 50
TopSearch 20
AllSites no
AllURLs yes
AllReferrers yes
AllAgents yes
AllSearchStr yes
AllUsers no
#IndexAlias home.htm
#IndexAlias homepage.htm
DefaultIndex no
HideSite localhost
HideReferrer localhost/
HideReferrer 193.175.110.91/
HideReferrer salzwiki.de
HideReferrer www.salzwiki.de
HideReferrer salzwiki.hawk-hhg.de
HideReferrer Direct Request
 
HideURL *.css
HideURL *.ico
HideURL *.ICO
HideURL *.js
HideURL *.ra
HideURL robots.txt
HideURL api.php
HideURL load.php
HideURL opensearch_desc.php
HideURL /docs/
HideURL /extensinos/
HideURL /images/common/
HideURL /images/math/
HideURL /includes/
HideURL /languages/
HideURL /maintenance/
HideURL /mw-config/
HideURL /resources/
HideURL /serialized/
HideURL /skins/
HideURL /tests/
 
</pre>
</pre>


=== Fußzeile "Footer" anpassen ===
=== Dateien ===
 
Die nachfolgenden Informationen sind in der Datei "D:\xampp\webalizer\INFO_WikiStatistiken.txt" gespeichert.
 
Bis Ende Mai 2017 war eine einzige Log-Datei für alle Wikis beim Apache-Webserver konfiguriert.
Ab Ende Mai 2017 sind für die 3 Wikis eigene Log-Dateien beim Apache-Webserver konfiguriert.
 
2017-06-20: Die Log-Dateien des Apache-Webservers, access.log und access.old1.log, enthalten für Januar bis April 2017 identische Aufzeichnungen.
 
Für die Auswertung durch Webalizer wurden die großen Log-Dateien access.log und access.old1.log vom Apache-Log-Verzeichnis zu den Verzeichnissen "\webalizer\logs\access_20170612\" und "\webalizer\logs\access_old1_2016\" kopiert.
Anschließend wurden die großen Dateien mit "7-zip" in kleine Dateien für jeden Monat aufgeteilt. Hierzu wird mit "Hinzufügen" die Kompressionsstärke "Speichern" ausgewählt und "In Teildaten aufsplitten (Bytes)" verwendet. Dann werden die Inhalte der Teildateien so zusammengestellt, dass für jeden Monat eine Datei "access_YYYY_Monat00.log" vorhanden ist.
Für den Monat Mai 2017 wurde wegen der Umstellung auf Wiki-Log-Dateien jeweils die Datei "access_2017_Monat05.log" mit der Datei "access_2017_Monat05_02_wikiname.log" zur Datei "access_2017_Monat05_wikiname.log zusammengefügt".
Für die Monate von Juni 2017 bis einschließlich Dezember 2017 werden die Wiki-Log-Dateien wie die alten, großen Dateien in Teildateien für jeden Monat aufgeteilt, beispielsweise "access_YYYY_Monat00_wikiname.log".
Ab Januar 2018 werden die Wiki-Log-Dateien in Teildateien für jeden Monat nach dem Schema "wikiname_YYYY_Monat00.log" aufgeteilt.
 
Für die Statistiken bis einschließlich April 2017 wird in den Konfigurationsdateien der Wikis, "wikiname_YYYY_Monate.conf", die Monatsdatei "access_YYYY_Monat00.log", die aus der großen log-Datei stammt, angegeben.
Für die Statistiken ab Mai 2017 wird in den Konfigurationsdateien der Wikis, "wikiname_YYYY_Monate.conf", die Monatsdatei "access_YYYY_Monat00_wikiname.log", die aus den einzelnen Wiki-Log-Dateien stammt, angegeben.
 
Die Batch-Datei "webalizer_YYYY_Monate.bat" wird für jeden Monat nach Anpassung der conf-Dateien ausgeführt.


==== Logos mit Verlinkung und Footerlinks anpassen MW 1.23 ====
* Statistiken für 2018:
** Log-Dateien-Verzeichnis für Webalizer: \logs\access_2018\access_wikiname.log => wikiname_2018_Monat00.log
** Statistik-Verzeichnisse: \stats\wikiname\
** Konfigurationsdateien: wikiname_[2018_]monate.conf
** Batch-Datei: webalizer_[2018_]monate.bat
* Statistiken für 2017:
** Log-Dateien-Verzeichnis für Webalizer bis Juli: \logs\access_20170612\access_2017.log => access_2017_Monat00.log, access_wikiname.log => access_2017_Monat00_wikiname.log
** Log-Dateien-Verzeichnis für Webalizer ab August: \logs\access_20171231\access_wikiname_2017_Hj2.log => access_2017_Monat00_wikiname.log
** Statistik-Verzeichnisse: \stats_2017\wikiname\ => \stats_2017\wikiname\
** Konfigurationsdateien: wikiname_2017_monate.conf
** Batch-Datei: webalizer_2017_monate.bat
* Statistiken für 2016:
** Log-Dateien-Verzeichnis für Webalizer: \logs\access_old1_2016\access.old2016.log => access_2016_Monat00.log
** Statistik-Verzeichnisse: \stats_2016\wikiname\
** Konfigurationsdateien: wikiname_2016.conf
** Batch-Datei: webalizer_2016.bat


* Grafiken wie die Logos "HI.png", "HAWK.png" und <del>"DFG.jpg"</del> "SIK.png" im Verzeichnis "[wikiverzeichnisname]/images/common/" speichern.
=== DNS-Cache ===
* [[#LocalSettings.php anpassen|LocalSettings.php anpassen]]
* [[#MonoBook.php anpassen (Wiki-Code)|MonoBook.php anpassen (Wiki-Code)]]


===== LocalSettings.php anpassen =====
Anhand der IPs – sowohl IPv4 als auch IPv6 – erfolgt eine Zuordnung von Domains und abgeleitet von den First-Level-Domains eine Zuordnung von Ländern. Die Zuordnungen werden standardmäßig in einer DNS-Cache-Datei namens "dnscache.db" zwischengespeichert.


Änderungen in der Datei "LocalSettings.php" <del>"MonoBookSW.php": Zeile 141ff</del>:
Der DNS-Zwischenspeicher wird mit folgenden Parametern festgelegt:
# DNSCache: Dateiname
# DNSChildren: Anzahl der Prozesse (1-100) für die DNS-Zuordnungen
# CacheIPs: IPs speichern, wenn keine Domain-Zuordnung möglich ist [yes|no]
# CacheTTL: Gültigkeitsdauer in Tagen (1-100) für jede zwischengespeicherten Adresse


Die Anzeige der Texte von "lastmodified", "Anzahl der Seitenabrufe" und "CC-Lizenz" kann wie folgt unterbunden werden. Hierbei wird "Anzahl der Seitenabrufe" in der Datei "LocalSettings.php" festgelegt:
Bei der Konfiguration kann der Cache für IPs, die nicht in Domainnamen aufgelöst werden können, aktiviert werden, wenn dies häufig vorkommt, damit bei der nächsten Auswertung nicht noch einmal eine Auflösung versucht wird:
<pre>
<pre>
$wgDisableCounters = true;
CacheIPs yes
</pre>
</pre>


== Suchmaschinen  ==
=== robots.txt ===
Damit Test-Wikis während der Erprobungsphase, das Repositorium und verschiedene Wiki-Unterverzeichnisse nicht von Suchmaschinen durchsucht werden, wird eine Datei "robots.txt" im Verzeichnis "htdocs" gespeichert.
<br/>Damit kein Robot irgendetwas liest:
<pre>User-agent: *
Disallow:</pre>
Angaben nach dem Upgrade auf MW1.23 am 26.02.2016, damit der "Riddler"-Robot (hohe Zugriffszahlen) gar nichts und andere Robots nur das jeweilige Hauptverzeichnis von SalzWiki und SaltWiki und sonst nichts durchsuchen:
<pre>
<pre>
#### Beginn FOOTER ab Version MW1.23
# robots.txt für Salzwiki und Saltwiki, damit Robots weder Unterverzeichnisse noch das Repositorium noch Test-Wikis durchsuchen
// CC-Icon rechts unten für "MonoBook" angepasst 2015-09-28:
User-agent: Riddler
$wgFooterIcon_copyright['copyright'] = array(
Disallow:/
  "src" => $wgRightsIcon, // Icon
 
  "url" => $wgRightsUrl,
User-agent: *
  "alt" => $wgRightsText,
Disallow:/dashboard/
  //"height" => "", // Icon-Höhe
Disallow:/webalizer/
  //"width" => "" // Icon-Breite
Disallow:/xampp/
);
Disallow:/salzwiki/cache/
unset($wgFooterIcons['copyright']);
Disallow:/salzwiki/docs/
$wgFooterIcons_r['poweredby'] = array_merge($wgFooterIcon_copyright,$wgFooterIcons['poweredby']);
Disallow:/salzwiki/extensions/
// für "MonoBook" und "Vector" ergänzt
Disallow:/salzwiki/images/
## FOOTER-Icons links, wobei der erste Schlüssel zu <li id="footer-...ico"> verarbeitet wird
Disallow:/salzwiki/includes/
$wgFooterIcons_l['copyright']['hornemanninstitut'] = array(
Disallow:/salzwiki/languages/
  "src" => "$wgScriptPath/images/common/HI.png", // Icon
Disallow:/salzwiki/maintenance/
  "url" => "http://www.hornemann-institut.de",
Disallow:/salzwiki/mw-config/
  "alt" => "Hornemann Institut",
Disallow:/salzwiki/resources/
  //"height" => "", // Icon-Höhe
Disallow:/salzwiki/serialized/
  //"width" => "" // Icon-Breite
Disallow:/salzwiki/skins/
);
Disallow:/salzwiki/tests/
$wgFooterIcons_l['copyright']['hawk'] = array(
Disallow:/saltwiki/cache/
  "src" => "$wgScriptPath/images/common/hawk.png", // Icon
Disallow:/saltwiki/docs/
  "url" => "http://www.hawk-hhg.de",
Disallow:/saltwiki/extensions/
  "alt" => "HAWK HHG",
Disallow:/saltwiki/images/
  //"height" => "", // Icon-Höhe
Disallow:/saltwiki/includes/
  //"width" => "" // Icon-Breite
Disallow:/saltwiki/languages/
);
Disallow:/saltwiki/maintenance/
$wgFooterIcons_l['copyright']['sik'] = array(
Disallow:/saltwiki/mw-config/
  "src" => "$wgScriptPath/images/common/SIK.png", // Icon
Disallow:/saltwiki/resources/
  "url" => "http://http://www.salze-kulturgut.de",
Disallow:/saltwiki/serialized/
  "alt" => "SIK",
Disallow:/saltwiki/skins/
  "height" => "30px", // Icon-Höhe
Disallow:/saltwiki/tests/
  "width" => "30px" // Icon-Breite
Disallow:/repository/
);
Disallow:/salzwiki_draft/
// für "Vector"
Disallow:/saltwiki_draft/
#$wgFooterIcons_r = $wgFooterIcons;
Disallow:/repository_draft/
unset($wgFooterIcons);
Disallow:/salz_salt_repo/
$wgFooterIcons = array_merge($wgFooterIcons_l, $wgFooterIcons_r);
Disallow:/mediawiki_1_23_11/
#### Ende FOOTER ab Version MW1.23
</pre>
</pre>


===== MonoBook.php anpassen (Wiki-Code) =====
Im  jeweiligen Wiki-Hauptverzeichnis:
<pre>
# Robots sollen keine Unterverzeichnisse durchsuchen
User-agent: Riddler
Disallow:/


Da die Datei "[wikiname]\skins\MonoBook.php" bearbeitet werden muss, wird im Verzeichnis "[wikiname]\skins\monobook" eine Kopie der Datei als "MonoBook_original.php" gespeichert und von der geänderten Datei als Backup für Wiki-Updates ebenfalls im Verzeichnis "\monobook" eine Kopie als "MonoBookSW.php" gespeichert.
User-agent: *
 
Disallow:/cache/
In der Datei "MonoBook.php" werden die Texte von "lastmodified" und "CC-Lizenz" sowie der Verweis zu "Über" bzw. "About" durch eigenen Code unter Zeile 154 herausgefiltert:
Disallow:/docs/
<pre>
Disallow:/extensions/
<?php
Disallow:/images/
      foreach ( $validFooterLinks as $aLink ) { ?>
Disallow:/includes/
        <?php if($aLink!=="lastmod" && $aLink!=="copyright" && $aLink!=="about"){ /*eingefügt für HAWK HHG 2015-12-07 u. 2016-03-29*/ ?>
Disallow:/languages/
    <li id="<?php echo $aLink ?>"><?php $this->html( $aLink ) ?>
Disallow:/maintenance/
<?php  } /*eingefügt für HAWK HHG 2015-12-07*/
Disallow:/mw-config/
      }
Disallow:/resources/
?>
Disallow:/serialized/
</pre>
Disallow:/skins/
Original:
Disallow:/tests/
<pre>
<?php
      foreach ( $validFooterLinks as $aLink ) { ?>
    <li id="<?php echo $aLink ?>"><?php $this->html( $aLink ) ?>
<?php
      }
?>
</pre>
</pre>


===== CSS-Anpassungen als Alternative =====
=== Setzen von Keywords für den Head-Bereich eines Wikis ===
 
Hierzu ist in der Datei "LocalSettings.php" die Funktion "efSetKeywords()" mit den entsprechenden Keywords einzufügen. Hier am Beispiel von SaltWiki. Diese sind jedoch nur bei Zugang über die IP-Adresse und nicht über den Frame von 1&1 sichtbar. Damit Keywords über den Frame sichtbar sind, sind diese für unseren Zugang bei 1&1 bei der Einrichtung der Website mit anzugeben. Dasselbe gilt für "description".


Alternativ kann in der Datei "\skins\monobook\main.css" unterhalb der Angaben für den Footerbereich in Zeile 550 die Anzeige verhindert werden, wobei der HTML-Quelltext für die Listenelemente aber trotzdem erzeugt wird:
<pre>##Setzen von keywords
<pre>
function efSetKeywords(){
/* eingefügt für HAWK HHG 2015-12-07 */
  global $wgOut;
#f-list #lastmod, #f-list #copyright {
  $wgOut->addKeyword( 'salt' );
  display:none;
  $wgOut->addKeyword( 'desalination' );
  $wgOut->addKeyword( 'salt decay' ); 
  $wgOut->addKeyword( 'cultural heritage' ); 
  $wgOut->addKeyword( 'salt damage' );
  $wgOut->addKeyword( 'conservation' );
}
}
</pre>
</pre>


===== Footer-Elemente rechts =====
== E-Mail-Versand  ==


Die Variable $wgFooterIcons kann nur für Icons rechts unten im Footer erweitert werden. Der Footer-Container besteht aus folgenden Bereichen:
Die HAWK-Outlook-Adressen können nicht für den Versand per SMTP als Absender verwendet werden, sondern nur als Zieladresse.
* ul id="footer-info" (oberer Footer-Bereich)
  * li id="footer-info-lastmod"
  * li id="footer-info-copyright"
* ul id="footer-places" (unterer Footer-Bereich links)
  * ul id="footer-places-privacy"
  * ul id="footer-places-about"
  * ul id="footer-places-disclaimer"
* ul id="footer-icons" (unterer Footer-Bereich rechts)
  * ul id="footer-copyrightico"
  * ul id="footer-poweredbyico"


===== $wgHooks entfällt =====
Die Datei "localSettings.php" wurde in den Verzeichnissen


Nicht mehr erforderlich: Anpassungen mit $wgHooks in der Datei "LocalSettings.php" für neue Footer-Verweise, siehe auch https://www.mediawiki.org/wiki/Manual:Footer:
*salzwiki/  
<pre>
*repository/
$wgHooks['SkinTemplateOutputPageBeforeExec'][] = 'lfDatenschutz';
*saltwiki/
function lfDatenschutz($sk, &$tpl){
  $tpl->set('Datenschutz', $sk->footerLink('Datenschutz', 'Salzwiki:Datenschutz'));
  $tpl->data['footerlinks']['places'][] = 'Datenschutz';
  return true;
}
$wgHooks['SkinTemplateOutputPageBeforeExec'][] = 'lfProjektverbund';
function lfProjektverbund($sk, &$tpl){
  $tpl->set('Projektverbund', $sk->footerLink('Projektverbund', 'Projektverbund'));
  $tpl->data['footerlinks']['places'][] = 'Projektverbund';
  return true;
}
$wgHooks['SkinTemplateOutputPageBeforeExec'][] = 'lfImpressum';
function lfImpressum($sk, &$tpl){
  $tpl->set('Impressum', $sk->footerLink('Impressum', 'Salzwiki:Impressum'));
  $tpl->data['footerlinks']['places'][] = 'Impressum';
  return true;
}</pre>


==== "Forschungsverbund"/"Projektverbund" statt "Über [Wiki-Name]" ====
folgendermaßen für E-Mail-Versand angepasst:


Damit im "Footer" statt auf die Seite "Über SalzWiki" auf die Seite <del>"Forschungsverbund"</del> "Projektverbund" bzw. "Research Network" verlinkt wird, sind Änderungen an "Aboutsite" und "Aboutpage" vorzunehmen. Hierzu entweder über "Spezialseiten->Systemdaten und Werkzeuge->MediaWiki-Systemtexte" gehen oder folgende Adressen eingeben:
'''Salzwiki/Repositorium'''
<pre>
<pre>
"[Wiki-Verzeichnis]/index.php?title=MediaWiki:Aboutsite/de[-formal|-at|-ch]&action=edit"
## E-Mail-Versand angepasst 15.01.2016 G. Werner
bzw.
$wgEmergencyContact = "salzwiki.fb@hawk-hhg.de";
"[Wiki-Verzeichnis]/index.php?title=MediaWiki:Aboutpage/de&action=edit"
$wgPasswordSender = "service@salzwiki.de";
$wgSMTP = array(
'host' =&gt; "smtp.1und1.de",
'IDHost' =&gt; "1und1.de",
'port' =&gt; "587",
'auth' =&gt; true,
'username' =&gt; "service@salzwiki.de",
'password' =&gt; "********"
);
$wgEnotifUserTalk = true; # UPO
$wgEnotifWatchlist = true; # UPO
$wgEmailAuthentication = true;
</pre>
</pre>
*Link-Text in "aboutsite" bearbeiten:
 
<pre>Projektverbund
'''Saltwiki'''
<!--Über {{SITENAME}}-->
<pre>
</pre>
## E-Mail-Versand angepasst 15.01.2016 G. Werner
*Seitenname, zu dem verlinkt wird, in "aboutpage" bearbeiten:
$wgEmergencyContact = "saltwiki.fb@hawk-hhg.de";
<pre>Project:Über
$wgPasswordSender = "service@saltwiki.net";
</pre>
$wgSMTP = array(
ersetzen durch
'host' =&gt; "smtp.1und1.de",
<pre>Forschungsverbund
'IDHost' =&gt; "1und1.de",
'port' =&gt; "587",
'auth' =&gt; true,  
'username' =&gt; "service@saltwiki.net",  
'password' =&gt; "********"  
);
$wgEnotifUserTalk = true; # UPO
$wgEnotifWatchlist = true; # UPO
$wgEmailAuthentication = true;
</pre>
</pre>


Diese Änderungen müssen auf allen Sprach-Subpages für Aboutsite und Aboutpage - nämlich für "de", "de-formal", "de-at" und "de-ch" - durchgeführt werden, da die Änderungen an den Seiten "Aboutpage" und "Aboutsite" sich nur bei den Standard-Sprachversion wie "de" auswirken, jedoch nicht z. B. bei "de-formal". Deshalb wurden als auszuwählende Sprachen "de-formal", "de-at" und "de-ch" vorerst deaktiviert in der Datei [wikiverzeichnisname]\languages\Names.php
== Externe Links ==
Wenn ein User in den Profileinstellungen die Sprache abweichend von der Festlegung "de-formal" in der Datei "LocalSettings.php" auf "de" einstellt, funktioniert eventuell "Forschungsverbund" erst, nachdem "English" oder eine andere nicht-deutsche Sprache eingestellt wurde.
 
Damit externe Links in einem neuen Fenster geöffnet werden, ist in die "localsettings.php" einzufügen:


<pre>
##Externe links erscheinen in einem neuen Fenster
'de' => 'Deutsch', # German ("Du")
$wgExternalLinkTarget = '_blank';
##'de-at' => 'Österreichisches Deutsch', # Austrian German
##'de-ch' => 'Schweizer Hochdeutsch', # Swiss Standard German
##'de-formal' => 'Deutsch (Sie-Form)', # German - formal address ("Sie")
</pre>


Um im "Footer" den Hyperlink "Forschungsverbund" statt "Projektverbund" angezeigt zu  bekommmen, wird in der Skin-Datei der Code angepasst.
== Datenbank-Fehler ==
* MW 1.23 Datei "monobook.php"


MW 1.23
Falls ein Hinweis "A database query error has occured" angezeigt wird, kann man sich weitere Angaben anzeigen lassen, indem man in der Datei "LocalSettings.php" unten einfügt:
<pre>
<pre>
???
$wgShowSQLErrors = 1;
</pre>
</pre>


=== Favicon ===
== Versionshinweise ==
 
=== Betriebssystem und Wiki-Serversysteme ===
 
* <del>Beim Produktivserver bis 2017-01-04 mit Windows Server 2008 SP2 (Standard Edition) wird XAMPP 5.6.14.0 verwendet</del>
* Beim Produktivserver ab 2017-01-04 mit Windows Server 2012 R2 Datacenter wird XAMPP 5.6.14.0 verwendet
** XAMPP Control Center 3.2.1
** Apache 2.4.17
** MariaDB 10.0.17 Server mit libmysql - mysqlnd5.0.11dev Client
** PHP 5.6.14 für Windows und VC11 Visual C++ 2012 x86
** OpenSSL 1.0.2d
** phpMyAdmin 4.5.0.2
* Beim Testserver ab 2017-01-04 mit Windows Server 2012R2 Datacenter wird auf XAMPP verzichtet und werden folgende Einzelsysteme aus dem XAMPP-Paket Version 5.6.30-0 eingerichtet:
** Apache 2.4.25 für Windows und VC11 von http://www.apachelounge.com, alternativ von http://www.apachehaus.com im Verzeichnis "D:\xampp\apache\"
** MariaDB 10.0.17 Server mit libmysql - mysqlnd 5.0.11dev Client vom Produktivserver, ansonsten neuere Version von http://ftp.hosteurope.de/mirror/archive.mariadb.org/ oder https://downloads.mariadb.org/mariadb/+releases/ bzw. http://archive.mariadb.org/mariadb-10.0.17/
** PHP 5.6.30 32Bit für Windows und VC11 von http://windows.php.net/downloads/releases/archives/ im Verzeichnis "D:\xampp\php\"
** OpenSSL 1.0.2j
** phpMyAdmin 4.6.5.2


Damit in der Browser-Adresszeile ein Favicon dargestellt wird, ist eine Datei "salzwiki.ico" in das jeweilige Wiki-Verzeichnis hochzuladen und folgender Eintrag in der jeweiligen Datei "LocalSettings.php" vorzunehmen:
=== Datenbanksystem ===
<pre>$wgFavicon = "/[wikiverzeichnisname]/salzwiki.ico";</pre>


=== Darstellung in einem Frame ===
* MySQL-Upgrade von Version 5.1 zu Version 5.6 ist nur möglich über Version 5.5
* XAMPP hat zuletzt in Version 1.8.2-6 die MySQL-Version 5.5.x, danach die Version 5.6
* XAMPP hat bis Version 5.5.28 bzw. 5.6.12 als Datenbanksystem MySQL, danach MariaDB
* XAMPP hat in Version 5.6.14.0 die MariaDB-Version 10.0.x, aber in Version 5.6.14.3 die MariaDB-Version 10.1.x


Seit Version 1.16.1 gibt es Vorkehrungen gegen CrossSiteScripting, was Seiten, die in Frames dargestellt werden und somit die Weiterleitung des Salzwiki-Hosters zur IP des HAWK-Rechenzentrumsservers, betrifft.
=== XAMPP ===


Die neuen Versionen des Internet Explorers und des Firefox zeigen eine Fehlermeldung, wenn man sich anmelden möchte, da der Inhalt in einem Frame angezeigt werden soll. Meist hilft die Nutzung eines Links zur IP-Seite weiter.
==== XAMPP 5.6.30 ====


Dies ist zu umgehen, d.h. es tritt keine Fehlermeldung auf, wenn man in den localsetting.php einfügt:
* PHP 5.6.30 32Bit
<pre>
* VC11 MS Visual C++ 2012 redistributable x86 Update 4
$wgEditPageFrameOptions = 'false';
* <b>MariaDB 10.1</b>.21 Win32 (Server), libmysql - mysqlnd 5.0.11dev (Client)
</pre>
* Apache 2.4.25 Win32
* phpMyAdmin 4.6.5.2, Zeichensatz MySQL-Verbindung utf8mb4_unicode_ci
* OpenSSL 1.0.2j
* XAMPP Control Panel 3.2.2


Hierzu näheres unter http://webcache.googleusercontent.com/search?q=cache:H1KG7SKYpvoJ:100thpriest.appspot.com/www.mediawiki.org/wiki/Project:Support_desk+mediawiki+1.16.1+frame+warnung+anmelden&cd=3&hl=de&ct=clnk&gl=de&client=firefox-a&source=www.google.de
In phpMyAdmin 4.6.5.2 ist ein Bug, der eine Fehlermeldung erzeugt, wenn versucht wird, ein neues Datenbank-Nutzungskonto zu erstellen. Die Lösung besteht darin, im Verzeichnis "D:\xampp\mysql\" die Unterverzeichnisse "lib\plugin\" zu erstellen.


<pre>
==== XAMPP 5.6.14.3 ====
* The X-Frame-Options header to send on pages sensitive to clickjacking
* PHP 5.6.14 32Bit
* attacks, such as edit pages. This prevents those pages from being displayed
* VC11 MS Visual C++ 2012 redistributable x86 Update 4
* in a frame or iframe. The options are:
* <b>MariaDB 10.1</b>.8 Win32 (Server), libmysql - mysqlnd 5.0.11dev (Client)
*
* Apache 2.4.17 Win32
*   - 'DENY': Do not allow framing. This is recommended for most wikis.
* phpMyAdmin 4.5.1, Zeichensatz MySQL-Verbindung utf8mb4_unicode_ci
*
* OpenSSL 1.0.2d
*  - 'SAMEORIGIN': Allow framing by pages on the same domain. This can be used
* XAMPP Control Panel 3.2.2
*         to allow framing within a trusted domain. This is insecure if there
*        is a page on the same domain which allows framing of arbitrary URLs.
*
- false: Allow all framing. This opens up the wiki to XSS attacks and thus
*         full compromise of local user accounts. Private wikis behind a
*        corporate firewall are especially vulnerable. This is not
*         recommended.
*
* For extra safety, set $wgBreakFrames = true, to prevent framing on all pages,
* not just edit pages.  
</pre>


== Wiki-Konfiguration ==
==== XAMPP 5.5.30/5.6.14.0 ====
* PHP 5.5.30/5.6.14 32Bit + Pear, MS VC11 x86 32Bit ThreadSafe
* VC11 MS Visual C++ 2012 redistributable x86 Update 4
* <b>MariaDB 10.0</b>.17 Win32 (Server), libmysql - mysqlnd 5.0.11dev (Client)
* Apache 2.4.17 Win32
* phpMyAdmin 4.5.0.2, Zeichensatz MySQL-Verbindung utf8mb4_unicode_ci
* OpenSSL 1.0.2d
* XAMPP Control Panel 3.2.1


Die Konfiguration eines Wikis erfolgt hauptsächlich mit PHP-Variablen in der Datei "xampp\htdocs\[wikiname]\LocalSettings.php".
==== XAMPP 5.5.28/5.6.12 ====
* PHP 5.5.28/5.6.12 + Pear, MS VC11 x86 32Bit ThreadSafe
* MySQL 5.6.26-Community
* Apache 2.4.16 Win32
* phpMyAdmin 4.4.14
* openSSL 1.0.1i


=== Spracheinstellungen ===
==== XAMPP 1.8.2-6 ====
* PHP 5.4.31, MS VC9
* MySQL 5.5.32-Community
* Apache 2.4.4 Win32
* phpMyAdmin 4.0.4
* openSSL 0.9.8y mit OpenSSL-Bug "Heartbleed"


==== Standardsprache ====
==== XAMPP 1.8.0 ====
Neues Sicherheitskonzept: Zugriff per Browser auf Verzeichnisse wie "phpmyadmin" nur noch direkt vom Server aus ("Require local")


Die Standardsprache wird in der Datei "LocalSettings.php" festgelegt, kann von den Usern in den Profileinstellungen aber nach den persönnlichen Bedürfnissen angepasst werden.
==== XAMPP 1.7.1 ====
* PHP 5.2.9, MS Visual C++ 2008 redistributable x86 9.0...
* MySQL 5.1.33-Community Client 5.0.51a
* Apache 2.2.11 Win32
* phpMyAdmin 3.1.3.1


* Salzwiki: $wgLanguageCode = "de-formal";
=== MediaWiki ===
* Saltwiki: $wgLanguageCode = "en";
* Repositorium: $wgLanguageCode = "en";


==== de-formal korrigieren (Wiki-Code) ====
Informationen zu
* Versionszyklen inkl. LTS: https://www.mediawiki.org/wiki/Version_lifecycle
* Systemabhängigkeiten: https://www.mediawiki.org/wiki/Compatibility
* Versionsänderungen:
** entfallen oder veraltet: https://www.mediawiki.org/wiki/Category:MediaWiki_Deprecated_or_obsolete_features
** Erweiterungen
*** integrierte Erweiterungen: https://www.mediawiki.org/wiki/Comparison_of_extensions_in_distributions
*** nicht mehr kompatible Erweiterungen: https://phabricator/wikimedia.org/T110291


Die Datei "[wikiname]\languages\i18n\de-formal.json" wird wegen einer Du-Form ergänzt. Zuvor ist die Datei als Kopie "de-formal_original.json" zu speichern. Nach der Korrektur ist für Wiki-Updates eine Kopie als "de-formalSW.json" zu speichern.
==== MW Version 1.30 ====


Für die Sie-Form wird aus der Datei "de.json" von Zeile 1759 "emailccme" mit Du-Form verwendet: "Sende eine Kopie der E-Mail an mich"; deshalb ist in der Datei "de-formal.json" in Zeile 216f zwischen "emailpagetext" und "emailccsubject" einzufügen:
* Hooks
<pre>
** $wgExceptionHooks['MWException'][] entfällt
"emailccme": "Eine Kopie der E-Mail an mich senden",
</pre>


=== Zugangsberechtigungen  ===
==== MW Version 1.27 ====


==== Gruppen für Berechtigungen ====
* Datei "LocalSettings.php" anpassen
** $wgScriptExtension entfällt
* Skins-Element
** $wgCopyrightIcon wird ersetzt durch $wgFooterIcons['copyright']['copyright']
* Core-Variablen
** $wgSessionHandler gilt als veraltet


* Administratoren = Chef-Redakteure für Accounts erstellen/sperren, Systemtexte bearbeiten, Wiki-Inhalte verschieben, löschen, importieren etc.
==== MW Version 1.26 ====
* autor = Autor/in für Wiki-Inhalte
* Benutzer = nur Diskussionsseiten
* Bots (Systemgruppe)
* Bürokraten = Rechtevergabe, Account-Vereinigung
* Editor (saltwiki, repository) = Wiki-Inhalte-Kontrolle
* Redakteur (salzwiki) = siehe Editor
* Sicherheit = Seitensperre für Spezialseiten und gesperrte Seiten bei deaktiviertem JavaScript
* Salzwiki, HAWK etc. = Gruppen im Repository
* sysop = Hauptadministrator


==== Spezial-Seiten verbergen bzw. verstecken (Wiki-Code) ====
* Plugins
** AuthPlugin mit $wgAuth gilt als veraltet und soll ab MW 1.27 ersetzt werden durch die Frameworks AuthManager und SessionManager, siehe auch https://www.mediawiki.org/wiki/Manual:SessionManager_and_AuthManager/Updating_tips


Spezialseiten, die nur mit besonderen Berechtigungen verfügbar sind, werden nach Anmeldung bei einem Konto mit besonderen Berechtigungen auf der Seite "Spezialseiten" per CSS fett-formatiert dargestellt:
==== MW Version 1.25 ====
<pre>
<li class="mw-specialpagerestricted">...
</pre>


Für Berechtigungen von Spezialseiten siehe auch https://www.mediawiki.org/wiki/Manual:Special_pages/de#Seitenzugriff_beschr.C3.A4nken
* Skins
<del>http://phlow.net/magazin/netzkultur/technik/445-mediawiki-spezialseiten-vor-unerlaubtem-zugriff-sperren</del> (2015-12-04 nicht mehr vorhanden)
** "Autodiscovery mechanism" entfällt
 
** Die Skin-Datei "MonoBookSW.php" anpassen an die neue Version, siehe https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery#Migration_guide
Datei "LocalSettings:php"
* Datei "LocalSettings.php" anpassen
<pre>
** $wgDisableCounters entfällt; für Seitenbesuchszahlen ist die Erweiteerung "HitCounters" erforderlich
##Benutzergruppe um zu verhindern, dass Seiten der Specialpages
** Skin-Registrierung
##von jedem anderen außer Bürokraten und Admin und Sicherheit
** Erweiterungen-Registrierung
##aufgerufen werden können. Risos 08.02.2012
* Statistik Seitenaufrufe {{NUMBEROFVIEWS}} entfällt (https://www.mediawiki.org/wiki/Help:Magic_words/de#Statistik)
$wgGroupPermissions['Sicherheit']['read'] = true;
$wgGroupPermissions['Sicherheit']['Sicherheit'] = true;
</pre>
 
===== MW 1.23 =====
 
Wiki-Code anders als in MW 1.16:
*Datei "includes\specialpage\SpecialPageFactory.php" statt Datei "includes\SpecialPage.php"
*Variable "private static $list" statt "static public $mList"
*Assoziative Array-Elemente haben geänderte Werte, die nicht mehr in Arrays, sondern nur noch als Text-Strings angegeben sind
**Bereich "Media reports and uploads" ab Zeile 114
**Bereich "Unlisted / redirects" in Zeile 171


Skin-Registrierung
<pre>
<pre>
// Media reports and uploads
wfLoadSkin("MonoBook"); //statt require_once "$IP/skins/MonoBook.php";
'Listfiles' => 'SpecialListFiles,
'Filepath' => 'SpecialFilePath',
...
// Unlisted / redirects
'Specialpages' => 'SpecialSpecialpages',
...
</pre>
</pre>
Eventuell  muss die Datei "\includes\SkinTemplate.php" bei der Funktion "buildNavUrls()" in den Zeilen 1247 und 1262 angepasst werden - siehe http://nullraffer.de/wiki/index.php?title=Mediawiki_absichern:
 
Erweiterungen-Registrierung
<pre>
<pre>
global $wgUploadNavigationUrl;
wfLoadExtension("Cite"); //statt require_once "$IP/extensions/Cite/Cite.php";
global $wgUser; // eingefügt 2015-12-04 für HAWK HHG
...
// Bedingung eingefügt 2015-12-04 für HAWK HHG
if(!$wgUser->isAnon()){
  $nav_urls['specialpages'] = array( 'href' => self::makeSpecialUrl( 'Upload' ) );
}
...
</pre>
</pre>


==== Vergabe von Nutzerrechten durch den Hauptadministrator (sysop) ====
==== MW Version 1.24 ====


Damit die unten beschriebenen Rechtevergaben umgesetzt werden können, erhält der Sysop zunächst den Zugang zu den SpecialPages, um auch nach Änderung der Datei "SpecialPage.php" Zugriff auf die Spezialseiten zu haben. Folgende Zeile ist in "LocalSettings.php" einzufügen:
* Logo-Speicherort geändert von "skins/common/images/" zu "resources/assets/" bzw. "images/..."
<pre>$wgGroupPermissions['sysop']['restrictusers'] = true; ##HJschwarz 22.02.2011, Ersteinstellung für "restrictusers" zum Einstellen der Rechte
* Bisher mitgelieferte Skins sind nicht mehr enthalten; die jeweiligenSkins-php-Dateien und Ordner sind gegebenenfalls aus dem Verzeichnis "skins/" zu entfernen:
** CologneBlue.php, cologneblue
** Modern.php, modern
** MonoBook.php, monobook
** Vector.php, vector
* Datei "LocalSettings.php" eventuell an neue Skin-Registrierung anpassen
<pre>
require_once "$IP/skins/MonoBookSW.php"; //statt $wgDefaultSkin = "monobooksw";
</pre>
</pre>
* Nicht mehr unterstützt wird "register_globals => Bei PHP vor Version 5.4 in der Datei "php.ini" angeben "register_globals=Off"
* Erweiterung "OggHandler" wird nicht mehr unterstützt


Anschließend über SpecialPages->UserRightsManagement->[Username] die Rechte erweitern und alle Gruppen aktivieren.
==== MW Version 1.23 ====


* Skins werden anders eingebunden
** Das jeweilige Skin-Unterverzeichnis sollte wie die php-Datei die Groß-Klein-Schreibweise berücksichtigen ("monobooksw/" => "MonoBookSW/")
** Kleinbuchstaben bei $wgDefaultSkin = "monobooksw"; in der Datei "LocalSettings.php"
** Die Skin-php-Datei, z. B. "MonoBookSW.php", ist nicht mehr im Verzeichnis "skins/", sondern im Unterverzeichnis, z. B. "skins/MonoBookSW/"
** Die Skin-Datei "MonoBookSW.php" anpassen an die neue Version, siehe www.mediawiki.org/wiki/Manual:Skin_autodiscovery#Migration_guide
* "Autodiscovery mechanism" für "Core Skins" gilt als "deprecated" und schreibt Warnungen in die Log-Dateien. Folgende Dateien und Ordner sind gegebenenfalls aus dem Verzeichnis "skins/" zu entfernen:
** Chick.php, chick
** Nostalgia.php, nostalgia
** Simple.php, simple
** Standard.php, standard
*  "The info page action, which provides useful statistics for any given page, has been improved and turned on by default."
* Bei "Spezialseiten" wird die "ISBN-Suche" unter "Daten und Werkzeuge" statt unter "Andere Spezialseiten" angezeigt.
* $wgPasswordSenderName wurde abgeschafft; der Name für die E-Mail-Adresse von $wgPasswordSender kann nur noch in der Seite "MediaWiki:Emailsender" angepasst werden


==== Nutzerrechte bis zum Freischalten von Saltwiki ====
==== MW Version 1.21 ====


Kein "normaler" Nutzer kann Seiten in SaltWiki lesen:
* implementierte Erweiterungen
 
** Cite
$wgGroupPermissions['*']['read'] =false;
** ImageMap
 
** TitleBlacklist
Folgende Seiten werden durch $wgWhitelistRead dennoch für alle zum Lesen freigegegben:
** SpamBlacklist
 
** Interwiki bzw. SpecialInterwiki u. a.
$wgWhitelistRead = array("Main_Page", "Saltwiki:About", "Saltwiki:General disclaimer", "Saltwiki:Privacy policy");
* Änderungen
** Die Funktion "wfLoadExtensionMessages()" existiert nicht  mehr, wird aber von BibManager REL1_23 verwendet und muss auskommentiert werden


==== Benutzer-Rechte in SalzWiki und SaltWiki  ====
==== MW Version 1.20 ====


Die aktuelle Benutzerrechteschema ist:
* PHP 5.3.2 oder neuer ist erforderlich
* Erweiterungen, die Elemente der neuen Version voraussetzen
** ApprovedRevs
** Cite u. a.


<pre># alle duerfen '''nur''' lesen
==== MW Version 1.19 ====
$wgGroupPermissions['*']['read'] = true;
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['createpage'] = false;
$wgGroupPermissions['*']['createtalk'] = false;
$wgGroupPermissions['*']['writeapi'] = false;
# Benutzer duerfen: lesen, Diskussionsseiten erstellen und darin schreiben
$wgGroupPermissions['user']['read']            = true;
$wgGroupPermissions['user']['createtalk']      = true;
$wgGroupPermissions['user']['move']            = false;
$wgGroupPermissions['user']['move-rootuserpages']            = false;
$wgGroupPermissions['user']['move-subpages']            = false;
$wgGroupPermissions['user']['edit']            = true;
$wgGroupPermissions['user']['createpage']      = false;
$wgGroupPermissions['user']['upload']          = false;
$wgGroupPermissions['user']['reupload']        = false;
$wgGroupPermissions['user']['reupload-shared'] = false;
$wgGroupPermissions['user']['minoredit']      = false;
$wgGroupPermissions['user']['purge']          = false;
#$wgGroupPermissions['emailconfirmed']['emailconfirmed'] = true;
# Spezialgruppe Autor
$wgGroupPermissions['autor']['emailconfirmed'] = true;
$wgGroupPermissions['autor']['createpage'] = true;
$wgGroupPermissions['autor']['createtalk'] = true;
$wgGroupPermissions['autor']['edit'] = true;
$wgGroupPermissions['autor']['protect'] = true;
$wgGroupPermissions['autor']['editprotected'] = true;
$wgGroupPermissions['autor']['read'] = true;
$wgGroupPermissions['autor']['upload'] = true;
$wgGroupPermissions['autor']['move'] = true;
</pre>


==== Spezialseiten dürfen nur AutorInnen lesen (Wiki-Code) ====
* $wgEnableCreativeCommonsRdf für "LocalSettings.php" wird nicht mehr unterstützt; stattdessen gibt es eine Erweiterung [http://www.mediawiki.org/wiki/Extension:CreativeCommonsRdf|"CreativeCommonsRdf"], die Beta-Status hat (2015-09-21).


Diese Änderungen dienen dazu, dass nur Autoren die SpecialPages lesen dürfen und keine normalen Nutzer oder angemeldeten Nutzer.
* In der revision-Tabelle ist eine neue Spalte "rev_sha1" hinzugekommen, die in der alten Verison vor einem Update hinzugefügt werden muss; siehe [http://www.mediawiki.org/wiki/Manual:FAQ|Mediawiki FAQ] Punkt 3.2, [http://www.mediawiki.org/wiki/Manual:Revision_table|Mediawiki Manual Revision_table] und http://www.mediawiki.org/wiki/Thread:Project:Support_desk/upgrade_problems:_1.11_--_1.21:<pre>ALTER TABLE /*$wgDBprefix*/revision ADD rev_sha1 varbinary(32) NOT NULL default '';</pre>


'''Achtung: Muss bei MW 1.16 in "includes/SpecialPage.php" nach jedem mediawiki-Update auf Vorhandensein überprüft werden!''' Siehe [[#Spezial-Seiten verbergen bzw. verstecken (Wiki-Code)|Spezial-Seiten verbergen bzw. verstecken (Wiki-Code)]]
==== MW Version 1.18 ====


in LocalSettings.php einfügen:
* MySQL 5.0.2 oder neuer ist erforderlich
<pre>
* mehr Genderneutralität bei Sprachdateien
$wgGroupPermissions['autor']['restrictusers'] = true;
* Neue "Hooks"
</pre>
** BaseTemplateToolbox
und folgende Zeile wieder auskommentieren:
* implementierte Erweiterungen
<pre>$wgGroupPermissions['sysop']['restrictusers'] = true;
** ConfirmEdit
</pre>
** ParserFunctions mit Control Structure Functions ohne Loops
 
** RenameUser
=== Weiterleitungen ===
** Nuke u. a.
* Neue Erweiterungen
** "Math", bisher Datei "\includes\math.php", siehe https://www.mediawiki.org/wiki/Texvc/de, verwendet "texvc", welches 3 Zusatzprogramme benötigt:
*** ocaml
*** LaTeX
*** dvipng
** "WikiEditor", bisher Datei "\includes\EditPage.php" bzw. JS-Erweiterung "Extra Edit Buttons (XEB)", siehe en.wikipedia.org/wiki/User:MarkS/Extra_edit_buttons und en.wikipedia.org/wiki/User:MarkS/extraeditbuttons.js
 
==== MW Version 1.17 ====
 
* PHP 5.2.3 oder neuer ist erforderlich
* neuer Installationsvorgang
* Kategoriensortierung geändert
* Interwiki-Verweise werden in gesonderten Tabellen gespeichert
* Standard-Skin "vector" statt "monobook"
* neue Variable $wgPasswordSenderName (existiert nur bis Version 1.22)
 
= SalzWiki SaltWiki Repository  =
 
== Anpassungen an Systemdateien ==
 
Verzeichnisse und Dateien im jeweiligen Wiki:
* includes
** EditPage.php
** HttpFunctions.php
** <del>Skin.php</del> für 2 Varianten des linken Menüs
** <del>SkinTemplate.php</del> für Werkzeuge ohne Datei-Upload
** SkinTemplate.php</del> für Werkzeuge ohne Spezialseiten
** <del>specialpage\SpecialPageFactory.php</del> für Werkzeuge ohne Spezialseiten
* languages
** i18n\de-formal.json für Text bei Kontaktformular
* skins
** <del>MonoBook.php</del> für Footer-Elemente und eingeschränkte Sichtbarkeit von Werkzeugen
** monobook\main.css für allgemeine Farben und für Farben in bestimmten Seitenbereichen
 
== Upgrade vorhandener Wikis ==
 
# neue Wiki-Version 1.31 entpacken nach "D:\noxampp\[wikiname]"
# Erweiterungen
## Erweiterungen für aktuelle Version herunterladen
## aktuelle Erweiterungen entpacken nach "D:\noxampp\[wikiname]\extensions"
# Datei "LocalSettings.php" umbenennen zu "LocalSettings_original_131.php"
# Dateien vom alten Server zum neuen Server kopieren
## ...\[wikiname]\images inkl. eigenem Unterverzeichnis "commons\"
## ...\[wikiname]\LocalSettings.php
# Wiki-Datenbanken
## Datenbankdaten auf dem alten Server sichern
## Datenbankdaten vom alten zum neuen Server kopieren
## Datenbankdaten auf dem neuen Server wiederherstellen
# Wiki-Anpassungen
## Datei "LocalSettings.php" vergleichen mit Angaben in "LocalSettings_original_131.php" und anpassen
## Datei "...\[wikiname]\maintenance\runJobs.php" mit php.exe auf der Admin-Kommandozeile ausführen
## Datei "...\[wikiname]\maintenance\upgrade.php" mit php.exe auf der Admin-Kommandozeile ausführen


Für einige Seiten werden Weiterleitungen eingerichtet. Für eine Übersicht der bestehenden Weiterleitungen siehe bei den Spezialseiten http://193.175.110.91/[wikiverzeichnis]/index.php/Spezial:Weiterleitungen bzw. http://193.175.110.91/[wikiverzeichnis]/index.php/Special:ListRedirects:
=== Datenbanken sichern ===


Für die Navigation links (Sidebar), den Footer-Bereich und dergleichen gibt es folgende Weiterleitungen:
Kommandozeile als Administrator öffnen und folgenden Befehl eingeben:
*SalzWiki
<pre>
**Aktuelles => Startseite#Aktuelles
D:
**Bibliographie => Special:BibMangerList
cd xampp\mysql\bin
**Forschungsverbund => Informationen zum DFG-Projekt#Projektverbund
mysqldump -uroot -p --databases db_wikiname > D:\Backup_193.175.110.91\Laufwerk_D\Backups
**Hauptseite => Startseite
mysqldump --user=root --password --databases db_wikiname > D:\Backup_193.175.110.91\Laufwerk_D\Backups\db_wikiname_MW1.16_MariaDBv10.0.17_yyyymmdd.sql
**Projektverbund => Informationen zum DFG-Projekt#Projektverbund
</pre>
**Willkommen im SalzWiki => Informationen zum DFG-Projekt
**Über => Informationen zum DFG-Projekt
**Über SalzWiki => Informationen zum DFG-Projekt
**Über Salzwiki => Informationen zum DFG-Projekt
**Diskussion:Hauptseite => Diskussion:Startseite
**Diskussion:Willkommen im SalzWiki => Diskussion:Informationen zum DFG-Projekt
**Salzwiki:Forschungsverbund => Informationen zum DFG-Projekt#Projektverbund
**Salzwiki:Portal => Informationen zum DFG-Projekt
**Salzwiki:Projektverbund => Informationen zum DFG-Projekt#Projektverbund
**Salzwiki Diskussion:Portal => Diskussion:Informationen zum DFG-Projekt
**Hilfe:Variables => Help:Magic words
**Adm:ToDo-Liste => Salzwiki:ToDo-Liste
*SaltWiki
**Literature and Data => Literature and Programs
**News => Home
**Project Network => About the project#Research Network
**Research Network => About the project#Research Network
**Welcome to SaltWiki => About the project
**Talk:Welcome to SaltWiki => Talk:About the project
**Saltwiki:Portal => Home
**Saltwiki:Research Network => About the project#Research Network
**Help:Tex/de => Help:TeX/de
**Help:Variables => Help:Magic words


=== Sidebar anpassen (Wiki-Code, JS) ===
=== Datenbanken wiederherstellen ===


==== Logo-Hyperlink ====
Kommandozeile als Administrator öffnen und folgenden Befehl eingeben:
<pre>
D:
cd xampp\mysql\bin
mysql -uroot -p --execute="source D:\Backups\db_wikiname_MW1.16_MariaDBv10.0.17_yyyymmdd.sql" --force
mysql --user=root --password --execute="source D:\Backups\db_wikiname_MW1.16_MariaDBv10.0.17_yyyymmdd.sql" --force
</pre>


Die Seite, die beim Klick auf das Logo aufgerufen werden soll, wird in der Seite "MediaWiki:Mainpage" angegeben.
== Datenbank mittels XAMPP und phpmyAdmin anlegen ==


==== Navigation links mit 2 Varianten ====
Seit der Version 1.16.1 kann die jeweilige Datenbank statt mit phpMyAdmin während der Installation mittels Browser (/[wikiverzeichnis]/config/index.php) angelegt werden, sofern der Superuser-Account (Datenbank-Hauptadministrator) bekannt ist:


Es gibt zwei Varianten; die Standardvariante für angemeldete Standard-User und die Autor-Variante für AutorInnen, AdministratorInnen und ForscherInnen. Nicht-angemeldete User können Wiki-Seiten nur ansehen.
=== salzwiki ===
<pre>Database name: salzwiki
Benutzer: SW_sawi
Host: localhost
Global Rechte: all privileges
Grant: ja
database table prefix: sw_
</pre>


====Navigation links Standard-Variante====
=== repository ===
<pre>Database name: repository
Benutzer: SW_repo
Host: localhost
Global Rechte: all privileges
Grant: ja
database table prefix: sr_
</pre>


Die '''Standardvariante''' ist zu erreichen über:<br/>http://193.175.110.91/[wikiverzeichnis]/index.php/MediaWiki:Sidebar
=== saltwiki ===
 
<pre>Database name: saltwiki
<pre>&lt;!-- Salzwiki --&gt;
Benutzer: SW_sawi
*navigation
Host: localhost
**Mainpage|Startseite
Global Rechte: all privileges
<del>**Salzwiki:Portal|SalzWiki:Portal</del>
Grant: ja
<!--**Informationen zum DFG-Projekt|SalzWiki-Portal-->
database table prefix: sw_
<!--**Aktuelles|Aktuelles-->
Special:BibManager_Overview|Bibliographie
**Glossar|Glossar
<!--**Autorenanmeldung|Autorenanmedlung-->
**Redaktion SalzWiki|Redaktion
**Autoren/innen_von_SalzWiki|Autor/inn/en
**recentchanges-url|Recentchanges
**special:contact|Kontakt
**Hilfe:Contents/de|Hilfe
 
*SEARCH
<!--*Umfrage-->
<!--**http://www.worktogether51.net/gc/wsl.php?I=Y4TTY7YTOTTYT47TTUTTBT4NTTYT4BT40 |Ihre Meinung zu SalzWiki-->
 
*TOOLBOX
 
*andere Sprachen
**http://www.saltwiki.net/|English
</pre>
</pre>


<pre>&lt;-- Repositorium --&gt;
== Mediawiki Installieren  ==
*Navigation
**Hauptseite|Home


*Other Wikis
*Für die jeweiligen Wikis einen entsprechenden Wiki- und Verzeichnisnamen festlegen: "salzwiki", "repository", "saltwiki".
**http://www.salzwiki.de|SalzWiki
*Die Dateien und Verzeichnisse aus der tar.gz-Datei in das jeweilige Wiki-Verzeichnis entpacken:
**http://www.saltwiki.net|SaltWiki
<pre>"D:\xampp\htdocs\[wikiverzeichnisname]\"</pre>
</pre>
*Nach Installationsanweisung das jeweilige Wiki installieren; hierzu im Browser die Adresse "D:\xampp\htdocs\[wikiverzeichnisname]\mw-config\index.php" aufrufen.
**Contact e-mail: service@salzwiki.hawk-hhg.de
**Language: Je nach Wiki Deutsch oder English
**Copyright/license: Creative Commons
**Admin username: Hornemann
**Object caching: No
**E-Mail
***E-mail features: enabled
***User-to-user e-mail: enabled
***E-mail notification: enabled for discussion pages nad watchlists
***E-mail address authentication: enabled
**Datenbank
***Database type: MySQL
***Database host: localhost
***Database name: [wikiname]
***DB username: SW_sawi (SalzWiki, SaltWiki) bzw. SW_repo (Repositorium) <del>hi_wiki_1</del>
***Superuser account: yes
***Superuser name: root
***Database table prefix: sw_ (SalzWiki, Saltwiki) bzw. sr_ (Repositorium)
***Storage Engine: InnoDB
***Database character set: MySQL 4.1/5.0 binary
**Wiki
***SalzWiki bzw. SaltWiki bzw. Repository
***Projektraum entspricht Namen des Wikis
***Benutzername: Hornemann
***E-Mail-Adresse: salzwiki@hornemann-institut.de
**Optionen
***ausschließlich berechtigte Bearbeiter (SalzWiki, SaltWiki) bzw. geschlossenes Wiki (Repository)


<pre>&lt;-- Saltwiki --&gt;
=== Lizenz für das jeweilige Wiki  ===
* navigation
** mainpage|Home
<!--** portal-url|SaltWiki-Portal-->
<!--** About_the_project|SaltWiki Portal-->
<!--** News|News-->
** Special:BibManager_Overview|Bibliography|Literature
** Glossary|Glossary
** Editorial Board|Editorial Board
** Authors in SaltWiki|Authors
** Special:Contact|Contact
** Help:Contents|Help


* SEARCH
Verwendet werden Creative-Commons-Lizenzen. Für SalzWiki wird die deutsche Variante, für SaltWiki und Repository wird die Standard-Variante vom Typ "cc-by-nc-sa" – Version 3.0 (Stand 2017-07-21) – eingesetzt.


* TOOLBOX
Da die Grafiken unter "\skins\images\common\cc-..." keine Unterscheidung nach Versionsnummer und Länderversion anbieten, werden die Grafiken von "Creative Commons" heruntergeladen, umbenannt und gespeichert unter "[wikiname]\images\common\":
* https://i.creativecommons.org/l/by-nc-sa/3.0/de/88x31.png => CC_BY_NC_SA_3.0_de_88x31.png
* https://i.creativecommons.org/l/by-nc-sa/3.0/88x31.png => CC_BY_NC_SA_3.0_en_88x31.png


*Languages
Die Lizenzkonfiguration erfolgt in der Datei "LocalSettings.php":
**http://www.salzwiki.de/|German
*Salzwiki
<pre>
## For attaching licensing metadata to pages, and displaying an
## appropriate copyright notice / icon. GNU Free Documentation
## License and Creative Commons licenses are supported so far.
$wgRightsPage = ""; # Set to the title of a wiki page that describes your license/copyright
## Deutsch
$wgRightsUrl = "https://creativecommons.org/licenses/by-nc-sa/3.0/de/";
$wgRightsText = "Namensnennung-Nicht-kommerziell-Weitergabe unter gleichen Bedingungen 3.0 Deutschland";
// bei MW 1.23
#$wgRightsIcon = "https://i.creativecommons.org/l/by-nc-sa/3.0/de/88x31.png";
#$wgRightsIcon = "{$wgStylePath}/common/images/cc-by-nc-sa.png";
$wgRightsIcon = $wgScriptPath."/common/images/CC_BY_NC_SA_3.0_de_88x31.png";
# $wgRightsCode = "<nowiki>[</nowiki>license_code<nowiki>]</nowiki>"; # Not yet used
</pre>
*Saltwiki und Repositorium
<pre>
## For attaching licensing metadata to pages, and displaying an
## appropriate copyright notice / icon. GNU Free Documentation
## License and Creative Commons licenses are supported so far.
$wgRightsPage = ""; # Set to the title of a wiki page that describes your license/copyright
## English und Repositorium
$wgRightsUrl = "https://creativecommons.org/licenses/by-nc-sa/3.0/";
$wgRightsText = "Attribution-Noncommercial-Share Alike 3.0 Unported";
// bei MW 1.23
#$wgRightsIcon = "https://i.creativecommons.org/l/by-nc-sa/3.0/88x31.png";
#$wgRightsIcon = "{$wgStylePath}/common/images/cc-by-nc-sa.png";
$wgRightsIcon = $wgScriptPath."/common/images/CC_BY_NC_SA_3.0_en_88x31.png";
# $wgRightsCode = "<nowiki>[</nowiki>license_code<nowiki>]</nowiki>"; # Not yet used
</pre>
</pre>


====Navigation links Autor-Variante====
=== Style/Skin  ===
 
==== MW 1.23 LTS MonoBook ====
 
Das Design für das Salzwiki basiert wegen der Hintergrundgrafik und der links angeordneten Footer-Icons weiter auf dem Stil (Skin) "Monobook", obwohl der Stil seit MW 1.17 von "Vector" als Standardstil abgelöst wurde. Dazu wird die Original-Datei "MonoBook.php" wegen der veralteten Auto-discovery-Funktion, die "Monobook" bei MW 1.23 LTS noch hat, als Kopie namens "MonoBook_Original.php" im Verzeichnis "skins\monobook\" gespeichert.


Die '''Autor-Variante''' muss durch Erstellung einer neuen Seite (Adminrechte erforderlich) erfolgen:
In der Datei "LocalSettings.php" heißt die entsprechende Zuweisung dann <br> <nowiki>$wgDefaultSkin = "monobook";</nowiki>.
*Erst folgende Adresse im Browser eingeben:<br/>http://193.175.110.91/[wikiverzeichnis]/index.php/MediaWiki:Autor_sidebar
*Danach mit Karteikarte "Erstellen" folgenden Quelltext eingeben:


<pre>&lt;!-- Salzwiki --&gt;
Zusätzlich sind darunter folgende Zeilen erforderlich:
*Navigation
<pre>
**Mainpage|Startseite
  // CC-Icon rechts unten für "MonoBook" angepasst 2015-09-28:
<del>**SalzWiki:Portal|SalzWiki:Portal</del>
  $wgFooterIcon_copyright['copyright'] = array(
<!--**Informationen zum DFG-Projekt|SalzWiki-Portal-->
    "src" => $wgRightsIcon, // Icon
<!--**Aktuelles|Aktuelles-->
    "url" => $wgRightsUrl,
**http://193.175.110.91/repository/index.php/Main_Page |Repositorium
    "alt" => $wgRightsText,
**Spezial:Bibliographieeinträge_verwalten|Bibliographie
    //"height" => "", // Icon-Höhe
**Glossar|Glossar
    //"width" => "" // Icon-Breite
**Redaktion_SalzWiki|Redaktion
  );
**Autoren/innen von SalzWiki|Autor/inn/en
  unset($wgFooterIcons['copyright']);
**recentchanges-url|recentchanges
  $wgFooterIcons_r['poweredby'] = array_merge($wgFooterIcon_copyright,$wgFooterIcons['poweredby']);
**special:contact|Kontakt
  // für "MonoBook" und "Vector" ergänzt
**help:contents/de|help
  ## FOOTER-Icons links, wobei der erste Schlüssel zu <li id="footer-...ico"> verarbeitet wird
<!--
  $wgFooterIcons_l['copyright']['hornemanninstitut'] = array(
*Umfrage
    "src" => "$wgScriptPath/images/common/HI.png", // Icon
**http://www.worktogether51.net/gc/wsl.php?I=Y4TTY7YTOTTYT47TTUTTBT4NTTYT4BT40ON84RMK758E |Ihre Meinung als Autor zu SalzWiki
    "url" => "http://www.hornemann-institut.de",
**http://www.worktogether51.net/gc/wsl.php?I=Y4TTY7YTOTTYT47TTUTTBT4NTTYT4BT40 |Ihre Meinung als Nutzer zu SalzWiki -->
    "alt" => "Hornemann Institut",
 
    //"height" => "", // Icon-Höhe
* Autor/inn/en-Seiten
    //"width" => "" // Icon-Breite
**Autoren|Richtlinien/Übersichten
  );
**Nutzungsrechte|Nutzungsrechte
  $wgFooterIcons_l['copyright']['hawk'] = array(
**Review|Review
    "src" => "$wgScriptPath/images/common/hawk.png", // Icon
**Kategorie|Kategorienbaum
    "url" => "http://www.hawk-hhg.de",
**Vorlagen|Vorlagen
    "alt" => "HAWK HHG",
<!--**sandkasten|Sandbox-->
    //"height" => "", // Icon-Höhe
 
    //"width" => "" // Icon-Breite
*SEARCH
  );
  $wgFooterIcons_l['copyright']['dfg'] = array(
    "src" => "$wgScriptPath/images/common/DFG.jpg", // Icon
    "url" => "http://www.dfg.de",
    "alt" => "DFG",
    //"height" => "", // Icon-Höhe
    //"width" => "" // Icon-Breite
  );
  // für "Vector"
  #$wgFooterIcons_r = $wgFooterIcons;
  unset($wgFooterIcons);
  $wgFooterIcons = array_merge($wgFooterIcons_l, $wgFooterIcons_r);
</pre>
 
==== MW 1.23 LTS Vector ====
 
Bei der Verwendung von "Vector" wird die Original-Datei "skins\Vector.php" wegen der veralteten Auto-discovery-Funktion, die "Vector" bei MW 1.23 LTS noch hat, als Kopie namens "Vector_Original.php" im Verzeichnis "skins\vector\" gespeichert.


*TOOLBOX
In der Datei "LocalSettings.php" heißt die entsprechende Zuweisung dann <br> <nowiki>$wgDefaultSkin = "vector";</nowiki>.


*Andere Sprachen
Im Verzeichnis "vector/components/footer.less" wird für die eigenen Icons im Footer unten links die Definition von "#footer-icons" kopiert und umbenannt in "#footer-icons-left" und folgendermaßen angepasst:
**http://www.saltwiki.net/ |English
<pre>
/* SalzWiki eingefügt 2015-09-28 */
#footer-icons-left {
  float: left;
  li {
    float: left;
    margin-right: 0.5em;
    line-height: 2em;
    text-align: left;
  }
}
</pre>
</pre>


Im Verzeichnis "vector/images/" wird die Datei "headbg.jpg" für ein eigenes Hintergrundbild eingefügt.


<pre>&lt;-- Saltwiki --&gt;
Im Verzeichnis "vector/components/common.less" wird für das Hintergrundbild "body" folgendermaßen angepasst:
*Navigation
<pre>
**Mainpage|Home
body {
<!--**Saltwiki:Community_portal|SaltWiki:Portal-->
  /* SalzWiki eingefügt 2015-09-28 */
<!--**About_the_Project|SaltWiki Portal-->
  background: #F9F9F4 url("headbg.jpg");
<!--**News|News-->
  /*background-color: @menu-background-color*/
**http://193.175.110.91/repository/index.php/Main_Page |Repository
}
**Special:BibManager_Overview|Bibliography
</pre>
**Glossary|Glossary
**Editorial_Board|Editorial Board
**Authors in Saltwiki|Authors
**recentchanges-url|recentchanges
**Special:Contact|Contact
**Help:Contents|Help
<!--**Helppage|help-->


* Author Pages
==== HAWK-Design ====
**Authors_Page|Guidelines
**Rights|Rights
**Review|Review
**categories|Category tree
**Templates|Templates
<!--**sandbox|Sandbox-->


*SEARCH
Für Anpassungen der StyleSheets an das HAWK-Design siehe [[Adm:HAWK-Design]].


*TOOLBOX
=== Logo  ===


*Languages
Die Datei für das Logo links oben ist hochzuladen und in der Datei "LocalSettings.php" zuzuweisen:
**http://www.salzwiki.de/ |German
*Salzwiki
</pre>
<pre>
##Logo MW1.23
$wgLogo = $wgScriptPath."/images/common/Logo_Salz.png";
</pre>
*Saltwiki
<pre>
##Logo MW1.23
$wgLogo = $wgScriptPath."/images/common/Logo_Salt.png";
</pre>
*Repositorium
<pre>
##Logo MW1.23
$wgLogo = $wgScriptPath."/images/common/Logo_Repo.png";
</pre>


=== Fußzeile "Footer" anpassen ===


<pre>&lt;-- Repositorium --&gt;
Um "Footer"-Verweise auszublenden und anzupassen sowie eigene Logos mit Verlinkung einzufügen, sind folgende Schritte notwendig:
*Navigation
* Grafiken wie die Logos "HI.png", "HAWK.png" und <del>"DFG.jpg"</del> "SIK.png" im Verzeichnis "[wikiverzeichnisname]/images/common/" speichern.
<!--*Research Environment-->
* Seite "MediaWiki:Disclaimers" anpassen
**Mainpage|Home
* [[#LocalSettings.php anpassen|LocalSettings.php anpassen]]
<!--**Repository Portal|Repository Portal-->
* [[#MonoBook.php nicht mehr anpassen (Wiki-Code)|<del>MonoBook.php anpassen (Wiki-Code)</del>]]
**News|News
 
**Projekte|Projects
==== LocalSettings.php anpassen ====
**Communication|Communication
**Publications|Publication


*
Änderungen in der Datei "LocalSettings.php" <del>"MonoBookSW.php": Zeile 141ff</del>:
**Special:BibManager_Overview|Bibliography
**terminology|Glossary
**Category:Author|Authors' Contents
**recentchanges-url|Recent changes
**Special:Contact|Contact
**Help:Contents|Help


* author pages
===== Ausblendung des Besuche-Zählers =====
**Rights|Rights
**Kategorienbaum|Category tree


* other wikis
Die Anzeige der Texte von "Anzahl der Seitenabrufe" wird bei MW1.23 wie folgt unterbunden:
**Vorlagen|Templates
**http://www.salzwiki.de/ |SalzWiki
**http://www.saltwiki.net/ |SaltWiki
 
*SEARCH
 
*TOOLBOX
 
*LANGUAGES
 
</pre>
 
====Navigationsbereich mit Nutzungsrechten versehen (Wiki-Code)====
 
Um die Navigation links ("Sidebar") anzupassen wurden Änderungen an den Dateien "includes\Skin.php" und "skins\MonoBook.php" vorgenommen.
 
=== Sidebar-Einschränkung (Wiki-Code) ===
 
In der Datei "includes\Skin.php" in der Funktion "function buildSidebar()" in der zweiten Zeile die globale Variable "$wgUser" hinzufügen, um später die Gruppenrechte abfragen zu können:
 
<pre><!--MW1.23, Z.1249-->
global $wgMemc, $wgEnableSidebarCache, $wgSidebarCacheExpiry, $wgUser;
</pre>
 
Nach der Zeile mit "$bar = array();" (MW1.23 Z.1263, MW1.16 Z.2085) folgende Zeile auskommentieren:
<pre>#$this->addToSidebar( $bar, 'sidebar' );</pre>
und folgenden Code einfügen:
<pre>
<pre>
  $groups = $wgUser->getEffectiveGroups();
$wgDisableCounters = true;
  ## add here admin support
  if (in_array("autor", $groups) || in_array("Administrators", $groups) || in_array("forschung", $groups)) {
    //$lines = explode( "\n", wfMsgForContent( 'autor_sidebar' ) );
    $this->addToSidebar( $bar, 'autor_sidebar' );
  } else {
    //$lines = explode( "\n", wfMsgForContent( 'sidebar' ) );
    $this->addToSidebar( $bar, 'sidebar' );
  }
</pre>
</pre>
Die Zeile "$lines = explode( "\n", wfMsgForContent( 'sidebar' ) );"  muss auskommentiert oder gelöscht werden.


Nun gibt es zwei Sidebars die man unterschiedlich "bestücken" kann.
===== Anpassung für Logos links und rechts =====
 
Sollte es danach '''PHP-Warnungen''' wie "Warning: Call-time pass-by-reference has been deprecated ..." geben, gibt es folgende vorübergehende '''Notlösung''':
In der Datei "php.ini" in Zeile 165 "allow_call_time_pass_reference = On" statt "Off" setzen.
'''Diese Möglichkeit gilt als veraltet und wird in Zukunft nicht mehr von PHP unterstützt werden, so dass der oben beschriebene Code der Funktion dann geändert werden muss!'''
 
ACHTUNG: Wenn das Mediawiki aktualisiert wird, muss die Änderung in der Datei "Skin.php" wieder eingefügt werden, um die Funktionalität zu erhalten!
Deshalb ist von der geänderten Datei "Skin.php" zusätzlich eine Kopie "SkinSW.php" im Verzeichnis "includes" zu speichern.
 
=== Werkzeuge/Toolbox (Wiki-Code) ===
 
Die Sidebar im Bereich "Werkzeuge" wird mit einem Eingriff in den Wiki-Code bei "skins/MonoBook.php" für alle Gruppen außer "autor", "admin" und "forschung" manipuliert. Hierzu wird in der Funktion "toolbox()" Z.254ff die Variable "global $wgUser;" eingefügt und bei "foreach" die Z.262 bei "$this->makeListItem" mit einer Bedingung versehen:


Die Logos und Verweise links für "Hornemann Institut", "HAWK" und "SIK" sowie rechts für "CC-Lizenz" und "Powered by MediaWiki" werden wie folgt festgelegt:
<pre>
<pre>
function toolbox();
#### Beginn FOOTER ab Version MW1.23
   global $wgUser; // Für HAWK HHG
// CC-Icon rechts unten für "MonoBook" angepasst 2015-09-28:
   $groups = $wgUser->getEffecitveGroups(); // Für HAWK HHG
$wgFooterIcon_copyright['copyright'] = array(
  ...
   "src" => $wgRightsIcon, // Icon
  foreach ( $this->getToolbox() as $key => $tbitem ) {
   "url" => $wgRightsUrl,
    // Für HAWK HHG: Alle Werkzeuge für die Gruppen autor, Administrators und forschung, sonst nur Werkzeug "Druckversion"
  "alt" => $wgRightsText,
    if(in_array("autor", $groups) || in_array("Administrators", $groups) || in_array("forschung", $groups) || $key==="print"){
  //"height" => "", // Icon-Höhe
      <?php echo $this->makeListItem( $key, $tbitem); ?>
  //"width" => "" // Icon-Breite
    }
);
   }
unset($wgFooterIcons['copyright']);
</pre>
$wgFooterIcons_r['poweredby'] = array_merge($wgFooterIcon_copyright,$wgFooterIcons['poweredby']);
 
// für "MonoBook" und "Vector" ergänzt
'''Achtung: Code-Anpassung muss in "skins/MonoBook.php" nach jedem mediawiki-Update auf Vorhandensein und Funktion überprüft werden!'''
## FOOTER-Icons links, wobei der erste Schlüssel zu <li id="footer-...ico"> verarbeitet wird
 
$wgFooterIcons_l['copyright']['hornemanninstitut'] = array(
==== Werkzeuge-Schlüsselwörter ====
  "src" => "$wgScriptPath/images/common/HI.png", // Icon
 
  "url" => "http://www.hornemann-institut.de",
* Links auf diese Seite: key = whatlinkshere
  "alt" => "Hornemann Institut",
* Änderungen an verlinkten Seiten: key = recentchangeslinked
  //"height" => "", // Icon-Höhe
* Datei hochladen: key = upload
  //"width" => "" // Icon-Breite
* Spezialseiten: key = specialpages
);
* Druckversion: key = print
$wgFooterIcons_l['copyright']['hawk'] = array(
* Permanenter Link: key = permalink
  "src" => "$wgScriptPath/images/common/hawk.png", // Icon
* Seiteninformationen: key = info
  "url" => "http://www.hawk-hhg.de",
  "alt" => "HAWK HHG",
   //"height" => "", // Icon-Höhe
  //"width" => "" // Icon-Breite
);
$wgFooterIcons_l['copyright']['sik'] = array(
  "src" => "$wgScriptPath/images/common/SIK.png", // Icon
  "url" => "http://http://www.salze-kulturgut.de",
  "alt" => "SIK",
  "height" => "30px", // Icon-Höhe
  "width" => "30px" // Icon-Breite
);
// für "Vector"
#$wgFooterIcons_r = $wgFooterIcons;
unset($wgFooterIcons);
$wgFooterIcons = array_merge($wgFooterIcons_l, $wgFooterIcons_r);
#### Ende FOOTER ab Version MW1.23
</pre>


==== sichtbare Toolbox-Menüpunkte ====
===== Anpassung mittlerer Fußzeilen-Elemente =====


* SalzWiki, Repositorium: alle Gruppen und User
Die Änderung von "Über [Wiki-Name]" zu "Forschungsverbund"/"Projektverbund" findet nicht mehr statt. Stattdessen muss "Disclaimer" durch "Impressum" ersetzt werden und wird "about" weggelassen.
** Druckversion


* SaltWiki: alle Gruppen und User
Die Anzeige der Texte von "lastmodified", "about" und "CC-Lizenz" im mittleren Bereich kann mit einem "Hook" wie folgt unterbunden werden:
** Printable version
<pre>
#### Beginn mittlerer FOOTER ab Version MW1.23
// Elemente verbergen
$wgHooks['SkinTemplateOutputPageBeforeExec'] = 'lfHide';
function lfHide( $skin, &$template ) {
  $template->set( "lastmod", "");
  $template->set( "copyright", "");
  $template->set( "about", "");
  return true;
};
// "Haftungsausschluss" wird auf der Seite "MediaWiki:Disclaimers" durch "Impressum" ersetzt
// Datenschutz ist bei MW1.31 mit "privacy" standardmäßig enthalten
// Projektverbund soll nicht mehr im Fußbereich erscheinen
#### Ende mittlerer FOOTER ab Version MW1.23
</pre>


==== ausgeblendete Toolbox-Menüpunkte ====
Für neue, geänderte und ausgeblendete Footer-Verweise, siehe auch https://www.mediawiki.org/wiki/Manual:Footer. Nicht mehr erforderliche Festlegungen:
<pre>
// "Haftungsausschluss" wird auf der Seite "MediaWiki:Disclaimers" durch "Impressum" ersetzt
#$wgHooks['SkinTemplateOutputPageBeforeExec'][] = function ($sk, &$tpl){
#  $tpl->set('impressum', $sk->footerLink('impressum', 'Impressum'));
#  $tpl->data['footerlinks']['places'][] = 'impressum';
#  return true;
#}
// Datenschutz ist bei MW1.23 standardmäßig enthalten
#$wgHooks['SkinTemplateOutputPageBeforeExec'][] = function ($sk, &$tpl){
#  $tpl->set('datenschutz', $sk->footerLink('datenschutz', 'Datenschutz'));
#  $tpl->data['footerlinks']['places'][] = 'datenschutz';
#  return true;
#}
// Projektverbund soll nicht mehr im Fußbereich erscheinen
#$wgHooks['SkinTemplateOutputPageBeforeExec'][] = function ($sk, &$tpl){
#  $tpl->set('projektverbund', $sk->footerLink('projektverbund', 'Projektverbund'));
#  $tpl->data['footerlinks']['places'][] = 'projektverbund';
#  return true;
#}
</pre>


* SalzWiki: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
Angeblich können auch nicht erwünschte "Footer"-Seiten ausgeblendet werden, indem im Namensraum "MediaWiki:..." der enthaltene Text durch einen Bindestrich ersetzt wird, siehe https://www.mediawiki.org/wiki/Manual:Footer#Customizing_the_Built-in_items letzte Zeile. Dann müsste aber bei der entsprechenden Seite für jede Sprache die Änderung erfolgen.
** "Links auf diese Seite" (Special:WhatLinksHere/Main_Page)
** "Änderungen an verlinkten Seiten" (Spezial:%C3%84nderungen_an_verlinkten_Seiten)
** "Hochladen" (Special:Upload)
** "Spezialseiten" (Special:SpecialPages)
** "Permanenter Link" (Main_page&oldid=921)
** "Seiteninformationen" ([Seitentitel]&action=info])


* SaltWiki: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
Ursprüngliche Texte für "de-formal":
** "What links here" (Special:WhatLinksHere/Main_Page)
** "Related changes" (Special:RecentChangesLinked)
** "Hochladen" (Special:Upload)
** "Spezialseiten" (Special:SpecialPages)
** "Permanent link" (Main_page&oldid=921)
** "Page information" ([Seitentitel]&action=info])
 
* Repository: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
** "Links auf diese Seite" (Special:WhatLinksHere/Main_Page)
** "Änderungen an verlinkten Seiten" (Spezial:%C3%84nderungen_an_verlinkten_Seiten)
** "Datei Hochladen" (Special:Upload)
** "Spezialseiten" (Spezial:Spezialseiten)
** "Permanent link" (Main_page&oldid=9522)
** "Seiteninformationen" ([Seitentitel]&action=info])
 
=== Überschrift der Hauptseite/Mainpage ändern ===
Die Überschrift ist auf der Systemseite "Mediawiki:Mainpage" eingetragen und muss dort geändert werden.
Die Überschrift, die per Voreinstellung Main Page (Hauptseite in der deutschen Übersetzung) heißt, ist in die entsprechende Titelzeile zu ändern.


=== Repositorium-Dateien im SalzWiki ===
* "MediaWiki:About": Über
* "MediaWiki:Copyright": Der Inhalt ist verfügbar unter der Lizenz $1, sofern nicht anders angegeben.
* "MediaWiki:Lastmodifiedat": Diese Seite wurde zuletzt am $1 um $2 Uhr bearbeitet.


==== Hochladen von Dateien  ====
==== MonoBook.php nicht mehr anpassen (Wiki-Code) ====


Das Hochladen von Dateien geschieht immer in das Repositorium.  
Wenn die Datei "[wikiname]\skins\MonoBook.php" bearbeitet wird, ist im Verzeichnis "[wikiname]\skins\monobook" eine Kopie der Datei als "MonoBook_original.php" uz speichern und von der geänderten Datei als Backup für Wiki-Updates ebenfalls im Verzeichnis "\monobook" eine Kopie als "MonoBookSW.php" zu speichern.


Hierzu sind folgende Änderungen in der Datei "LocalSettings.php" des SalzWikis vorzunehmen:
Wird kein "Hook" in der Datei "LocalSettings.php" verwendet, können in der Datei "MonoBook.php" die Texte von "lastmodified" und "CC-Lizenz" sowie der Verweis zu "Über" bzw. "About" durch eigenen Code unter Zeile 154 herausgefiltert werden:
<pre>
<pre>
$wgUploadNavigationUrl = "/repository/index.php/Special:Upload";
<?php
$wgEnableUploads       = false;  ##damit kein Upload in SalzWiki möglich ist
      foreach ( $validFooterLinks as $aLink ) { ?>
        <?php if($aLink!=="lastmod" && $aLink!=="copyright" && $aLink!=="about"){ /*eingefügt für HAWK HHG 2015-12-07 u. 2016-03-29*/ ?>
    <li id="<?php echo $aLink ?>"><?php $this->html( $aLink ) ?>
<?php   } /*eingefügt für HAWK HHG 2015-12-07*/
       }
?>
</pre>
</pre>
 
Original:
Zudem sind folgende Änderungen in der Datei "LocalSettings.php" des Repositoriums vorzunehmen:
<pre>
<pre>
$wgEnableUploads      = true;
<?php
## Erlaubte Dateitypen
      foreach ( $validFooterLinks as $aLink ) { ?>
$wgFileExtensions = array('png', 'gif', 'tiff','tif','jpg', 'jpeg', 'doc', 'xls', 'xml','pdf', 'svg', 'avi',
    <li id="<?php echo $aLink ?>"><?php $this->html( $aLink ) ?>
'mpeg','ogg', 'ogv', 'oga','mov');
<?php
      }
?>
</pre>
</pre>


==== Übergreifende Suche im SalzWiki und Repositorium ====
==== CSS-Anpassungen als Alternative (Wiki-Code) ====


Für den Zugriff vom SalzWiki auf das Repositorium mittels "http" durch anonyme User ist in der Datei "LocalSettings.php" des SalzWikis folgender Code hinzuzufügen:
Alternativ kann in der Datei "\skins\monobook\main.css" unterhalb der Angaben für den Footerbereich in Zeile 550 die Anzeige verhindert werden, wobei der HTML-Quelltext für die Listenelemente aber trotzdem erzeugt wird:
<pre>
<pre>
$wgFetchCommonsDescriptions  = true;
/* eingefügt für HAWK HHG 2015-12-07 */
#f-list #lastmod, #f-list #copyright {
  display:none;
}
</pre>
</pre>


Findet das Salzwiki eine Datei oder ein Bild nicht im eigenen Wiki, schaut es mit Hilfe von Shared-Einstellungen automatisch im Repositorium nach und sucht dort. Dazu wurde in der Datei "LocalSettings.php" des SalzWikis folgender Code hinzugefügt:
==== HTML-Footer-Elemente ====
<pre>
$wgUseSharedUploads = true;
$wgSharedUploadPath = "/repository/images";
#$wgSharedUploadPath = 'http://193.175.110.91/repository/images;
$wgSharedUploadDirectory = "D:/xampp/htdocs/repository/images";
$wgHashedSharedUploadDirectory = true;
$wgSharedUploadDBname = "repository";
$wgSharedUploadDBprefix  = "sr_";
$wgRepositoryBaseUrl = 'http://193.175.110.91/repository/index.php/Datei:';
#$wgRepositoryBaseUrl = 'http://193.175.110.91/repository/index.php/file:'; 
#wenn auf ein englischsprachiges Repositorium verwiesen wird, ist "Datei" durch "file" zu ersetzen,
#damit die Metadaten auch ausgelesen werden können.
</pre>


==== Metadaten aus Repositoriumsdateien im SalzWiki sichtbar ====
Bei MW1.17 bis 1.23 kann die Variable $wgFooterIcons für Icons links und rechts unten im Footer erweitert werden.
Wie bei MW1.16 gibt es auch noch die Variable $wgCopyrightIcon, mit der nur der Bereich rechts unten im Footer angepasst werden kann.


Da alle Dateien wie z.B Fotos im Repositorium liegen, muss vom SalzWiki aus der Zugriff nicht nur auf die Dateien, sondern auch auf die dazugehörigen Metadaten erfolgen. Dazu ist nicht nur
Bei MW1.23 besteht der Footer-Container aus folgenden Bereichen:
<br/>$wgFetchCommonsDescriptions  = true;<br/>
* div id="footer"
erforderlich, sondern auch eine Änderung in der PHP-Konfigurationsdatei "php.ini" in Zeile 523:
** div id="f-copyrightico" (unterer Footer-Bereich links)
<pre>allow_url_fopen = On</pre>
** div id="f-poweredbyico" (unterer Footer-Bereich rechts)
So kann fopen() ausgeführt werden, um Beschreibungsdaten vom Repositorium zu holen.
** ul id="f-list" (oberer=mittlerer Footer-Bereich)
*** li id="lastmod"
*** li id="viewcount"
*** li id="copyright"
*** li id="privacy"
*** li id="about"
*** li id="disclaimer"


==== Zugriff auf ein geschütztes Repository (Wiki-Code) ====
Bei MW1.16 bestand der Footer-Container aus folgenden Bereichen:
* ul id="footer-info" (oberer Footer-Bereich)
** li id="footer-info-lastmod"
** li id="footer-info-copyright"
* ul id="footer-places" (unterer Footer-Bereich links)
** ul id="footer-places-privacy"
** ul id="footer-places-about"
** ul id="footer-places-disclaimer"
* ul id="footer-icons" (unterer Footer-Bereich rechts)
** ul id="footer-copyrightico"
** ul id="footer-poweredbyico"


Die beschriebene Vorgehenssweise erlaubt es, auf ein für den normalen User gesperrtes Wiki = Repositorium zuzugreifen und die Metadaten der Abbildungen/Dateien auszulesen und in SalzWiki widerzugeben. '''Nach jedem mediawiki-Update muss die Datei "includes/httpFunctions.php" auf Änderungen überprüft werden!'''
==== "Forschungsverbund"/"Projektverbund" statt "Über [Wiki-Name]" ====


*Zunächst ist die Datei "httpFunctions.php" im Verzeichnis includes von SalzWiki zu modifizieren. Dazu wird von der Datei eine Kopie "httpFunctions_original.php" gespeichert. Danach wird folgender Code eingefügt:
Damit im "Footer" statt auf die Seite "Über SalzWiki" auf die Seite <del>"Forschungsverbund"</del> "Projektverbund" bzw. "Research Network" verlinkt wird, sind Änderungen an "Aboutsite" und "Aboutpage" vorzunehmen. Hierzu entweder über "Spezialseiten->Systemdaten und Werkzeuge->MediaWiki-Systemtexte" gehen oder folgende Adressen eingeben:
**für die Mediawiki-Version '''16.0''':
<pre>
<pre>
--- HttpFunctions.php 2010-06-09 05:49:34.000000000 +0200
"[Wiki-Verzeichnis]/index.php?title=MediaWiki:Aboutsite/de[-formal|-at|-ch]&action=edit"
+++ HttpFunctions_new.php 2010-11-22 17:09:33.000000000 +0100
bzw.
@@ -744,7 +744,7 @@
"[Wiki-Verzeichnis]/index.php?title=MediaWiki:Aboutpage/de&action=edit"
$this->curlOptions[CURLOPT_CUSTOMREQUEST] = $this->method;
</pre>
}
*Link-Text in "aboutsite" bearbeiten:
<pre>Projektverbund
  $this->curlOptions[CURLOPT_HTTPHEADER] = $this->getHeaderList();
<!--Über {{SITENAME}}-->
</pre>
$curlHandle = curl_init( $this->url );
*Seitenname, zu dem verlinkt wird, in "aboutpage" bearbeiten:
if ( !curl_setopt_array( $curlHandle, $this->curlOptions ) ) {
<pre>Project:Über
@@ -755,14 +755,97 @@
</pre>
/* Continue the processing. If it were in curl_setopt_array, processing would have halted on its entry */
ersetzen durch
}
<pre>Forschungsverbund
</pre>
- if ( false === curl_exec( $curlHandle ) ) {
 
- $code = curl_error( $curlHandle );
Diese Änderungen müssen auf allen Sprach-Subpages für Aboutsite und Aboutpage - nämlich für "de", "de-formal", "de-at" und "de-ch" - durchgeführt werden, da die Änderungen an den Seiten "Aboutpage" und "Aboutsite" sich nur bei den Standard-Sprachversion wie "de" auswirken, jedoch nicht z. B. bei "de-formal". Deshalb wurden als auszuwählende Sprachen "de-formal", "de-at" und "de-ch" vorerst deaktiviert in der Datei [wikiverzeichnisname]\languages\Names.php
-
Wenn ein User in den Profileinstellungen die Sprache abweichend von der Festlegung "de-formal" in der Datei "LocalSettings.php" auf "de" einstellt, funktioniert eventuell "Forschungsverbund" erst, nachdem "English" oder eine andere nicht-deutsche Sprache eingestellt wurde.
- if ( isset( self::$curlMessageMap[$code] ) ) {
 
- $this->status->fatal( self::$curlMessageMap[$code] );
<pre>
- } else {
'de' => 'Deutsch', # German ("Du")
- $this->status->fatal( 'http-curl-error', curl_error( $curlHandle ) );
##'de-at' => 'Österreichisches Deutsch', # Austrian German
- }
##'de-ch' => 'Schweizer Hochdeutsch', # Swiss Standard German
- } else {
##'de-formal' => 'Deutsch (Sie-Form)', # German - formal address ("Sie")  
- $this->headerList = explode("\r\n", $this->headerText);
</pre>
- }
 
-
Um im "Footer" den Hyperlink "Forschungsverbund" statt "Projektverbund" angezeigt zu  bekommmen, wird in der Skin-Datei der Code angepasst.
- curl_close( $curlHandle );
* MW 1.23 Datei "MonoBook.php"
-
 
+ /*
<pre>
+ *  START:
<?php foreach ($validFooterLinks as $aLink) { ?>
+ *  Add code to access restricted repositories.  
...
+ *  Add the following line in the LocalSettings.php
<?php } ?>
+ * $wgAuthenticatedRepository = true;
</pre>
+ * $wgAuthenticatedRepositoryUser = 'WikiSysop';
 
+ * $wgAuthenticatedRepositoryPassword = 'dev2010wer';
=== Favicon ===
+ * $wgShowAuthenticatedRepositoryError = true;
 
+ */
Damit in der Browser-Adresszeile ein Favicon dargestellt wird, ist eine Datei "salzwiki.ico" in das jeweilige Wiki-Verzeichnis hochzuladen und folgender Eintrag in der jeweiligen Datei "LocalSettings.php" vorzunehmen:
+
<pre>$wgFavicon = "/[wikiverzeichnisname]/salzwiki.ico";</pre>
+    global $wgAuthenticatedRepository, $wgAuthenticatedRepositoryUser, $wgAuthenticatedRepositoryPassword, $wgShowAuthenticatedRepositoryError;
 
+    $error = true;
=== Darstellung in einem Frame ===
+    $text = '';
 
+    $token2 = array();
Diese Funktionalität war nötig, solange die Wikis über die IP durch Frame-"Weiterleitung" bei "1&1" erreichbar waren. Sie wurde im ersten Halbjahr 2017 überflüssig nach Änderung des DNS-Eintrags auf die HAWK-IP bei "1&1" im Rahmen der Umstellung auf HTTPS und Server-Zertifikate.
+
 
+ /* run the code only if the user activate is in the LocalSettings.php*/
Seit MW Version 1.16.1 gibt es Vorkehrungen gegen CrossSiteScripting, was Seiten, die in Frames dargestellt werden und somit die Weiterleitung des Salzwiki-Hosters zur IP des HAWK-Rechenzentrumsservers, betrifft.
+    if ( $wgAuthenticatedRepository ) {
 
+      require_once 'extensions/Snoopy-1.2.4/Snoopy.class.php';
Die neuen Versionen des Internet Explorers und des Firefox zeigen eine Fehlermeldung, wenn man sich anmelden möchte, da der Inhalt in einem Frame angezeigt werden soll. Meist hilft die Nutzung eines Links zur IP-Seite weiter.
+      $index = '';
 
+      $login = '';
Dies ist zu umgehen, d.h. es tritt keine Fehlermeldung auf, wenn man in den localsetting.php einfügt:
+     
<pre>
+      /* Get all relevat url informations */
$wgEditPageFrameOptions = 'false';  
+      /* URL: http://localhost/mediawiki/mediawiki-repository/index.php/File:MediawikiExampleImageFlower.jpg?action=render&uselang=en */
</pre>
+      $wikiPath = "";
 
+      if (!preg_match('/(.*)\/index.php\/(.*)\?(.*)/', $this->url, $matches)) {
Hierzu näheres unter http://webcache.googleusercontent.com/search?q=cache:H1KG7SKYpvoJ:100thpriest.appspot.com/www.mediawiki.org/wiki/Project:Support_desk+mediawiki+1.16.1+frame+warnung+anmelden&cd=3&hl=de&ct=clnk&gl=de&client=firefox-a&source=www.google.de
+          echo "nicht gefunden";
 
+      } else {
<pre>
+          $wikiPath = $matches[1];
* The X-Frame-Options header to send on pages sensitive to clickjacking
+   /* If the url contains special characters, when these characters must be convert */
* attacks, such as edit pages. This prevents those pages from being displayed
+   $title = rawurldecode($matches[2]);
* in a frame or iframe. The options are:
+      }
*
+     
*   - 'DENY': Do not allow framing. This is recommended for most wikis.
+      $apiPath = "$wikiPath/api.php";
*
+      $indexPath = "$wikiPath/index.php";
*   - 'SAMEORIGIN': Allow framing by pages on the same domain. This can be used
+
*        to allow framing within a trusted domain. This is insecure if there
+      $snoopy = new Snoopy;
*        is a page on the same domain which allows framing of arbitrary URLs.
+      /* Start request to get an token */
*
+      $request_vars = array('action' => 'login', 'lgname' => $wgAuthenticatedRepositoryUser, 'lgpassword' => $wgAuthenticatedRepositoryPassword, 'format' => 'php');
*   - false: Allow all framing. This opens up the wiki to XSS attacks and thus
+      if(!$snoopy->submit($apiPath, $request_vars))
*         full compromise of local user accounts. Private wikis behind a
+      $this->status->fatal("Snoopy error: {$snoopy->error}");
*        corporate firewall are especially vulnerable. This is not
+     
*        recommended.
+      // We're only really interested in the cookies
*
+      $snoopy->setcookies();
* For extra safety, set $wgBreakFrames = true, to prevent framing on all pages,
+      $token = unserialize($snoopy->results);
* not just edit pages.
+     
</pre>
+      /* Use the Token to login */
 
+      if ( $token['login']['result'] == 'NeedToken') {
== Wiki-Konfiguration ==
+      $request_vars = array('action' => 'login', 'lgname' => $wgAuthenticatedRepositoryUser, 'lgpassword' => $wgAuthenticatedRepositoryPassword,  'lgtoken' => $token['login']['token'], 'format' => 'php');
 
+      if(!$snoopy->submit($apiPath, $request_vars))
Die Konfiguration eines Wikis erfolgt hauptsächlich mit PHP-Variablen in der Datei "xampp\htdocs\[wikiname]\LocalSettings.php".
$this->status->fatal("Snoopy error: {$snoopy->error}");
 
+      $token2 = unserialize($snoopy->results);
Z.23ff bei Verwendung der Domain-Adressen mit HTTP oder HTTPS
+      }
<pre>
+      else if ( ($token['login']['result'] == 'NoName') ) {
...
+        wfDebug( __METHOD__ . ": Wrong or no User for wgAuthenticatedRepositoryUser in the LocalSetting. \n" );
$wgSitename = "Salzwiki"; # "Salzwiki" "Saltwiki" "Repository"
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no User for <i>wgAuthenticatedRepositoryUser</i> in the LocalSetting.<br/>";
...
+      }
$wgScriptPath = ""; # "/salzwiki" "/saltwiki" "/repository"
+           
$wgScriptExtension = ".php";
+      /* If the login was successful, get the Information from the File Description */
...
+      if ( ($token2['login']['result'] == 'Success') or ($token['login']['result'] == 'Success') ) {
## The protocol and server name to use in fully-qualified URLs
+      $request_vars = array('action' => 'render', 'title'=> $title, 'lgtoken' => $token['login']['token'], 'format' => 'php');
if($_SERVER['HTTPS']==="on" OR !empty($_SERVER['HTTPS'])){$protokoll = "https";}
+      if(!$snoopy->submit($indexPath, $request_vars))
else{$protokoll = "http";}
+  $this->status->fatal("Snoopy error: {$snoopy->error}");
$wgServer = $protokoll."://".$_SERVER['SERVER_NAME'];
+      $this->content = $snoopy->results;
...
+      }
</pre>
+      else if ( ($token2['login']['result'] == 'WrongPass') or ($token2['login']['result'] == 'WrongPluginPass') or ($token2['login']['result'] == 'EmptyPass') ) {
 
+        wfDebug( __METHOD__ . ": Wrong or no Password for wgAuthenticatedRepositoryPassword in the LocalSetting." );
Z.23ff bei Verwendung der IP-Adresse
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no Password for <i>wgAuthenticatedRepositoryPassword</i> in the LocalSetting.<br/>";
<pre>
+      }
...
+      else if ( ($token2['login']['result'] == 'NotExists') ) {
$wgSitename = "Salzwiki"; # "Salzwiki" "Saltwiki" "Repository"
+        wfDebug( __METHOD__ . ": Wrong or no User for wgAuthenticatedRepositoryUser in the LocalSetting. \n" );
...
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no User for <i>wgAuthenticatedRepositoryUser</i> in the LocalSetting.<br/>";
$wgScriptPath = "/salzwiki"; # "/salzwiki" "/saltwiki" "/repository"
+      }
$wgScriptExtension = ".php";
+      $this->headerList = explode("\r\n", $this->headerText);     
...
+    }
## The protocol and server name to use in fully-qualified URLs
+    else
$wgServer = "http://".$_SERVER['SERVER_NAME'];
+    {   
...
+ /*
</pre>
+ *  START: Original Code - now in a if statement
 
+ */
=== Spracheinstellungen ===
+
 
+  if ( false === curl_exec( $curlHandle ) ) {
==== Standardsprache ====
+  $code = curl_error( $curlHandle );
 
Die Standardsprache wird in der Datei "LocalSettings.php" festgelegt, kann von den Usern in den Profileinstellungen aber nach den persönnlichen Bedürfnissen angepasst werden.
+  if ( isset( self::$curlMessageMap[$code] ) ) {
 
+  $this->status->fatal( self::$curlMessageMap[$code] );
* Salzwiki: $wgLanguageCode = "de-formal";
+  } else {
* Saltwiki: $wgLanguageCode = "en";
+  $this->status->fatal( 'http-curl-error', curl_error( $curlHandle ) );
* Repositorium: $wgLanguageCode = "en";
+  }
 
+  } else {
==== de-formal korrigieren (Wiki-Code) ====
+  $this->headerList = explode("\r\n", $this->headerText);
 
+  }
Die Datei "[wikiname]\languages\i18n\de-formal.json" wird wegen einer Du-Form ergänzt. Zuvor ist die Datei als Kopie "de-formal_original.json" zu speichern. Nach der Korrektur ist für Wiki-Updates eine Kopie als "de-formalSW.json" zu speichern.
+  curl_close( $curlHandle );
 
Für die Sie-Form wird aus der Datei "de.json" von Zeile 1759 "emailccme" mit Du-Form verwendet: "Sende eine Kopie der E-Mail an mich"; deshalb ist in der Datei "de-formal.json" in Zeile 216f zwischen "emailpagetext" und "emailccsubject" einzufügen:
+ /*
<pre>
+ *  END: Original Code - now in a if statement
"emailccme": "Eine Kopie der E-Mail an mich senden",
+ */
+  }
+ /*
+ *  END: Add code to access restricted repositories
+ */
$this->parseHeader();
$this->setStatus();
return $this->status;
}
}
class PhpHttpRequest extends HttpRequest {
</pre>
</pre>
Es wurden hauptsächlich Anpassungen gemacht, die den Text zurückgeben, sowie an der Abarbeitung von Fehlern. <br/>Für das korrekte Bearbeiten von Sonderzeichen in der url wurde rawurldecode() hinzugefügt.


*Die geänderte Datei "httpFunctions.php" als Sicherung für Mediawiki-Updates kopieren und speichern als "httpFunctions_sw.php".
=== Zugangsberechtigungen  ===


*Die Erweiterung "Snoopy-1.2.4" von "http://sourceforge.net/projects/snoopy/" herunterladen, zip-Dateien auspacken und die Erweiterung in das Verzeichnis "extensions" des SalzWikis bzw. Saltwikis kopieren.
==== Gruppen für Berechtigungen ====


*Das Modul "curl" muss beim Apache-Webserver aktiviert sein; dazu kommentiert man in der Datei "D:\xampp\php\php.ini" die folgende Zeile ein:
* Administratoren = Chef-Redakteure für Accounts erstellen/sperren, Systemtexte bearbeiten, Wiki-Inhalte verschieben, löschen, importieren etc.
<pre>extension=php_curl.dll </pre>
* autor = Autor/in für Wiki-Inhalte
Den Apache-Dienst über das XAMPP-Control-Panel neu starten, damit die Änderungen wirksam werden.
* Benutzer = nur Diskussionsseiten
 
* Bots (Systemgruppe)
*Der Zugriff auf das Repositorium wird gesperrt durch folgenden Eintrag in der Datei "LocalSettings.php" des Repositoriums:
* Bürokraten = Rechtevergabe, Account-Vereinigung
<pre>$wgGroupPermissions['*']['read'] = false;</pre>
* Editor (saltwiki, repository) = Wiki-Inhalte-Kontrolle
* Redakteur (salzwiki) = siehe Editor
* Sicherheit = Seitensperre für Spezialseiten und gesperrte Seiten bei deaktiviertem JavaScript
* Salzwiki, HAWK etc. = Gruppen im Repository
* sysop = Hauptadministrator
 
==== Vergabe von Nutzerrechten durch den Hauptadministrator (sysop) ====


*Um den Zugriff auf das geschützte Repositorium durchführen zu können, ist folgende Konfiguration der Datei "LocalSettings.php" des Salzwikis bzw. Saltwikis vorzunehmen:
Damit die unten beschriebenen Rechtevergaben umgesetzt werden können, erhält "sysop" zunächst den Zugang zu den SpecialPages, um auch nach Änderung der Datei "SpecialPage.php" Zugriff auf die Spezialseiten zu haben. Folgende Zeile ist in "LocalSettings.php" einzufügen:
<pre>
##HJschwarz 22.02.2011, Ersteinstellung für "restrictusers" zum Einstellen der Rechte
$wgAuthenticatedRepository = true;
<pre>$wgGroupPermissions['sysop']['restrictusers'] = true;
$wgAuthenticatedRepositoryUser = 'WikiSysop';
$wgAuthenticatedRepositoryPassword = 'xxx';
$wgShowAuthenticatedRepositoryError = false;
</pre>
</pre>
$wgAuthenticatedRepository - aktiviert den Zugriff auf ein gesichertes Repository. Wenn dies nicht notwendig ist, bitte abstellen, da die Funktion zusätzliche Abfragen schickt, was die Zugriffe bei hoher Last verlangsamen kann.
<br>$wgShowAuthenticatedRepositoryError - Gibt Fehlermeldungen in die Log Dateien. Für den Live Betrieb bitte abstellen.


*Konfiguration für das allgemeine Salzwiki, um die Daten aus der Datenbank zu holen. Folgende Zeilen in die Datei "LocalSettings.php" des Salzwikis bzw. Saltwikis einfügen:
Anschließend über SpecialPages->UserRightsManagement->[Username] die Rechte erweitern und alle Gruppen aktivieren.
 
==== Nutzerrechte bis zum Freischalten von Saltwiki ====
 
Kein "normaler" Nutzer kann Seiten in SaltWiki lesen:
<pre>
<pre>
$wgForeignFileRepos[] = array(
$wgGroupPermissions['*']['read'] = false;
'class' => 'ForeignDBRepo',
'name' => 'mediawiki-repository',
'url' => $wgSharedUploadPath,
'directory' => $wgSharedUploadDirectory,
'hashLevels' => 2, // This must be the same for the other family member
'dbType' => $wgDBtype,
'dbServer' => $wgDBserver,
'dbUser' => $wgDBuser,
'dbPassword' => $wgDBpassword,
'dbFlags' => DBO_DEFAULT,
'dbName' => $wgSharedUploadDBname,
'tablePrefix' => $wgSharedUploadDBprefix,
'hasSharedCache' => false,
'descBaseUrl' => $wgRepositoryBaseUrl,
'fetchDescription' => $wgFetchCommonsDescriptions
);
</pre>
</pre>


=== Vorlagen ===
Als Ausnahme werden mit $wgWhitelistRead alle im Array genannten Seiten dennoch für alle zum Lesen freigegegben, beispielsweise die Startseite und die Anmeldeseite.
 
==== Benutzer-Rechte in allen 3 Wikis ====


Vorlagen = Templates finden sich beispielhaft auf der Seite [[Vorlagen]] dargestellt.
Das Benutzerrechteschema sieht folgendermaßen aus:


Die einzelnen Vorlagen sind im Namensraum "Vorlage" bzw. "Template" zu finden. Für jede Vorlage ist eine eigene Wiki-Seite zu erstellen, um diese Vorlage dann im Wiki mit <nowiki>{{Vorlagenname}}</nowiki> verwenden zu können.
<pre>
Die Vorlage ist anschließend auf der Seite "Vorlagen" beispielhaft aufzuführen.
// Salzwiki (auskommentiert)
Die vorhandene Vorlage "Languages" wird ersetzt durch eine eigene Vorlage.
#$wgWhitelistRead = arry(":Hauptseite", "Spezial:Userlogin", "Salzwiki:Impressum", "General_disclaimer");
// Saltwiki
#$wgWhitelistRead = arry("Welcome_to_SaltWiki", "Saltwiki:About", "Saltwiki:General disclaimer", "Saltwiki:Privacy policy");
// Repository
#$wgWhitelistRead = arry(":home", "Spezial:Userlogin");
// Salzwiki/Saltwiki
$wgWhitelistedit = "talk";
// Salzwiki/Saltwiki
$wgGroupPermissions['Sysadmin']['editadmin'] = true;
# alle duerfen lesen, alle dürfen nicht editieren
$wgGroupPermissions['*']['read']          = true;
$wgGroupPermissions['*']['edit']          = false;
$wgGroupPermissions['*']['createpage']    = false;
$wgGroupPermissions['*']['createaccount'] = false; // Salzwiki: true, Saltwiki/Repository: false
$wgGroupPermissions['*']['createtalk']    = false;
$wgGroupPermissions['*']['writeapi']      = false;
$wgGroupPermissions['*']['restrictusers'] = false; // Salzwiki/Saltwiki: false, Repository: auskommentiert


*'''Vorlagen für SalzWiki und Saltwiki'''
# Benutzer duerfen: lesen, Diskussionsseiten erstellen
**Infobox_Salz bzw. Infobox_Salt
$wgGroupPermissions['user']['read']            = true; // Salzwiki/Saltwiki: true, Repository: false
**MetadatenFoto_upload (wird im Artikel Vorlagen/Templates verwendet)
$wgGroupPermissions['user']['createtalk']      = true; // Salzwiki/Saltwiki: true, Repository: false
*'''Vorlagen für das Repositorium'''
$wgGroupPermissions['user']['move']            = false;
**MetadatenFoto_upload
$wgGroupPermissions['user']['move-rootuserpages'] = false;
**MetadatenDaten_upload
$wgGroupPermissions['user']['move-subpages']  = false;
**MetadatenLiteratur_upload
$wgGroupPermissions['user']['edit']            = true;
**MetadatenProben_upload
$wgGroupPermissions['user']['createpage']      = false;
**MetadatenText_upload
$wgGroupPermissions['user']['upload']          = false;
**Untersuchungsmethoden
$wgGroupPermissions['user']['reupload']        = false;
*'''Lizenzvorlagen''': Eine neue Kategorie "Kategorie:Lizenzenvorlagen" erstellen mit folgenden Vorlagen:
$wgGroupPermissions['user']['reupload-shared'] = false;
**CC-by-nc-nd,CC-by-nc-nd/de
$wgGroupPermissions['user']['minoredit']      = false;
**CC-by-nc-sa,CC-by-nc-sa/de
$wgGroupPermissions['user']['purge']          = false;
**PD
$wgGroupPermissions['user']['writeapi']        = false;
**PD Help Page, PD Help Page/de, PD Help Page/fr
$wgGroupPermissions['user']['restrictusers']  = false;
** GFDL,GFDL/de (nur im Repositorium)
#$wgGroupPermissions['user']['sendemail']      = false; Repository: false, Salzwiki/Saltwiki: fehlt
 
# Spezialgruppe Autor
$wgGroupPermissions['autor']['emailconfirmed'] = true;
$wgGroupPermissions['autor']['createpage'] = true;
$wgGroupPermissions['autor']['createaccount'] = false; // Salzwiki: true, Saltwiki: false, Repository: auskommentiert
$wgGroupPermissions['autor']['createtalk'] = true;
$wgGroupPermissions['autor']['edit'] = true;
$wgGroupPermissions['autor']['protect'] = true; // Salzwiki/Saltwiki: true, Repository: auskommentiert
$wgGroupPermissions['autor']['editprotected'] = true; // Salzwiki/Saltwiki: true, Repository: auskommentiert
$wgGroupPermissions['autor']['read'] = true;
$wgGroupPermissions['autor']['upload'] = true;
$wgGroupPermissions['autor']['move'] = true;
$wgGroupPermissions['autor']['restrictusers'] = true; // Spezialseiten lesen


Alle anderen Vorlagen wurden beim Einbinden der Hilfeseiten bzw. Extensions eingestellt.
# Spezialgruppe Redakteur (Salzwiki) bzw. Editor (Saltwiki/Repository)
$wgGroupPermissions['Redakteur']['emailconfirmed'] = true;
$wgGroupPermissions['Redakteur']['createpage'] = true;
$wgGroupPermissions['Redakteur']['createtalk'] = true;
$wgGroupPermissions['Redakteur']['edit'] = true;
$wgGroupPermissions['Redakteur']['protect'] = true;
$wgGroupPermissions['Redakteur']['editprotected'] = true;
$wgGroupPermissions['Redakteur']['read'] = true;
$wgGroupPermissions['Redakteur']['upload'] = true;
$wgGroupPermissions['Redakteur']['patrol'] = true;
$wgGroupPermissions['Redakteur']['move'] = true;
$wgGroupPermissions['Redakteur']['createaccount'] = true;
$wgGroupPermissions['Redakteur']['movefile'] = true;
$wgGroupPermissions['Redakteur']['deletedtext'] = true;
$wgGroupPermissions['Redakteur']['deletedhistory'] = true;
$wgGroupPermissions['Redakteur']['noratelimit'] = true;
$wgGroupPermissions['Redakteur']['undelete'] = true;
$wgGroupPermissions['Redakteur']['restrictusers'] = true; // Salzwiki/Saltwiki: true, Repository: false
$wgGroupPermissions['Redakteur']['skipcaptcha'] = true;
$wgGroupPermissions['Redakteur']['approverevisions'] = true;


=== Lizenzen-Auswahl im Upload-Formular ===
##Benutzergruppe um zu verhindern, dass Seiten der Specialpages
##von jedem anderen außer Bürokraten und Admin und Sicherheit
##aufgerufen werden können. Risos 08.02.2012
$wgGroupPermissions['Sicherheit']['read'] = true;
$wgGroupPermissions['Sicherheit']['Sicherheit'] = true;


Um neue Lizenzen im Klappfeld im Upload-Formular einzugeben muss die Datei Mediawiki:Licenses (http://193.175.110.91/repository_1.16.1/index.php?title=MediaWiki:Licenses) editiert werden, nach dem vorgegebene Schema:
# Prevent new user registrations except by sysops
$wgWhitelistAccount = array( "user" => 0, "sysop" => 1, "developer" => 1 );
#$wgGroupPermissions['sysop']['createaccount'] = false; // Salzwiki: fehlt, Saltwiki: false, Repository: auskommentiert


<pre>
## Freischalten der Spezialseiten
*Free licenses:          <!-- Lizenztyp -->
$wgGroupPermissions['sysop']['restrictusers'] = true;
**PD|PD: public domain    <!--einzelne Lizenz-->
## Special Pages nur für Autoren lesbar
**GNU|GFDL: GNU Free Documentation License
##$wgNamespaceProtection[NS_spezial] = array( 'spezial-read');
##$wgGroupPermissions['autor']['spezial-read'] = true;


*Creative Commons
#$wgGroupPermissions['emailconfirmed']['emailconfirmed'] = true;
**CC-by-nc-nd|Attribution-NonCommercial-NoDerivs 3.0 Unported (CC BY-NC-ND 3.0)
**CC-by-nc-sa|Attribution-NonCommercial-ShareAlike 3.0 Unported (CC BY-NC-SA 3.0)
</pre>
</pre>


=== XEB Extra Edit Buttons (Wiki-Code, JS) ===
==== Benutzer-Rechte in Repository  ====
 
Das für das Repositorium erweiterte Benutzerrechteschema enthält folgende Angaben:


'''Achtung: Funktioniert nur bei Browsern mit aktiviertem JavaScript und muss in "includes/EditPage.php" nach jedem mediawiki-Update auf Vorhandensein überprüft werden!'''
<pre>
# Repository
##---------------------------------------------------------------------------------
# Spezialgruppe HAWK eingefügt HSChwarz 4.10.2011
$wgGroupPermissions['HAWK']['emailconfirmed'] = true;
$wgGroupPermissions['HAWK']['createpage'] = true;
$wgGroupPermissions['HAWK']['createtalk'] = true;
$wgGroupPermissions['HAWK']['edit'] = true;
$wgGroupPermissions['HAWK']['read'] = true;
$wgGroupPermissions['HAWK']['move'] = true;
$wgGroupPermissions['HAWK']['restrictusers'] = false;
## Anlegen von Rechteschema für Projekte
# Spezialgruppe SalzWiki eingefügt HSChwarz 27.07.2010
$wgGroupPermissions['SalzWiki']['emailconfirmed'] = true;
$wgGroupPermissions['SalzWiki']['createpage'] = true;
$wgGroupPermissions['SalzWiki']['createtalk'] = true;
$wgGroupPermissions['SalzWiki']['edit'] = true;
$wgGroupPermissions['SalzWiki']['read'] = true;
$wgGroupPermissions['SalzWiki']['move'] = true;
$wgGroupPermissions['SalzWiki']['restrictusers'] = false;
# Spezialgruppe SIP eingefügt HSChwarz 27.07.2010
$wgGroupPermissions['SIP']['emailconfirmed'] = true;
$wgGroupPermissions['SIP']['createpage'] = true;
$wgGroupPermissions['SIP']['createtalk'] = true;
$wgGroupPermissions['SIP']['edit'] = true;
$wgGroupPermissions['SIP']['read'] = true;
$wgGroupPermissions['SIP']['move'] = true;
$wgGroupPermissions['SIP']['restrictusers'] = false;


Die Funktionen bzw. verfügbaren Schaltflächensymbole des Editors wurden durch nachfolgenden Scriptcode erweitert.
## Erweiterung ApprovedRevs nicht zusammen mit "AccessControl" einsetzbar
#$wgGroupPermissions['sysop']['approverevisions'] = true;
#$wgGroupPermissions['*']['viewlinktolatest'] = false;
#$wgGroupPermissions['autor']['viewlinktolatest'] = true; // Salzwiki/Saltwiki: true, Repository: auskommentiert
#$wgGroupPermissions['sysop']['viewlinktolatest'] = true;


Die im Code benannten Bilder "Button_[...].png" im Verzeichnis skins/common/images/" speichern.
## BibManager-Berechtigungen eingefügt 2016-02-23
$wgGroupPermissions['*']['bibmanagercreate'] = false;
$wgGroupPermissions['*']['bibmanageredit'] = false;
$wgGroupPermissions['*']['bibmanagerdelete'] = false;
$wgGroupPermissions['autor']['bibmanager'create] = true;
$wgGroupPermissions['autor']['bibmanageredit'] = true;
#$wgGroupPermissions['autor']['bibmanagerdelete'] = true;
$wgGroupPermissions['Redakteur']['bibmanager'create] = true;
$wgGroupPermissions['Redakteur']['bibmanageredit'] = true;
$wgGroupPermissions['Redakteur']['bibmanagerdelete'] = true;
$wgGroupPermissions['sysop']['bibmanager'create] = true;
$wgGroupPermissions['sysop']['bibmanageredit'] = true;
$wgGroupPermissions['sysop']['bibmanagerdelete'] = true;
/*
## Salzwiki/Saltwiki: Erweiterung ConfirmEdit
#captcha Hschwarz 12.01.2010
$wgGroupPermissions['*']['skipcaptcha'] = false;
$wgGroupPermissions['user']['skipcaptcha'] = false;
$wgGroupPermissions['autor']['skipcaptcha'create] = true;
$wgGroupPermissions['autoconfirmed']['skipcaptcha'] = false;
#$wgGroupPermissions['bot']['skipcaptcha'] = true; // registered bots
$wgGroupPermissions['sysop']['skipcaptcha'] = true;
*/
## to allow interwiki-linking
$wgGroupPermissions['*']['interwiki'] = false;
$wgGroupPermissions['sysop']['interwiki'] = true;
</pre>


Den Code im Verzeichnis "includes" in der "EditPage.php" bei der Array-Variablen "$Toolarray" (ab Zeile 2110) am Ende einfügen (Z. 2210) - Komma nicht vergessen! - (siehe auch http://meta.wikimedia.org/wiki/Help_talk:Edit_toolbar). Hier können noch weitere eigene Funktionen implementiert werden.
==== Spezial-Seiten ====


<pre> ,
Für die Spezialseiten gibt es die Berechtigungsgruppe "Sicherheit" mit entsprechender Konfiguration in der Datei "LocalSettings.php".
array( 'image' => "Button_redirect.png",
 
'id'    => "Button_redirect",
===== Spezial-Seiten mit Sonderrechten =====
'tip' => "Redirect",
 
'open' => "#REDIRECT [[",
Spezialseiten, die nur mit besonderen Berechtigungen verfügbar sind, werden nach Anmeldung bei einem Konto mit besonderen Berechtigungen auf der Seite "Spezialseiten" per CSS fett-formatiert dargestellt:
'close' => "]]",
<pre>
'sample'=> "Insert text"
<li class="mw-specialpagerestricted">...
),
array( 'image' => "Button_strike.png",
'id'    => "Button_strike",
'tip' => "Strike",
'open' => "<s>",
'close' => "</s>",
'sample'=> "Strike-through text"
),
array( 'image' => "Button_enter.png",
'id'    => "Button_enter",
'tip' => "Line break",
'open' => "<br />",
'close' => "",
'sample'=> ""
),
array( 'image' => "Button_upper_letter.png",
'id'    => "Button_upper_letter",
'tip' => "Superscript",
'open' => "<sup>",
'close' => "</sup>",
'sample'=> "Superscript text"
),
array( 'image' => "Button_lower_letter.png",
'id'    => "Button_lower_letter",
'tip' => "Subscript",
'open' => "<sub>",
'close' => "</sub>",
'sample'=> "Subscript text"
),
array( 'image' => "Button_small.png",
'id'    => "Button_small",
'tip' => "Small",
'open' => "<small>",
'close' => "</small>",
'sample'=> "Small Text"
),
array( 'image' => "Button_hide_comment.png",
'id'    => "Button_hide_comment",
'tip' => "Insert hidden Comment",
'open' => "<!-- ",
'close' => " -->",
'sample'=> "Comment"
),
array( 'image' => "Button_Bibliogryphy.png",
'id'    => "Button_insert Literature",
'tip' => "Literturzitat einfügen",
'open' => '<bib id="',
'close' => '"/>',
'sample'=> 'Mueller:2009'
),
array( 'image' => "Button_blockquote.png",
'id'    => "Button_blockquote",
'tip' => "Insert block of quoted text",
'open' => "<blockquote>\\n",
'close' => "\\n</blockquote>",
'sample'=> "Block quote"
),
array( 'image' => "Button_insert_table.png",
'id'    => "Button_insert_table",
'tip' => "Insert a table",
'open' => '{| class="wikitable"\\n|-\\n',
'close' => "\\n|}",
'sample'=> "! header 1\n! header 2\n! header 3\n|-\n| row 1, cell 1\n| row 1, cell 2\n| row 1, cell 3\n|-\n| row 2, cell 1\n| row 2, cell 2\n| row 2, cell 3"
),
array( 'image' => "Button_reflink.png",
'id'    => "Button_reflink",
'tip' => "Insert a reference",
'open' => "<ref>",
'close' => "</ref>",
'sample'=> "Insert footnote text here"
)
</pre>
</pre>


Je nach Sprachvariante sind die Texte hinter "tip" und "sample" zu übersetzen.
===== Spezial-Seiten verbergen =====


ACHTUNG: Nach jedem mediawiki-Update muss überprüft werden, ob die vorgenommene Änderung in der Datei "EditPage.php" noch existiert und funktioniert. Deshalb ist von der Datei eine Kopie "EditPageSW.php" im Verzeichnis "inludes" zu speichern.
Werden die Spezial-Seiten in der linken Menüleiste verborgen - siehe [[#Sidebar-Einschr.C3.A4nkung|Sidebar-Einschränkung]] - sind sie dennoch über die Adresszeile des Browsers erreichbar, beispielsweise mit "https://wikiname.tld/index.php/Spezial:Spezialseiten".
Sollten die Übersetzungen in der entsprechenden Übersetzungsdatei statt in "EditPage.php" hinzugefügt werden, wäre die Übersetzungsdatei nach jedem mediawiki-Update ebenfalls zu überprüfen.


=== Einrichten von Namensräumen<br>  ===
Um derartige Seitenaufrufe zu unterbinden sind in der Datei "LocalSettings.php" Berechtigungen festzulegen.


Es werden folgende Namensräume eingerichtet:
===== Spezialseiten mit Gruppenberechtigung =====
# "ADM" bzw. "Access": "ADM" bei Salzwiki und Saltwiki, "Access" bei Repository) für Dokumente der Administratoren, den nur diese bearbeiten können,
 
# "Bearbeitung": nur bei Saltwiki zum erstmaligen Erstellen von Dokumenten, die kein Leser sehen soll
Es sollen nur Mitglieder bestimmter Gruppen die Spezialseiten im Namensraum "NS_SPECIAL" lesen dürfen, aber nicht unangemeldete Gäste oder Mitglieder anderer Gruppen. Gruppen mit Leserecht:
# "Literature": für die Bibliographie - Achtung: Bei der Zuweisung in $wgExtraNamespaces ist ein Leerzeichen vor "_talk"!
* Administratoren
# "SalzeImPorenraum": nur bei Repository
* autor
# "RBKLuebeck": nur bei Repository - Achtung: Ursprüngliche Konstante "RBK-Luebeck" mit Bindestrich erzeugt bei MW 1.23 eine Fehlermeldung und Bindestrich ist auch nicht bei $wgExtraNamespaces enthalten
* Redakteur
* Sicherheit
* sysop
 
Für Berechtigungen von Spezialseiten siehe auch
* https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:$wgNamespaceProtection
* <del>https://www.mediawiki.org/wiki/Manual:Special_pages/de#Seitenzugriff_beschr.C3.A4nken</del> (2018-11-06 nicht mehr vorhanden)
* <del>http://phlow.net/magazin/netzkultur/technik/445-mediawiki-spezialseiten-vor-unerlaubtem-zugriff-sperren</del> (2015-12-04 nicht mehr vorhanden)
 
In der Datei "LocalSettings.php" wird am Ende des Blocks "Namensräume" ein "Hook" namens "SpecialPage_initList" eingefügt. Der "Hook" wird in der Datei "SpecialPagesFactory.php" in der Funktion "getPageList()" ausgeführt. Verarbeitet werden die Angaben aus der Variablen $coreList.
 
Damit alle, die nicht Mitglied der berechtigten Gruppen sind, bestimmte Spezialseiten dennoch aufrufen können, wird Folgendes in der Datei "LocalSettings.php" eingegeben:
<pre>
$wgHooks['SpecialPage_initList'][] = 'groupspecificSpecialpages';
function groupspecificSpecialpages(&$aSpecialPages){
  global $wgUser;
  $groups = $wgUser->getEffectiveGroups();
  if($wgUser->isAnon() || ( !in_array("sysop", $groups)
    && !in_array("autor", $groups) && !in_array("Administratoren", $groups)
    && !in_array("Redakteur", $groups) && !in_array("Editor", $groups)
    && !in_array("forschung", $groups)
  ) ){
    $aSpecialPages = array(
      "Specialpages" => "SpecialSpecialpages",
      "UserLogin" => "SpecialUserLogin",
      "UserLogout" => "SpecialUserLogout", // Seite nach der Abmeldung
      "CreateAccount" => "SpecialCreateAccount", // für Registrierung
      "Contact" => "SpecialContact", // Letzte Änderung im Menü links
      "Recentchanges" => "SpecialRecentChanges", // Kontaktseite im Menü links
      "BibManager" => "BibManager", // Bibliographie im Menü links
    );
  }
}
</pre>


Leerzeichen und Bindestriche sind für selbst definierte Namensräume (custom namespaces) nicht zulässig, siehe https://www.mediawiki.org/wiki/Manual:Using_custom_namespaces
===== Anpassungen in vorigen MW-Versionen (Wiki-Code) =====


Salzwiki
Festlegungen in der Datei "LocalSettings.php" wirkten bei Aufruf der Spezialseiten in der Browser-Adresszeile nicht, unter anderem, weil
* sich $wgNamespaceProtection nur auf "edit" und nicht auf "read" anwenden lässt
* der Namensraum mit "NS_SPECIAL" statt mit "NS_spezial" angegeben werden muss
* die Nutzungsfunktion "spezial-read" dem System nicht bekannt ist
Die unwirksame Konfiguration:
<pre>
<pre>
# Einrichten der Namensräume Adm, Bearbeitung und Literature
## Freischalten der Spezialseiten
define("NS_ADM", 100);
$wgGroupPermissions['sysop']['restrictusers'] = true;
define("NS_ADM_TALK", 101);
## SpecialPages nur für Autoren lesbar
#define("NS_Bearbeitung", 120);
$wgNamespaceProtection[NS_spezial] = array('spezial-read');
#define("NS_Bearbeitung_TALK", 121);
$wgGroupPermissions['autor']['spezial-read'] = true;
define("NS_Literature", 110);
define("NS_Literature_TALK", 111);
# Create namespaces
$wgExtraNamespaces = array(
NS_ADM => 'Adm',
NS_ADM_TALK => 'Adm_talk',
#NS_Bearbeitung => 'Bearbeitung',
#NS_Bearbeitung_TALK => 'Bearbeitung_talk',
NS_Literature => 'Literature',
NS_Literature_TALK => 'Literature _talk'
);
$wgNamespacesWithSubpages[NS_HELP] = true;           #subpages enabled for the Helpnamespace
$wgNamespaceProtection[NS_ADM] = array( 'editadm' ); #permission "editadmin" required to edit the Adm namespace
$wgNamespacesWithSubpages[NS_ADM] = true;            #subpages enabled for the ADM namespace
$wgGroupPermissions['Administrator']['editadm'] = true;
</pre>
</pre>


Saltwiki
'''Achtung: Bei MW1.23 sind keine Anpassungen in der Datei "[wikiname]\includes\skins\SkinTemplate.php" vorzunehmen!''' Erfolgen dennoch Änderungen siehe auch http://nullraffer.de/wiki/index.php?title=Mediawiki_absichern.
<pre>
 
# Einrichten der Namensräume Adm, Bearbeitung und Literature
Bei MW1.16 waren die Anpassungen im Wiki-Code der Datei "SpecialPage.php" sowie in der Konfigurationsdatei erforderlich.
define("NS_ADM", 100);
Bei MW1.31/1.27/1.23 heißt die Datei "SpecialPageFactory.php" statt "SpecialPage.php". Die gleichnamige Klasse mit der Funktion "getRestrictedPages(...)" gilt ab MW1.32 als veraltet.
define("NS_ADM_TALK", 101);
define("NS_Bearbeitung", 120);
define("NS_Bearbeitung_TALK", 121);
define("NS_Literature", 110);
define("NS_Literature_TALK", 111);
# Create namespaces
$wgExtraNamespaces = array(
NS_ADM => 'Adm',
NS_ADM_TALK => 'Adm_talk',
NS_Bearbeitung => 'Bearbeitung',
NS_Bearbeitung_TALK => 'Bearbeitung_talk',
NS_Literature => 'Literature',
NS_Literature_TALK => 'Literature _talk'
);


$wgNamespacesWithSubpages[NS_HELP] = true;          #subpages enabled for the Helpnamespace
'''Achtung: Bei MW 1.23 ist der Wiki-Code anders als bei MW 1.16!''' Wiki-Code bei MW 1.23 im Vergleich zu MW 1.16:
$wgNamespaceProtection[NS_ADM] = array( 'editadm' ); #permission "editadmin" required to edit the Adm namespace
 
$wgNamespacesWithSubpages[NS_ADM] = true;            #subpages enabled for the ADM namespace
*Datei "includes\specialpage\SpecialPageFactory.php" statt Datei "includes\SpecialPage.php"
$wgGroupPermissions['Sysadmin']['editadm'] = true;
*Variable "private static $list" statt "static public $mList"
</pre>
*Assoziative Array-Elemente haben geänderte Werte, die nicht mehr in Arrays, sondern nur noch als Text-Strings angegeben sind
**Bereich "Media reports and uploads" ab Zeile 114
**Bereich "Unlisted / redirects" in Zeile 171


Repository
<pre>
<pre>
# Einrichten der Namensräume Adm, Bearbeitung und Literature
// Media reports and uploads
define("NS_Access", 100);
'Listfiles' => 'SpecialListFiles,
define("NS_Access_TALK", 101);
'Filepath' => 'SpecialFilePath',
#define("NS_Bearbeitung", 120);
...
#define("NS_Bearbeitung_TALK", 121);
// Unlisted / redirects
define("NS_Literature", 110);
'Specialpages' => 'SpecialSpecialpages',
define("NS_Literature_TALK", 111);
...
# Create namespaces
</pre>
$wgExtraNamespaces = array(
 
NS_Access => 'Access',
=== Weiterleitungen ===
NS_Access_TALK => 'Access_talk',
 
#NS_Bearbeitung => 'Bearbeitung',
Für einige Seiten werden Weiterleitungen eingerichtet. Für eine Übersicht der bestehenden Weiterleitungen siehe bei den Spezialseiten http://193.175.110.91/[wikiverzeichnis]/index.php/Spezial:Weiterleitungen bzw. http://193.175.110.91/[wikiverzeichnis]/index.php/Special:ListRedirects:
#NS_Bearbeitung_TALK => 'Bearbeitung_talk',
NS_Literature => 'Literature',
NS_Literature_TALK => 'Literature _talk'
);


##Anlegen von Namensräumen für Projekte
Für die Navigation links (Sidebar), den Footer-Bereich und dergleichen gibt es folgende Weiterleitungen:
define('NS_SalzeImPorenraum', 1010);
*SalzWiki
define('NS_SalzeImPorenraum_TALK', 1011);
**Aktuelles => Startseite#Aktuelles
$wgExtraNamespaces[NS_SalzeImPorenraum] = 'SIPP';
**Bibliographie => Special:BibMangerList
$wgExtraNamespaces[NS_SalzeImPorenraum_TALK] = 'SIPP_talk';
**Forschungsverbund => Informationen zum DFG-Projekt#Projektverbund
#define('NS_RBK-Luebeck', 1020); //Achtung: Bindestrich darf nicht sein und ist auch nicht bei $wgExtraNamespaces enthalten
**Hauptseite => Startseite
#define('NS_RBK-Luebeck_TALK', 1021);  //Achtung: Bindestrich darf nicht sein und ist auch nicht bei $wgExtraNamespaces enthalten
**Projektverbund => Informationen zum DFG-Projekt#Projektverbund
define('NS_RBKLuebeck', 1021);
**Willkommen im SalzWiki => Informationen zum DFG-Projekt
define('NS_RBKLuebeck_TALK', 1021);
**Über => Informationen zum DFG-Projekt
$wgExtraNamespaces[NS_RBKLuebeck] = 'Rbkl';
**Über SalzWiki => Informationen zum DFG-Projekt
$wgExtraNamespaces[NS_RBKLuebeck_TALK] = 'Rbkl_talk';
**Über Salzwiki => Informationen zum DFG-Projekt
**Diskussion:Hauptseite => Diskussion:Startseite
**Diskussion:Willkommen im SalzWiki => Diskussion:Informationen zum DFG-Projekt
**Salzwiki:Forschungsverbund => Informationen zum DFG-Projekt#Projektverbund
**Salzwiki:Portal => Informationen zum DFG-Projekt
**Salzwiki:Projektverbund => Informationen zum DFG-Projekt#Projektverbund
**Salzwiki Diskussion:Portal => Diskussion:Informationen zum DFG-Projekt
**Hilfe:Variables => Help:Magic words
**Adm:ToDo-Liste => Salzwiki:ToDo-Liste
*SaltWiki
**Literature and Data => Literature and Programs
**News => Home
**Project Network => About the project#Research Network
**Research Network => About the project#Research Network
**Welcome to SaltWiki => About the project
**Talk:Welcome to SaltWiki => Talk:About the project
**Saltwiki:Portal => Home
**Saltwiki:Research Network => About the project#Research Network
**Help:Tex/de => Help:TeX/de
**Help:Variables => Help:Magic words
*Repository
**Hauptseite => Repository
**Main Page => Repository
**Main Page/de => Repository
**Repository:About => VRE/Repository
 
=== Sidebar anpassen ===


#$wgNamespacesWithSubpages[NS_HELP] = true;            #subpages enabled for the Helpnamespace
==== Logo-Hyperlink ====
#$wgNamespaceProtection[NS_ADM] = array( 'editadm' ); #permission "editadmin" required to edit the Adm namespace
#$wgNamespacesWithSubpages[NS_ADM] = true;            #subpages enabled for the ADM namespace
#$wgGroupPermissions['Sysadmin']['editadm'] = true;
</pre>


== Extensions  ==
Die Seite, die beim Klick auf das Logo aufgerufen werden soll, wird in der Seite "MediaWiki:Mainpage" angegeben.


Welche Erweiterungen in welcher Distribution enthalten sind, erfährt man auf der Seite https://www.mediawiki.org/wiki/Comparison_of_extensions_in_distributions
==== Navigation links mit 2 Varianten ====


Es gibt zwei Varianten:
* die Standard-Variante für
** nicht-angemeldete Gäste, welche Wiki-Seiten nur ansehen können
** angemeldete Standard-User
* die Autor-Variante für
** Autor/inn/en
** Administrator/inn/en
** Forscher/innen


=== AccessControl  ===
===== Navigation links Standard-Variante =====


==== Verwendungszweck ====
Die '''Standard-Variante''' ist zu erreichen über:<br/><del>http://193.175.110.91/[wikiverzeichnis]/index.php/MediaWiki:Sidebar</del> <br/>https://[wiki-domain]/index.php/MediaWiki:Sidebar


Die Erweiterung dient dazu, Seiten beispielsweise auch zum Lesen zu sperren, wenn wie im Repositorium Inhalte zwar bereits bearbeitet und ins Wiki eingestellt werden, aber noch nicht öffentlich zugänglich sein sollen.
<pre>&lt;!-- Salzwiki --&gt;
*navigation
**Mainpage|Startseite
<del>**Salzwiki:Portal|SalzWiki:Portal</del>
<!--**Informationen zum DFG-Projekt|SalzWiki-Portal-->
<!--**Aktuelles|Aktuelles-->
Special:BibManager_Overview|Bibliographie
**Glossar|Glossar
<!--**Autorenanmeldung|Autorenanmedlung-->
**Redaktion SalzWiki|Redaktion
**Autoren/innen_von_SalzWiki|Autor/inn/en
**recentchanges-url|Recentchanges
**special:contact|Kontakt
**Hilfe:Contents/de|Hilfe


Der Zugang auf eine Seite wird durch Eingabe einer Nutzergruppe (Beispiel: "parole") erlaubt, die vorher z.B. in "LocalSettings.php" definiert wird:
*SEARCH
<pre>$wgGroupPermissions['parole']['read'] = true;</pre>
<!--*Umfrage-->
Damit nur Mitglieder der Gruppe "parole" Zugang zu einer Seite erhalten, wird auf der jeweiligen Seite oben folgende Zeile eingegeben (siehe dazu auch http://www.mediawiki.org/wiki/Extension:AccessControl):
<!--**http://www.worktogether51.net/gc/wsl.php?I=Y4TTY7YTOTTYT47TTUTTBT4NTTYT4BT40 |Ihre Meinung zu SalzWiki-->
<pre><accesscontrol>parole</accesscontrol></pre>


==== AccessControl v2.4 fehlerhaft bei MW 1.23 ====
*TOOLBOX


Für  MW 1.23 wurde versucht, AccessControl v2.5 zu verwenden. Der Download enthält aber nicht wie in Aussicht gestellt Version 2.5, sondern Version v2.4, bei welcher in der Datei "changelog.txt" nur Änderungen bis v2.3 aufgelistet sind. Die Version 2.4 hat mehrere Fehler:
*andere Sprachen
* Z.21: "$wgAccessControlRedirect = true;" fehlt
**https://www.saltwiki.net/|English
* Z.136: in Funktion getTemplatePage() ist ein Rückgabewert auskommentiert
</pre>
* Z.173: php-Warnung, weil "isset($allow)" fehlt
* Z.225: php-Warnung, weil "isset($rights)" fehlt
* Z.202, Z.210: in Funktion fromTemplates() wird dieselbe Funktion evtl. endlos aufgerufen
* Z.284: in Funktion allRightsTag() wird die Funktion fromTemplates() aufgerufen, die wiederum evtl. die Funktion allRightsTag() in Z.213, Z.218 und Z.220 endlos aufruft
* Funktion doRedirect() ist im Vergleich zu v2.5 anders


==== AccessControl v2.5 für MW 1.23 ====
<pre>&lt;-- Repositorium --&gt;
*Navigation
**Hauptseite|Home


Siehe auch https://www.mediawiki.org/wiki/Extension:AccessControl
*Other Wikis
**https://www.salzwiki.de/|SalzWiki
**https://www.saltwiki.net/|SaltWiki
</pre>


Achtung: Version 2.5 ist nicht zum Herunterladen bei REL1.23, sondern erst bei REL1.24 verfügbar.
<pre>&lt;-- Saltwiki --&gt;
* navigation
** mainpage|Home
<!--** portal-url|SaltWiki-Portal-->
<!--** About_the_project|SaltWiki Portal-->
<!--** News|News-->
** Special:BibManager_Overview|Bibliography|Literature
** Glossary|Glossary
** Editorial Board|Editorial Board
** Authors in SaltWiki|Authors
** Special:Contact|Contact
** Help:Contents|Help


* Die Extension wird als (REL1.24 oder) REL1.26 heruntergeladen und nach dem Extrahieren in das Verzeichnis "extensions" kopiert.
* SEARCH
** v2.5 "...REL1.26...", Datei "version": 2016-01-09T22:48:53 1a2ce27 [verwendet]
** v2.5 "...REL1.24...", Datei "version": 2016-01-09T22:48:53 c7e1e54 [nicht verwendet]
** v2.4 "...REL1.23...", Datei "version": 2015-06-16T21:00:32 befc02e [nicht verwendet]
* Einfügen in Datei "LocalSettings.php":
<pre>require_once("$IP/extensions/AccessControl/AccessControl.php");</pre>


PHP erzeugt evtl. eine Meldung "Notice: Undefined variable: allow ... on line 174". Es fehlt bei $allow die Abfrage "isset(...)".
* TOOLBOX


Die Datei "AccessControl.php" ist zur Verhinderung von php-Warnungen wie folgt zu bearbeiten:<br/>
*Languages
In Zeile 174 "if(is_array($allow)){" mit "isset($allow) &&" ergänzen:
**https://www.salzwiki.de/|German
<pre>
if(isset($allow) && is_array($allow)){
</pre>
</pre>


Weitere Probleme mit Script-Timeout wie bei AccessControl v2.4:
===== Navigation links Autor-Variante =====
* Z.206, Z.214: in Funktion fromTemplates() wird dieselbe Funktion evtl. endlos aufgerufen
* Z.290: in Funktion allRightsTag() wird die Funktion fromTemplates() aufgerufen, die wiederum evtl. die Funktion allRightsTag() in Z.217, Z.222 und Z.224 endlos aufruft


Timeout-Ursache sind in den Templates "Ynotice" und "Baustelle" die noinclude-Bereiche, in denen der Template-Name erneut auftaucht. Der erste Buchstabe muss entweder kleingeschrieben werden oder - besser - durch Hexadezimal-HTML-Zeichen ersetzt werden:
Die '''Autor-Variante''' muss durch Erstellung einer neuen Seite (Adminrechte erforderlich) erfolgen:
*Erst folgende Adresse im Browser eingeben:<br/><del>http://193.175.110.91/[wikiverzeichnis]/index.php/MediaWiki:Autor_sidebar</del><br/>https://[wiki-domain]/index.php/MediaWiki:Autor_sidebar
*Danach mit Karteikarte "Erstellen" folgenden Quelltext eingeben:


<pre>
<pre>&lt;!-- Salzwiki --&gt;
<nowiki>
*Navigation
&lt;noinclude&gt;
**Mainpage|Startseite
=== Beispielvorlage ===
<del>**SalzWiki:Portal|SalzWiki:Portal</del>
{{&amp;#98;notice|text=
<!--**Informationen zum DFG-Projekt|SalzWiki-Portal-->
}}
<!--**Aktuelles|Aktuelles-->
&lt;/noinclude&gt;
<!--**http://193.175.110.91/repository/index.php/Main_Page |Repositorium-->
**https://repository.hawk-hhg.de/ |Repositorium
**Spezial:Bibliographieeinträge_verwalten|Bibliographie
**Glossar|Glossar
**Redaktion_SalzWiki|Redaktion
**Autoren/innen von SalzWiki|Autor/inn/en
**recentchanges-url|recentchanges
**special:contact|Kontakt
**help:contents/de|help
<!--
*Umfrage
**http://www.worktogether51.net/gc/wsl.php?I=Y4TTY7YTOTTYT47TTUTTBT4NTTYT4BT40ON84RMK758E |Ihre Meinung als Autor zu SalzWiki
**http://www.worktogether51.net/gc/wsl.php?I=Y4TTY7YTOTTYT47TTUTTBT4NTTYT4BT40 |Ihre Meinung als Nutzer zu SalzWiki -->


&lt;noinclude&gt;
* Autor/inn/en-Seiten
=== Beispielvorlage ===
**Autoren|Richtlinien/Übersichten
{{&amp;#66;austelle}}
**Nutzungsrechte|Nutzungsrechte
&lt;/noinclude&gt;
**Review|Review
</nowiki>
**Kategorie|Kategorienbaum
</pre>
**Vorlagen|Vorlagen
<!--**sandkasten|Sandbox-->


Abhilfe schaffen folgende Änderungen von https://www.mediawiki.org/wiki/Extension_talk:AccessControl#Selected_fixes_against_2.5:
*SEARCH
<pre>
//function makeGroupArray(...)
//Z.94
$usersreadonly[] = (string)$user;  #$usersreadonly[] = $user;
//Z.97
$userswrite[] = (string)$user;  #$userswrite[] = $user;


//function getUsersFromPages(...)
*TOOLBOX
//Z.150
$gt = $Title->newFromText( $group );    #$gt = $Title->makeTitle( 0, $group );


//function fromTemplates(...)
*Andere Sprachen
//Z.231
**https://www.saltwiki.net/ |English
if ( $wgUser->isAnon() ) {    #if ( $wgUser->mID === 0 ) {
</pre>
//Z.236
if ( in_array( 'sysop', $wgUser->getGroups(), true) ) {    #if ( in_array( 'sysop', $wgUser->mGroups, true) ) {
//Z.244
if ( ! in_array( $wgUser->getName(), $users[0], true) ) {    #if ( ! in_array( $wgUser->mName, $users[0], true) ) {
//Z.255
if ( ! in_array( $wgUser->getName(), $users[1], true) ) {    #if ( ! in_array( $wgUser->mName, $users[1], true) ) {


//Z.298
$gt = $Title->newFromText( $redirecttarget );    #$gt = $Title->makeTitle( 0, $redirecttarget );


//function hookUserCan(...)
<pre>&lt;-- Saltwiki --&gt;
//Z.322
*Navigation
if ( $wgUser->isAnon() ) {    #if ( $wgUser->mID === 0 ) {
**Mainpage|Home
//Z.338
<!--**Saltwiki:Community_portal|SaltWiki:Portal-->
if ( $wgUser->isAnon() ) {    #if ( $wgUser->mID === 0 ) {
<!--**About_the_Project|SaltWiki Portal-->
//Z.351
<!--**News|News-->
if ( in_array( $wgUser->getName(), $users[0], true) ) {    #if ( in_array( $wgUser->mName, $users[0], true) ) {
<!--**http://193.175.110.91/repository/index.php/Main_Page |Repository-->
//Z.364
**https://repository.hawk-hhg.de/ |Repository
if ( in_array( $wgUser->getName(), $users[1], true) ) {    #if ( in_array( $wgUser->mName, $users[1], true) ) {
**Special:BibManager_Overview|Bibliography
</pre>
**Glossary|Glossary
**Editorial_Board|Editorial Board
**Authors in Saltwiki|Authors
**recentchanges-url|recentchanges
**Special:Contact|Contact
**Help:Contents|Help
<!--**Helppage|help-->


==== Einrichten einer Nutzungsgruppe ====
* Author Pages
**Authors_Page|Guidelines
**Rights|Rights
**Review|Review
**categories|Category tree
**Templates|Templates
<!--**sandbox|Sandbox-->


Eine Gruppe von Usern, die alleine Zugang auf bestimmte Seiten haben soll, wird z. b. beim Repositorium im Namensrauam "ACCESS" wie unten eingerichtet.
*SEARCH


:Speichern der Liste auf der Seite Access:SIP
*TOOLBOX
<nowiki><accesscontrol>Access:SIP</accesscontrol></nowiki># Schutz der eigenen Seite
*Hschwarz                                                # einfache Liste der User
*HJuling
*MSteiger
*SLaue
*SBrueggerhoff
*Testuser


=== Approved_Revs ===
*Languages
**https://www.salzwiki.de/ |German
</pre>


Mit dieser Erweiterung können Revisionen (Versionen einer SalzWiki-Seite) bestätigt oder abgelehnt werden.


'''Installation der Erweiterung "Approved_Revs"'''
<pre>&lt;-- Repositorium --&gt;
*Navigation
<!--*Research Environment-->
**Mainpage|Home
<!--**Repository Portal|Repository Portal-->
**News|News
**Projekte|Projects
**Communication|Communication
**Publications|Publication
 
*
**Special:BibManager_Overview|Bibliography
**terminology|Glossary
**Category:Author|Authors' Contents
**recentchanges-url|Recent changes
**Special:Contact|Contact
**Help:Contents|Help
 
* author pages
**Rights|Rights
**Kategorienbaum|Category tree


* Die Erweiterung wird mit der Version 0.7.0 REL1.23 2015-06-16T21:01:12 513cff5 heruntergeladen und nach dem Extrahieren in das Extensions-Verzeichnis des jeweiligen Wikis kopiert.
* other wikis
**Vorlagen|Templates
**https://www.salzwiki.de/ |SalzWiki
**https://www.saltwiki.net/ |SaltWiki


* Es muss bei einem neuen Wiki eine Datenbank-Tabelle mit dem Präfix "sw_" (SalzWiki, SaltWiki) bzw. "sr_" (Repository) und dem Namen "approved_revs" angelegt werden. Hierzu gibt es zwei Möglichkeiten:
*SEARCH
**Das Skript "update.php" von "MediaWiki's/maintenance" benutzen oder
**Mittels "phpMyAdmin" in der Datenbank die Tabelle mit den beiden SQL-Befehlen, die in der Datei "ApprovedRevs.sql" der Erweiterung zu finden sind, erstellen.


* Konfiguration von den Approved_Revs in der LocalSettings.php
*TOOLBOX


<pre>// SalzWiki
*LANGUAGES
require_once( "$IP/extensions/ApprovedRevs/ApprovedRevs.php" );


$wgGroupPermissions['Redakteur']['approverevisions'] = true;
$wgGroupPermissions['sysop']['approverevisions'] = true;
$wgGroupPermissions['autor']['viewlinktolatest'] = true;
$wgGroupPermissions['*']['viewlinktolatest'] = false;
$wgGroupPermissions['sysop']['viewlinktolatest'] = true;
</pre>
</pre>
<pre>// SaltWiki
require_once( "$IP/extensions/ApprovedRevs/ApprovedRevs.php" );


$wgGroupPermissions['Editor']['approverevisions'] = true;
==== Navigationsbereich mit Einschränkungen versehen ====
$wgGroupPermissions['sysop']['approverevisions'] = true;
 
$wgGroupPermissions['autor']['viewlinktolatest'] = true;
Um die linke Navigationsleiste abhängig von der Gruppenzugehörigkeit in der Menüauswahl zu beschränken werden folgende "Hooks" statt Änderungen am Wiki-Code verwendet:
$wgGroupPermissions['*']['viewlinktolatest'] = false;
* Sidebar-Variante: "SkinBuildSidebar", siehe [[#Sidebar-Einschr.C3.A4nkung|Sidebar-Einschränkung]]
$wgGroupPermissions['sysop']['viewlinktolatest'] = true;
* Werkzeuge-Auswahl: "BaseTemplateToolbox", siehe [[#Werkzeuge.2FToolbox|Werkzeuge/Toolbox]]
</pre>
 
<pre>// Repository
Änderungen am Wiki-Code der Datei "[wikiname]\includes\Skin.php" für die zu verwendende Sidebar-Variante sind nicht mehr erforderlich, da mit dem "Hook" die Auswahl für die Menü-Variante je nach Gruppenzugehörigkeit festgelegt werden kann.
require_once( "$IP/extensions/ApprovedRevs/ApprovedRevs.php" );
 
Änderungen am Wiki-Code der Datei "[wikiname]\skins\MonoBook\MonoBookTemplate.php" für den Umfang der Werkzeuge sind nicht mehr erforderlich, da mit dem "Hook" die Einschränkungen bei den Werkzeugen je nach Gruppenzugehörigkeit festgelegt werden können.
 
=== Sidebar-Einschränkung ===


$wgGroupPermissions['Editor']['approverevisions'] = true;
Mit den nachfolgend beschriebenen Änderungen gibt es zwei Sidebar-Varianten (Menü-Varianten links). Welche Variante angezeigt wird, richtet sich dabei nach der Gruppen-Zugehörigkeit.
$wgGroupPermissions['sysop']['approverevisions'] = true;
#$wgGroupPermissions['autor']['viewlinktolatest'] = true;
$wgGroupPermissions['*']['viewlinktolatest'] = false;
$wgGroupPermissions['sysop']['viewlinktolatest'] = true;
</pre>


[[Datei:Approved _Revs-1.jpg|thumb|800px|center]]
Bei MW1.31/1.27/1.23 können die Änderungen mit einem "Hook" in der Datei "LocalSettings.php" vorgenommen werden und sind für alle Layouts ("Skins") gültig, während bei MW1.16 Wiki-Code in der Datei "Skin.php" des jeweiligen Layouts angepasst wurde und sich nur auf den jeweiligen "Skin" auswirkte.


'''Funktionsweise'''
==== Sidebar-Anpassungen mit "Hook" ====


Man kann Revisionen bestätigen - oder wieder ablehnen. Die bestätigte Version wird allen Usern angezeigt.
Der "Hook" für die Auswahl der Sidebar-Variante heißt "SkinBuildSidebar" und steht seit MW1.14 zur Verfügung.
*Aktivierung von Approved_Revs, z.B. alle Autoren können Seiten als geprüft markieren
<pre>$wgGroupPermissions['autor']['approverevisions'] = true;</pre>


*Für alle wird der Approved_Revs Link deaktiviert.
In der Datei "LocalSettings.php" wird oberhalb der Anpassungen für die "Toolbox" (Werkzeuge) folgender Code eingefügt:
<pre>$wgGroupPermissions['*']['viewlinktolatest'] = false;</pre>
<pre>
#### Beginn SIDEBAR je nach Gruppenzugehörigkeit
$wgHooks['SkinBuildSidebar'] = 'groupspecificSidebar';
function groupspecificSidebar( $skin, &$sidebar ) {
  global $wgUser;
  $groups = $wgUser->getEffectiveGroups();
  $sidebar = array();
  if (in_array("autor", $groups) || in_array("Administrator", $groups) || in_array("forschung", $groups)) {
    $skin->addToSidebar($sidebar, 'autor_sidebar');
  }
  else{
    $skin->addToSidebar($sidebar, 'sidebar');
  }
  return true;
};
#### Ende SIDEBAR je nach Gruppenzugehörigkeit
</pre>


*Für alle Autoren werden diese wieder eingeblendet
==== Sidebar-Anpassungen ohne "Hook" (Wiki-Code) ====
<pre>$wgGroupPermissions['autor']['viewlinktolatest'] = true;
$wgGroupPermissions['sysops']['viewlinktolatest'] = true;</pre>


Diejenigen, die das Recht "viewlinktolatest" haben, sehen einen Link unter dem Titel des Artikels, um zur aktuellsten Version zu
ACHTUNG: Wenn Mediawiki aktualisiert wird, muss die Änderung in der Datei "Skin.php" wieder eingefügt werden, um die Funktionalität zu erhalten!
kommen.<br>
Deshalb ist von der geänderten Datei "Skin.php" zusätzlich eine Kopie "Skin_SW.php" im Verzeichnis "includes" zu speichern.
Diejenigen, die das Recht "approverevisions" haben, sehen die "Bestätigen" und "Ablehnen" Links in der History (Versionen).


Nur Administratoren, d.h. Redakteure können eine Version bestätigen bzw. Ablehnen!
In der Datei "includes\Skin.php" in der Funktion "function buildSidebar()" in der zweiten Zeile die globale Variable "$wgUser" mit Kommentar hinzufügen, um später die Gruppenrechte abfragen zu können:


'''Ausblenden von der History''' (wurde nicht aktiviert)
<pre><!--MW1.23, Z.1249-->
global $wgMemc, $wgEnableSidebarCache, $wgSidebarCacheExpiry, $wgUser; // for HAWK HHG $wgUser added
</pre>


Wenn nur die Autoren, Redakteure und Admins die History sehen sollen ist Folgendes in der Datei "LocalSettings.php" zu ergänzen:
Nach der Zeile mit "$bar = array();" (MW1.23 Z.1263, MW1.16 Z.2085) folgende Zeile auskommentieren:
<pre>
<pre>
## Bei der angegebenen User-Gruppe wird der Versionen-Button angezeigt. Der Admin sieht diesen immer!
#$this->addToSidebar( $bar, 'sidebar' ); // changed for HAWK HHG 2015-12-22
$groupToShowHistory = 'autor';
</pre>
## Code um die Histroy zu verstecken - sreher 20101105
und folgenden Code einfügen:
$wgHooks['SkinTemplateContentActions'][] = 'removeHistory';
<pre>
function removeHistory( $content_actions ) {
// new for HAWK HHG 2015-12-22
global $wgUser, $groupToShowHistory;
$groups = $wgUser->getEffectiveGroups();
# print_r ($wgUser);
## add here admin support
if ( ! (in_array( $groupToShowHistory, $wgUser->mGroups ) or in_array( 'sysop', $wgUser-
if (in_array("autor", $groups) || in_array("Administrators", $groups) || in_array("forschung", $groups)) {
>mGroups) ) ) {
  //$lines = explode( "\n", wfMsgForContent( 'autor_sidebar' ) );
#print "drin!";
  $this->addToSidebar( $bar, 'autor_sidebar' );
unset( $content_actions['history'] ); // only this to remove an action
} else {
}
  //$lines = explode( "\n", wfMsgForContent( 'sidebar' ) );
return true;
  $this->addToSidebar( $bar, 'sidebar' );
}
}
</pre>
</pre>


=== Bibliography ===
Die Zeile "$lines = explode( "\n", wfMsgForContent( 'sidebar' ) );" muss auskommentiert oder gelöscht werden. Die explode-Funktion wird als Wiki-Code in "addToSidebarPlain(...)" verwendet.


Die Extension Bibliography wurde durch die Erweiterung BibManager ersetzt. Siehe hierzu unter "Erweiterungen -  BibManager".
Nun gibt es zwei Sidebars die man unterschiedlich "bestücken" kann.


Sollte es danach '''PHP-Warnungen''' wie "Warning: Call-time pass-by-reference has been deprecated ..." geben, gibt es folgende vorübergehende '''Notlösung''':
In der Datei "php.ini" in Zeile 165 "allow_call_time_pass_reference = On" statt "Off" setzen.
'''Diese Möglichkeit gilt als veraltet und wird in Zukunft nicht mehr von PHP unterstützt werden, so dass der oben beschriebene Code der Funktion dann geändert werden muss!'''


=== BibManager===
=== Werkzeuge/Toolbox ===


==== Versionen ====
Änderungen an der Datei "skins\MonoBook\MonoBookTemplate.php" sind bei MW1.31/1.27/1.23 nicht mehr erforderlich, da mit einem "Hook" namens "BaseTemplateToolbox" die Einschränkungen bei den Werkzeugen je nach Gruppenzugehörigkeit in der Datei "LocalSettings.php festgelegt werden können.


Für MediaWiki 1.23 LTS wird wegen diverser Probleme bei der BibManager-Version v1.1.0 die Version 1.23 REL1.26 2015-11-17T01:01:50 d824ce8 installiert.
Anpassungen mittels "Hook" in der Datei "LocalSettings.php" wirken sich auf alle "Skins" aus, wohingegen sich Anpassungen in der Datei "MonoBookTemplate.php" nur auf das Layout "MonoBook" auswirken, wenn nicht in der Datei "[wikiname]\includes\skins\SkinTemplate.php" Änderungen entsprechend denen für die Spezialseiten erfolgen.
* v1.23.0 master 2016-01-15T07:01:22 951b12f
* v1.23.0 REL1.26 2015-11-17T01:01:50 d824ce8
* v1.1.0 REL1.23 2015-06-16T21:02:02 6218f71 (angeboten für MW 1.22+)
* v1 (verwendet bei MW1.16)


==== Installation ====
==== Werkzeuge-Anpassung mit "Hook" ====


Die Erweiterung wird zur Erstellung und Verwaltung der Literaturhinweise bzw. zum Einbinden der Zitate in Artikel benutzt.
Der verwendete "Hook" für den Umfang der zur Verfügung stehenden Werkzeuge heißt "BaseTemplateToolbox" und steht seit MW1.18 zur Verfügung.


Sie besteht aus der Grunderweiterung "BibManager" und der Erweiterung "Saltwiki" mit weiteren für SalzWiki spezifischen Feldern, die nicht im original BibTeX spezifiziert sind, wie DOI und Fulltext, sowie der Erweiterung "SaltwikiUpload" für den Dateiupload im Repositorium.
In der Datei " in LocalSettings.php" ist folgender Code einzufügen:
<pre>
#### Beginn TOOLBOX je nach Gruppenzugehörigkeit nur 'print' oder alles
$wgHooks['BaseTemplateToolbox'][] = 'groupspecificToolbox';
function groupspecificToolbox( BaseTemplate $baseTemplate, array &$toolbox ) {
  global $wgUser;
  $groups = $wgUser->getEffectiveGroups();
  if (!in_array("autor", $groups) && !in_array("Administrator", $groups) && !in_array("forschung", $groups)) {
    foreach($toolbox as $k => $v_array){
      if($k!=="print" && isset($toolbox[$k])){
        unset($toolbox[$k]);
      }
    }
  }
  return true;
}
#### Ende TOOLBOX je nach Gruppenzugehörigkeit nur 'print' oder alles
</pre>


Bei der Installeion wird die Erweiterung "BibManager" in den Ordner "\extensions\BibManager\" kopiert.
==== Werkzeuge-Anpassungen ohne "Hook" (Wiki-Code) ====


In die Localsettings.php wird Folgendes eingefügt.
Die Sidebar im Bereich "Werkzeuge" wird mit einem Eingriff in den Wiki-Code bei "skins/MonoBook.php" für alle Gruppen außer "autor", "admin" und "forschung" manipuliert. Hierzu wird in der Funktion "toolbox()" Z.254ff die Variable "global $wgUser;" eingefügt und bei "foreach" die Z.262 bei "$this->makeListItem" mit einer Bedingung versehen:


#Definition eines Namensraumes , in dem nachher alle Literaturseiten liegen
<pre>
define("NS_CITATION", 800);
function toolbox();
define("NS_CITATION_TALK", 801);
  global $wgUser; // Für HAWK HHG
$wgExtraNamespaces[NS_CITATION] = 'Cit';
  $groups = $wgUser->getEffecitveGroups(); // Für HAWK HHG
$wgExtraNamespaces[NS_CITATION_TALK] = 'Cit_talk';
  ...
$wgBibManagerCitationArticleNamespace = NS_CITATION;
  foreach ( $this->getToolbox() as $key => $tbitem ) {
    // Für HAWK HHG: Alle Werkzeuge für die Gruppen autor, Administrators und forschung, sonst nur Werkzeug "Druckversion"
    if(in_array("autor", $groups) || in_array("Administrators", $groups) || in_array("forschung", $groups) || $key==="print"){
      <?php echo $this->makeListItem( $key, $tbitem); ?>
    }
  }
</pre>


  ##Freischalten der Erweiterungen
'''Achtung: Code-Anpassung muss in "skins/MonoBook.php" nach jedem mediawiki-Update auf Vorhandensein und Funktion überprüft werden!'''
require_once('extensions/BibManager/BibManager.php');
 
require_once('extensions/SaltWiki/SaltWiki.php' );
Eventuell muss auch die Datei "\includes\SkinTemplate.php" bei der Funktion "buildNavUrls()" in den Zeilen 1247 und 1262 angepasst werden, um Datei-Uploads auszublenden - siehe http://nullraffer.de/wiki/index.php?title=Mediawiki_absichern:
#nur im Repositorium:
<pre>
require_once('extensions/SaltWikiUpload/SaltWikiUpload.php' );
global $wgUploadNavigationUrl;
global $wgUser; // eingefügt 2015-12-04 für HAWK HHG
...
// Bedingung eingefügt 2015-12-04 für HAWK HHG
if(!$wgUser->isAnon()){
  $nav_urls['specialpages'] = array( 'href' => self::makeSpecialUrl( 'Upload' ) );
}
...
</pre>


$wgBibManagerCitationArticleNamespace = NS_CITATION;
==== Werkzeuge-Schlüsselwörter ====


#### RepoClass und ScholarLink auskommentiert 2012-05-11 wg. neuer Version inkl. GoogleScholar
* Links auf diese Seite: key = whatlinkshere
## Option zur Weiterentwickung zur Benutzung einer zentralen Bibliographie
* Änderungen an verlinkten Seiten: key = recentchangeslinked
#$wgBibManagerRepoClass = 'BibManagerLocalMWDatabaseRepo';
* Datei hochladen: key = upload
## Verlinkung zu GoogleScholar wird konfiguriert
* Spezialseiten: key = specialpages
#$wgBibManagerScholarLink = 'http://scholar.google.com/scholar?q=%title%';
* Druckversion: key = print
* Permanenter Link: key = permalink
* Seiteninformationen: key = info


## Anpassung an die gewünschte Zitierweise
==== sichtbare Toolbox-Menüpunkte ====
$wgBibManagerCitationFormats = array (
    '-' => '%author%: %title%, %year% %url%, %doi%.',
    'article' => '%author% (%year%): %title%. <em>%journal%</em>, <b>%volume%</b> (%number%), %pages%, %url%, %doi%.',
    'book' => '%editor% %author% (%year%): <em>%title%, %edition%, %publisher%, %address%, %pages%</em>, %url%., %doi%',
    'booklet' => '%title% %url%, %doi%.',
    'conference' => '%author% (%year%): %title%. %booktitle% %url%, %doi%.',
    'inbook' => '%author% (%year%): <em>%title%. In: %editor%: %edition%, %publisher%, %address%, %pages%</em> %url%, %doi%.',
    'incollection' => '%author% (%year%): %title%. In: %editor%: %booktitle%, <em>%publisher%</em>, %pages%, %url%, %doi%.',
    'inproceedings' => '%author% (%year%): %title%. In: %editor%: %booktitle%,<em>%publisher%</em>, %pages%, %url%, %doi%.',
    'manual' => '%title% %url%, %doi%.',
    'mastersthesis' => '%author% (%year%): %title%, %type%, %school%, %address%, %url%, %doi%.',
    'misc' => '%author% (%year%): %title%, %howpublished%, %pages% %url%, %doi%.',
    'phdthesis' => '%author% (%year%): %title%. %type%, %school%, %url%, %doi%.',
    'proceedings' => '%editor% (%year%): %title%,<em> %publisher%</em>, %url%, %doi%.',
    'techreport' => '%author% (%year%): %title%. %institution% %url%, %doi%.',
    'unpublished' => '%author% (%year%): %title%. %note%, %url%, %doi%.'
);


===== BibManager v1.23 REL1_26 und v1.23 master =====
* SalzWiki, Repositorium: alle Gruppen und User
** Druckversion


* Fehler bei "Edit" mit Fehlermeldung zu bereits vorhandenem Schlüssel
* SaltWiki: alle Gruppen und User
* Fehler bei "Delete" wegen fehlender Datensatzkennung
** Printable version
* Bei "Verwalten" fehlen rechts die Icons für "Edit" und "Delete" sowie die Trennung zwischen beiden Texten: css-Datei fehlt im head-Bereich
* In der Datei "\extensions\BibManager\includes\BibManagerHooks.php" ist in der Funktion "getIcons(...)" der Pfad 2-mal hart-codiert statt mit einer Variablen angegeben:<pre>... htmlspecialchars( $wgScriptPath . '/extensions/BibManager/resources/images/[pencil.png|book.png]' );</pre>


===== BibManager v1.1.0 REL1_23 =====
==== ausgeblendete Toolbox-Menüpunkte ====


* Fehler bei "Create", "Edit" und "Delete" wegen fehlender Datensatzkennung.
* SalzWiki: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
* In der Datei "\extensions\BibManager\includes\BibManagerHooks.php" ist in der Funktion "onBeforePageDisplay(...)" der Pfad zur Erweiterung 3-mal hart-codiert statt mit einer Variablen angegeben: <pre>... htmlspecialchars( $wgScriptPath . '/extensions/BibManager/client/[BibManagerCommon.css|BibManagerEdit.js|BibManagerList.js]' );</pre>
** "Links auf diese Seite" (Special:WhatLinksHere/Main_Page)
*Für ebenfalls hart-codierte Pfadangaben in der Funktion "getIcons(...)" siehe [[#BibManager 1.23 REL1_26 und 1.23 master]]
** "Änderungen an verlinkten Seiten" (Spezial:%C3%84nderungen_an_verlinkten_Seiten)
** "Hochladen" (Special:Upload)
** "Spezialseiten" (Special:SpecialPages)
** "Permanenter Link" (Main_page&oldid=921)
** "Seiteninformationen" ([Seitentitel]&action=info])


==== Spezialseiten-Gruppe ====
* SaltWiki: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
** "What links here" (Special:WhatLinksHere/Main_Page)
** "Related changes" (Special:RecentChangesLinked)
** "Hochladen" (Special:Upload)
** "Spezialseiten" (Special:SpecialPages)
** "Permanent link" (Main_page&oldid=921)
** "Page information" ([Seitentitel]&action=info])


Verfügbarkeit in Abhängigkeit vom Status
* Repository: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
* Ohne Anmeldung sollen nur die Verweise zu "Bibliographien anzeigen: Autoren" und "Bibliographien verwalten" sichtbar sein. Bei "Bibliographien verwalten" sind dann die Funktionen "Edit" und "Delete" nicht vorhanden, sondern nur "Export".
** "Links auf diese Seite" (Special:WhatLinksHere/Main_Page)
* Nach Anmeldung sind auch die Funktionen "Bibliographieeintrag anlegen" und "Bibliographien importieren" verfügbar.
** "Änderungen an verlinkten Seiten" (Spezial:%C3%84nderungen_an_verlinkten_Seiten)
** "Datei Hochladen" (Special:Upload)
** "Spezialseiten" (Spezial:Spezialseiten)
** "Permanent link" (Main_page&oldid=9522)
** "Seiteninformationen" ([Seitentitel]&action=info])


Von den zu ändernden Dateien bzw. Verzeichnissen ist nach den Anpassungen jeweils eine Kopie mit dem Suffix "SW" im Dateinamen bzw. Verzeichnisnamen zu speichern, um nach Updates von MediaWiki oder Erweiterungen die Änderungen übernehmen zu können.
=== Überschrift der Hauptseite/Mainpage ändern ===
Die Überschrift ist auf der Systemseite "Mediawiki:Mainpage" eingetragen und muss dort geändert werden.
Die Überschrift, die per Voreinstellung Main Page (Hauptseite in der deutschen Übersetzung) heißt, ist in die entsprechende Titelzeile zu ändern.


Es sollte eine Datei "\i18n\qqq.json" mit folgendem Code erstellt werden:
=== Repositorium-Dateien im SalzWiki ===
 
Für das wiki-übergreifende Hochladen und Anzeigen von Media-Dateien sind in der Datei "LocalSettings.php" folgende Variablen anzupassen:
* $wgUploadNavigationUrl
* $wgSharedUploadPath
* $wgRepositoryBaseUrl
 
{| class="wikitable"
|-
|rowspan="2"|Logo
|colspan="3" style="text-align:right;"|Wiki-Header-Leiste
|-
|Datei
|Diskussion
|auf einem gemeinsam genutzten Medienarchiv ansehen '''$wgRepositoryBaseUrl'''
|-
|rowspan="4"|Navigation
<br/>Suche
<br/><br/>Werkzeuge
<br/>&nbsp;Datei hochladen
<br/>&nbsp;'''$wgUploadNavigatonUrl'''
|colspan="3"|Abschnitt "Datei"
* bei vorhandener Quelle:
** Datei-Verweis: '''$wgSharedUploadPath'''
** Dateibeschreibungsseite-Verweis: '''$wgRepositoryBaseUrl'''
* bei nicht gefundener Quelle
** moved-Verweis: '''$wgRepositoryBaseUrl'''
|-
|colspan="3"|Abschnitte aus anderem Wiki mittels '''$wgRepositoryBaseUrl'''
* "Metadaten"
* "Summary"
* "Licensing" aus Vorlage im anderen Wiki mit relativem Pfad im Verweis für Icons
|-
|colspan="3"|Abschnitt "Dateiversionen" mit Verweis zu "Version vom": '''$wgSharedUploadPath'''
|-
|colspan="3"|Abschnitt "Dateiverwendung" mit Datei-Verweis: '''$wgRepositoryBaseUrl'''
|-
|colspan="4" style="text-align:center;"| Wiki-Footer-Leiste
|}
 
==== Hochladen von Dateien  ====
 
Das Hochladen von Dateien geschieht immer in das Repositorium. Hierfür sind Anpassungen in der Konfigurationsdatei erforderlich.
 
===== Konfigurationsdatei anpassen =====
 
Für das Hochladen ins Repositorium über "Werkzeuge => Datei hochladen" bzw. "tools => Upload file" sind folgende Änderungen in der Datei "LocalSettings.php" des SalzWikis bzw. SaltWikis vorzunehmen, siehe auch https://www.mediawiki.org/wiki/Manual:$wgUploadNavigationUrl:
<pre>
## für $wgUploadNavigationUrl, $wgSharedUploadPath und $wgRepositoryBaseUrl
## bei Verwendung einer IP-Adresse statt Domain-Adresse
#$url_repository = "/repository/";
## bei Verwendung von Domain-Adresse statt IP-Adresse ohne Protokoll wg. Inhalten bei "https"
$url_repository = "repository.hawk-hhg.de/";
...
## relative IP-Adresse "..._draft"
#$wgUploadNavigationUrl = "/repository_draft/index.php/Special:Upload";
#$wgUploadNavigationUrl = $url_repository."index.php/Special:Upload";
## bei Verwendung von Domain-Adresse statt IP-Adresse mit Protokoll
$wgUploadNavigationUrl = $protokoll."://".$url_repository."index.php/Special:Upload";
$wgEnableUploads      = false;  ##damit kein Upload in SalzWiki bzw. SaltWiki möglich ist
</pre>
 
Zudem sind folgende Änderungen in der Datei "LocalSettings.php" des Repositoriums vorzunehmen:
<pre>
<pre>
{
$wgEnableUploads      = true;
  "@metadata": {
## Erlaubte Dateitypen
    "authors": []
$wgFileExtensions = array('avi','bib','doc','docx','gif','jpeg','jpg','mov','mpeg','odt','ods','oga','ogg','ogv',
  },
'pdf','png','svg','tif','tiff','txt','xls','xlsx','xml');
  "bibmanager": "BibManager",
  "bibmanager-desc": "{{desc}}"
}
</pre>
</pre>


===== BibManager v1.23.0 REL1.26 Datei-Anpassungen =====
===== Text der Upload-Spezialseite =====


* \i18n\ => \i18nSW\
Es gibt folgende MW-Seiten für den Text der Seite "Special:Upload":
** de.json
* MediaWiki:Uploadtext (Standard "en")
** de-formal.json
* MediaWiki:Uploadtext/de
** en.json
* MediaWiki:Uploadtext/de-formal
** qqq.json
* MediaWiki:Uploadtext/[Sprachenkürzel] (andere Sprachen)
* \includes\
** BibManagerHooks.php => BibManagerHooksSW.php
** BibManagerPagerList.php =>BibManagerPagerListSW.php
* \includes\specials\
** SpecialBibManagerDelete.php => SpecialBibManagerDeleteSW.php
** SpecialBibManagerEdit.php => SpecialBibManagerEditSW.php
* \resources\ext.bibManager.css =ext.bibManagerSW.css>


===== BibManager v1.1.0 REL1.23 Datei-Anpassungen =====
In den Textdefinitionen unter "...\[wikiname]\languages\i18n\" gibt es ebenfalls Texte für die Uploadseite, welche scheinbar nicht verwendet werden; diese Texte befinden sich in den json-Dateien im Element "uploadtext":
* en.json Z.1286
* de.json Z.1290
* de-formal.json Z.176


* BibManager.php => BibManagerSW.php
==== Übergreifende Darstellung ====
* <del>BibManager.alias.php => BibManager.aliasSW.php</del>
* \i18n\ => \i18nSW\
** de.json
** de-formal.json
** en.json
** qqq.json
* \specialpages\ => \specialpagesSW\
** BibManagerCreate_body.php
** BibManagerDelete_body.php
** BibManagerEdit_body.php
** BibManagerExport_body.php
** BibManagerImport_body.php
** BibManagerList_body.php
** BibManagerListAuthors_body.php


Die Spezialseiten-Gruppe "BibManager" und die darin angezeigten Spezialseiten werden in der Datei "\extensions\BibManager\i18n\[Sprache].json" festgelegt; siehe https://www.mediawiki.org/wiki/Manual:Special_pages#The_localisation_file. Die Einbindung funktioniert mit MW1.23 fehlerhaft: Entweder werden die Seiten nicht angezeigt (Schlüssel mit Großbuchstaben wie bisher) oder werden die Seiten nicht gefunden (Schlüssel insgesamt in Kleinbuchstaben).
Für den Zugriff vom SalzWiki bzw. SaltWiki auf Dateien und deren Seiten im Repositorium mittels "http" bzw. "https" durch anonyme User sind Anpassungen wie nachfolgend beschrieben erforderlich.


In den Zeilen 5 und 13 der json-Sprachdateien wäre der Array-Schlüssel von "BibManager" in Kleinbuchstaben zu ändern:
Da alle Dateien wie z.B Fotos mit den dazugehörigen Metadaten und Lizenzhinweisen im Repositorium liegen, muss vom SalzWiki aus der Zugriff nicht nur auf die Dateien, sondern auch auf die dazugehörigen Metadaten und Lizenzhinweise erfolgen.
<pre>
...
  "specialpages-group-bibmanager": "BibManager",
...
  "bibmanager": "BibManager",
...
</pre>


Die Variable $wgSpecialPageGroups in der Datei "BibManager.php" gilt als "deprecated" seit MW 1.21 (https://gerrit.wikimedia.org/r/#/c/220819/3) und kann auskommentiert werden, wenn im Verzeichnis "\specialpages\" in den jeweiligen Dateien "BibManager..._body.php" am Ende der Klasse folgende Funktion eingefügt wird (https://www.mediawiki.org/wiki/Manual:Special_pages => Special page group):
Bei Seiten-Aufrufen mit https wird die Seite aus dem Repositorium mit den Metadaten, der Zusammenfassung und den Lizenzhinweisen ignoriert.
<pre>
  protected function getGroupName(){
    return 'bibmanager';
  }
</pre>


'''Systemnachrichten für Gruppe prüfen'''
Anzupassende Dateien:
* Konfigurationsdatei "LocalSettings.php" des SalzWikis bzw. SaltWikis
* PHP-Konfigurationsdatei "php.ini"


Ob die Gruppe "BibManager" in den Systemnachrichten auftaucht, lässt sich durch Aufruf der MediaWiki-Systemnachrichten bei den Spezialseiten überprüfen, indem als Präfixfilter "Specialpages-group" angegeben wird. Dann sollte bei den Ergebnissen der Name "specialpages-group-bibmanager" mit dem Text "BibManager" aufgelistet werden.
===== Wiki-Konfigurationsdatei =====


'''Einschränkungen für Darstellung in der Spezialseiten-Gruppe überprüfen'''
Findet das Salzwiki eine Datei oder ein Bild nicht im eigenen Wiki, schaut es mit Hilfe von Shared-Einstellungen automatisch im Repositorium nach und sucht dort. Wird auf ein englischsprachiges Repositorium verwiesen, ist in der Wiki-Konfigurationsdatei "Datei:" durch "File:" zu ersetzen, damit die Metadaten ausgelesen werden können.


Wenn die BibManager-Spezialseiten nicht angezeigt werden, folgendes prüfen:
====== Zusammenhang zwischen Variablen und Darstellung ======
* In den Dateien "BibManager.php" oder "LocalSettings.php" die Gruppenberechtigung ändern:
** Bibliographien anlegen: $wgGroupPermissions['sysop']['bibmanagercreate'] => $wgGroupPermissions['*']['bibmanagercreate']
** Bibliographien importieren: $wgGroupPermissions['sysop']['bibmanageredit'] => $wgGroupPermissions['*']['bibmanageredit']
* Beim Klassen-Konstruktor "parent::__construct('...', '...')" den 2. Parameter (Kleinbuchstaben) für $restriction weggelassen in folgenden Dateien:
** "\specialpages\BibManagerCreate_body.php" in Zeile 6
** "\specialpages\BibManagerImport_body.php" in Zeile 6


==== Fehler korrigieren ====
* $wgSharedUploadPath
** Abschnitt "Datei": Verweis zur Datei
* $wgRepositoryBaseUrl
** Karteikartenreiter "Auf einem gemeinsam genutzten Medienarchiv ansehen" bzw. "View on a shared repository"
** Abschnitt "Datei": Verweis zur Dateibeschreibungsseite, anderenfalls Verweis "moved"
** Abschnitt "Dateiversionen": Verweis zur "Version vom"
** Abschnitt "Dateiverwendung": Verweis zur Ursprungsdatei der erzeugten Duplikatdatei
** Zusätzliche Inhalte (Metadata, Summary, Licencing) der Datei-Seite im Repositorium benötigen "http" als Base-URL-Protokoll


===== Fehler beim Speichern nach Bearbeitung =====
====== Anpassungen in der Konfigurationsdatei ======


Der bearbeitete Datensatz kann nicht gespeichert werden, weil die Prüfung des Bearbeitungsmodus fehlerhaft ist und der Datensatz wie ein Neueintrag auf einen bereits vorhandenen Zitatschlüssel überprüft wird.
In der Datei "\extensions\BibManager\includes\specials\SpecialBibManagerEdit.php" muss in der Funktion "execute(...)" in Zeile 69 "bm_edit_mode" zu "wpbm_edit_mode" geändert werden:
<pre>
<pre>
$editMode = $wgRequest->getBool( 'wpbm_edit_mode' ); #$editMode = $wgRequest->getBool( 'bm_edit_mode' ); für HAWK HHG geändert 2016-02-16
## Zugriff auf das Repositorium
$wgFetchCommonsDescriptions  = true;
## für $wgUploadNavigationUrl, $wgSharedUploadPath und $wgRepositoryBaseUrl
## bei Verwendung von IP-Adresse statt Domain-Adresse
#$url_repository = "/repository/";
## bei Verwendung von Domain-Adresse statt IP-Adresse ohne Protokoll wg. Inhalten bei "https"
$url_repository = "repository.hawk-hhg.de/";
...
## shared uploads: Das Laden der Daten erfolgt immer aus dem Repositorium
## Damit automatisch im Repository nach "Dateien" gesucht wird:
$wgUseSharedUploads = true;
## bei Verwendung von IP-Adresse statt Domain-Adresse
#$wgSharedUploadPath = "/repository/images";
#$wgSharedUploadPath = $url_repository."images";
## bei Verwendung von Domain-Adresse statt IP-Adresse mit Protokoll
$wgSharedUploadPath = $protokoll."://".$url_repository."images";
$wgSharedUploadDirectory = "D:/xampp/htdocs/repository/images";
$wgHashedSharedUploadDirectory = true;
$wgSharedUploadDBname = "repository";
$wgSharedUploadDBprefix  = "sr_";
## IP-Adresse mit Protokoll "http" wg. fehlendem Serverzertifikat
#$wgRepositoryBaseUrl = 'http://193.175.110.91/repository/index.php/Datei:'; 
#$wgRepositoryBaseUrl = 'http://'.$_SERVER['SERVER_NAME'].'/repository/index.php/File:';
#$wgRepositoryBaseUrl = 'http://'.$_SERVER['SERVER_ADDR'].'/repository/index.php/File:';
## Domain-Adresse mit Protokoll "http" bei "https"-Aufruf wg. Seiteninhalten mit CC-Icons u. Ä., 2018-02-06
#$wgRepositoryBaseUrl = "http://".$url_repository."index.php/Datei:";
$wgRepositoryBaseUrl = "http://".$url_repository."index.php/File:";
## Verwendung der Klasse ForeignDBRepo
$wgForeignFileRepos[] = array(
'class' => 'ForeignDBRepo',
'name' => 'repository',
'url' => $wgSharedUploadPath,
'directory' => $wgSharedUploadDirectory,
'hashLevels' => 2, // This must be the same for the other family member
'dbType' => $wgDBtype,
'dbServer' => $wgDBserver,
'dbUser' => $wgDBuser,
'dbPassword' => $wgDBpassword,
'dbFlags' => DBO_DEFAULT,
'dbName' => $wgSharedUploadDBname,
'tablePrefix' => $wgSharedUploadDBprefix,
'hasSharedCache' => false,
'descBaseUrl' => $wgRepositoryBaseUrl,
'fetchDescription' => $wgFetchCommonsDescriptions
);
</pre>
</pre>


Anschließend ist eine Kopie der Datei mit dem Suffix "SW" zu speichern.
===== PHP-Konfigurationsdatei =====
 
Die Funktion "fopen()" muss ausgeführt werden können, um Beschreibungsdaten wie Metadaten und Zusammenfassungen sowie Lizenzhinweise vom Repositorium zu holen. Hierfür muss in der PHP-Konfigurationsdatei "php.ini" in Zeile 523 folgende Einstellung vorhanden sein:
<pre>allow_url_fopen = On</pre>
 
===== Grafiken für Lizenz =====
 
Die Grafiken für die CC-Lizenz werden im Repositorium in der Vorlage "CC-by-nc-nd" verwendet und haben eine interne Adresse. Diese Lizenz-Grafiken werden bei Aufrufen mit "http" und "https" nur im Repositorium, aber nicht im SalzWiki bzw. SaltWiki angezeigt, wenn das Repositorium mit einer Domain-Adresse statt mit einer IP-Adresse konfiguriert ist. Ein Änderung in der Interwiki-Tabelle von "ja" zu "nein" bei "lokales Wiki" bewirkt nichts.


===== Fehler bei Löschvorgang =====
Für Seiten im SalzWiki und SaltWiki, die Media-Dateien des Repositoriums verwenden, sind für http-/https-Aufrufe deshalb folgende Unterverzeichnisse und Dateien aus dem Repositorium in die beiden anderen Wikis zu kopieren:
* [wikiverzeichnis]\images\thumb\
** 0\07\Pict-nd.png\30px-Pict-nd.png
** 1\1f\Pict-nc.png\30px-Pict-nc.png
** d\d6\Pict-by.png\30px-Pict-by.png


Der Datensatz kann wegen fehlender Angaben nach der Löschbestätigung nicht gelöscht werden:
==== MediaWiki-Datei anpassen (Wiki-Code) ====
* Element "bm_bibtexCitation" existiert nicht im Formular, sondern "wpbm_bibtexCitation"
* Element "bm_delete" existiert nicht im Formular, sondern "wpbm_delete"
* $deleteSubmit ist immer falsch, weil String (Zeichenkette) mit Boolean (Wahrheitswert) verglichen wird


In der Datei "\extensions\BibManager\includes\specials\SpecialBibManagerDelete.php" folgende Anpassungen vornehmen:
Die nachfolgend beschriebene Vorgehensweise erlaubt es, auf ein für den normalen User gesperrtes Wiki wie das Repositorium zuzugreifen und die Metadaten der Abbildungen/Dateien auszulesen und in SalzWiki widerzugeben. '''Nach jedem mediawiki-Update muss die Datei "includes/httpFunctions.php" auf Änderungen überprüft werden!'''
* Bei Array "$formDescriptor" einen Namen für das Formularfeld "bm_delete" vorgeben
* Bei Array "$formDescriptor" einen Namen für das Formularfeld "bm_bibtexCitation" vorgeben
* In Funktion "formSubmit(...)" bei der Prüfung von "$formdata['bm_delete']" Umwandlung von Boolean in String einfügen


*Zunächst ist die Datei "httpFunctions.php" im Verzeichnis includes von SalzWiki sowohl für https als auch für die Erweiterung "Snoopy" zu modifizieren, siehe https://phabricator.wikimedia.org/T27563. Dazu wird von der Datei eine Kopie "httpFunctions_original.php" gespeichert; danach wird folgender Code angepasst:
**für die Mediawiki-Version '''1.23''':
<pre>
<pre>
//Z.59ff
--- HttpFunctions.php 2010-06-09 05:49:34.000000000 +0200
$formDescriptor = array (
+++ HttpFunctions_sw.php 2018-01-29
  'bm_delete' = array (
@@ -131,1 +131,1 @@
    'class' => 'HTMLHiddenField';
- if ( preg_match( '!^http://([\w.-]+)[/:].*$!' ) ) {
    'default' => true,
+ if ( preg_match( '!^http://([\w.-]+)[/:].*$!' ) || preg_match( '!^https://([\w.-]+)[/:].*$!' ) ) {
    'name' => 'bm_delete', // für HAWK HHG eingefügt 2016-02-09
@@ -790,11 +790,97 @@
  )
- $curlRes = curl_exec( $curlHandle );
  'bm_bibtexCitation' = array (
- if ( curl_errno ($curlHandle ) == CURLE_OPERATION_TIMEOUTED ) {
    'class' => 'HTMLHiddenField';
- $this->status->fatal( 'http_timed_out', $this->url );
    'default' => $citation,
- } elseif ($curlRes === false ) {
    'name' => 'bm_bibtexCitation', // für HAWK HHG eingefügt 2016-02-09
- $this->status->fatal( 'http-curl-error', curl_error( $curlHandle ) );
  )
- } else {
);
- $this->headerList = explode( "\r\n", $this->headerText );
//Z.89
- }
if ( empty( $formData['bm_delete'] ) || $formData['bm_delete'] !== (string)true ) // für HAWK HHG ergänzt mit (string) 2016-02-09
-
</pre>
- curl_close( $curlHandle );
 
-
===== Falscher Text nach Löschvorgang =====
+ /*  Neuer Code für "Snoopy" ungeprüft bei MW1.23 übernommen von MW1.16
 
+ *  START:
Nachdem ein Eintrag gelöscht wurde, erscheint "Ihre Daten wurden erfolgreich gespeichert!" (auch schon in MW1.16).
+ *  Add code to access restricted repositories.
 
+ *  Add the following line in the LocalSettings.php
In der Datei "\extensions\BibManager\includes\specials\SpecialBibManagerDelete.php" in der Funktion "formSubmit(...)" wird in Z.94 fälschlicherweise "bm_success_save-complete" verwendet. Da es kein Text-Element "bm_success_delete" gibt, muss es in den Dateien "\i18n\[en|de|de-formal].json" für "en", "de" und "de-formal" in der Zeile nach "bm_success_save-complete" ergänzt werden, damit es in der Datei "BibManagerDelete_body.php" verwendet werden kann.
+ * $wgAuthenticatedRepository = true;
 
+ * $wgAuthenticatedRepositoryUser = 'WikiSysop';
Nach den Anpassungen ist die Delete-Datei als Kopie mit dem Suffix "SW" im Verzeichnis "specials" und das Verzeichnis "i18n" als Kopie "i18nSW" zu speichern.
+ * $wgAuthenticatedRepositoryPassword = 'dev2010wer';
 
+ * $wgShowAuthenticatedRepositoryError = true;
<pre>
+ */
//de.json Z.135f
+
  "bm_success_save-complete": "<div class=\"successbox\"><strong>Deine Daten wurden erfolgreich gespeichert!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
+    global $wgAuthenticatedRepository, $wgAuthenticatedRepositoryUser, $wgAuthenticatedRepositoryPassword, $wgShowAuthenticatedRepositoryError;
  "bm_success_delete": "<div class=\"successbox\"><strong>Die Daten wurden erfolgreich gelöscht!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
+    $error = true;
 
+    $text = '';
//de-formal.json Z.135f
+    $token2 = array();
  "bm_success_save-complete": "<div class=\"successbox\"><strong>Ihre Daten wurden erfolgreich gespeichert!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
+
  "bm_success_delete": "<div class=\"successbox\"><strong>Die Daten wurden erfolgreich gelöscht!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
+ /* run the code only if the user activate is in the LocalSettings.php*/
 
+    if ( $wgAuthenticatedRepository ) {
//en.json Z.135f
+      require_once 'extensions/Snoopy-1.2.4/Snoopy.class.php';
  "bm_success_save-complete": "<div class=\"successbox\"><strong>Your data was successfully saved!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
+      $index = '';
  "bm_success_delete": "<div class=\"successbox\"><strong>The data were successfully deleted!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
+      $login = '';
</pre>
+     
 
+      /* Get all relevat url informations */
<pre>
+      /* URL: http://localhost/mediawiki/mediawiki-repository/index.php/File:MediawikiExampleImageFlower.jpg?action=render&uselang=en */
//SpecialBibManagerDelete.php Z.92ff
+      $wikiPath = "";
// für HAWK HHG geändert zu "delete"-Text statt "save-complete" 2016-02-15
+      if (!preg_match('/(.*)\/index.php\/(.*)\?(.*)/', $this->url, $matches)) {
if ( $result === true ) {
+          echo "nicht gefunden";
  $wgOut->addHtml( wfMessage( 'bm_success_delete') ); #wfMsg( 'bm_success_save-complete') für HAWK HHG korrigiert 2016-02-08
+      } else {
  ...
+          $wikiPath = $matches[1];
}
+   /* If the url contains special characters, when these characters must be convert */
</pre>
+   $title = rawurldecode($matches[2]);
 
+      }
Außerdem kann in der Datei "SpecialBibManagerDelete.php" wie in Z.94 die Funktion "wfMsg()" ersetzt werden durch "wfMessage()" in den Zeilen 24, 29, 35, 43, 54, 71.
+     
 
+      $apiPath = "$wikiPath/api.php";
===== Fehler im HTML-Code korrigieren =====
+      $indexPath = "$wikiPath/index.php";
 
+
Bei der BibManager-Übesicht wird für jede Tabellenzeile ein <tr> statt eines </tr> erzeugt (auch schon in MW1.16). Im Verzeichnis "BibManager\includes\" in der Datei "bibManagerPagerList.php" in Zeile 133 den fehlenden Schrägstrich einfügen:
+      $snoopy = new Snoopy;
<pre>
+      /* Start request to get an token */
  $tablerow[] = '</tr>'; // Schrägstrich für schließendes Tag eingefügt 2012-09-17 G. Werner
+      $request_vars = array('action' => 'login', 'lgname' => $wgAuthenticatedRepositoryUser, 'lgpassword' => $wgAuthenticatedRepositoryPassword, 'format' => 'php');
</pre>
+      if(!$snoopy->submit($apiPath, $request_vars))
 
+      $this->status->fatal("Snoopy error: {$snoopy->error}");
===== Fehlende Icons bei Verweisen rechts für "edit" und "delete" =====
+     
 
+      // We're only really interested in the cookies
In der BibManager-Übersicht sind rechts Text-Hyperlinks ohne Abstand für "edit" und "delete" anstatt Icons; es sind in folgenden Dateien Anpassungen vorzunehmen:
+      $snoopy->setcookies();
* "\extensions\BibManager\includes\BibManagerHooks.php"
+      $token = unserialize($snoopy->results);
* "\extensions\BibManager\resources\ext.bibManager.css"
+     
* "\extensions\BibManager\includes\BibManagerPagerList.php"
+      /* Use the Token to login */
 
+      if ( $token['login']['result'] == 'NeedToken') {
Nach den Anpassungen ist jeweils eine Kopie der Datei mit dem Suffix "SW" zu speichern.
+      $request_vars = array('action' => 'login', 'lgname' => $wgAuthenticatedRepositoryUser, 'lgpassword' => $wgAuthenticatedRepositoryPassword,  'lgtoken' => $token['login']['token'], 'format' => 'php');
 
+      if(!$snoopy->submit($apiPath, $request_vars))
Bei "BibManagerHooks.php" ist in Funktion "onBeforePageDisplay(...)" am Anfang, vor Zeile 29 (Eindbindung der JS-Module), die Einbindung der css-Datei einzufügen:
+  $this->status->fatal("Snoopy error: {$snoopy->error}");
<pre>
+      $token2 = unserialize($snoopy->results);
  // für HAWK HHG eingefügt 2016-02-12
+      }
  $out->addModuleStyles( 'ext.bibManager.styles' );
+      else if ( ($token['login']['result'] == 'NoName') ) {
</pre>
+        wfDebug( __METHOD__ . ": Wrong or no User for wgAuthenticatedRepositoryUser in the LocalSetting. \n" );
 
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no User for <i>wgAuthenticatedRepositoryUser</i> in the LocalSetting.<br/>";
Bei "ext.bibManager.css" in Zeile 96 einen Kommentar einfügen und zwischen "width: 16px;" und "text-indent: 9999px;", Z.99f, eine neue Zeile "height: 15px;" einfügen
+      }
<pre>
+           
/* für HAWK HHG wg. nicht sichtbarer Icons, die bei BibManager v1 ohne "overflow:hidden" sehr weit rechts waren, geändert 2016-02-15 */
+      /* If the login was successful, get the Information from the File Description */
#bm_table a.icon {
+      if ( ($token2['login']['result'] == 'Success') or ($token['login']['result'] == 'Success') ) {
  ...
+      $request_vars = array('action' => 'render', 'title'=> $title, 'lgtoken' => $token['login']['token'], 'format' => 'php');
  height: 15 px; /*text-indent: 9999px;*/
+      if(!$snoopy->submit($indexPath, $request_vars))
  ...
+  $this->status->fatal("Snoopy error: {$snoopy->error}");
}
+      $this->content = $snoopy->results;
</pre>
+      }
+      else if ( ($token2['login']['result'] == 'WrongPass') or ($token2['login']['result'] == 'WrongPluginPass') or ($token2['login']['result'] == 'EmptyPass') ) {
+        wfDebug( __METHOD__ . ": Wrong or no Password for wgAuthenticatedRepositoryPassword in the LocalSetting." );
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no Password for <i>wgAuthenticatedRepositoryPassword</i> in the LocalSetting.<br/>";
+      }
+      else if ( ($token2['login']['result'] == 'NotExists') ) {
+        wfDebug( __METHOD__ . ": Wrong or no User for wgAuthenticatedRepositoryUser in the LocalSetting. \n" );
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no User for <i>wgAuthenticatedRepositoryUser</i> in the LocalSetting.<br/>";
+      }
+      $this->headerList = explode("\r\n", $this->headerText);     
+    }
+    else
+    {   
+ /*
+ * START: Original Code - now in a if statement
+ */
+
+  if ( false === curl_exec( $curlHandle ) ) {
+  $code = curl_error( $curlHandle );
+  if ( isset( self::$curlMessageMap[$code] ) ) {
+  $this->status->fatal( self::$curlMessageMap[$code] );
+  } else {
+  $this->status->fatal( 'http-curl-error', curl_error( $curlHandle ) );
+  }
+  } else {
+  $this->headerList = explode("\r\n", $this->headerText);
+  }
+  curl_close( $curlHandle );
+ /*
+ *  END: Original Code - now in a if statement
+ */
+  }
+ /*
+ *  END: Add code to access restricted repositories
+ */
$this->parseHeader();
$this->setStatus();
return $this->status;
}
}


Bei "BibManagerPagerList.php" in Funktion "formatRow(...)" in den Zeilen 104, 108, 117 und 120 die "wfMsg"-Funktionen ersetzen durch "wfMessage"-Funktionen:
**für die Mediawiki-Version '''16.0''':
<pre>
<pre>
if ($wgUser->isAllowed('bibmanageredit')){
--- HttpFunctions.php 2010-06-09 05:49:34.000000000 +0200
  // für HAWK HHG "wfMsg()" zu "wfMessage()" geändert 2016-02-15
+++ HttpFunctions_new.php 2010-11-22 17:09:33.000000000 +0100
  $editLink = Linker::link(
@@ -758,14 +758,97 @@
    SpecialPage::getTitleFor( 'BibManagerEdit' ),
- if ( false === curl_exec( $curlHandle ) ) {
    wfMessage( 'bm_list_table_edit' ), /*wfMsg( 'bm_list_table_edit' )*/
- $code = curl_error( $curlHandle );
    array (
-
      'class' => 'icon edit',
- if ( isset( self::$curlMessageMap[$code] ) ) {
      'title' => wfMessage( 'bm_list_table_edit' ) /*wfMsg( 'bm_list_table_edit' )*/
- $this->status->fatal( self::$curlMessageMap[$code] );
    ),
- } else {
    $specialPageQuery
- $this->status->fatal( 'http-curl-error', curl_error( $curlHandle ) );
  );
- }
}
- } else {
 
- $this->headerList = explode("\r\n", $this->headerText);
if ($wgUser->isAllowed('bibmanagerdelete')){
- }
  $deleteLink = Linker::link(
-
    SpecialPage::getTitleFor( 'BibManagerDelete' ),
- curl_close( $curlHandle );
    wfMessage( 'bm_list_table_delete' ),
-
    array (
+ /*
      ...
+ *  START:
    ),
+ *  Add code to access restricted repositories.  
    $specialPageQuery
+ *  Add the following line in the LocalSettings.php
  );
+ * $wgAuthenticatedRepository = true;
}
+ * $wgAuthenticatedRepositoryUser = 'WikiSysop';
</pre>
+ * $wgAuthenticatedRepositoryPassword = 'dev2010wer';
 
+ * $wgShowAuthenticatedRepositoryError = true;
===== In BibManager v1.1.0 Fehler bei SpecialPageAliases =====
+ */
 
+
In der Datei "BibManager.alias.php" müssen die Array-Schlüssel von $specialPageAliases wie z. B. 'BibManagerCreate' für die jeweilige Sprache in Kleinbuchstaben angegeben werden, damit die BibManager-Seiten bei den Spezialseiten aufgelistet werden, allerdings werden die Seiten dann nicht mehr gefunden, wenn man auf die Verweise klickt.
+    global $wgAuthenticatedRepository, $wgAuthenticatedRepositoryUser, $wgAuthenticatedRepositoryPassword, $wgShowAuthenticatedRepositoryError;
 
+    $error = true;
Einzige Lösung scheint zu sein, in der Datei "BibManager.php" die Zeile 66 auszukommentieren:
+    $text = '';
<pre>
+    $token2 = array();
#$wgExtensionMessagesFiles['BibManagerAlias'] = $dir . 'BibManager.alias.php'; // Fehlfunktion in MW 1.23
+
</pre>
+ /* run the code only if the user activate is in the LocalSettings.php*/
 
+    if ( $wgAuthenticatedRepository ) {
===== In BibManager v1.1.0 fehlerhafte Funktionen auskommentieren bzw. ändern =====
+      require_once 'extensions/Snoopy-1.2.4/Snoopy.class.php';
 
+      $index = '';
BibManager v1.1.0 (REL1.23) verwendet in mehreren Dateien die Funktion "wfLoadExtensionMessages()", die seit MW 1.21 nicht mehr existiert, so dass die Zeile in folgenden Dateien auskommentiert werden muss:
+      $login = '';
*"\specialpages\BibManagerCreate_body.php" in Zeile 7
+     
*"\specialpages\BibManagerEdit_body.php" in Zeile 7
+      /* Get all relevat url informations */
*"\specialpages\BibManagerDelete_body.php" in Zeile 7
+      /* URL: http://localhost/mediawiki/mediawiki-repository/index.php/File:MediawikiExampleImageFlower.jpg?action=render&uselang=en */
*"\specialpages\BibManagerList_body.php" in Zeile 7
+      $wikiPath = "";
*"\specialpages\BibManagerListAuthors_body.php" in Zeile 7
+      if (!preg_match('/(.*)\/index.php\/(.*)\?(.*)/', $this->url, $matches)) {
 
+          echo "nicht gefunden";
BibManager v1.1.0 (REL1.23) verwendet in der Datei "\specialpages\BibManagerList_body.php" in den Zeilen 25 und 29 die Methode "SpecialPageFactory::getPage('...')->getDescription()", die einen Fehler "Call to a member function getDescription() on null" verursacht, weil "getPage('...') als Ergebnis NULL hat und "getDescription()" nicht darauf angewendet werden kann. Ursache ist der Name bei "getPage('...')", der mit dem Alias ersetzt werden muss. Der Alias der Sprachvarianten befindet sich in der Datei "\BibManager\BibManager.alias.php". Um den Alias für "getPage('...')" zu erhalten, wird die Methode "SpecialPageFactory::getLocalNameFor('...')" benötigt:
+      } else {
<pre>
+          $wikiPath = $matches[1];
// $linkDescription eingefügt und $createLink angepasst 2015-12-01 G. Werner für HAWK HHG
+   /* If the url contains special characters, when these characters must be convert */
$linkDescription = array();
+   $title = rawurldecode($matches[2]);
if(SpecialPageFactory::getPage(SpecialPageFactory::getLocalNameFor('BibManagerCreate'))===NULL){
+      }
  $linkDescription['Create'] = NULL;
+     
}
+      $apiPath = "$wikiPath/api.php";
else{
+      $indexPath = "$wikiPath/index.php";
  $linkDescription['Create'] = SpecialPageFactory::getPage(SpecialPageFactory::getLocalNameFor('BibManagerCreate'))->getDescription();
+
}
+      $snoopy = new Snoopy;
if(SpecialPageFactory::getPage(SpecialPageFactory::getLocalNameFor('BibManagerImport'))===NULL){
+      /* Start request to get an token */
  $linkDescription['Import'] = NULL;
+      $request_vars = array('action' => 'login', 'lgname' => $wgAuthenticatedRepositoryUser, 'lgpassword' => $wgAuthenticatedRepositoryPassword, 'format' => 'php');
}
+      if(!$snoopy->submit($apiPath, $request_vars))
else{
+      $this->status->fatal("Snoopy error: {$snoopy->error}");
  $linkDescription['Import'] = SpecialPageFactory::getPage(SpecialPageFactory::getLocalNameFor('BibManagerImport'))->getDescription();
+     
}
+      // We're only really interested in the cookies
$createLink = Linker::link(
+      $snoopy->setcookies();
  SpecialPage::getTitleFor('BibManagerCreate'),
+      $token = unserialize($snoopy->results);
  /*SpecialPageFactory::getPage('BibManagerCreate')->getDescription()*/
+     
  $linkDescription['Create']
+      /* Use the Token to login */
);
+      if ( $token['login']['result'] == 'NeedToken') {
$importLink = Linker::link(
+      $request_vars = array('action' => 'login', 'lgname' => $wgAuthenticatedRepositoryUser, 'lgpassword' => $wgAuthenticatedRepositoryPassword, 'lgtoken' => $token['login']['token'], 'format' => 'php');
  SpecialPage::getTitleFor('BibManagerImport'),
+      if(!$snoopy->submit($apiPath, $request_vars))
  /*SpecialPageFactory::getPage('BibManagerImport')->getDescription()*/
+  $this->status->fatal("Snoopy error: {$snoopy->error}");
  $linkDescription['BibManagerImport']
+      $token2 = unserialize($snoopy->results);
);
+      }
</pre>
+      else if ( ($token['login']['result'] == 'NoName') ) {
 
+        wfDebug( __METHOD__ . ": Wrong or no User for wgAuthenticatedRepositoryUser in the LocalSetting. \n" );
===== In BibManager v1.1.0 Fehler bei neuem Eintrag und Eintragsbearbeitung =====
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no User for <i>wgAuthenticatedRepositoryUser</i> in the LocalSetting.<br/>";
 
+      }
Der Fehler bei einem Neueintrag in BibManager v1.1.0 REL1.23 2015-06-16 resultiert aus der Weiterleitung zur Datei für Bearbeitungen "specialpages\BibManagerEdit_body.php".
+           
 
+      /* If the login was successful, get the Information from the File Description */
In der Datei "specialpages\BibManagerCreate_body.php" kann in der Funktion "execute()" das Array "$formDescriptor" zwischen "id" und "options" um die Angabe eines Namens ergänzt werden, damit das Formularfeld "bm_select_type" nicht "wpbm_select_type" heißt:
+      if ( ($token2['login']['result'] == 'Success') or ($token['login']['result'] == 'Success') ) {
<pre>
+      $request_vars = array('action' => 'render', 'title'=> $title, 'lgtoken' => $token['login']['token'], 'format' => 'php');
//Z.26ff
+      if(!$snoopy->submit($indexPath, $request_vars))
$formDescriptor = array (
+  $this->status->fatal("Snoopy error: {$snoopy->error}");
  'bm_select_type' => array (
+      $this->content = $snoopy->results;
    'class' => 'HTMLSelectField',
+      }
    ...
+      else if ( ($token2['login']['result'] == 'WrongPass') or ($token2['login']['result'] == 'WrongPluginPass') or ($token2['login']['result'] == 'EmptyPass') ) {
    'id' => '',
+        wfDebug( __METHOD__ . ": Wrong or no Password for wgAuthenticatedRepositoryPassword in the LocalSetting." );
    'name' => 'bm_select_type',
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no Password for <i>wgAuthenticatedRepositoryPassword</i> in the LocalSetting.<br/>";
    'options' => ...
+      }
  )
+      else if ( ($token2['login']['result'] == 'NotExists') ) {
)
+        wfDebug( __METHOD__ . ": Wrong or no User for wgAuthenticatedRepositoryUser in the LocalSetting. \n" );
</pre>
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no User for <i>wgAuthenticatedRepositoryUser</i> in the LocalSetting.<br/>";
 
+      }
==== BibManager-Berechtigungen ====
+      $this->headerList = explode("\r\n", $this->headerText);    
 
+    }
'''Rechte-Vergabe für BibManager'''
+    else
 
+    {   
In der Datei "LocalSettings.php" werden zwischen "include_once(...)" und dem Array für die Zitierweise folgende Berechtigungen definiert, wobei im deutschen Salzwiki "Redakteur" statt "Editor" anzugeben ist:
+ /*
 
+ * START: Original Code - now in a if statement
## Berechtigungen eingefügt 2012-05-11
+ */
$wgGroupPermissions['*']['bibmanagercreate'] = false;
+
$wgGroupPermissions['*']['bibmanageredit'] = false;
+  if ( false === curl_exec( $curlHandle ) ) {
$wgGroupPermissions['*']['bibmanagerdelete'] = false;
$code = curl_error( $curlHandle );
$wgGroupPermissions['autor']['bibmanagercreate'] = true;
+  
$wgGroupPermissions['autor']['bibmanageredit'] = true;
+  if ( isset( self::$curlMessageMap[$code] ) ) {
#$wgGroupPermissions['autor']['bibmanagerdelete'] = false;
+  $this->status->fatal( self::$curlMessageMap[$code] );
$wgGroupPermissions['Redakteur|Editor']['bibmanagercreate'] = true;
+  } else {
$wgGroupPermissions['Redakteur|Editor']['bibmanageredit'] = true;
$this->status->fatal( 'http-curl-error', curl_error( $curlHandle ) );
  $wgGroupPermissions['Redakteur|Editor']['bibmanagerdelete'] = true;
+  }
  $wgGroupPermissions['sysop']['bibmanagercreate'] = true;
+  } else {
$wgGroupPermissions['sysop']['bibmanageredit'] = true;
+  $this->headerList = explode("\r\n", $this->headerText);
  $wgGroupPermissions['sysop']['bibmanagerdelete'] = true;
+  }
+  curl_close( $curlHandle );
+ /*
+ *  END: Original Code - now in a if statement
+ */
+  }
+ /*
+ *  END: Add code to access restricted repositories
+ */
+  
$this->parseHeader();
$this->setStatus();
return $this->status;
}
}
class PhpHttpRequest extends HttpRequest {
</pre>
Es wurden hauptsächlich Anpassungen gemacht, die den Text zurückgeben, sowie an der Abarbeitung von Fehlern. <br/>Für das korrekte Bearbeiten von Sonderzeichen in der url wurde rawurldecode() hinzugefügt.


'''Entfernen der Löschen- und Editier-Buttons ohne Rechte-Vergabe'''
*Die geänderte Datei "httpFunctions.php" als Sicherung für Mediawiki-Updates kopieren und speichern als "httpFunctions_sw.php".


Das Entfernen der Schaltflächen funktionierte bis April 2012 auf nachfolgend beschriebene Weise, solange es noch kein Rechte-Management für den BibManager gab.
*Die Erweiterung "Snoopy-1.2.4" von "http://sourceforge.net/projects/snoopy/" herunterladen, zip-Dateien auspacken und die Erweiterung in das Verzeichnis "extensions" des SalzWikis bzw. Saltwikis kopieren.


In der Datei BibManager/includes/BibManagerPagerList.php werden in den Zeilen 57ff dazu die Variablen "$editLink" und "$deleteLink" entfernt.
*Das Modul "curl" muss beim Apache-Webserver aktiviert sein; dazu kommentiert man in der Datei "D:\xampp\php\php.ini" die folgende Zeile ein:
<pre>extension=php_curl.dll </pre>
Den Apache-Dienst über das XAMPP-Control-Panel neu starten, damit die Änderungen wirksam werden.


Mit ein wenig PHP-Kenntnissen kann man auch die Anzeige des Links schaltbar machen:
*Der Zugriff auf das Repositorium wird gesperrt durch folgenden Eintrag in der Datei "LocalSettings.php" des Repositoriums:
<pre>$wgGroupPermissions['*']['read'] = false;</pre>


  $tablerow = array ( );
*Um den Zugriff auf das geschützte Repositorium durchführen zu können, ist folgende Konfiguration der Datei "LocalSettings.php" des Salzwikis bzw. Saltwikis vorzunehmen:
  $tablerow[] = '<tr>';
<pre>
  $tablerow[] = '  <td style="vertical-align:top;">' . $citationLink . '</td>';
$wgAuthenticatedRepository = true;
  $tablerow[] = ' <td>' . $format . '</td>';
$wgAuthenticatedRepositoryUser = 'WikiSysop';
  #$tablerow[] = ' <td style="text-align:center;">' . $editLink . $deleteLink . '</td>';
$wgAuthenticatedRepositoryPassword = 'xxx';
  if($_REQUEST['showDelete'] == 1){$tablerow[] = '  <td style="text-align:center;">' . $editLink . $deleteLink . '</td>';}
$wgShowAuthenticatedRepositoryError = false;
  else{$tablerow[] = '  <td style="text-align:center;">' . $editLink . '</td>';}
</pre>
  $tablerow[] = '  <td style="text-align:center;">' . $exportLink . '</td>';
$wgAuthenticatedRepository - aktiviert den Zugriff auf ein gesichertes Repository. Wenn dies nicht notwendig ist, bitte abstellen, da die Funktion zusätzliche Abfragen schickt, was die Zugriffe bei hoher Last verlangsamen kann.
  $tablerow[] = '<tr>';
<br>$wgShowAuthenticatedRepositoryError - Gibt Fehlermeldungen in die Log Dateien. Für den Live Betrieb bitte abstellen.


So würde der Link nur angezeigt werden, wenn in der Url "&showDelete=1" vorkommt.
=== Vorlagen  ===


Wenn die Löschen-Funktion vollständig deaktiviert und nicht nur den Link versteckt werden soll, müssen in der Datei BibManager/BibManager.php folgende Zeilen auskommentiert werden:
Vorlagen = Templates finden sich beispielhaft auf der Seite [[Vorlagen]] dargestellt.  


  $wgAutoloadClasses['BibManagerDelete'] = $dir . 'specialpages/BibManagerDelete_body.php';
Die einzelnen Vorlagen sind im Namensraum "Vorlage" bzw. "Template" zu finden. Für jede Vorlage ist eine eigene Wiki-Seite zu erstellen, um diese Vorlage dann im Wiki mit <nowiki>{{Vorlagenname}}</nowiki> verwenden zu können.
  $wgSpecialPages['BibManagerDelete'] = 'BibManagerDelete';
Die Vorlage ist anschließend auf der Seite "Vorlagen" beispielhaft aufzuführen.
Die vorhandene Vorlage "Languages" wird ersetzt durch eine eigene Vorlage.


==== Anleitung anpassen und installieren ====
Für Vorlagen mit Beispieltexten unter Verwendung des Vorlagennamens im "noinclude"-Bereich siehe weiter unten bei [[#Code-Probleme und deren Lösungen|Code-Probleme und deren Lösungen]], Abschnitt "Timeout durch Template-Name im Template-Text" – betrifft insbesondere die Erweiterung "AccessControl".


Die von halloWelt! gelieferte Datei "manual.xml" enthält alle 4 Anleitungen: Benutzerhandbuch, User manual, Administrationshandbuch und Admin manual, die jeweils durch die <page>-Elemente gegliedert sind.
*'''Vorlagen für SalzWiki'''
**FreeForTranslation
*'''Vorlagen für SalzWiki und Saltwiki'''
**Infobox_Salz bzw. Infobox_Salt
**MetadatenFoto_upload (wird im Artikel Vorlagen/Templates verwendet)
*'''Vorlagen für das Repositorium'''
**MetadatenFoto_upload
**MetadatenDaten_upload
**MetadatenLiteratur_upload
**MetadatenProben_upload
**MetadatenText_upload
**Untersuchungsmethoden
*'''Lizenzvorlagen''': Eine neue Kategorie "Kategorie:Lizenzenvorlagen" erstellen mit folgenden Vorlagen:
**CC-by-nc-nd,CC-by-nc-nd/de
**CC-by-nc-sa,CC-by-nc-sa/de
**PD
**PD Help Page, PD Help Page/de, PD Help Page/fr
** GFDL,GFDL/de (nur im Repositorium)
 
Alle anderen Vorlagen wurden beim Einbinden der Hilfeseiten bzw. Extensions eingestellt.
 
=== Lizenzen-Auswahl im Upload-Formular ===


* Für das SalzWiki ist nur der <page>-Bereich "BibManager:Benutzerhandbuch" für den Import relevant, so dass eine Kopie der Datei unter "bibmanager_manual_user_de.xml" gespeichert wird und in dieser Datei die 3 anderen <page>-Bereiche entfernt werden.
Um neue Lizenzen im Klappfeld im Upload-Formular einzugeben muss die Datei Mediawiki:Licenses (http://193.175.110.91/repository_1.16.1/index.php?title=MediaWiki:Licenses) editiert werden, nach dem vorgegebene Schema:
* Für das SaltWiki und das Repositorium ist jeweils nur der <page>-Bereich "BibManager:User manual" für den Import relevant, so dass eine Kopie der Datei unter "bibmanager_manual_user_en.xml" gespeichert wird und in dieser Datei die 3 anderen <page>-Bereiche entfernt werden.
* Der Bilder-Import für das Handbuch findet nur im Repositorium statt.


==== Anleitung anpassen ====
Im <title>-Element nach <page> ist jeweils "HalloWelt:" vor "BibManager:..." zu entfernen:
<pre>
<pre>
<page>
*Free licenses:          <!-- Lizenztyp -->
<title>HalloWelt:BibManager:...</title>
**PD|PD: public domain    <!--einzelne Lizenz-->
**GNU|GFDL: GNU Free Documentation License
 
*Creative Commons
**CC-by-nc-nd|Attribution-NonCommercial-NoDerivs 3.0 Unported (CC BY-NC-ND 3.0)
**CC-by-nc-sa|Attribution-NonCommercial-ShareAlike 3.0 Unported (CC BY-NC-SA 3.0)
</pre>
</pre>
Ebenso ist der Teil "Project:" vor "BibManager:..." in den Admin-Anleitungen am Ende des <text>-Elementes zu entfernen:
 
<pre>
=== Editor (JavaScript) ===
  [[Project:BibManager:...]]
 
  [[Project:BibManager:...]]</text>
'''Achtung: Alle üblichen Editoren zur Bearbeitung von Seiteninhalten funktionieren nur mit JavaScript.''' Dies gilt auch für die Erweiterung [[#WikiEditor_.28JavaScript.29|WikiEditor]].
  </revision>
 
</page>
==== Standard-Editor (Wiki-Code, JS) ====
 
'''Achtung: Funktioniert nur bei Browsern mit aktiviertem JavaScript und muss in den 3 nachfolgend genannten Dateien und dem Grafiken-Verzeichnis nach jedem MediaWiki-Update auf Vorhandensein und Änderungen überprüft werden!'''
 
Folgende Dateien werden  vom Standard-Editor verwendet:
* "/includes/EditPage.php"
* Symbole/Grafiken: "skins/common/images/..."
* "/languages/i18n/..."
 
Vorhanden sind folgende Funktionen:
* bold, italic
* link (wiki), ext. link
* headline size 2
* file embedded, media
* nowiki, signatur
* horizontal line
 
Das Schaltflächen-Symbol für Weiterleitungen ist bei MW 1.23 im Gegensatz zu MW 1.16 nicht vorhanden und wird für die Salz-Wikis auch nicht mehr durch Anpassungen hinzugefügt.
 
Das Schaltflächen-Symbol für mathematische Formeln wird von der Erweiterung "Math" hinzugefügt, u. a. in folgenden Dateien:
* "/extensions/Math/Math.hooks.php" für die Modul-Aktivierung von "math.editbuttons"
* "/extensions/Math/modules/ext.math.editbuttons.js"
* "/extensions/Math/i18n/de.json" für Texte zur Schaltfläche
 
Ergänzt werden sollen folgende Funktionen (siehe "Anpassungen" weiter unten):
* Zeilenumbruch
* Durchgestrichen
* Hoch gestellt
* Tief gestellt
* Zitat
* Fußnoten-Verweis
* Versteckter Kommentar
* Tabelle einfügen
 
===== Anpassungen =====
 
Für Anpassungen siehe auch https://www.mediawiki.org/wiki/Manual:Custom_edit_buttons#Classic_edit_toolbar
 
* neues Unterverzeichnis "/editor_default_sw/" für Grafiken der Schaltflächen
* neue Einträge in den Sprachdateien im Verzeichnis "/languages/i18n/"
* Code-Anpassungen in der Core-Datei "EditPage.php"
 
Es wird ein neues Unterverzeichnis "editor_default_sw" im Verzeichnis "/skins/common/images/" erstellt, da vom Wiki-Code für den Editor aus diesem Verzeichnis die Grafiken geholt werden. In das neu erstellte Verzeichnis werden folgende Grafiken aus der älteren Wiki-Installation oder von https://commons.wikimedia.org/wiki/Mediawiki_edit_toolbar kopiert und gespeichert:
* "Button_Bibliogryphy.png" umbenennen zu "Button_bibliography.png"
* "Button_blockquote.png"
* "Button_enter.png"
* "Button_hide_comment.png" umbenennen zu "Button_hidden_comment.png"
* "Button_insert_table.png"
* "Button_lower_letter.png" umbennen zu "Button_sub_letter.png"
* "Button_redirect.png"
* "Button_reflink.png"
* <del>"Button_small.png"</del>
* "Button_strike.png"
* "Button_upper_letter.png" umbenennen zu "Button_sup_letter.png"
 
 
de.json Z.626 unter "hr_tip" wie folgt ergänzen und anschließend eine Kopie der Datei als "de_SW.json" speichern:
<pre>
"enter_tip": "Zeilenumbruch",
"strike_sample": "durchgestrichener Text",
"strike_tip": "Durchgestrichen",
"sup_letter_sample": "hoch gestellter Text",
"sup_letter_tip": "Hoch gestellt",
"sub_letter_sample": "tief gestellter Text",
"sub_letter_tip": "Tief gestellt",
"blockquote_sample": "Zitat",
"blockquote_tip": "Zitierter Text",
"reflink_sample": "Fußnoten-Text",
"reflink_tip": "Fußnoten-Verweis",
"hidden_comment_sample": "Kommentar",
"hidden_comment_tip": "Versteckter Kommentar",
"insert_table_sample": "! Kopf1\n! Kopf2\n! Kopf3\n|-\n| Reihe1 Spalte1\n| Reihe1 Spalte2\n| Reihe1 Spalte3\n|-\n| Reihe2 Spalte1\n| Reihe2 Spalte2\n| Reihe2 Spalte3",
"insert_table_tip": "Tabelle einfügen (Tabellenkopf, 3 Spalten, 2 Reihen)",
"redirect_sample": "Seitenname",
"redirect_tip": "Weiterleitung",
"bibliography_sample": "Nachname:2017",
"bibliography_tip": "Literaturzitat einfügen",
</pre>
 
en.json Z.593 unter "hr_tip" wie folgt ergänzen und anschließend eine Kopie derDatei als "en_SW.json" speichern:
<pre>
"enter_tip": "Line break",
"strike_sample": "Strike-through text",
"strike_tip": "Strike",
"sup_letter_sample": "Superscript text",
"sup_letter_tip": "Superscript",
"sub_letter_sample": "Subscript text",
"sub_letter_tip": "Subscript",
"blockquote_sample": "Block quote",
"blockquote_tip": "Quoted text",
"reflink_sample": "Footnote text",
"reflink_tip": "footnote reference",
"hidden_comment_sample": "Comment",
"hidden_comment_tip": "Hidden comment",
"insert_table_sample": "! header 1\n! header 2\n! header 3\n|-\n| row 1, cell 1\n| row 1, cell 2\n| row 1, cell 3\n|-\n| row 2, cell 1\n| row 2, cell 2\n| row 2, cell 3",
"insert_table_tip": "Insert table (table head, 3 columns, 2 rows)",
"redirect_sample": "Page name",
"redirect_tip": "Redirect",
"bibliography_sample": "Surname:2017",
"bibliography_tip": "Insert literature blockquote",
</pre>
</pre>


==== Anleitung im Wiki installieren ====


* Die angepasste xml-Datei über "Spezialseiten->Import" ins Wiki laden.
Nachfolgenden Code in der Datei "/includes/EditPage.php" bei der Array-Variablen "$Toolarray" (ab Zeile 3385) am Ende einfügen (Z. 3475); hierbei das erste Komma nicht vergessen.
* Anschließend sind die Bilder für das [[Project:BibManager:...]] im Repositorium mittels DOS-Konsole und PHP hochzuladen, um sie ins Wiki zu bringen:
<pre>
<pre>
D:\
,
xampp\php\php.exe xampp\htdocs\saltwiki\maintenance\importImages.php xampp\htdocs\saltwiki\images_en
array(
  'image'  => "editor_default_sw/Button_enter.png",
  'id'    => 'mw-editbutton-enter',
  'open'  => '<br />',
  'close'  => '',
  'sample' => '',
  'tip'    => wfMessage( 'enter_tip' )->text()
),
array(
  'image'  => "editor_default_sw/Button_strike.png",
  'id'    => 'mw-editbutton-strike',
  'open'  => '<s>',
  'close'  => '</s>',
  'sample' => wfMessage( 'strike_sample' )->text(),
  'tip'    => wfMessage( 'strike_tip' )->text()
),
array(
  'image'  => "editor_default_sw/Button_sup_letter.png",
  'id'    => 'mw-editbutton-sup-letter',
  'open'  => '<sup>',
  'close'  => '</sup>',
  'sample' => wfMessage( 'sup_letter_sample' )->text(),
  'tip'    => wfMessage( 'sup_letter_tip' )->text()
),
array(
  'image'  => "editor_default_sw/Button_sub_letter.png",
  'id'    => 'mw-editbutton-sub-letter',
  'open'  => '<sub>',
  'close'  => '</sub>',
  'sample' => wfMessage( 'sub_letter_sample' )->text(),
  'tip'    => wfMessage( 'sub_letter_tip' )->text()
),
array(
  'image'  => "editor_default/Button_redirect.png",
  'id'    => 'mw-editbutton-redirect',
  'open'  => "#REDIRECT[[",
  'close'  => ']]',
  'sample' => wfMessage( 'redirect_sample' )->text(),
  'tip'    => wfMessage( 'redirect_tip' )->text(),
  'key'    => 'F'
),
array(
  'image'  => "editor_default_sw/Button_reflink.png",
  'id'    => 'mw-editbutton-reflink',
  'open'  => '<ref>',
  'close'  => '</ref>',
  'sample' => wfMessage( 'reflink_sample' )->text(),
  'tip'    => wfMessage( 'reflink_tip' )->text()
),
array(
  'image'  => "editor_default_sw/Button_blockquote.png",
  'id'    => 'mw-editbutton-blockquote',
  'open'  => '<blockquote>'."\n",
  'close'  => "\n".'</blockquote>',
  'sample' => wfMessage( 'blockquote_sample' )->text(),
  'tip'    => wfMessage( 'blockquote_tip' )->text()
),
array(
  'image'  => "editor_default_sw/Button_Bibliography.png",
  'id'    => 'mw-editbutton-bibliography',
  'open'  => '<bib id="',
  'close'  => '"/>',
  'sample' => wfMessage( 'bibliography_sample' )->text(),
  'tip'    => wfMessage( 'bibliography_tip' )->text()
),
array(
  'image'  => "editor_default_sw/Button_hidden_comment.png",
  'id'    => 'mw-editbutton-hidden-comment',
  'open'  => '<!-- ',
  'close'  => ' -->',
  'sample' => wfMessage( 'hidden_comment_sample' )->text(),
  'tip'    => wfMessage( 'hidden_comment_tip' )->text()
),
array(
  'image'  => "editor_default_sw/Button_insert_table.png",
  'id'    => 'mw-editbutton-insert-table',
  'open'  => '{| class="wikitable"'."\n".'|-'."\n",
  'close'  => "\n".'|}',
  'sample' => wfMessage( 'insert_table_sample' )->text(),
  'tip'    => wfMessage( 'insert_table_tip' )->text()
)
</pre>
</pre>


=== CategoryTree ===
Die Texte für "tip" und "sample" befinden sich in den json-Sprachdateien im Verzeichnis "/includes/i18n/".


Die Extension dient zur Darstellung der Kategorienbäzme, damit schnell den Artikeln und Dokumenten die richtigen Kategorien zugewiesen werden können.
ACHTUNG: Nach jedem mediawiki-Update muss überprüft werden, ob die vorgenommene Änderung in der Datei "EditPage.php" noch existiert und funktioniert. Deshalb ist im Verzeichnis "/includes/" von der Datei eine Kopie namens "EditPage_SW.php" zu speichern.


* Extension unter http://www.mediawiki.org/wiki/Categorytree herunterladen und in den Extensionsordner kopieren.
==== Erweiterung WikiEditor oder alter Standard-Editor ??? ====
* In den Localsettinge eingefügen.


Beispiel für einzufügenden HTML-Kommentar in Datei ??? ("ext.wikiEditor.js"? oder "ext.wikiEditor.toolbar.js"? im Verzeichnis "/extensions/WikiEditor/modules/"?):
<pre>
<pre>
$wgUseAjax = true; ##muss von false auf true geändert werden, falls noch nicht geschehen
if(mw.toolbar){
require_once("{$IP}/extensions/CategoryTree/CategoryTree.php");  
  mw.toolbar.addButton({
    imageFile: '//upload.wikimedia.org/wikipedia/en/3/34/Button_hide_comment.png',
    speedTip: 'Comment visible only for editors',
    tagOpen: '<!-- ',
    tagClose: ' -->',
    sampleText: 'Insert comment here',
    imageId: 'button-comment'
  });
}
</pre>
</pre>


=== CharacterEscapes, LOParserFunctions, ControlStructureFunctions  ===
=== Namensräume ===
 
==== Übersicht der vorhandenen Namensräume ====


Notwendig für #if: und #switch-Anweisungen (z. B. beim Einsetzen des Seitentitels im Kopf von Vorlage:Infobox_Salz und bei den Hilfe-Seiten.
Eine Übersicht sowohl der MediaWiki-Namensräume als auch der selbst erstellten Namensräume wird aufgelistet durch Eingabe folgender Adresse:
"ControlStructureFunctions" soll laut "mediawiki.org" nur bis Version 1.12 erforderlich und danach im Wiki-Code integriert sein, was aber scheinbar nicht zutrifft.<br>
<br/>localhost/[wikiname]/api.php?action=query&meta=siteinfo&siprop=namespaces
Alternativ zu "LOParserFunctions" und "ControlStructureFunctions" kann möglicherweise auch die Erweiterung "ParserFunctions" (http://www.mediawiki.org/wiki/Help:ParserFunctions) in Kombination mit der Erweiterung "Loop" (http://www.mediawiki.org/wiki/Help:Loop) verwendet werden, wobei Folgendes zu berücksichtigen ist:
<pre>
Don't These Parser Functions Already Exist?
Yes and no. The ParserFunctions extension has
#if, #ifeq, #ifexpr, #switch, and #ifexist,
and Loop Functions extension has
#for and #foreach.
The limitation of all those parser functions is
that wiki markup is parsed before any parameters are passed to the underlying function.
These functions bypass that limitation through character escapes (see below),
and allow wiki markup to be parsed after the parameters have been passed.
</pre>


*Extensions unter http://www.mediawiki.org/wiki/Extension:Character_Escapes, http://www.mediawiki.org/wiki/Extension:LO_Parser_Functions und http://www.mediawiki.org/wiki/Extension:Control_Structure_Functions/ControlStructureFunctions.php herunterladen und in den Ordner "extensions" kopieren.
==== Einrichten von Namensräumen  ====
**'''Extension CharacterEscapes'''
***Im Verzeichnis "extensions" ein Unterverzeichnis "CharacterEscapes" und darin eine Datei "CharacterEscapes.php" anlegen.
***In der Datei das Quelltext-Beispiel von http://www.mediawiki.org/wiki/Extension:Character_Escapes einfügen.
**'''LOParserFunctions'''
***Im Verzeichnis "extensions" ein Unterverzeichnis "LOParserFunctions" und darin eine Datei "LOParserFunctions.php" und eine Datei "LOParserFunctions.i18n.php" anlegen.
***In den Dateien die Quelltext-Beispiele von http://www.mediawiki.org/wiki/Extension:LO_Parser_Functions einfügen und jeweils die fehlenden php-Tags "?>" am Ende ergänzen.
***In das Verzeichnis die Datei "expr.php" von http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/ParserFunctions/Expr.php?revision=25357 kopieren
**'''Extension ControlStructureFunctions'''
***Im Verzeichnis "extensions" ein Unterverzeichnis "ControlStructureFunctions" und darin eine Datei "ControlStructureFunctions.php" und eine Datei "ControlStructureFunctions.i18n.php" anlegen.
***In den Dateien die Quelltext-Beispiele von "http://www.mediawiki.org/wiki/Extension:Control_Structure_Functions" einfügen und jeweils die fehlenden php-Tags "?>" am Ende ergänzen.


*Erweiterungen in Datei "LocalSettings.php" eingefügen.
Es werden folgende Namensräume eingerichtet:
<pre>##Extension CharacterEscapes fuer Helppages
# "ADM" bzw. "Access": "ADM" bei Salzwiki und Saltwiki, "Access" bei Repository) für Dokumente der Administratoren, den nur diese bearbeiten können,
require_once("extensions/CharacterEscapes/CharacterEscapes.php");
# "Bearbeitung": nur bei Saltwiki zum erstmaligen Erstellen von Dokumenten, die kein Leser sehen soll
# "Literature": für die Bibliographie - Achtung: Bei der Zuweisung in $wgExtraNamespaces ist ein Leerzeichen vor "_talk"!
# "SalzeImPorenraum": nur bei Repository
# "RBKLuebeck": nur bei Repository - Achtung: Ursprüngliche Konstante "RBK-Luebeck" mit Bindestrich erzeugt bei MW 1.23 eine Fehlermeldung und Bindestrich ist auch nicht bei $wgExtraNamespaces enthalten


##Extension LOParserFunctions  fuer Helppages
Leerzeichen und Bindestriche sind für selbst definierte Namensräume (custom namespaces) nicht zulässig, siehe https://www.mediawiki.org/wiki/Manual:Using_custom_namespaces
require_once( "extensions/LOParserFunctions/LOParserFunctions.php" );


##Extension  ControlStructureFunctions fuer Helppages
Salzwiki
# require_once( "extensions/ControlStructureFunctions/ControlStructureFunctions.php" );
<pre>
# Einrichten der Namensräume Adm, Bearbeitung und Literature
define("NS_ADM", 100);
define("NS_ADM_TALK", 101);
#define("NS_Bearbeitung", 120);
#define("NS_Bearbeitung_TALK", 121);
define("NS_Literature", 110);
define("NS_Literature_TALK", 111);
# Create namespaces
$wgExtraNamespaces = array(
NS_ADM => 'Adm',
NS_ADM_TALK => 'Adm_talk',
#NS_Bearbeitung => 'Bearbeitung',
#NS_Bearbeitung_TALK => 'Bearbeitung_talk',
NS_Literature => 'Literature',
NS_Literature_TALK => 'Literature _talk'
);
$wgNamespacesWithSubpages[NS_HELP] = true;            #subpages enabled for the Helpnamespace
$wgNamespaceProtection[NS_ADM] = array( 'editadm' ); #permission "editadmin" required to edit the Adm namespace
$wgNamespacesWithSubpages[NS_ADM] = true;            #subpages enabled for the ADM namespace
$wgGroupPermissions['Administrator']['editadm'] = true;
</pre>
</pre>


=== CharInsert ===
Saltwiki
 
<pre>
Diese Extension dient dazu Editierhilfen zum Einfügen von Spezialzeichen und Formatierungshilfen zur Verfügung zu stellen.Diese Hilfe wird im Bearbeitungsmodus und beim UpLoad-Formular zur Verfügung gestellt. Diese Erweiterung wurde Testweise installiert und dann wieder deaktiviert.
# Einrichten der Namensräume Adm, Bearbeitung und Literature
 
define("NS_ADM", 100);
Die Extension wird bei http://www.mediawiki.org/wiki/Extension:CharInsert heruntergeladen und in ...Extensions/CharInsert extrahiert.
define("NS_ADM_TALK", 101);
 
define("NS_Bearbeitung", 120);
In die localsettings ist einzufügen:
define("NS_Bearbeitung_TALK", 121);
 
define("NS_Literature", 110);
require_once("$IP/extensions/CharInsert/CharInsert.php");
define("NS_Literature_TALK", 111);
# Create namespaces
$wgExtraNamespaces = array(
NS_ADM => 'Adm',
NS_ADM_TALK => 'Adm_talk',
NS_Bearbeitung => 'Bearbeitung',
NS_Bearbeitung_TALK => 'Bearbeitung_talk',
NS_Literature => 'Literature',
NS_Literature_TALK => 'Literature _talk'
);


In Mediawiki:Edittools werden die entsprechenden Zeichen bzw. Hilfen mit
$wgNamespacesWithSubpages[NS_HELP] = true;          #subpages enabled for the Helpnamespace
<pre><charinsert> .. </charinsert> </pre>
$wgNamespaceProtection[NS_ADM] = array( 'editadm' ); #permission "editadmin" required to edit the Adm namespace
 
$wgNamespacesWithSubpages[NS_ADM] = true;            #subpages enabled for the ADM namespace
eingefügt.
$wgGroupPermissions['Sysadmin']['editadm'] = true;
 
=== Cite  ===
 
Dient zum Erstellen von Fußnoten in SalzWiki Artikeln.
 
*Extension unter http://www.mediawiki.org/wiki/Cite herunterladen.
*Extrahieren der Dateien nach extensions/Cite
*In den Localsettings eingefügen
 
<pre>
require_once("$IP/extensions/Cite/Cite.php");
</pre>
</pre>


Siehe näheres zum Einfügen von Fußnoten unter http://193.175.110.91/salzwiki/index.php/Autor#Fu.C3.9Fnoten.
Repository
 
=== ConfirmEdit ===
 
Registrierte Nutzer dürfen auf die Diskussionseiten schreiben. Damit dies etwas sicherer vonstatten geht, wird mit ConfirmEdit ein Captcha eingeführt ('''bisher nur bei Salzwiki und Saltwiki, nicht bei Repositorium''').
 
*Dateien unter http://www.mediawiki.org/wiki/Confirmedit herunterladen und unter "extensions\ConfirmEdit\" speichern.
*In der Datei "LocalSettings.php" einfügen:
<pre>
<pre>
require_once( "$IP/extensions/ConfirmEdit/ConfirmEdit.php" );
# Einrichten der Namensräume Adm, Bearbeitung und Literature
define("NS_Access", 100);
define("NS_Access_TALK", 101);
#define("NS_Bearbeitung", 120);
#define("NS_Bearbeitung_TALK", 121);
define("NS_Literature", 110);
define("NS_Literature_TALK", 111);
# Create namespaces
$wgExtraNamespaces = array(
NS_Access => 'Access',
NS_Access_TALK => 'Access_talk',
#NS_Bearbeitung => 'Bearbeitung',
#NS_Bearbeitung_TALK => 'Bearbeitung_talk',
NS_Literature => 'Literature',
NS_Literature_TALK => 'Literature _talk'
);
 
##Anlegen von Namensräumen für Projekte
define('NS_SalzeImPorenraum', 1010);
define('NS_SalzeImPorenraum_TALK', 1011);
$wgExtraNamespaces[NS_SalzeImPorenraum] = 'SIPP';
$wgExtraNamespaces[NS_SalzeImPorenraum_TALK] = 'SIPP_talk';
#define('NS_RBK-Luebeck', 1020); //Achtung: Bindestrich darf nicht sein und ist auch nicht bei $wgExtraNamespaces enthalten
#define('NS_RBK-Luebeck_TALK', 1021);  //Achtung: Bindestrich darf nicht sein und ist auch nicht bei $wgExtraNamespaces enthalten
define('NS_RBKLuebeck', 1021);
define('NS_RBKLuebeck_TALK', 1021);
$wgExtraNamespaces[NS_RBKLuebeck] = 'Rbkl';
$wgExtraNamespaces[NS_RBKLuebeck_TALK] = 'Rbkl_talk';
 
#$wgNamespacesWithSubpages[NS_HELP] = true;            #subpages enabled for the Helpnamespace
#$wgNamespaceProtection[NS_ADM] = array( 'editadm' ); #permission "editadmin" required to edit the Adm namespace
#$wgNamespacesWithSubpages[NS_ADM] = true;            #subpages enabled for the ADM namespace
#$wgGroupPermissions['Sysadmin']['editadm'] = true;
</pre>
</pre>


=== ContactPage - Kontaktseite (Wiki-Code de-Formal) ===
== Extensions  ==
 
Welche Erweiterungen in welcher Distribution enthalten sind, erfährt man auf der Seite https://www.mediawiki.org/wiki/Comparison_of_extensions_in_distributions


Für Mitteilungen allgemeiner Art wird eine Kontaktformular-Seite eingesetzt, die im Repositorium nur nach Anmeldung zur Verfügung steht. Bei Versand einer Kopie an eine im Formular eingetragene E-Mail-Adresse steht im Betreff: "Kopie Ihrer Nachricht an Hornemann (von [Ihr Name])"


Für das Kontaktformular muss als Empfangsadresse ein bestehendes Wiki-Konto angegeben werden und muss als E-Mail-Absender wegen Authentifizierung beim Versand die Angabe von $wgPasswordSender übernommen werden:
=== AccessControl ===
<pre>$wgContactConfig['default'] = array(
  'RecipientUser' => 'Hornemann', //'WikiUser' // Must be a valid account //vormals $wgContactUser
...
'SenderEmail' => null, // Defaults to $wgPasswordSender, may be changed as required
...);
</pre>
Im jeweiligen Wiki-Konto "Hornemann" wird als E-Mail-Adresse "service@salzwiki.de" bzw. "service@saltwiki.net" angegeben. Es kann auch "salzwiki.fb@hawk-hhg.de" bzw. "saltwiki.fb@hawk-hhg.de" angegeben werden.


Für das Formular wird die Erweiterung "ContactPage" benutzt. Die Sie-Form der Wiki-Übersetzungsdatei ist um einen Eintrag zu ergänzen.
==== Verwendungszweck ====


Das Absenden des Kontaktformulars wird bei Nutzung ohne Anmeldung zum Verhindern von Spam über ein Captcha abgesichert. Hierfür sind bei der Erweiterung für MW 1.23 (REL1_23) Anpassungen am Code der Dateien "ContactPage_body.php", "\i18n\de.json" und "\i18n\en.json" sowie "\i18n\qqq.json" erforderlich.
Die Erweiterung dient dazu, Seiten beispielsweise auch zum Lesen zu sperren, wenn wie im Repositorium Inhalte zwar bereits bearbeitet und ins Wiki eingestellt werden, aber noch nicht öffentlich zugänglich sein sollen.


*Dateien unter http://www.mediawiki.org/wiki/Extension:ContactPage bzw. <b>für MW 1.23</b> unter https://git.wikimedia.org/zip/?r=mediawiki/extensions/ContactPage&h=daa666dec4793a2ce9675dbb8b6c365d105e8986&format=zip herunterladen und die Dateien unter "Extensions/ContactPage" speichern.
Der Zugang auf eine Seite wird durch Eingabe einer Nutzergruppe (Beispiel: "parole") erlaubt, die vorher z.B. in "LocalSettings.php" definiert wird:
*Für MediaWiki 1.23 in den Übersetzungsdateien "de.json", "en.json" und "qqq.json" Zeilen einfügen (siehe weiter unten)
<pre>$wgGroupPermissions['parole']['read'] = true;</pre>
*In der Wiki-Systemtexte-Datei vor "'emailccsubject '=> '...'" das Array-Element "'emailccme' => 'Sende eine Kopie der E-Mail an mich'," einfügen und an Sie-Form anpassen: "Eine Kopie der E-Mail an mich senden"
Damit nur Mitglieder der Gruppe "parole" Zugang zu einer Seite erhalten, wird auf der jeweiligen Seite oben folgende Zeile eingegeben (siehe dazu auch http://www.mediawiki.org/wiki/Extension:AccessControl):
**Für MediaWiki 1.23 im Verzeichnis "[wikiverzeichnis]\languages\i18n\" aus der Datei "de.json" aus Zeile 1759 in Datei "de-formal.json" in Zeile 217 einfügen
<pre><accesscontrol>parole</accesscontrol></pre>
*Erweiterung mit Variablenzuweisungen in der Datei "LocalSettings.php" einfügen


ACHTUNG: Nach jedem mediawiki-Update muss überprüft werden, ob die vorgenommene Änderung in den Sprachdateien noch existiert. Deshalb ist von den Dateien jeweils eine Kopie "...SW.json" bzw. "...SW.php" zu speichern:
==== AccessControl v2.4 fehlerhaft bei MW 1.23 ====
* MW1.23  
** "[wikiverzeichnis]\languages\i18n\de.json"
** "...\extensions\ContactPage\i18n\de.json", "...de-formal.json", "...en.json" und "...qqq.json"


==== MW 1.23 Code-Anpassungen ====
Für  MW 1.23 wurde versucht, AccessControl v2.5 zu verwenden. Der Download enthält aber nicht wie in Aussicht gestellt Version 2.5, sondern Version v2.4, bei welcher in der Datei "changelog.txt" nur Änderungen bis v2.3 aufgelistet sind. Die Version 2.4 hat mehrere Fehler:
* Z.21: "$wgAccessControlRedirect = true;" fehlt
* Z.136: in Funktion getTemplatePage() ist ein Rückgabewert auskommentiert
* Z.173: php-Warnung, weil "isset($allow)" fehlt
* Z.225: php-Warnung, weil "isset($rights)" fehlt
* Z.202, Z.210: in Funktion fromTemplates() wird dieselbe Funktion evtl. endlos aufgerufen
* Z.284: in Funktion allRightsTag() wird die Funktion fromTemplates() aufgerufen, die wiederum evtl. die Funktion allRightsTag() in Z.213, Z.218 und Z.220 endlos aufruft
* Funktion doRedirect() ist im Vergleich zu v2.5 anders


Zur Code-Anpassung siehe auch https://gerrit.wikimedia.org/r/#/c/156052/
==== AccessControl v2.5 für MW 1.23 ====


In der Datei "\extensions\ContactPage\i18n\qqq.json" Ergänzung bei "authors" hinter "Shirayuki" sowie in Zeile 25 am Ende ein Komma und darunter  eine Zeile für "contactpage-captcha-error" einfügen:
Siehe auch https://www.mediawiki.org/wiki/Extension:AccessControl
 
Für die Gruppe "autor" wird standardmäßig beispielsweise die Seite "Autor" nach einer Liste mit Kontonamen durchsucht, wobei unterschieden wird zwischen "write"-Berechtigung und durch das Suffix "(ro)", was "readonly" bedeutet, "read"-Berechtigung.
 
Da eine Vielzahl Benutzungskonten zur Gruppe "autor" gehört und die Seite "Autor" in SalzWiki anderweitig verwendet wird, muss die Gruppenzugehörigkeit mit der Zuordnung in der MW-Datenbank überprüft werden und der Code der Erweiterung in der Funktion "makeGroupArray(...)" angepasst werden.
 
===== Installationshinweise =====
 
Achtung: Version 2.5 ist nicht zum Herunterladen bei REL1.23, sondern erst bei REL1.24 verfügbar.
 
* Die Extension wird als (REL1.24 oder) REL1.26 heruntergeladen und nach dem Extrahieren in das Verzeichnis "extensions" kopiert.
** v2.5 "...REL1.26...", Datei "version": 2016-01-09T22:48:53 1a2ce27 [verwendet]
** v2.5 "...REL1.24...", Datei "version": 2016-01-09T22:48:53 c7e1e54 [nicht verwendet]
** v2.4 "...REL1.23...", Datei "version": 2015-06-16T21:00:32 befc02e [nicht verwendet]
* Einfügen in Datei "LocalSettings.php":  
<pre>
<pre>
{
require_once("$IP/extensions/AccessControl/AccessControl.php");
  "metadata": {
$wgUseMediaWikiGroups = true;
    "authors": [
      ...
      "Shirayuki",
      "Gunnar Werner HAWK HHG"
    ]
  },
  ...
  "contactpage-usermailererror": "...",
  "contactpage-captcha-error": "Error message displayed when ehter was a CAPTCHA error (i.e. the user failed to enter the correct CAPTCHA, or didn't enter one at all, etc.)"
}
</pre>
</pre>


In der Datei "\extensions\ContactPage\i18n\en.json" Ergänzung bei "authors" hinter "Reedy" sowie in Zeile 20 am Ende ein Komma einfügen und darunter eine Zeile für "contactpage-captcha-error" einfügen:
===== Code-Probleme und deren Lösungen =====
 
'''undefinierte Variablen'''
 
PHP erzeugt evtl. eine Meldung "Notice: Undefined variable: allow ... on line 174". Es fehlt bei $allow die Abfrage "isset(...)".
 
Die Datei "AccessControl.php" ist zur Verhinderung von php-Warnungen wie folgt zu bearbeiten:<br/>
In Zeile 174 "if(is_array($allow)){" mit "isset($allow) &&" ergänzen:
<pre>
<pre>
{
if(isset($allow) && is_array($allow)){
  "metadata": {
</pre>
    "authors": [
 
      ...
'''Gruppenzugehörigkeit mit Datenbank statt Gruppen-Seite prüfen'''
      "Umherirrender",
 
      "Gunnar Werner HAWK HHG"
Die Überprüfung der Gruppenberechtigung darf nicht mit einer Seite für die Gruppe mit Kontenliste, sondern muss mit den Angaben in der Wiki-Datenbank ausgeführt werden
    ]
* Datei "LocalSettings.php" mit "$wgUseMediaWikiGroups" ergänzen
  },
* Datei "\extensions\AccessControl\AccessControl.php" in der Funktion "makeGroupArray(...)" anpassen
  ...
 
  "contactpage-usermailererror": "Mail object returned error:",
 
  "contactpage-captcha-error": "CAPTCHA error"
Datei "LocalSettings.php":
}
<pre>
require_once("$IP/extensions/AccessControl/AccessControl.php");
$wgUseMediaWikiGroups = true;
</pre>
</pre>


In der Datei "\extensions\ContactPage\i18n\de.json" Ergänzung bei "authors" hinter "Umherirrender", außerdem die Menüleisten-Bezeichnung "Kontaktseite" sowie Captcha-Texte einfügen:
Datei "AccessControl.php" Z.89ff:
<pre>
<pre>
{
function makeGroupArray( $accesslist ) {
   "metadata": {
   ...
    "authors": [
  $usersreadonly = Array();
      ...
  // für HAWK HHG eingefügt 2016-05-17
      "Umherirrender",
  // users of group from wiki database
      "Gunnar Werner HAWK HHG"
  global $wgUseMediaWikiGroups, $wgUser;
     ]
  if($wgUseMediaWikiGroups === true){
   },
     if( in_array($accesslist, $wgUser->getGroups()) ){
   "contact": "Kontaktseite",
      $userswrite[] = $wgUser->getName();
    }
    return array($userswrite, $usersreadonly);
   }
   // users from group-page with list of users and their rights for writing or reading
  $users = getUsersFromPages( $accesslist );
   ...
   ...
  "contactpage-captcha": "Um die Nachricht senden zu können, bitte das Captcha lösen ([[Special:Captcha/help|weitere Informationen]])",
  "contactpage-captcha-error": "Captcha-Fehlfunktion",
  "contactpage-captcha-failed": "Captcha-Test nicht bestanden! ([[Special:Captcha/help|weitere Informationen]])"
}
}
</pre>
</pre>


Datei "ContactPage_body.php" vor Zeile 185 und nach Zeile 217+11 (228), vor Zeile 341+11+1 (353), nach Zeile 393+11+1+6 (411):
'''Timeout durch Template-Name im Template-Text'''
 
Weitere Probleme mit Script-Timeout wie bei AccessControl v2.4:
* Z.206, Z.214: in Funktion fromTemplates() wird dieselbe Funktion evtl. endlos aufgerufen
* Z.290: in Funktion allRightsTag() wird die Funktion fromTemplates() aufgerufen, die wiederum evtl. die Funktion allRightsTag() in Z.217, Z.222 und Z.224 endlos aufruft
 
Timeout-Ursache sind in den Templates "Ynotice", "Baustelle" und "FreeForTranslation" die noinclude-Bereiche, in denen der Template-Name erneut auftaucht. Der erste Buchstabe muss entweder kleingeschrieben werden oder - besser - durch Hexadezimal-HTML-Zeichen ersetzt werden:
 
<pre>
<pre>
...
<nowiki>
// Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
&lt;noinclude&gt;
if ( $this->useCaptcha() ) {
=== Beispielvorlage ===
  $formItems['Captcha'] = array(
{{&amp;#98;notice|text=
     'label-message' => 'captcha-label',
}}
     'type' => 'info',
&lt;/noinclude&gt;
     'default' => $this->getCaptcha(),
 
    'raw' => true,
&lt;noinclude&gt;
   );
=== Beispielvorlage ===
{{&amp;#66;austelle}}
&lt;/noinclude&gt;
 
&lt;noinclude&gt;
=== Beispielvorlage ===
{{&amp;#70;reeForTranslation}}
&lt;/noinclude&gt;
</nowiki>
</pre>
 
 
'''Verarbeitung von Rückgabewert NULL'''
 
In den Funktionen "getTemplatePage(...)" Z.130ff und "getUsersFromPages(...)" Z.144ff muss wie bei der Funktion "getContentPage(...)" für die Verwendung der Methode "getNativeData()" der Wert, der sich zuvor aus der Methode "getContent()" ergibt, auf "NULL" überprüft werden.
 
<pre>
function getTemplatePage( $template ) {
  ...
  if ( method_exists('WikiPage', 'getContent' ) ){
    // für HAWK HHG angepasst 2016-05-17
    #$contentPage = new WikiPage( $gt );
    #return $contentPage->getContent()->getNativeData();
    $contentPage = WikiPage::factory( $gt );
     $contentPageContent = $contentPage->getContent( Revision::RAW )
    if ( $contentPageContent != NULL ){
      return ContentHandler::getContentText( $contentPageContent );
    }
  } else {
    // create Article and get the content
     $contentPage = new Article( $gt, 0 );
     return $contentPage->fetchContent( 0 );
   }
}
}


$form = new HTMLForm( $formItems, $this->getContext(), "contactpage-{$this->formType}" );
function getUsersFromPages( $group ) {
...
  ...
public function processInput( $formData ) {
  if ( method_exists('WikiPage', 'getContent' ) ){
  global $wgUserEmailUseReplyTo, $wgPasswordSender;
    // für HAWK HHG angepasst 2016-05-17
  global $wgCaptcha; // Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
    #$groupPage = new WikiPage( $gt );
...
    #$allowedUsers = $groupPage->getContent()->getNativeData();
// Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
    $groupPage = WikiPage::factory( $gt );
if ( $this->useCaptcha() && !$wgCaptcha->passCaptcha() ) {
    $groupContent = $groupPage->getContent( Revision::RAW )
  // TODO proper i18n message
    if ( $groupContent != NULL ){
  return wfMessage( 'contactpage-captcha-error' )->plain();
      $allowedUsers = ContentHandler::getContentText( $groupContent );
    }
  } else {
    // create Article and get the content
    $groupPage = new Article( $gt, 0 );
    $allowedUsers = $groupPage->fetchContent( 0 );
  }
}
}
// Stolen from Special:EmailUser
</pre>
$error = '';
 
...
 
  private static function getYesOrNoMsg( $value ) {
'''weitere Fehlerquellen'''
    return wfMessage( $value ? 'htmlform-yes' : 'htmlform-no' )->inContentLanguage()->text();
 
  }
Abhilfe schaffen folgende Änderungen von https://www.mediawiki.org/wiki/Extension_talk:AccessControl#Selected_fixes_against_2.5:
  // Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
<pre>
  /**
//function makeGroupArray(...)
  * @return boolean True if CAPTCHA should be used, false otherwise
//Z.94
  */
$usersreadonly[] = (string)$user;  #$usersreadonly[] = $user;
  private function useCaptcha() {
//Z.97
    global $wgCaptchaClass, $wgCaptchaTriggers;
$userswrite[] = (string)$user;  #$userswrite[] = $user;
 
    return $wgCaptchaClass &&
//function getUsersFromPages(...)
      isset( $wgCaptchaTriggers['contactpage'] ) &&
//Z.150
      $wgCaptchaTriggers['contactpage'] &&
$gt = $Title->newFromText( $group );    #$gt = $Title->makeTitle( 0, $group );
      !$this->getUser()->isAllowed( 'skipcaptcha' );
 
  }
//function fromTemplates(...)
   // Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
//Z.231
   /**
if ( $wgUser->isAnon() ) {    #if ( $wgUser->mID === 0 ) {
   * @return string CAPTCHA form HTML
//Z.236
   */
if ( in_array( 'sysop', $wgUser->getGroups(), true) ) {    #if ( in_array( 'sysop', $wgUser->mGroups, true) ) {
   private function getCaptcha() {
//Z.244
     // NOTE: make sure we have a session. May be required for CAPTCHAs to work.
if ( ! in_array( $wgUser->getName(), $users[0], true) ) {    #if ( ! in_array( $wgUser->mName, $users[0], true) ) {
    wfSetupSession();
//Z.255
if ( ! in_array( $wgUser->getName(), $users[1], true) ) {    #if ( ! in_array( $wgUser->mName, $users[1], true) ) {
     $captcha = ConfirmEditHooks::getInstance();
 
     $captcha->trigger = 'contactpage';
// function allRightTags(...)
     $captcha->action = 'contact';
//Z.285
$gt = $Title->newFromText( $redirecttarget );    #$gt = $Title->makeTitle( 0, $redirecttarget );
     return '<div class="captcha">' .
 
      $captcha->getForm() .
//function hookUserCan(...)
      "</div>\n";
//Z.322
if ( $wgUser->isAnon() ) {    #if ( $wgUser->mID === 0 ) {
//Z.338
if ( $wgUser->isAnon() ) {   #if ( $wgUser->mID === 0 ) {
//Z.351
if ( in_array( $wgUser->getName(), $users[0], true) ) {    #if ( in_array( $wgUser->mName, $users[0], true) ) {
//Z.364
if ( in_array( $wgUser->getName(), $users[1], true) ) {    #if ( in_array( $wgUser->mName, $users[1], true) ) {
</pre>
 
 
'''Funktion "fromTemplates"'''
 
Bei der Funktion "fromTemplates($string)" bei Z.219ff hat möglicherweise die Variable $rights den Wert NULL, weil sie die verschachtelteten Funktionen "allRightTags( getContentPage( 10, $templatepage) )" mit dem Namensraum 10 (ID für Templates) und mit dem Inhalt anstatt mit dem Seitentitel verwendet:
<pre>
} elseif ( ctype_alnum( substr( $templatepage, 0, 1 ) )) {
   // für HAWK HHG angepasst 2016-05-17
   $context = new RequestContext();
   $gt2 = $context->getTitle();
   // The check of included template
   if (strpos( $tempatepage, '|' ) > 0) {
     $templatename = substr( $templatepage, 0, strpos( $templatepage, '|' ) );
     #$rights = allRightTags( getContentPage( 10, $templatename ) );
     $rights = allRightTags( getContentPage( $gt2->getNamespace(), $templatename ) );
  } else {
     #$rights = allRightTags( getContentPage( 10, $templatepage ) );
     $rights = allRightTags( getContentPage( $gt2->getNamespace(), $gt2->getFullText() ) );
   }
   }
}
}
</pre>
</pre>


==== LocalSettings.php ====
===== Lösungsversuche ohne Erfolg =====
 
'''Funktion "getContentPage(...)"'''
 
Fehlversuch Z. 121ff hinzufügen von "else{...}"
<pre>
<pre>
// Version 2.2 für MediaWiki 1.25
if ( method_exists( 'WikiPage', 'getContent' ) ) {
#wfLoadExtension("ContactPage.php");
$contentPage = WikiPage::factory( $gt ); #$contentPage = new WikiPage( $gt );
// Version 2.2 für MediaWiki 1.23
if ( $contentPage->getContent (Revision::RAW) != NULL ) {
require_once( "$IP/extensions/ContactPage/ContactPage.php" );
   ...
$wgContactConfig['default'] = array(
}
  'RecipientUser' => 'Hornemann', //'WikiUser' // Must be the name of a valid account //vormals $wgContactUser
// für HAWK HHG nicht eingefügt 2016-05-10 wegen Endlosscript
   'SenderName'=> 'Kontaktformular ' . $wgSitename, //"Contact Form " // "Contact Form on" needs to be translated //vormals $wgContactSenderName
else{
   'SenderEmail'=> null // Defaults to $wgPasswordSender, may be changed as required
   $context = new RequestContext();
   'RequireDetails'=> true, // Whether users will be required to supply a name and an email address on Special:Contact
   $gt2 = $context->getTitle();
   'IncludeIP'=> false, // Whether the form will include a checkbox offering to put the IP address of the submitter in the subject line
   $contentArticle = new Article( $gt2, $namespace);
   'AdditonalFields'=> array(
   if($contentArticle->getPage()->getContent() != NULL){
    'Text'=> array(
  return $contentArticle->getPage()->getContent(Revision::RAW)->getNativeData()
      'label-message'=> 'E-Mail-Nachricht', //'e-mail-message' //'emailmessage',
   }
      'type'=> 'textarea',
}
      'rows'=> 20,
} else {
      'cols'=> 80,
// create Article and get the content
      'required' => true, //Pflichtfeld
...
    ),
}
   ),
  // Added in MW 1.26
  #'DisplayFormat' => 'table', // See HTMLForm documentation for available values.
  #'RLModules' => array(), // Resource loader modules to add to the form display page.
  #'RLStyleModules' => array(), // Resource loader CSS modules to add to the form display page.
);
</pre>
</pre>


=== CreativeCommonsRdf ===
==== Einrichten einer Nutzungsgruppe ====


Die Erweiterung soll ab MW-Version 1.19 die Variable "$wgEnableCreativeCommonsRdf" in der Datei "LocalSettings.php" ersetzen, hat aber noch Beta-Status (2015-09-21). Die 3 Dateien der Erweiterung können heruntergeladen werden bei https://www.mediawiki.org/wiki/Extension:CreativeCommonsRdf
Eine Gruppe von Usern, die alleine Zugang auf bestimmte Seiten haben soll, wird z. b. beim Repositorium im Namensrauam "ACCESS" wie unten eingerichtet.


=== DynamicPageList ===
:Speichern der Liste auf der Seite Access:SIP
<nowiki><accesscontrol>Access:SIP</accesscontrol></nowiki># Schutz der eigenen Seite
*Hschwarz                                                # einfache Liste der User
*HJuling
*MSteiger
*SLaue
*SBrueggerhoff
*Testuser


Es gibt 3 Erweiterungen mit der Bezeichnung "DynamicPageList", wobei die erste mit dem Alias "Intersection" nicht verwendet wird (siehe auch https://www.mediawiki.org/wiki/Extension:DPL).
=== ApprovedRevs ===


==== MediaWiki 1.23 ====
==== Einschränkung ====
* Für MW 1.23 wird die Erweiterung "DynamicPageList" mit dem Alias "DynamicPageList3" von https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:DynamicPageList3 heruntergeladen und nach dem Extrahieren in das Verzeichnis "extensions" des jeweiligen Wikis extrahiert.
* Einfügen in LocalSettings:
<pre>include("$IP/extensions/DynamicPageList3/DynamicPageList.php");</pre>


Diese Erweiterung kann nicht verwendet werden, wenn die Erweiterung "AccessControl" verwendet wird; siehe https://www.mediawiki.org/wiki/Extension:ApprovedRevs.


=== Inline SVG Extension ===
==== Verwendungszweck ====


Diese Erweiterung wird ab Mediawiki 1.23 nicht mehr verwendet, weil die üblichen Browser inzwischen SVG-Elemente darstellen können.
Mit dieser Erweiterung können Revisionen (Versionen einer SalzWiki-Seite) bestätigt oder abgelehnt werden. Die bestätigte Version wird allen Usern angezeigt.


Die php-Datei "SVGtag.php" sorgt dafür, dass Inline-SVG-Code im Upload-Verzeichnis gespeichert und in einem "iframe" geladen wird. Dies ist erforderlich für ältere Browser, insbesondere für Internet Explorer bis einschließlich Version 8.
[[Datei:Approved _Revs-1.jpg|thumb|800px|center]]


* Extension unter http://www.mediawiki.org/wiki/Extension:Inline_SVG_extension herunterladen.
==== Installation der Erweiterung "ApprovedRevs" ====
* Datei in das Verzeichnis "extensions" kopieren
* In der Datei "LocalSettings.php" einfügen:
<pre>require_once("$IP/extensions/SVGtag.php");</pre>


=== JavaScript ===
* Die Erweiterung wird mit der Version 0.7.0 REL1.23 2015-06-16T21:01:12 513cff5 heruntergeladen und nach dem Extrahieren in das Extensions-Verzeichnis des jeweiligen Wikis kopiert.
* Es muss bei einem neuen Wiki eine Datenbank-Tabelle mit dem Präfix "sw_" (SalzWiki, SaltWiki) bzw. "sr_" (Repository) und dem Namen "approved_revs" angelegt werden. Hierzu gibt es zwei Möglichkeiten:
** Das Skript "update.php" von "MediaWiki's/maintenance" benutzen oder
** Mittels "phpMyAdmin" in der Datenbank die Tabelle mit den beiden SQL-Befehlen, die in der Datei "ApprovedRevs.sql" der Erweiterung zu finden sind, erstellen.
* Die Erweiterung in der Datei "LocalSettings.php" aktivieren
<pre>// SalzWiki, SaltWiki, Repository
require_once( "$IP/extensions/ApprovedRevs/ApprovedRevs.php" );
</pre>


Entfällt bei MW 1.23.11 LTS und wird ersetzt durch eine Anpassung in der Datei "skins\MonoBook.php".
==== Konfiguration von "ApprovedRevs" ====


Die Erweiterung hat den Status "unmaintained" (Stand 2015-09-15); die Version 3.0.8 (2012-02-15) kann wegen einer ungültigen Internetadresse nicht heruntergeladen werden, doch gibt es auf der Internetseite https://www.organicdesign.co.nz/Extension:Javascript den Hinweis, dass die Erweiterung obsolet ist, seitdem MediaWiki den ResourceLoader bereitstellt, siehe https://www.mediawiki.org/wiki/ResourceLoader.
Diejenigen, die das Recht "viewlinktolatest" haben, sehen einen Hyperlink unter dem Titel des Artikels, um zur aktuellen unbestätigten Version zu kommen.


Diese Erweiterung diente zusammen mit der von S. Reher gelieferten Datei "customizeSidebar.js" dazu, den Navigationsbereich "Werkzeuge" in der Sidebar entsprechend dem Anmeldestatus zu manipulieren - siehe hierzu [[#Sidebar_anpassen_.28Wiki-Code.2C_JS.29|Sidebar anpassen]]. Dies funktionierte allerdings nur, wenn beim Browser JavaScript aktiviert war.
Diejenigen, die das Recht "approverevisions" haben, können in der History (Versionen-Übersicht) eine Version "bestätigen" oder "ablehnen".


==== sichtbare Toolbox-Menüpunkte ====
Damit nur Admins und Mitglieder der Gruppen "Redakteur"/"Editor" eine Version bestätigen bzw. ablehnen können und zusätzlich Mitglieder der Gruppe "autor" den Verweis zur aktuellen unbestätigten Version zur Verfügung gestellt bekommen, sind in der Datei "LocalSettings.php" folgende Angaben erforderlich:


* SalzWiki: alle Gruppen und User
<pre>// SalzWiki
** Druckversion
$wgGroupPermissions['Redakteur']['approverevisions'] = true;
$wgGroupPermissions['sysop']['approverevisions'] = true;
$wgGroupPermissions['autor']['viewlinktolatest'] = true;
$wgGroupPermissions['*']['viewlinktolatest'] = false;
$wgGroupPermissions['sysop']['viewlinktolatest'] = true;
</pre>
<pre>// SaltWiki
$wgGroupPermissions['Editor']['approverevisions'] = true;
$wgGroupPermissions['sysop']['approverevisions'] = true;
$wgGroupPermissions['autor']['viewlinktolatest'] = true;
$wgGroupPermissions['*']['viewlinktolatest'] = false;
$wgGroupPermissions['sysop']['viewlinktolatest'] = true;
</pre>
<pre>// Repository
$wgGroupPermissions['Editor']['approverevisions'] = true;
$wgGroupPermissions['sysop']['approverevisions'] = true;
#$wgGroupPermissions['autor']['viewlinktolatest'] = true;
$wgGroupPermissions['*']['viewlinktolatest'] = false;
$wgGroupPermissions['sysop']['viewlinktolatest'] = true;
</pre>


* SaltWiki: alle Gruppen und User
Beispiele:
** Printable version
* damit z. B. alle Mitglieder der Gruppe "autor" Seiten als geprüft markieren können
<pre>$wgGroupPermissions['autor']['approverevisions'] = true;</pre>


* Repository: alle Gruppen und User
* um den ApprovedRevs-Hyperlink standardmäßig zu deaktivieren
** Printable version
<pre>$wgGroupPermissions['*']['viewlinktolatest'] = false;</pre>


==== ausgeblendete Toolbox-Menüpunkte ====
* um den ApprovedRevs-Hyperlink allen Admins und Mitgliedern der Gruppe "autor" zur Verfügung zu stellen
<pre>$wgGroupPermissions['autor']['viewlinktolatest'] = true;
$wgGroupPermissions['sysops']['viewlinktolatest'] = true;</pre>


* SalzWiki: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
=== Bibliography  ===
** "Links auf diese Seite" (Special:WhatLinksHere/Main_Page)
** "Änderungen an verlinkten Seiten" (Spezial:%C3%84nderungen_an_verlinkten_Seiten)
** "Hochladen" (Special:Upload)
** "Spezialseiten" (Special:SpecialPages)
** "Permanenter Link" (Main_page&oldid=921)
** "Seiteninformationen" ([Seitentitel]&action=info])


* SaltWiki: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
Die Extension Bibliography wurde durch die Erweiterung BibManager ersetzt. Siehe hierzu unter "Erweiterungen - BibManager".
** "What links here" (Special:WhatLinksHere/Main_Page)
 
** "Related changes" (Special:RecentChangesLinked)
 
** "Hochladen" (Special:Upload)
=== BibManager===
** "Spezialseiten" (Special:SpecialPages)
 
** "Permanent link" (Main_page&oldid=921)
Die Erweiterung "BibManager" wird zur Erstellung und Verwaltung der Literaturhinweise bzw. zum Einbinden der Zitate in Artikel benutzt und verwendet den Namensraum "NS_CITATION" ("Cit") mit der Nummer 800 sowie "NS_CITATION_TALK" ("Cit_talk") mit der Nummer 801.
** "Page information" ([Seitentitel]&action=info])


* Repository: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
Die Erweiterung besteht aus
** "Links auf diese Seite" (Special:WhatLinksHere/Main_Page)
* der Grunderweiterung "BibManager"
** "Änderungen an verlinkten Seiten" (Spezial:%C3%84nderungen_an_verlinkten_Seiten)
* und den von "HalloWelt" für die HAWK HHG programmierten Zusatzerweiterungen
** "Datei Hochladen" (Special:Upload)
** [[#SaltWiki_2|"SaltWiki"]]
** "Spezialseiten" (Spezial:Spezialseiten)
** [[#SaltWikiUpload|"SaltWikiUpload"]]
** "Permanent link" (Main_page&oldid=9522)
** "Seiteninformationen" ([Seitentitel]&action=info])


=== Math (Wiki-Code) ===
Mit der Erweiterung [[#SaltWiki_2|"SaltWiki"]] können im SalzWiki/SaltWiki/Repository weitere Felder, die nicht im original "BibTeX" spezifiziert sind, wie DOI und Fulltext, verwendet werden.


"Math" kann heruntergeladen werden von https://www.mediawiki.org/wiki/Extension:Math/de. Es ist inzwischen eine Erweiterung; bei MW1.16 wurde hingegen die Datei "[wikiname]\includes\math.php" angepasst.
Die Erweiterung [[#SaltWikiUpload|"SaltWikiUpload"]] soll im Repositorium das Hochladen von Dateien mit BibTex-Angaben erleichtern, doch wird bei MW1.23LTS nur das MW-Standard-Upload-Formular angezeigt.


Die Erweiterung "Math" ist für die Darstellung von Formeln erforderlich und nutzt standardmäßig "texvc", wobei das mitgelieferte "texvc" nur unter Linux genutzt werden kann und für Windows erst kompiliert werden muss und problembehaftet sein soll.
==== Versionen ====


Da "texvc" unter Windows ausscheidet, muss für die Nutzung von GhostScript, mImageMagick und MikTeX wie bei MW1.16 der Wiki-Code angepasst und die Klasse "LatexRender" in der Datei "Math_SW.php" mit Anpassungen als Klasse "MathLatexRender" weiterverwendet werden. Der Quelltext von "LatexRender" für alte MediaWikiVersionen wie MW1.16 steht zur Verfügung bei "https://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Windows/math.php".
Für MediaWiki 1.23 LTS wird wegen diverser Probleme bei der BibManager-Version v1.1.0 die Version 1.23 REL1.26 2015-11-17T01:01:50 d824ce8 installiert.


Getestet werden kann die Erweiterung "Math" über die Kommandozeile:
* BibManager
<pre>
** v1.23.0 master 2016-01-15T07:01:22 951b12f
D:
** v1.23.0 REL1.26 2015-11-17T01:01:50 d824ce8 verwenden bei MW1.23LTS
cd xampp\htdocs\[wikiname]
** v1.1.0 REL1.23 2015-06-16T21:02:02 6218f71 (angeboten für MW 1.22+)
D:\xampp\php\php.exe tests\phpunit\phpunit.php extensions\Math\tests\
** v1 (verwendet bei MW1.16)
</pre>
* SaltWiki
** SaltWiki mit Datum 2012-05-25 verwenden bei MW1.23LTS
** SaltWiki mit Datum 2012-01-20 (verwendet bei MW1.16)
* SaltWikiUpload
** SaltWikiUpload mit Datum 2012-01-25 verwenden bei MW1.23LTS Repository
** SaltWikiUpload mit Datum 2012-01-11 (verwendet bei MW1.16 Repository)


==== Installation "Math" ====
BibManager-Versionsangaben befinden sich in folgenden Dateien:
* version: REL1.26 2015-11-17T01:01:50
* BibManager.php: 1.23.0
* BibManager.i18n.php: compatibility back to MediaWiki 1.17


* Die heruntergeladene Erweiterung entpacken in das Verzeichnis "extensions\"
==== Installation ====
* Die Erweiterung in der Datei "LocalSettings.php" einbinden<pre>require_once "$IP/extensions/Math/Math.php";</pre>
* Existenz der Datenbanktabelle "math" überprüfen, ansonsten erstellen
** entweder SQL-Befehl für MySQL/MariaDB aus der Datei "\extensions\Math\db\math.sql" mit phpMyAdmin ausführen
** oder per Kommandozeile eine Aktualisierung ausführen: <pre>D:\xampp\php\php.exe D:\xampp\htdocs\[wikiname]\maintenance\update.php</pre>


==== ImageMagick und MikTeX für Math statt Texvc ====
Bei der Installation werden die Erweiterungen in folgende Ordner kopiert:
* "\extensions\BibManager\"
* "\extensions\SaltWiki\"
* "\extensions\SaltWikiUpload\"


Bei MW1.23 soll zwar "Math" ohne "ImageMagick" verwendet werden (siehe https://www.mediawiki.org/Manual:Running_MediaWiki_on_Windows#ImageMagick), doch funktioniert dies nicht mit "texvc" unter Windows. Deshalb wird in der Datei "LocalSettings.php" weiterhin "ImageMagick" mit "true" aktiviert statt mit "false" deaktiviert und außerdem "Texvc" für die Datei "Math.hooks.php" deaktiviert:
In der Datei "LocalSettings.php" wird Folgendes eingefügt:
<pre>
<pre>
$wgUseImageMagick = true;
## Namensräume
...
...
require_once "$IP/extensions/Math/Math.php";
// für Erweiterung BibManager
$wgMathDisableTexFilter = true; // in Math.hooks.php
define("NS_CITATION", 800);
define("NS_CITATION_TALK", 801);
$wgExtraNamespaces[NS_CITATION] = 'Cit';
$wgExtraNamespaces[NS_CITATION_TALK] = 'Cit_talk';
...
## EXTENSIONS
...
require_once('extensions/BibManager/BibManager.php');
require_once('extensions/SaltWiki/SaltWiki.php' );
#nur im Repositorium:
require_once('extensions/SaltWikiUpload/SaltWikiUpload.php' );
...
## Einstellungen
...
## Erweiterung BibManager
# Namensraum berücksichtigen
$wgBibManagerCitationArticleNamespace = NS_CITATION;
# BibManager-Anpassung an die gewünschte Zitierweise
$wgBibManagerCitationFormats = array (
  '-' => '%author%: %title%, %year% %url%, %doi%.',
  'article' => '%author% (%year%): %title%. <em>%journal%</em>, <b>%volume%</b> (%number%), %pages%, %url%, %doi%.',
  'book' => '%editor% %author% (%year%): <em>%title%, %edition%, %publisher%, %address%, %pages%</em>, %url%., %doi%',
  'booklet' => '%title% %url%, %doi%.',
  'conference' => '%author% (%year%): %title%. %booktitle% %url%, %doi%.',
  'inbook' => '%author% (%year%): <em>%title%. In: %editor%: %edition%, %publisher%, %address%, %pages%</em> %url%, %doi%.',
  'incollection' => '%author% (%year%): %title%. In: %editor%: %booktitle%, <em>%publisher%</em>, %pages%, %url%, %doi%.',
  'inproceedings' => '%author% (%year%): %title%. In: %editor%: %booktitle%,<em>%publisher%</em>, %pages%, %url%, %doi%.',
  'manual' => '%title% %url%, %doi%.',
  'mastersthesis' => '%author% (%year%): %title%, %type%, %school%, %address%, %url%, %doi%.',
  'misc' => '%author% (%year%): %title%, %howpublished%, %pages% %url%, %doi%.',
  'phdthesis' => '%author% (%year%): %title%. %type%, %school%, %url%, %doi%.',
  'proceedings' => '%editor% (%year%): %title%,<em> %publisher%</em>, %url%, %doi%.',
  'techreport' => '%author% (%year%): %title%. %institution% %url%, %doi%.',
  'unpublished' => '%author% (%year%): %title%. %note%, %url%, %doi%.'
);
</pre>
</pre>


===== Anpassungen "Math.php" und "MathRenderer.php" (Wiki-Code) =====
===== BibManager v1.23 REL1_26 und v1.23 master =====
* in der Datei "Math.php" zwischen Z.191 und Z.192 die Klasse "LatexRender" hinzufügen
: <pre>#$wgAutoloadClasses['MathLatexRender.php'] // für HAWK HHG eingefügt 2016-04-25</pre>
* in der Datei "MathRenderer.php" bei der Funktion "getRenderer(...)" in Z.122f bei "default:"
: <code>
: default: // für HAWK HHG angepasst 2016-04-25
: $renderer = new MathLatexRender( $tex, $params ); #$renderer = new MathTexvc( $tex, $params );
: </code>


===== Anpassungen Klasse "LatexRender" =====
* Fehler bei "Edit" mit Fehlermeldung zu bereits vorhandenem Schlüssel
* Fehler bei "Delete" wegen fehlender Datensatzkennung
* Bei "Verwalten" fehlen rechts die Icons für "Edit" und "Delete" sowie die Trennung zwischen beiden Texten: css-Datei fehlt im head-Bereich
* In der Datei "\extensions\BibManager\includes\BibManagerHooks.php" ist in der Funktion "getIcons(...)" der Pfad 2-mal hart-codiert statt mit einer Variablen angegeben:<pre>... htmlspecialchars( $wgScriptPath . '/extensions/BibManager/resources/images/[pencil.png|book.png]' );</pre>


In der alten Datei "Math.php" bzw. "Math_SW.php" waren 2 Klassen, nämlich die Klasse "MathRenderer" und die Klasse "LatexRender" enthalten, wobei "MathRenderer" im Vergleich zum Original nur rudimentär vorhanden war, um ein Objekt der Klasse, "LatexRender" zu erzeugen.
===== BibManager v1.1.0 REL1_23 =====


Aus diesen beiden Klassen wird für MW1.23 die Klasse "MathLatexRender" als Sub-Klasse der Klasse "MathRenderer".
* Fehler bei "Create", "Edit" und "Delete" wegen fehlender Datensatzkennung.
* In der Datei "\extensions\BibManager\includes\BibManagerHooks.php" ist in der Funktion "onBeforePageDisplay(...)" der Pfad zur Erweiterung 3-mal hart-codiert statt mit einer Variablen angegeben: <pre>... htmlspecialchars( $wgScriptPath . '/extensions/BibManager/client/[BibManagerCommon.css|BibManagerEdit.js|BibManagerList.js]' );</pre>
*Für ebenfalls hart-codierte Pfadangaben in der Funktion "getIcons(...)" siehe [[#BibManager 1.23 REL1_26 und 1.23 master]]


Anstatt der Klasse "MathRenderer" unterhalb der Klasse "LatexRender" wird nun in der Klasse "LatexRender" die Konstruktor-Funktion "__constructor(...)" verwendet, wobei die Konstruktor-Funktion auch die Funktion "LatexRender(...)", die bisher zur Initialisierung als Konstruktor diente, ersetzt.
==== Spezialseiten-Gruppe ====


Hinzu kommt eine neue Funktion "render()", die durch die Definition in der Datei "MathRenderer.php" erforderlich ist.
Verfügbarkeit in Abhängigkeit vom Status
* Ohne Anmeldung sollen nur die Verweise zu "Bibliographien anzeigen: Autoren" und "Bibliographien verwalten" sichtbar sein. Bei "Bibliographien verwalten" sind dann die Funktionen "Edit" und "Delete" nicht vorhanden, sondern nur "Export".
* Nach Anmeldung sind auch die Funktionen "Bibliographieeintrag anlegen" und "Bibliographien importieren" verfügbar.


Zudem werden die Variablen $url und $text als Klassen-Variablen definiert.
Von den zu ändernden Dateien bzw. Verzeichnissen ist nach den Anpassungen jeweils eine Kopie mit dem Suffix "SW" im Dateinamen bzw. Verzeichnisnamen zu speichern, um nach Updates von MediaWiki oder Erweiterungen die Änderungen übernehmen zu können.
 
Es sollte eine Datei "\i18n\qqq.json" mit folgendem Code erstellt werden:
<pre>
<pre>
class MathLatexRender extends MathRenderer {
{
   ...
   "@metadata": {
  var $url = "";
    "authors": []
  var $text = "";
   },
   ...
   "bibmanager": "BibManager",
   /* done with function __constructor() below by changes 2016
   "bibmanager-desc": "{{desc}}"
   function LatexRender($picture_path,$picture_path_httpd,$tmp_dir) {
    ...
  }
  */
  ...
  function __constructor ($latex_formula, $params = array() ) {
    ...
  }
 
  public function render(){
    return $this->text;
  }
}
}
<pre>
</pre>


==== LaTeXML für Math statt Texvc ====
===== BibManager v1.23.0 REL1.26 Datei-Anpassungen =====


Da LaTeXML nur bei einfachen Formeln funktioniert, kommt es nicht als Alternative zu Texvc in Betracht.
* \i18n\ => \i18nSW\
 
** de.json
In der Datei "readme" gibt es folgende Hinweise:
** de-formal.json
* Seit MW1.19 beschränken sich die Rendering-Optionen auf "Always PNG" und "Leave it as TeX".
** en.json
* Statt Bildern kann "MathML" mittels "LaTeXML" verwendet werden
** qqq.json
** Für LaTeXML ist "php5-curl" erforderlich; bei Windows ist es im Verzeichnis "\php\ext\" die Datei "php_curl.dll", die als Modul in der Datei "php.ini" eingebunden sein muss
* \includes\
** In der Datei "LocalSettings.php" wird LaTeXML für die Konvertierung zu MathML verwendet: "$wgMathUseLaTeXML = true;"
** BibManagerHooks.php => BibManagerHooksSW.php
** In der Datei "LocalSettings.php" wird für anonyme Seitenaufrufe  angegeben: "$wgDefaultUserOptions['math'] = MW_MATH_LATEXML"
** BibManagerPagerList.php =>BibManagerPagerListSW.php
** Empfohlen wird eine Core-Version von wmf/1.22wmf7 oder neuer
* \includes\specials\
** SpecialBibManagerDelete.php => SpecialBibManagerDeleteSW.php
** SpecialBibManagerEdit.php => SpecialBibManagerEditSW.php
* \resources\ext.bibManager.css =ext.bibManagerSW.css>


==== Texvc für Math kompilieren ====
===== BibManager v1.1.0 REL1.23 Datei-Anpassungen =====


Für die Kompilierung ist "MinGW" gegenüber "Cygwin" vorzuziehen, weil es unabhängig von den dll-Dateien und deren MS-Lizenzen mit der MSVC-Runtime funktioniert (siehe http://stackoverflow.com/questions/771756/what-is-the-difference-between-cygwin-and-mingw).
* BibManager.php => BibManagerSW.php
* <del>BibManager.alias.php => BibManager.aliasSW.php</del>
* \i18n\ => \i18nSW\
** de.json
** de-formal.json
** en.json
** qqq.json
* \specialpages\ => \specialpagesSW\
** BibManagerCreate_body.php
** BibManagerDelete_body.php
** BibManagerEdit_body.php
** BibManagerExport_body.php
** BibManagerImport_body.php
** BibManagerList_body.php
** BibManagerListAuthors_body.php


Da für "MinGW" keine verwertbare Ausgangsdatei zur Verfügung steht - , "makefile" wird nicht akzeptiert -, müssen "Cygwin" und "OCaml" (Version 4.02.3 32Bit + findlib + batteries) installiert werden (Dauer ca. 20 Min.). "OCaml" kann bei http://caml.inria.fr oder bei http://protz.github.io/ocaml-installer/ heruntergeladen werden.
Die Spezialseiten-Gruppe "BibManager" und die darin angezeigten Spezialseiten werden in der Datei "\extensions\BibManager\i18n\[Sprache].json" festgelegt; siehe https://www.mediawiki.org/wiki/Manual:Special_pages#The_localisation_file. Die Einbindung funktioniert mit MW1.23 fehlerhaft: Entweder werden die Seiten nicht angezeigt (Schlüssel mit Großbuchstaben wie bisher) oder werden die Seiten nicht gefunden (Schlüssel insgesamt in Kleinbuchstaben).


'''Cygwin'''
In den Zeilen 5 und 13 der json-Sprachdateien wäre der Array-Schlüssel von "BibManager" in Kleinbuchstaben zu ändern:
 
<pre>
Während der Installation von "OCaml" in das Verzeichnis "D:\texmf\" wird zusätzlich "Cygwin" im Verzeichnis "C:\cygwin\" installiert, sofern noch nicht vorhanden.
...
  "specialpages-group-bibmanager": "BibManager",
...
  "bibmanager": "BibManager",
...
</pre>


Für die Installation von "Cygwin" muss zum Herunterladen ein Mirror-Server ausgewählt werden, z. B. ftp://ftp.hawo.stw.uni-erlangen.de.
Die Variable $wgSpecialPageGroups in der Datei "BibManager.php" gilt als "deprecated" seit MW 1.21 (https://gerrit.wikimedia.org/r/#/c/220819/3) und kann auskommentiert werden, wenn im Verzeichnis "\specialpages\" in den jeweiligen Dateien "BibManager..._body.php" am Ende der Klasse folgende Funktion eingefügt wird (https://www.mediawiki.org/wiki/Manual:Special_pages => Special page group):
<pre>
  protected function getGroupName(){
    return 'bibmanager';
  }
</pre>


Vor dem Kompilieren müssen Dateien angepasst werden (siehe https://www.mediawiki.org/wiki/Texvc#Windows und https://www.mediawiki.org/wiki/MWWRender.ml):
===== Systemnachrichten für Gruppe prüfen =====
* \Math\math\render.ml Z.42 und Z.48 (2 Backslashes statt einem Schrägstrich)
: <pre>...finalpath^"\\"^md5...</pre>
: <pre>...finalpath^"\\"^md5...</pre>


'''MinGW'''
Ob die Gruppe "BibManager" in den Systemnachrichten auftaucht, lässt sich durch Aufruf der MediaWiki-Systemnachrichten, die sich bei den Spezialseiten in der Rubrik "Daten und Werkzeuge" befinden, überprüfen, indem als Präfixfilter "Specialpages-group" angegeben wird. Dann sollte bei den Ergebnissen der Name "specialpages-group-bibmanager" mit dem Text "BibManager" aufgelistet werden.


"MinGW" (2013-10-26) kann als Installationsmanager, der während der Installation die ausgewählten "Packages" aus dem Internet lädt (Dauer ca. 10 Min.), heruntergeladen werden bei https://sourceforge.net/projects/mingw/files/ (Stand 2016-04-29).
===== Einschränkungen für Darstellung in der Spezialseiten-Gruppe überprüfen =====


"MinGW" wird als 32Bit-Version im Verzeichnis "C:\MinGW\" installiert und wird nicht in der Systemsteuerung bei den installierten Programmen aufgelistet. Das Programm-Unterverzeichnis "bin\" muss bei der Umgebungsvariablen "Path" hinzugefügt und der Server danach neu gestartet werden.
Wenn die BibManager-Spezialseiten nicht angezeigt werden, folgendes prüfen:
* In den Dateien "BibManager.php" oder "LocalSettings.php" die Gruppenberechtigung ändern:
** Bibliographien anlegen: $wgGroupPermissions['sysop']['bibmanagercreate'] => $wgGroupPermissions['*']['bibmanagercreate']
** Bibliographien importieren: $wgGroupPermissions['sysop']['bibmanageredit'] => $wgGroupPermissions['*']['bibmanageredit']
* Beim Klassen-Konstruktor "parent::__construct('...', '...')" den 2. Parameter (Kleinbuchstaben) für $restriction weggelassen in folgenden Dateien:
** "\specialpages\BibManagerCreate_body.php" in Zeile 6
** "\specialpages\BibManagerImport_body.php" in Zeile 6


Im Installationsmanager bei <del>"Basic Setup"</del> "All Packages" alle Packages von "MinGW", aber nicht "MSYS" aktivieren. Danach im Menü "Installation => Apply changes" auswählen.
==== Fehler korrigieren ====


Kompilieren (siehe auch http://www.mingw.org/wiki/mingw_for_first_time_users_howto):
===== Fehler beim Speichern nach Bearbeitung =====
* Die DOS-Kommandozeile als Administrator öffnen
* zum "Math"-Verzeichnis wechseln
* Befehl zum Kompilieren eingeben
<pre>
C:\MinGW\bin\gcc makefile -o texvc.exe
</pre>


Fehlermeldung: "Das Programm kann nicht gestartet werden, da libiconv-2.dll auf dem Computer fehlt."
Der bearbeitete Datensatz kann nicht gespeichert werden, weil die Prüfung des Bearbeitungsmodus fehlerhaft ist und der Datensatz wie ein Neueintrag auf einen bereits vorhandenen Zitatschlüssel überprüft wird.


In "Systemsteuerung => Alle Systemsteuerungselemente => System => Erweiterte Systemeinstellungen => Umgebungsvariablen" bei "Path" am Ende einfügen:
In der Datei "\extensions\BibManager\includes\specials\SpecialBibManagerEdit.php" muss in der Funktion "execute(...)" in Zeile 69 "bm_edit_mode" zu "wpbm_edit_mode" geändert werden:
<pre>;C:\MinGW\bin\</pre>
<pre>
$editMode = $wgRequest->getBool( 'wpbm_edit_mode' ); #$editMode = $wgRequest->getBool( 'bm_edit_mode' ); für HAWK HHG geändert 2016-02-16
</pre>


=== MwEmbedSupport ===
Anschließend ist eine Kopie der Datei mit dem Suffix "SW" zu speichern.


Die Erweiterung wird für die Wiedergabe von Videodateien mit der Erweiterung "TimedMediaHandler" benötigt. Sie kann heruntergeladen werden bei https://www.mediawiki.org/wiki/Extension:MwEmbedSupport
===== Fehler bei Löschvorgang =====


=== OggHandler ===
Der Datensatz kann wegen fehlender Angaben nach der Löschbestätigung nicht gelöscht werden:
* Element "bm_bibtexCitation" existiert nicht im Formular, sondern "wpbm_bibtexCitation"
* Element "bm_delete" existiert nicht im Formular, sondern "wpbm_delete"
* $deleteSubmit ist immer falsch, weil String (Zeichenkette) mit Boolean (Wahrheitswert) verglichen wird


Die Erweiterung wird ab Mediawiki 1.24 nicht mehr unterstützt; empfohlen wird die Erweiterung "TimedMediaHandler", die die Erweiterung "MwEmbedSupport" benötigt.
In der Datei "\extensions\BibManager\includes\specials\SpecialBibManagerDelete.php" folgende Anpassungen vornehmen:
 
* Bei Array "$formDescriptor" einen Namen für das Formularfeld "bm_delete" vorgeben
Diese Erweiterung dient zum Darstellen von Videodateien in SalzWiki-Artikeln. Da es sich beim OGG-Format um ein freies Format handelt, benötigt man keine Lizenz zum Darstellen der Inhalte.
* Bei Array "$formDescriptor" einen Namen für das Formularfeld "bm_bibtexCitation" vorgeben
'''Es ist noch zu klären, ob eventuell das MPEG Format für eine Hochschulanwendung lizenzfrei sein könnte.'''
* In Funktion "formSubmit(...)" bei der Prüfung von "$formdata['bm_delete']" Umwandlung von Boolean in String einfügen
 
'''Für die Erweiterung sind "PEAR" und "FFmpeg" erforderlich. '''
*"PEAR" ist in der PHP-Installation des Servers enthalten.
*"FFmpeg" ist herunterzuladen von ??? und wird dann gespeichert unter "D:\ffmpeg-wiki\"


Installation der Erweiterung:
* Extension unter http://www.mediawiki.org/wiki/Extension:OggHandler herunterladen.
* Extrahieren der Dateien nach extensions/OggHandler
* In der Datei "LocalSettings.php" einfügen:
<pre>
<pre>
require( "$IP/extensions/OggHandler/OggHandler.php" );
//Z.59ff
$wgFFmpegLocation = 'd:\ffmpeg-wiki\bin\ffmpeg';
$formDescriptor = array (
</pre>
  'bm_delete' = array (
 
    'class' => 'HTMLHiddenField';
=== QuestyCaptcha ===
    'default' => true,
 
    'name' => 'bm_delete', // für HAWK HHG eingefügt 2016-02-09
Für SaltWiki wird zusätzlich zu "ConfirmEdit" als Erweiterung das Captcha "QuestyCaptcha" gegen Spam-Anmeldungen genutzt, da das Standard-Mathe-Captcha nicht ausreichte.
  )
Die anderen angebotenen Captchas werden in zukünftigen Mediawiki-Versionen nicht mehr unterstützt oder funktionieren nicht mit allen gängigen Browsern oder funktionieren mit nicht-barrierefreien Bildern und/oder benötigen zusätzliche Installationen auf dem Wiki-Server mit Administrationsrechten, weshalb "QuestyCaptcha" trotz Beta-Status als einzig brauchbare Möglichkeit verwendet werden muss.
  'bm_bibtexCitation' = array (
    'class' => 'HTMLHiddenField';
    'default' => $citation,
    'name' => 'bm_bibtexCitation', // für HAWK HHG eingefügt 2016-02-09
  )
);
//Z.89
if ( empty( $formData['bm_delete'] ) || $formData['bm_delete'] !== (string)true ) // für HAWK HHG ergänzt mit (string) 2016-02-09
</pre>
 
===== Falscher Text nach Löschvorgang =====
 
Nachdem ein Eintrag gelöscht wurde, erscheint "Ihre Daten wurden erfolgreich gespeichert!" (auch schon in MW1.16).
 
In der Datei "\extensions\BibManager\includes\specials\SpecialBibManagerDelete.php" in der Funktion "formSubmit(...)" wird in Z.94 fälschlicherweise "bm_success_save-complete" verwendet. Da es kein Text-Element "bm_success_delete" gibt, muss es in den Dateien "\i18n\[en|de|de-formal].json" für "en", "de" und "de-formal" in der Zeile nach "bm_success_save-complete" ergänzt werden, damit es in der Datei "BibManagerDelete_body.php" verwendet werden kann.
 
Nach den Anpassungen ist die Delete-Datei als Kopie mit dem Suffix "SW" im Verzeichnis "specials" und das Verzeichnis "i18n" als Kopie "i18nSW" zu speichern.


*Dateien "QuestyCaptcha.php", "QuestyCaptcha.class.php" und "QuestyCaptcha.i18n.php" unter http://www.mediawiki.org/wiki/Extension:QuestyCaptcha herunterladen und unter "extensions\ConfirmEdit\" speichern.
*In der Datei "LocalSettings.php" nach "require_once( "$IP/extensions/ConfirmEdit/ConfirmEdit.php" );" einfügen:
<pre>
<pre>
##
//de.json Z.135f
## EXTENSIONS
  "bm_success_save-complete": "<div class=\"successbox\"><strong>Deine Daten wurden erfolgreich gespeichert!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
...
  "bm_success_delete": "<div class=\"successbox\"><strong>Die Daten wurden erfolgreich gelöscht!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
require_once( "$IP/extensions/ConfirmEdit/QuestyCaptcha.php" );
 
$wgCaptchaClass = "QuestyCaptcha";
//de-formal.json Z.135f
# Salzwiki
  "bm_success_save-complete": "<div class=\"successbox\"><strong>Ihre Daten wurden erfolgreich gespeichert!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
$wgCaptchaQuestions[] = array('question' => 'Welches Wort fehlt: "Eine Frage stellen, eine ... geben"?', 'answer' => '***' );
  "bm_success_delete": "<div class=\"successbox\"><strong>Die Daten wurden erfolgreich gelöscht!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
$wgCaptchaQuestions[] = array('question' => 'Um welche Art von Webseiteninhalt handelt es sich hier: Blog oder Wiki?', 'answer' => '***' );
 
$wgCaptchaQuestions[] = array('question' => 'Wie lautet der Name dieses Wikis?', 'answer' => $wgSitename );
//en.json Z.135f
$wgCaptchaQuestions[] = array('question' => 'Bitte das magische Wort - Salz - hier eingeben:', 'answer' => '***' );
  "bm_success_save-complete": "<div class=\"successbox\"><strong>Your data was successfully saved!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
$wgCaptchaQuestions[] = array('question' => 'Bitte das Spezialwort - 8Acht8 - hier eingeben:', 'answer' => '***' );
  "bm_success_delete": "<div class=\"successbox\"><strong>The data were successfully deleted!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
# Saltwiki
</pre>
$wgCaptchaQuestions[] = array('question' => 'Which is the language of this question: Dutch, English, French, German or Spanish?', 'answer' => '***' );
 
$wgCaptchaQuestions[] = array( 'question' => 'Please write the following word backwards: '.$wgSitename, 'answer' => strrev($wgSitename) ); #'ikiwtlaS'
<pre>
$wgCaptchaQuestions[] = array( 'question' => 'The taste of salt is neither bitter nor sweet nor sourish but &hellip;', 'answer' => '***' );
//SpecialBibManagerDelete.php Z.92ff
$wgCaptchaQuestions[] = array('question' => 'What is the missing word: "Ask a question, give an &hellip;"', 'answer' => ***'');
// für HAWK HHG geändert zu "delete"-Text statt "save-complete" 2016-02-15
$wgCaptchaQuestions[] = array('question' => 'What kind of web content is this: Blog or Wiki?', 'answer' => '***');
if ( $result === true ) {
$wgCaptchaQuestions[] = array( 'question' => 'What is this wiki\'s name (in capital letters)?', 'answer' => strtoupper($wgSitename) ); #'SALTWIKI'
  $wgOut->addHtml( wfMessage( 'bm_success_delete') ); #wfMsg( 'bm_success_save-complete') für HAWK HHG korrigiert 2016-02-08
# Repository
  ...
$wgCaptchaQuestions[] = array('question' => 'Which is the language of this question: Dutch, English, French, German or Spanish?', 'answer' => '***' );
}
$wgCaptchaQuestions[] = array( 'question' => 'Please write the following word backwards: '.$wgSitename, 'answer' => strrev($wgSitename) ); #'yrotisopeR'
</pre>
$wgCaptchaQuestions[] = array( 'question' => 'The taste of salt is neither bitter nor sweet nor sourish but &hellip;', 'answer' => '***' );
$wgCaptchaQuestions[] = array('question' => 'What is the missing word: "Ask a question, give an &hellip;"', 'answer' => ***'');
$wgCaptchaQuestions[] = array('question' => 'What kind of web content is this: Blog or Wiki?', 'answer' => '***');
$wgCaptchaQuestions[] = array( 'question' => 'What is this wiki\'s name (in capital letters)?', 'answer' => strtoupper($wgSitename) ); #'REPOSITORY'
#$wgCaptchaQuestions[] = array('question' => 'Please write the magic secret, "salt", here:', 'answer' => '***');
#$wgCaptchaQuestions[] = array('question' => 'Type the code word, 8eight8, here:', 'answer' => '***');


## Auslöser für Captcha-Aktivierung
Außerdem kann in der Datei "SpecialBibManagerDelete.php" wie in Z.94 die Funktion "wfMsg()" ersetzt werden durch "wfMessage()" in den Zeilen 24, 29, 35, 43, 54, 71.
# Salzwiki/Saltwiki
 
$wgCaptchaTriggers['edit']          = true;
===== Fehler im HTML-Code korrigieren =====
$wgCaptchaTriggers['create']        = true;
 
$wgCaptchaTriggers['addurl']        = true;
Bei der BibManager-Übesicht wird für jede Tabellenzeile ein <tr> statt eines </tr> erzeugt (auch schon in MW1.16). Im Verzeichnis "BibManager\includes\" in der Datei "bibManagerPagerList.php" in Zeile 133 den fehlenden Schrägstrich einfügen:
$wgCaptchaTriggers['createaccount'] = true;
<pre>
$wgCaptchaTriggers['badlogin']      = true;
  $tablerow[] = '</tr>'; // Schrägstrich für schließendes Tag eingefügt 2012-09-17 G. Werner
# Salzwiki/Saltwiki/Repository
$wgCaptchaTriggers['contactpage'] = true;
...
##
## EINSTELLUNGEN
...
## Salzwiki/Saltwiki
#captcha Hschwarz 12.02.2010
$wgGroupPermissions['*'            ]['skipcaptcha'] = false;
$wgGroupPermissions['user'        ]['skipcaptcha'] = false;
$wgGroupPermissions['autor'        ]['skipcaptcha'] = true;
$wgGroupPermissions['autoconfirmed']['skipcaptcha'] = false;
$wgGroupPermissions['bot'          ]['skipcaptcha'] = true; // registered bots
$wgGroupPermissions['sysop'        ]['skipcaptcha'] = true;
</pre>
</pre>


=== SpecialInterwiki ===
===== Fehlende Icons bei Verweisen rechts für "edit" und "delete" =====


Die Erweiterung wurde später in "Interwiki" umbenannt und ist in Mediawiki seit Version 1.21 enthalten.
In der BibManager-Übersicht sind rechts Text-Hyperlinks ohne Abstand für "edit" und "delete" anstatt Icons; es sind in folgenden Dateien Anpassungen vorzunehmen:
* "\extensions\BibManager\includes\BibManagerHooks.php"
* "\extensions\BibManager\resources\ext.bibManager.css"
* "\extensions\BibManager\includes\BibManagerPagerList.php"


Diese Erweiterung fügt die Seite Special:Interwiki zu Mediawiki hinzu, um die Interwiki-Tabelle sehen und editieren zu können. Es werden auch alle Änderungen aufgezeichnet.
Nach den Anpassungen ist jeweils eine Kopie der Datei mit dem Suffix "SW" zu speichern.
Mit dieser InterWiki Tabelle kann man einerseits einfach zu Inhalten in anderen Wikis verlinken, auch zu Wikipedia, andererseits ist es damit möglich durch das Setzen von  $wgEnableScaryTranscluding = true;  Inhalte eines anderen Wikis zu "transcludieren".


Die Erweiterung für MW 1.23 wird bei http://www.mediawiki.org/wiki/Extension:Interwiki heruntergeladen und in ...Extensions/Interwiki extrahiert.
Bei "BibManagerHooks.php" ist in Funktion "onBeforePageDisplay(...)" am Anfang, vor Zeile 29 (Eindbindung der JS-Module), die Einbindung der css-Datei einzufügen:
<pre>
  // für HAWK HHG eingefügt 2016-02-12
  $out->addModuleStyles( 'ext.bibManager.styles' );
</pre>


In die "localsettings" eines jeden Wiki's ist dann einzufügen:
Bei "ext.bibManager.css" in Zeile 96 einen Kommentar einfügen und zwischen "width: 16px;" und "text-indent: 9999px;", Z.99f, eine neue Zeile "height: 15px;" einfügen
 
##to allow interwiki-linking, für Version MW 1.23 anderer Dateiname
#require_once("$IP/extensions/Interwiki/SpecialInterwiki.php");
require_once("$IP/extensions/Interwiki/Interwiki.php");
$wgGroupPermissions['*']['interwiki'] = false;
$wgGroupPermissions['sysop']['interwiki'] = true; ## nur sysops können die InterWiki Tabelle ändern und sehen
$wgEnableScaryTranscluding = true;                ## Seiten von anderen Wikis können eingebunden werden
 
 
Diese Erweiterung wurde in SalzWiki, SaltWiki und im Repositorium installiert.
 
=== Terminology ===
 
Diese Erweiterung wird seit 2010-07-29 nicht mehr weiterentwickelt. Sie gilt als ineffizient bei umfangreichen Glossars. Es wird die Erweiterung "Lingo" empfohlen: http://www.mediawiki.org/wiki/Extension:Lingo.
 
Die Extension dient zum Erstellen eines Glossars.
<br>Um Verwirrungen zu vermeiden wurde bei "Terminology" in der Datei "terminology.php" in den Zeilen 29 und 51 der Name der Wiki-Seite, in der alles gespeichert wird, von "Terminology" in "Glossar" bzw. für SaltWiki in "Glossary" umbenannt (nur in SalzWiki/SaltWiki, nicht im Repositorium):
*Z. 31
<pre>
<pre>
$wgExtensionCredits['parserhook'][] = array(
/* für HAWK HHG wg. nicht sichtbarer Icons, die bei BibManager v1 ohne "overflow:hidden" sehr weit rechts waren, geändert 2016-02-15 */
  'name' => 'Glossar', //in Glossar umbenannt HJSChwarz 12.08.2010
#bm_table a.icon {
</pre>
  ...
*Z. 53
  height: 15 px; /*text-indent: 9999px;*/
<pre>
  ...
$rev = Revision::newFromTitle(Title::makeTitle(null, 'Glossar')); //in Glossar umbenannt HJSChwarz 12.08.2010
}
</pre>
</pre>


* Extension unter http://www.mediawiki.org/wiki/Extension:Terminology herunterladen.
Bei "BibManagerPagerList.php" in Funktion "formatRow(...)" in den Zeilen 104, 108, 117 und 120 die "wfMsg"-Funktionen ersetzen durch "wfMessage"-Funktionen:
* Datei in das Verzeichnis "extensions" kopieren
* In der Datei "LocalSettings.php" einfügen:
<pre>require_once("$IP/extensions/terminology.php");</pre>
 
 
=== TimedMediaHandler ===
 
Die Erweiterung steht ab Mediawiki 1.17 zur Verfügung und benötigt die Erweiterung "MwEmbedSupport". Sie beinhaltet den "Kaltura HTML5 Player". Unterstützt werden Streaming, WebM und Ogg sowie getID3.
 
* Extensions unter https://www.mediawiki.org/wiki/Extension:MwEmbedSupport und https://www.mediawiki.org/wiki/Extension:TimedMediaHandler herunterladen.
* Dateien in das Verzeichnis "extensions" kopieren
* In der Datei "LocalSettings.php" registrieren:
<pre>
<pre>
require_once("$IP/extensions/MwEmbedSupport/MwEmbedSupport.php");
if ($wgUser->isAllowed('bibmanageredit')){
require_once("$IP/extensions/TimedMediaHandler/TimedMediaHandler.php");
  // für HAWK HHG "wfMsg()" zu "wfMessage()" geändert 2016-02-15
  $editLink = Linker::link(
    SpecialPage::getTitleFor( 'BibManagerEdit' ),
    wfMessage( 'bm_list_table_edit' ), /*wfMsg( 'bm_list_table_edit' )*/
    array (
      'class' => 'icon edit',
      'title' => wfMessage( 'bm_list_table_edit' ) /*wfMsg( 'bm_list_table_edit' )*/
    ),
    $specialPageQuery
  );
}
 
if ($wgUser->isAllowed('bibmanagerdelete')){
  $deleteLink = Linker::link(
    SpecialPage::getTitleFor( 'BibManagerDelete' ),
    wfMessage( 'bm_list_table_delete' ),
    array (
      ...
    ),
    $specialPageQuery
  );
}
</pre>
</pre>


=== User Merge - Benutzername löschen ===


Das Löschen von benutzernamen, die nicht mehr benötigt werden, geschieht durch das Zusammenführen des zu löschenden Benuztzernamens mit dem Benutzername "Testuser" zu "Testuser" mit Hilfe der Extension UserMerge.  
===== Fehlendes Icon "Link zum Volltext" bei Detailseite =====
 
Auf der Detailseite eines Bibliographieeintrags wird rechts statt des Icons der Alternativtext "Link zum Volltext" bzw. "Fulltext link" angezeigt; es ist folgende Datei anzupassen:
* "\extensions\SaltWiki\SaltWiki.php"


* Extension unter http://www.mediawiki.org/wiki/Extension:User_Merge_and_Delete herunterladen.
Nach den Anpassungen ist jeweils eine Kopie der Datei mit dem Suffix "_SW" zu speichern.
* Datei in das Verzeichnis extensions/UserMerge kopieren
* In den Localsettings eingefügen


Bei "SaltWiki.php" ist in der Funktion "sw_onBibManagerGetIcons(...)" vor Zeile 160 ein Kommentar einzufügen und in Zeile 161 der Pfad von "client" zu "resources" anzupassen:
<pre>
<pre>
require_once( "$IP/extensions/UserMerge/UserMerge.php" );
function sw_onBibManagerGetIcons ( $entry, &$icons) {
# Assign the usermerge right to a usergroup, i.e. to the bureaucrats:
...
$wgGroupPermissions['bureaucrat']['usermerge'] = true;
// für HAWK HHG und MW1.23LTS Pfad von "client" zu "resources" angepasst 2016-06-14
$icons['fulltext'] = array (
  'src' = $wgScriptPath . '/extensions/BibManager/resources/images/' . $icon,
  ...
);
...
}
</pre>
</pre>


=== WhosOnline - Wer ist online ===
===== In BibManager v1.1.0 Fehler bei SpecialPageAliases =====


Die Extension WhosOnline dient dazu sich auf einer Specialpage anzeigen zu lassen, wer gerade online ist.
In der Datei "BibManager.alias.php" müssen die Array-Schlüssel von $specialPageAliases wie z. B. 'BibManagerCreate' für die jeweilige Sprache in Kleinbuchstaben angegeben werden, damit die BibManager-Seiten bei den Spezialseiten aufgelistet werden, allerdings werden die Seiten dann nicht mehr gefunden, wenn man auf die Verweise klickt.


Für MediaWiki 1.23 ist im Herbst 2015 als älteste Version nur eine "REL1_25", also Version 1.4.0 für MW 1.25 erhältlich, die einen Script-Fehler verursacht, wenn in der Datei "WhosOnlineSpecialPage.php" bei der Funktion "getNavigationBar()" die Variable "$title" vom Typ String statt Objekt ist; zur Fehlerbehebung siehe weiter unten und https://www.mediawiki.org/wiki/Extension_talk:WhosOnline#Bug_in_MW_1.24_.3F
Einzige Lösung scheint zu sein, in der Datei "BibManager.php" die Zeile 66 auszukommentieren:
 
Bei MediaWiki 1.25 verursacht die Version 1.5.0 einen Fehler, wenn die Datei "upgrade.php" verwendet wird, weil die Datei "extension.json" in der Erweiterung fehlt; siehe https://www.mediawiki.org/wiki/Extension_talk:WhosOnline#Fatal_error_running_update.php_on_V1.5.0. Es muss deshalb in der Datei "LocalSettings.php" wie bei älteren Versionen "require_once ..." statt "wfLoadExtension(...)" verwendet werden.
 
*Dateien unter http://www.mediawiki.org/wiki/Extension:WhosOnline herunterladen und extrahieren
*Verzeichnis "WhosOnline" unter "Extensions" speichern
*Für MediaWiki 1.23 in der Datei "WhosOnlineSpecialPage.php" die Funktion "getNavigationBar()" anpassen
*SQL-Befehl in der Extension-Datei "WhosOnline.sql" für neue Datenbank-Tabelle anpassen (siehe weiter unten)
*Mit "phpMyAdmin" und geändertem SQL-Befehl eine neue Datenbank-Tabelle erstellen (siehe weiter unten)
*In der Datei "LocalSettings.php" einfügen:
<pre>
<pre>
require_once("$IP/extensions/WhosOnline/WhosOnline.php");
#$wgExtensionMessagesFiles['BibManagerAlias'] = $dir . 'BibManager.alias.php'; // Fehlfunktion in MW 1.23
$wgWhosOnlineShowAnons = true;
</pre>
</pre>


'''Datei "WhosOnlineSpecialPage.php" für MW 1.23 anpassen'''
===== In BibManager v1.1.0 fehlerhafte Funktionen auskommentieren bzw. ändern =====
 
BibManager v1.1.0 (REL1.23) verwendet in mehreren Dateien die Funktion "wfLoadExtensionMessages()", die seit MW 1.21 nicht mehr existiert, so dass die Zeile in folgenden Dateien auskommentiert werden muss:
*"\specialpages\BibManagerCreate_body.php" in Zeile 7
*"\specialpages\BibManagerEdit_body.php" in Zeile 7
*"\specialpages\BibManagerDelete_body.php" in Zeile 7
*"\specialpages\BibManagerList_body.php" in Zeile 7
*"\specialpages\BibManagerListAuthors_body.php" in Zeile 7


Die Funktion "getNavigationBar()" ab Zeile 75 kopieren, auskommentieren und die Kopie darunter einfügen.
BibManager v1.1.0 (REL1.23) verwendet in der Datei "\specialpages\BibManagerList_body.php" in den Zeilen 25 und 29 die Methode "SpecialPageFactory::getPage('...')->getDescription()", die einen Fehler "Call to a member function getDescription() on null" verursacht, weil "getPage('...') als Ergebnis NULL hat und "getDescription()" nicht darauf angewendet werden kann. Ursache ist der Name bei "getPage('...')", der mit dem Alias ersetzt werden muss. Der Alias der Sprachvarianten befindet sich in der Datei "\BibManager\BibManager.alias.php". Um den Alias für "getPage('...')" zu erhalten, wird die Methode "SpecialPageFactory::getLocalNameFor('...')" benötigt:
In der Kopie die Variable $wgLang als Ersatz für $wgContLang und die entsprechenden Variablen für die return-Funktion hinzufügen:
<pre>
<pre>
function getNavigationBar(){
// $linkDescription eingefügt und $createLink angepasst 2015-12-01 G. Werner für HAWK HHG
  global $wgContLang, $wgLang;
$linkDescription = array();
  $link = $wgContLang->specialpage('WhosOnline');
if(SpecialPageFactory::getPage(SpecialPageFactory::getLocalNameFor('BibManagerCreate'))===NULL){
  if(is_object($link)){
  $linkDescription['Create'] = NULL;
    $title = $link;
}
  }
else{
  else{
  $linkDescription['Create'] = SpecialPageFactory::getPage(SpecialPageFactory::getLocalNameFor('BibManagerCreate'))->getDescription();
    $title = Title::newFromText($link);
}
    if(is_null($title)){
if(SpecialPageFactory::getPage(SpecialPageFactory::getLocalNameFor('BibManagerImport'))===NULL){
      return false;
   $linkDescription['Import'] = NULL;
    }
}
  }
else{
   $offset = $this->mOffset;
   $linkDescription['Import'] = SpecialPageFactory::getPage(SpecialPageFactory::getLocalNameFor('BibManagerImport'))->getDescription();
  $limit = $this->mLimit;
   $query = '';
  $query = wfCgiToArray('');
  $atend = $this->countUsersOnline() < ($this->mLimit + $this->mOffset); // show next link
 
  return $wgLang->viewPrevNext(
    $title,
    $offset,
    $limit,
    $query,
    $atend
  );
}
}
</pre>
$createLink = Linker::link(
 
  SpecialPage::getTitleFor('BibManagerCreate'),
'''Datei "WhosOnline.sql" anpassen'''
  /*SpecialPageFactory::getPage('BibManagerCreate')->getDescription()*/
 
  $linkDescription['Create']
Den SQL-Befehl in der Extension-Datei "WhosOnline.sql" für die neue Datenbank-Tabelle in der ersten Zeile z. B. wie folgt mit Präfix "sw_" bzw. "sr_" anpassen:
);
<pre>CREATE TABLE `[datenbankname]`.`[praefix]online` (</pre>
$importLink = Linker::link(
  SpecialPage::getTitleFor('BibManagerImport'),
  /*SpecialPageFactory::getPage('BibManagerImport')->getDescription()*/
  $linkDescription['BibManagerImport']
);
</pre>
 
===== In BibManager v1.1.0 Fehler bei neuem Eintrag und Eintragsbearbeitung =====


'''Datenbank-Tabelle erstellen'''
Der Fehler bei einem Neueintrag in BibManager v1.1.0 REL1.23 2015-06-16 resultiert aus der Weiterleitung zur Datei für Bearbeitungen "specialpages\BibManagerEdit_body.php".


Mit "phpMyAdmin" die MySQL-Datenbank für das Wiki auswählen und nach Auswahl des Karteikartenreiters/Tabs "SQL" die Tabelle "sw_online" bzw. "sr_online" durch Eingabe des folgenden SQL-Statements anlegen:
In der Datei "specialpages\BibManagerCreate_body.php" kann in der Funktion "execute()" das Array "$formDescriptor" zwischen "id" und "options" um die Angabe eines Namens ergänzt werden, damit das Formularfeld "bm_select_type" nicht "wpbm_select_type" heißt:
<pre>
<pre>
CREATE TABLE  `[datenbankname]`.`[praefix]online`  (
//Z.26ff
`userid` int(5) NOT NULL default '0',
$formDescriptor = array (
`username` varchar(255) NOT NULL default '',
  'bm_select_type' => array (
`timestamp` char(14) NOT NULL default '',
    'class' => 'HTMLSelectField',
PRIMARY KEY USING HASH (`userid`, `username`),
    ...
INDEX USING BTREE (`timestamp`)
    'id' => '',
) TYPE=MEMORY;
    'name' => 'bm_select_type',
    'options' => ...
  )
)
</pre>
</pre>


== Eingabe von Formeln mittels Tex (Wiki-Code) ==
==== BibManager-Berechtigungen ====
 
'''Rechte-Vergabe für BibManager'''


Damit mathematische und auch chemische Formeln dargestellt werden können, wird in Mediawiki "Texvc" benutzt. Hierfür muss folgende Software installiert werden (siehe auch https://www.mediawiki.org/wiki/Texvc#Windows):
In der Datei "LocalSettings.php" werden zwischen "include_once(...)" und dem Array für die Zitierweise folgende Berechtigungen definiert, wobei im deutschen Salzwiki "Redakteur" statt "Editor" anzugeben ist:
# Windows Server 2012R2
 
## GPL GhostScript 9.10 (gs910w32.exe, 2013-09-02)
## Berechtigungen eingefügt 2012-05-11
## ImageMagick 6.9.3-8-Q16-x86-dll.exe (16Bit dynamic, nicht static)
$wgGroupPermissions['*']['bibmanagercreate'] = false;
## MikTeX 2.9.5870 Net Installer 32Bit (complete, nicht basic)
$wgGroupPermissions['*']['bibmanageredit'] = false;
# Windows Server 2008
$wgGroupPermissions['*']['bibmanagerdelete'] = false;
## GPL GhostScript 8.70 (gs870w32.exe)
$wgGroupPermissions['autor']['bibmanagercreate'] = true;
## ImageMagick 6.5.9-0-Q16-windows-dll.exe (16Bit dynamic, nicht static)
$wgGroupPermissions['autor']['bibmanageredit'] = true;
## MikTeX 2.8 Net Installer 32Bit (complete, nicht basic)
#$wgGroupPermissions['autor']['bibmanagerdelete'] = false;
   
$wgGroupPermissions['Redakteur|Editor']['bibmanagercreate'] = true;
'''Nach jedem mediawiki-Update muss die Erweiterung "Math" mit den Dateien "Math.php" und "MathRenderer.php" auf Windows-Kompatibilität überprüft werden!'''
$wgGroupPermissions['Redakteur|Editor']['bibmanageredit'] = true;
$wgGroupPermissions['Redakteur|Editor']['bibmanagerdelete'] = true;
$wgGroupPermissions['sysop']['bibmanagercreate'] = true;
$wgGroupPermissions['sysop']['bibmanageredit'] = true;
  $wgGroupPermissions['sysop']['bibmanagerdelete'] = true;
 
'''Entfernen der Löschen- und Editier-Buttons ohne Rechte-Vergabe'''


Die '''[[#Tats.C3.A4chliche_Installation|tatsächliche Installation ]]''' eines Tex-Systems erfolgt in Anlehnung an die [[#Alternative_Installationsmethode_gem.C3.A4.C3.9F_Mediawiki|alternative Methode]] auf der Mediawiki Seite
Das Entfernen der Schaltflächen funktionierte bis April 2012 auf nachfolgend beschriebene Weise, solange es noch kein Rechte-Management für den BibManager gab.
http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Windows#Alternative_Solution.  


=== Tatsächliche Installation ===
In der Datei BibManager/includes/BibManagerPagerList.php werden in den Zeilen 57ff dazu die Variablen "$editLink" und "$deleteLink" entfernt.


Die Applikationen als Administrator für alle User im Verzeichnis "D:\texmf\" installieren:  
Mit ein wenig PHP-Kenntnissen kann man auch die Anzeige des Links schaltbar machen:


# GhostScript im Unterverzeichnis "ghostscript\" installieren
  $tablerow = array ( );
## aus dem Unterverzeichnis "bin\" die Datei "gswin32c.exe" kopieren und die Kopie umbenennen zu "gs.exe"
  $tablerow[] = '<tr>';
## In der Systemsteuerung unter "Erweiterte Systemeinstellungen => Erweitert => Umgebungsvariablen" die Systemvariable "Path" erweitern mit ";D:\texmf\ghostscript\bin\"
  $tablerow[] = '  <td style="vertical-align:top;">' . $citationLink . '</td>';
# ImageMagick im Unterverzeichnis "imagick\" installieren
  $tablerow[] = '  <td>' . $format . '</td>';
## ImageMagick dll-Datei (bei vorhandener Windows-Server-Konfigurationsberechtigung), sonst static-Datei (nur XAMPP-Zugriffsberechtigungen), inkl. "Create a desktop icon", "Add application directory to your system path" und "Install developement headers and libraries for C and C++"
  #$tablerow[] = '  <td style="text-align:center;">' . $editLink . $deleteLink . '</td>';
## Testen mit der "Eingabeaufforderung/Konsole"
  if($_REQUEST['showDelete'] == 1){$tablerow[] = '  <td style="text-align:center;">' . $editLink . $deleteLink . '</td>';}
##* bei Windows Server 2012R2 durch Eingabe von
  else{$tablerow[] = '  <td style="text-align:center;">' . $editLink . '</td>';}
##*# convert wizard: wizard.jpg [=&gt;Enter drücken]
  $tablerow[] = '  <td style="text-align:center;">' . $exportLink . '</td>';
##*# convert wizard.jpg win: [=&gt;Enter drücken]
  $tablerow[] = '<tr>';
##*# =&gt; ein Bild soll angezeigt werden, Fenstertitel "IMDisplay - wizard.jpg"
 
##* bei Windows Server 2008 durch Eingabe von
So würde der Link nur angezeigt werden, wenn in der Url "&showDelete=1" vorkommt.
##*# convert logo: logo.miff [=&gt;Enter drücken]
 
##*# imdisplay logo.miff [=&gt;Enter drücken]
Wenn die Löschen-Funktion vollständig deaktiviert und nicht nur den Link versteckt werden soll, müssen in der Datei BibManager/BibManager.php folgende Zeilen auskommentiert werden:
##*# =&gt; ein Bild soll angezeigt werden
 
## PHP-Erweiterung für ImageMagick
  $wgAutoloadClasses['BibManagerDelete'] = $dir . 'specialpages/BibManagerDelete_body.php';  
##* Für PHP 5.6.14 "php_imagick-3.4.1-5.6-ts-vc11-x86.zip" von http://windows.php.net/downloads/pecl/releases/imagick/ oder alternativ die Datei "php_imagick-3.2.0RC1-5.6-ts-vc11-x86.zip" von http://www.peewit.fr/imagick/ herunterladen und die VC11-kompilierte ThreadSafe-Datei Datei "php_imagick.dll" in das PHP-Unterverzeichnis "ext/" kopieren
  $wgSpecialPages['BibManagerDelete'] = 'BibManagerDelete';
##* Für PHP 5.6.14 in der Datei "php.ini" im Bereich Windows Extensions die Datei "php_imagick.dll" einbinden:<br/>extension=php_imagick.dll
 
##* <del>Für PHP 5.2.9 die VC6-kompilierte Datei "php_imagick_dyn-Q16.dll" von [http://valokuva.org/outside-blog-content/imagick-windows-builds/080709/ valukova.org] herunterladen und in das PHP-Unterverzeichnis "ext/" kopieren und umbenennen zu "php_imagick_dyn_Q16.dll" (Unterstrich statt Bindestrich)</del>
==== Anleitung anpassen und installieren ====
##* <del>Für PHP 5.2.9 in der Datei "php.ini" im Bereich Windows Extensions die Datei "php_imagick_dyn_Q16.dll" einbinden:<br/>extension=php_imagick_dyn_Q16.dll</del>
 
# MiKTeX Installation
Die von halloWelt! gelieferte Datei "manual.xml" enthält alle 4 Anleitungen: Benutzerhandbuch, User manual, Administrationshandbuch und Admin manual, die jeweils durch die <page>-Elemente gegliedert sind.
## Für Sophos-Ausnahme im Verzeichnis "D:\texmf\" ein Unterverzeichnis "miktex\" erstellen
 
## Für Sophos-Antivirus eine Ausnahme festlegen:
* Für das SalzWiki ist nur der <page>-Bereich "BibManager:Benutzerhandbuch" für den Import relevant, so dass eine Kopie der Datei unter "bibmanager_manual_user_de.xml" gespeichert wird und in dieser Datei die 3 anderen <page>-Bereiche entfernt werden.
##: Konfigurieren => Antivirus => On--Access-Scans => Ausschlüsse => Hinzufügen => Ordner => D:\texmf\miktex\
* Für das SaltWiki und das Repositorium ist jeweils nur der <page>-Bereich "BibManager:User manual" für den Import relevant, so dass eine Kopie der Datei unter "bibmanager_manual_user_en.xml" gespeichert wird und in dieser Datei die 3 anderen <page>-Bereiche entfernt werden.
## MikTeX herunterladen – kann bis zu einer Stunde dauern! – und installieren
* Der Bilder-Import für das Handbuch findet nur im Repositorium statt.
### Zum Herunterladen der Installationsdateien die Datei "MiKTeX_NetInstall_Complete_2.9.5870_setup.exe" ausführen
 
###* "Download MiKTeX" statt "Install MiKTeX"
==== Anleitung anpassen ====
###* "Complete MiKTeX" statt "Basic MiKTeX"
Im <title>-Element nach <page> ist jeweils "HalloWelt:" vor "BibManager:..." zu entfernen:
###* Zielverzeichnis "D:\Install\MiKTeX_2.9_complete\"
<pre>
### Die Datei "MiKTeX_NetInstall_Complete_2.9.5870_setup.exe" für Installation im Verzeichnis "D:\texfm\miktex\" ausführen mit
<page>
###* "Install MiKTeX" statt "Download MiKTeX"
<title>HalloWelt:BibManager:...</title>
###* "Complete MiKTeX" statt "Basic MiKTeX"
</pre>
###* "Anyone who uses this computer (all users)" statt "Only for: [Useraccount (Username)]"
Ebenso ist der Teil "Project:" vor "BibManager:..." in den Admin-Anleitungen am Ende des <text>-Elementes zu entfernen:
###* "Preferred paper: A4", "Install missing packags on-the-fly: Yes"
<pre>
# <del>Im Verzeichnis "includes\" des Wikis die Datei "Math.php" umbenennen in "Math_original.php" und ersetzen durch eine neue Datei "Math.php" mit Code von [http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Windows/math.php www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Windows/math.php]; danach von der neuen Datei "Math.php" für MediaWiki-Updates eine Sicherungskopie speichern als "Math_sw.php".</del> Im Verzeichnis "extensions\Math\" des Wikis die Dateien "Math.php" und "MathRenderer.php" umbenennen in "Math_original.php" und "MathRenderer_original.php"; davon Kopien "Math.php" und "MathRenderer.php" erstellen
  [[Project:BibManager:...]]
## "Math.php" Z.191 ...
  [[Project:BibManager:...]]</text>
## "MathRenderer.php" Z.123 ...
  </revision>
#In der Datei "LocalSettings.php" ist jeweils einzufügen:  
</page>
</pre>
 
==== Anleitung im Wiki installieren ====
 
* Die angepasste xml-Datei über "Spezialseiten->Import" ins Wiki laden.
* Anschließend sind die Bilder für das [[Project:BibManager:...]] im Repositorium mittels DOS-Konsole und PHP hochzuladen, um sie ins Wiki zu bringen:
<pre>
<pre>
  $wgUseTeX = true;
D:\
  # ImageMagick
xampp\php\php.exe xampp\htdocs\saltwiki\maintenance\importImages.php xampp\htdocs\saltwiki\images_en
$wgImageMagickConvertCommand = 'D:\texmf\imagick\convert.exe';<br>  
</pre>
  $wgImageMagickIdentifyCommand = 'D:\texmf\imagick\identify.exe';<br>
 
  # Tex
=== CategoryTree ===
 
Die Extension dient zur Darstellung der Kategorienbäzme, damit schnell den Artikeln und Dokumenten die richtigen Kategorien zugewiesen werden können.
 
* Extension unter http://www.mediawiki.org/wiki/Categorytree herunterladen und in den Extensionsordner kopieren.
* In den Localsettinge eingefügen.
 
<pre>
$wgUseAjax = true; ##muss von false auf true geändert werden, falls noch nicht geschehen
require_once("{$IP}/extensions/CategoryTree/CategoryTree.php");
</pre>
 
=== CharacterEscapes, LOParserFunctions, ControlStructureFunctions  ===
 
Notwendig für #if: und #switch-Anweisungen (z. B. beim Einsetzen des Seitentitels im Kopf von Vorlage:Infobox_Salz und bei den Hilfe-Seiten.
"ControlStructureFunctions" soll laut "mediawiki.org" nur bis Version 1.12 erforderlich und danach im Wiki-Code integriert sein, was aber scheinbar nicht zutrifft.<br>
Alternativ zu "LOParserFunctions" und "ControlStructureFunctions" kann möglicherweise auch die Erweiterung "ParserFunctions" (http://www.mediawiki.org/wiki/Help:ParserFunctions) in Kombination mit der Erweiterung "Loop" (http://www.mediawiki.org/wiki/Help:Loop) verwendet werden, wobei Folgendes zu berücksichtigen ist:
<pre>
Don't These Parser Functions Already Exist?
Yes and no. The ParserFunctions extension has
#if, #ifeq, #ifexpr, #switch, and #ifexist,
and Loop Functions extension has
#for and #foreach.
The limitation of all those parser functions is
that wiki markup is parsed before any parameters are passed to the underlying function.
These functions bypass that limitation through character escapes (see below),
and allow wiki markup to be parsed after the parameters have been passed.
</pre>
 
*Extensions unter http://www.mediawiki.org/wiki/Extension:Character_Escapes, http://www.mediawiki.org/wiki/Extension:LO_Parser_Functions und http://www.mediawiki.org/wiki/Extension:Control_Structure_Functions/ControlStructureFunctions.php herunterladen und in den Ordner "extensions" kopieren.
**'''Extension CharacterEscapes'''
***Im Verzeichnis "extensions" ein Unterverzeichnis "CharacterEscapes" und darin eine Datei "CharacterEscapes.php" anlegen.
***In der Datei das Quelltext-Beispiel von http://www.mediawiki.org/wiki/Extension:Character_Escapes einfügen.
**'''LOParserFunctions'''
***Im Verzeichnis "extensions" ein Unterverzeichnis "LOParserFunctions" und darin eine Datei "LOParserFunctions.php" und eine Datei "LOParserFunctions.i18n.php" anlegen.
***In den Dateien die Quelltext-Beispiele von http://www.mediawiki.org/wiki/Extension:LO_Parser_Functions einfügen und jeweils die fehlenden php-Tags "?>" am Ende ergänzen.
***In das Verzeichnis die Datei "expr.php" von http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/ParserFunctions/Expr.php?revision=25357 kopieren
**'''Extension ControlStructureFunctions'''
***Im Verzeichnis "extensions" ein Unterverzeichnis "ControlStructureFunctions" und darin eine Datei "ControlStructureFunctions.php" und eine Datei "ControlStructureFunctions.i18n.php" anlegen.
***In den Dateien die Quelltext-Beispiele von "http://www.mediawiki.org/wiki/Extension:Control_Structure_Functions" einfügen und jeweils die fehlenden php-Tags "?>" am Ende ergänzen.
 
*Erweiterungen in Datei "LocalSettings.php" eingefügen.
<pre>##Extension CharacterEscapes fuer Helppages
require_once("extensions/CharacterEscapes/CharacterEscapes.php");
 
##Extension LOParserFunctions  fuer Helppages
require_once( "extensions/LOParserFunctions/LOParserFunctions.php" );
 
##Extension  ControlStructureFunctions fuer Helppages
# require_once( "extensions/ControlStructureFunctions/ControlStructureFunctions.php" );
</pre>
 
=== CharInsert ===
 
Diese Extension dient dazu Editierhilfen zum Einfügen von Spezialzeichen und Formatierungshilfen zur Verfügung zu stellen.Diese Hilfe wird im Bearbeitungsmodus und beim UpLoad-Formular zur Verfügung gestellt. Diese Erweiterung wurde Testweise installiert und dann wieder deaktiviert.
 
Die Extension wird bei http://www.mediawiki.org/wiki/Extension:CharInsert heruntergeladen und in ...Extensions/CharInsert extrahiert.
 
In die localsettings ist einzufügen:
 
require_once("$IP/extensions/CharInsert/CharInsert.php");
 
In Mediawiki:Edittools werden die entsprechenden Zeichen bzw. Hilfen mit
<pre><charinsert> .. </charinsert> </pre>
 
eingefügt.
 
=== Cite ===
 
Die Erweiterung "Cite" dient zum Erstellen von Fußnoten in Wiki-Artikeln.
 
* Erweiterung unter http://www.mediawiki.org/wiki/Cite herunterladen.
* Extrahieren der Dateien nach "\[wikiname]\extensions\Cite\"
* Erweiterung in der Datei "LocalSettings.php" einfügen
 
<pre>
require_once("$IP/extensions/Cite/Cite.php");
</pre>
 
Siehe näheres zum Einfügen von Fußnoten unter http://193.175.110.91/salzwiki/index.php/Autor#Fu.C3.9Fnoten.
 
=== CiteThisPage ===
 
Die Erweiterung "CiteThisPage" dient zum Erstellen von Zitierhilfen für Wiki-Artikel. Sie ist erst ab MW Version 1.24 einsetzbar.
 
* Erweiterung unter https://www.mediawiki.org/wiki/Extension:CiteThisPage?uselang=de herunterladen.
* Extrahieren der Dateien nach "\[wikiname]\extensions\CiteThisPage\"
* Erweiterung in der Datei "LocalSettings.php" einfügen
 
<pre>
require_once("$IP/extensions/CiteThisPage/CiteThisPage.php");
</pre>
 
=== ConfirmEdit ===
 
Registrierte Nutzer dürfen auf die Diskussionseiten schreiben. Damit dies etwas sicherer vonstatten geht, wird mit ConfirmEdit ein Captcha eingeführt ('''bisher nur bei Salzwiki und Saltwiki, nicht bei Repositorium''').
 
*Dateien unter http://www.mediawiki.org/wiki/Confirmedit herunterladen und unter "extensions\ConfirmEdit\" speichern.
*In der Datei "LocalSettings.php" einfügen:
<pre>
require_once( "$IP/extensions/ConfirmEdit/ConfirmEdit.php" );
</pre>
 
=== ContactPage - Kontaktseite (Wiki-Code de-Formal) ===
 
Für Mitteilungen allgemeiner Art wird eine Kontaktformular-Seite eingesetzt, die im Repositorium nur nach Anmeldung zur Verfügung steht. Bei Versand einer Kopie an eine im Formular eingetragene E-Mail-Adresse steht im Betreff: "Kopie Ihrer Nachricht an Hornemann (von [Ihr Name])"
 
Für das Kontaktformular muss als Empfangsadresse ein bestehendes Wiki-Konto angegeben werden und muss als E-Mail-Absender wegen Authentifizierung beim Versand die Angabe von $wgPasswordSender übernommen werden:
<pre>$wgContactConfig['default'] = array(
'RecipientUser' => 'Hornemann', //'WikiUser' // Must be a valid account //vormals $wgContactUser
...
'SenderEmail' => null, // Defaults to $wgPasswordSender, may be changed as required
...);
</pre>
Im jeweiligen Wiki-Konto "Hornemann" wird als E-Mail-Adresse "service@salzwiki.de" bzw. "service@saltwiki.net" angegeben. Es kann auch "salzwiki.fb@hawk-hhg.de" bzw. "saltwiki.fb@hawk-hhg.de" angegeben werden.
 
Für das Formular wird die Erweiterung "ContactPage" benutzt. Die Sie-Form der Wiki-Übersetzungsdatei ist um einen Eintrag zu ergänzen.
 
Das Absenden des Kontaktformulars wird bei Nutzung ohne Anmeldung zum Verhindern von Spam über ein Captcha abgesichert. Hierfür sind bei der Erweiterung für MW 1.23 (REL1_23) Anpassungen am Code der Dateien "ContactPage_body.php", "\i18n\de.json" und "\i18n\en.json" sowie "\i18n\qqq.json" erforderlich.
 
*Dateien unter http://www.mediawiki.org/wiki/Extension:ContactPage bzw. <b>für MW 1.23</b> unter https://git.wikimedia.org/zip/?r=mediawiki/extensions/ContactPage&h=daa666dec4793a2ce9675dbb8b6c365d105e8986&format=zip herunterladen und die Dateien unter "Extensions/ContactPage" speichern.
*Für MediaWiki 1.23 in den Übersetzungsdateien "de.json", "en.json" und "qqq.json" Zeilen einfügen (siehe weiter unten)
*In der Wiki-Systemtexte-Datei vor "'emailccsubject '=> '...'" das Array-Element "'emailccme' => 'Sende eine Kopie der E-Mail an mich'," einfügen und an Sie-Form anpassen: "Eine Kopie der E-Mail an mich senden"
**Für MediaWiki 1.23 im Verzeichnis "[wikiverzeichnis]\languages\i18n\" aus der Datei "de.json" aus Zeile 1759 in Datei "de-formal.json" in Zeile 217 einfügen
*Erweiterung mit Variablenzuweisungen in der Datei "LocalSettings.php" einfügen
 
ACHTUNG: Nach jedem mediawiki-Update muss überprüft werden, ob die vorgenommene Änderung in den Sprachdateien noch existiert. Deshalb ist von den Dateien jeweils eine Kopie "...SW.json" bzw. "...SW.php" zu speichern:
* MW1.23
** "[wikiverzeichnis]\languages\i18n\de.json"
** "...\extensions\ContactPage\i18n\de.json", "...de-formal.json", "...en.json" und "...qqq.json"
 
==== MW 1.23 Code-Anpassungen ====
 
Zur Code-Anpassung siehe auch https://gerrit.wikimedia.org/r/#/c/156052/
 
In der Datei "\extensions\ContactPage\i18n\qqq.json" Ergänzung bei "authors" hinter "Shirayuki" sowie in Zeile 25 am Ende ein Komma und darunter  eine Zeile für "contactpage-captcha-error" einfügen:
<pre>
{
  "metadata": {
    "authors": [
      ...
      "Shirayuki",
      "Gunnar Werner HAWK HHG"
    ]
  },
  ...
  "contactpage-usermailererror": "...",
  "contactpage-captcha-error": "Error message displayed when ehter was a CAPTCHA error (i.e. the user failed to enter the correct CAPTCHA, or didn't enter one at all, etc.)"
}
</pre>
 
In der Datei "\extensions\ContactPage\i18n\en.json" Ergänzung bei "authors" hinter "Reedy" sowie in Zeile 20 am Ende ein Komma einfügen und darunter eine Zeile für "contactpage-captcha-error" einfügen:
<pre>
{
  "metadata": {
    "authors": [
      ...
      "Umherirrender",
      "Gunnar Werner HAWK HHG"
    ]
  },
  ...
  "contactpage-usermailererror": "Mail object returned error:",
  "contactpage-captcha-error": "CAPTCHA error"
}
</pre>
 
In der Datei "\extensions\ContactPage\i18n\de.json" Ergänzung bei "authors" hinter "Umherirrender", außerdem die Menüleisten-Bezeichnung "Kontaktseite" sowie Captcha-Texte einfügen:
<pre>
{
  "metadata": {
    "authors": [
      ...
      "Umherirrender",
      "Gunnar Werner HAWK HHG"
    ]
  },
  "contact": "Kontaktseite",
  ...
  "contactpage-captcha": "Um die Nachricht senden zu können, bitte das Captcha lösen ([[Special:Captcha/help|weitere Informationen]])",
  "contactpage-captcha-error": "Captcha-Fehlfunktion",
  "contactpage-captcha-failed": "Captcha-Test nicht bestanden! ([[Special:Captcha/help|weitere Informationen]])"
}
</pre>
 
Datei "ContactPage_body.php" vor Zeile 185 und nach Zeile 217+11 (228), vor Zeile 341+11+1 (353), nach Zeile 393+11+1+6 (411):
<pre>
...
// Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
if ( $this->useCaptcha() ) {
  $formItems['Captcha'] = array(
    'label-message' => 'captcha-label',
    'type' => 'info',
    'default' => $this->getCaptcha(),
    'raw' => true,
  );
}
 
$form = new HTMLForm( $formItems, $this->getContext(), "contactpage-{$this->formType}" );
...
public function processInput( $formData ) {
  global $wgUserEmailUseReplyTo, $wgPasswordSender;
  global $wgCaptcha; // Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
...
// Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
if ( $this->useCaptcha() && !$wgCaptcha->passCaptcha() ) {
  // TODO proper i18n message
  return wfMessage( 'contactpage-captcha-error' )->plain();
}
// Stolen from Special:EmailUser
$error = '';
...
  private static function getYesOrNoMsg( $value ) {
    return wfMessage( $value ? 'htmlform-yes' : 'htmlform-no' )->inContentLanguage()->text();
  }
  // Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
  /**
  * @return boolean True if CAPTCHA should be used, false otherwise
  */
  private function useCaptcha() {
    global $wgCaptchaClass, $wgCaptchaTriggers;
    return $wgCaptchaClass &&
      isset( $wgCaptchaTriggers['contactpage'] ) &&
      $wgCaptchaTriggers['contactpage'] &&
      !$this->getUser()->isAllowed( 'skipcaptcha' );
  }
  // Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
  /**
  * @return string CAPTCHA form HTML
  */
  private function getCaptcha() {
    // NOTE: make sure we have a session. May be required for CAPTCHAs to work.
    wfSetupSession();
    $captcha = ConfirmEditHooks::getInstance();
    $captcha->trigger = 'contactpage';
    $captcha->action = 'contact';
    return '<div class="captcha">' .
      $captcha->getForm() .
      "</div>\n";
  }
}
</pre>
 
==== LocalSettings.php ====
<pre>
// Version 2.2 für MediaWiki 1.25
#wfLoadExtension("ContactPage.php");
// Version 2.2 für MediaWiki 1.23
require_once( "$IP/extensions/ContactPage/ContactPage.php" );
$wgContactConfig['default'] = array(
  'RecipientUser' => 'Hornemann', //'WikiUser' // Must be the name of a valid account //vormals $wgContactUser
  'SenderName'=> 'Kontaktformular ' . $wgSitename, //"Contact Form " // "Contact Form on" needs to be translated //vormals $wgContactSenderName
  'SenderEmail'=> null // Defaults to $wgPasswordSender, may be changed as required
  'RequireDetails'=> true, // Whether users will be required to supply a name and an email address on Special:Contact
  'IncludeIP'=> false, // Whether the form will include a checkbox offering to put the IP address of the submitter in the subject line
  'AdditonalFields'=> array(
    'Text'=> array(
      'label-message'=> 'E-Mail-Nachricht', //'e-mail-message' //'emailmessage',
      'type'=> 'textarea',
      'rows'=> 20,
      'cols'=> 80,
      'required' => true, //Pflichtfeld
    ),
  ),
  // Added in MW 1.26
  #'DisplayFormat' => 'table', // See HTMLForm documentation for available values.
  #'RLModules' => array(), // Resource loader modules to add to the form display page.
  #'RLStyleModules' => array(), // Resource loader CSS modules to add to the form display page.
);
</pre>
 
=== CreativeCommonsRdf ===
 
Die Erweiterung soll ab MW-Version 1.19 die Variable "$wgEnableCreativeCommonsRdf" in der Datei "LocalSettings.php" ersetzen, hat aber noch Beta-Status (2015-09-21). Die 3 Dateien der Erweiterung können heruntergeladen werden bei https://www.mediawiki.org/wiki/Extension:CreativeCommonsRdf
 
=== DynamicPageList ===
 
Es gibt 3 Erweiterungen mit der Bezeichnung "DynamicPageList", wobei die erste mit dem Alias "Intersection" nicht verwendet wird (siehe auch https://www.mediawiki.org/wiki/Extension:DPL).
 
==== MediaWiki 1.23 ====
* Für MW 1.23 wird die Erweiterung "DynamicPageList" mit dem Alias "DynamicPageList3" von https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:DynamicPageList3 heruntergeladen und nach dem Extrahieren in das Verzeichnis "extensions" des jeweiligen Wikis extrahiert.
* Einfügen in LocalSettings:
<pre>include("$IP/extensions/DynamicPageList3/DynamicPageList.php");</pre>
 
 
=== Inline SVG Extension ===
 
Diese Erweiterung wird ab Mediawiki 1.23 nicht mehr verwendet, weil die üblichen Browser inzwischen SVG-Elemente darstellen können.
 
Die php-Datei "SVGtag.php" sorgt dafür, dass Inline-SVG-Code im Upload-Verzeichnis gespeichert und in einem "iframe" geladen wird. Dies ist erforderlich für ältere Browser, insbesondere für Internet Explorer bis einschließlich Version 8.
 
* Extension unter http://www.mediawiki.org/wiki/Extension:Inline_SVG_extension herunterladen.
* Datei in das Verzeichnis "extensions" kopieren
* In der Datei "LocalSettings.php" einfügen:
<pre>require_once("$IP/extensions/SVGtag.php");</pre>
 
=== Interwiki ===
 
Die Erweiterung "Interwiki" ist in Mediawiki seit Version 1.21 enthalten und hieß ehemals "SpecialInterwiki", bevor sie umbenannt wurde.
 
Diese Erweiterung fügt die Seite Special:Interwiki zu Mediawiki hinzu, um die Interwiki-Tabelle sehen und editieren zu können. Es werden auch alle Änderungen aufgezeichnet.
Mit dieser InterWiki Tabelle kann man einerseits einfach zu Inhalten in anderen Wikis verlinken, auch zu Wikipedia, andererseits ist es damit möglich durch das Setzen von  $wgEnableScaryTranscluding = true;  Inhalte eines anderen Wikis zu "transcludieren".
 
Die Erweiterung für MW 1.23 wird bei http://www.mediawiki.org/wiki/Extension:Interwiki heruntergeladen und in das Verzeichnis "[wikiname]\extensions\Interwiki" extrahiert.
 
In der Datei "LocalSettings.php" eines jeden Wikis ist dann einzufügen:
 
##to allow interwiki-linking, für Version MW 1.23 anderer Dateiname
#require_once("$IP/extensions/Interwiki/SpecialInterwiki.php");
require_once("$IP/extensions/Interwiki/Interwiki.php");
$wgGroupPermissions['*']['interwiki'] = false;
$wgGroupPermissions['sysop']['interwiki'] = true; ## nur sysops können die InterWiki Tabelle ändern und sehen
  $wgEnableScaryTranscluding = true;                ## Seiten von anderen Wikis können eingebunden werden
 
Diese Erweiterung wurde in SalzWiki, SaltWiki und im Repositorium installiert.
 
==== Anpassungen für geänderte Server-Adresse ====
 
Für die Umstellung der Wikis von IP-Adressen auf Domain-Adressen sind die Datenbank-Einträge der Tabelle "..._interwiki" zu bearbeiten. Hierzu wird unter "Daten und Werkzeuge => Interwikidaten ansehen und bearbeiten" bzw. "Data and Tools => View and edit interwiki data" die entsprechende Spezial-Seite "Spezial:Interwikitabelle" bzw. "Special:Interwiki" aufgerufen.
 
* Alte Adressen:
** repository | http://193.175.110.91/repository.hawk-hhg.de/index.php/$1
** saltwiki | http://193.175.110.91/saltwiki/index.php/$1
** salzwiki | http://193.175.110.91/salzwiki/index.php/$1
 
* Neue Adressen:
** repository | https://repository.hawk-hhg.de/index.php/$1
** saltwiki | https://saltwiki.net/index.php/$1
** salzwiki | https://salzwiki.de/index.php/$1
 
==== Anpassungen für HTTPS ====
 
Bei InterWikis in der Tabelle, für die sowohl "Als lokales Wiki definiert" als auch "Einbinden zulässig" aktiviert ist, die URL von "http" zu "https" ändern. Beispiel:
<pre>
wikipedia | https://de.wikipedia.org/wiki/$1 | ja | ja
</pre>
 
=== JavaScript ===
 
Entfällt bei MW 1.23.11 LTS und wird ersetzt durch eine Anpassung in der Datei "skins\MonoBook.php".
 
Die Erweiterung hat den Status "unmaintained" (Stand 2015-09-15); die Version 3.0.8 (2012-02-15) kann wegen einer ungültigen Internetadresse nicht heruntergeladen werden, doch gibt es auf der Internetseite https://www.organicdesign.co.nz/Extension:Javascript den Hinweis, dass die Erweiterung obsolet ist, seitdem MediaWiki den ResourceLoader bereitstellt, siehe https://www.mediawiki.org/wiki/ResourceLoader.
 
Diese Erweiterung diente zusammen mit der von S. Reher gelieferten Datei "customizeSidebar.js" dazu, den Navigationsbereich "Werkzeuge" in der Sidebar entsprechend dem Anmeldestatus zu manipulieren - siehe hierzu [[#Sidebar_anpassen_.28Wiki-Code.2C_JS.29|Sidebar anpassen]]. Dies funktionierte allerdings nur, wenn beim Browser JavaScript aktiviert war.
 
==== sichtbare Toolbox-Menüpunkte ====
 
* SalzWiki: alle Gruppen und User
** Druckversion
 
* SaltWiki: alle Gruppen und User
** Printable version
 
* Repository: alle Gruppen und User
** Printable version
 
==== ausgeblendete Toolbox-Menüpunkte ====
 
* SalzWiki: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
** "Links auf diese Seite" (Special:WhatLinksHere/Main_Page)
** "Änderungen an verlinkten Seiten" (Spezial:%C3%84nderungen_an_verlinkten_Seiten)
** "Hochladen" (Special:Upload)
** "Spezialseiten" (Special:SpecialPages)
** "Permanenter Link" (Main_page&oldid=921)
** "Seiteninformationen" ([Seitentitel]&action=info])
 
* SaltWiki: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
** "What links here" (Special:WhatLinksHere/Main_Page)
** "Related changes" (Special:RecentChangesLinked)
** "Hochladen" (Special:Upload)
** "Spezialseiten" (Special:SpecialPages)
** "Permanent link" (Main_page&oldid=921)
** "Page information" ([Seitentitel]&action=info])
 
* Repository: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
** "Links auf diese Seite" (Special:WhatLinksHere/Main_Page)
** "Änderungen an verlinkten Seiten" (Spezial:%C3%84nderungen_an_verlinkten_Seiten)
** "Datei Hochladen" (Special:Upload)
** "Spezialseiten" (Spezial:Spezialseiten)
** "Permanent link" (Main_page&oldid=9522)
** "Seiteninformationen" ([Seitentitel]&action=info])
 
=== Math (Wiki-Code) ===
 
"Math" kann heruntergeladen werden von https://www.mediawiki.org/wiki/Extension:Math/de. Es ist inzwischen eine Erweiterung; bei MW1.16 wurde hingegen die Datei "[wikiname]\includes\Math.php" angepasst.
 
Die Erweiterung "Math" ist für die Darstellung von Formeln erforderlich und nutzt standardmäßig "texvc" (TeX validator and converter), wobei das mitgelieferte "texvc" nur unter Linux genutzt werden kann und für Windows erst kompiliert werden muss und problembehaftet ist.
 
Somit scheidet "texvc" unter Windows aus. Stattdessen muss für die Nutzung von GhostScript, ImageMagick und MikTeX wie bei MW1.16 der Wiki-Code angepasst und die Klasse "LatexRender" in der Datei "Math_SW.php" mit Anpassungen als Klasse "MathLatexRender" weiterverwendet werden. Der Quelltext von "LatexRender" für alte MediaWikiVersionen wie MW1.16 steht zur Verfügung bei "https://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Windows/math.php".
 
Getestet werden kann die Erweiterung "Math" über die Kommandozeile:
<pre>
D:
cd xampp\htdocs\[wikiname]
D:\xampp\php\php.exe tests\phpunit\phpunit.php extensions\Math\tests\
</pre>
 
Zur Installation und Konfiguration von GhostScript, ImageMagick und MikTeX siehe [[#Eingabe_von_Formeln_mittels_Tex_.28Wiki-Code.29| Eingabe_von_Formeln_mittels_Tex_(Wiki-Code)]]
 
==== Symbol im Editor ====
 
Bei Verwendung des einfachen Standard-Editors wird diesem automatisch ein Symbol für "Math" mit den entsprechenden Funktionen hinzugefügt.
 
Bei Verwendung der Erweiterung "WikiEditor" muss die Editor-Erweiterung angepasst werden, um das "Math"-Symbol mit den Bearbeitungsfunktionen nutzen zu können.
 
==== Installation "Math" ====
 
* Die heruntergeladene Erweiterung entpacken in das Verzeichnis "extensions\"
* Die Dateien "Math.php" und "MathRenderer.php" umbenennen in "Math_original.php" und "MathRenderer_original.php"; davon Kopien "Math.php" und "MathRenderer.php" erstellen und die Kopien wie nachfolgend beschrieben anpassen
* Die Erweiterung in der Datei "LocalSettings.php" einbinden<pre>require_once "$IP/extensions/Math/Math.php";</pre>
* Existenz der Datenbanktabelle "math" überprüfen, ansonsten erstellen
** entweder SQL-Befehl für MySQL/MariaDB aus der Datei "\extensions\Math\db\math.sql" mit phpMyAdmin ausführen
** oder per Kommandozeile eine Aktualisierung ausführen, aber nur wenn die Tabelle noch nicht exisitiert: <pre>D:\xampp\php\php.exe D:\xampp\htdocs\[wikiname]\maintenance\update.php</pre>
 
==== ImageMagick und MikTeX für Math statt Texvc ====
 
Bei MW1.23 soll zwar "Math" ohne "ImageMagick" verwendet werden (siehe https://www.mediawiki.org/Manual:Running_MediaWiki_on_Windows#ImageMagick), doch funktioniert dies nicht mit "texvc" unter Windows. Deshalb wird in der Datei "LocalSettings.php" weiterhin "ImageMagick" mit "true" aktiviert statt mit "false" deaktiviert und außerdem "Texvc" für die Datei "Math.hooks.php" deaktiviert:
<pre>
$wgUseImageMagick = true;
#ImageMagick
$wgImageMagickConvertCommand = 'D:\texmf\imagick\convert.exe';
$wgImageMagickIdentifyCommand = 'D:\texmf\imagick\identify.exe';
#TeX
$wgLaTexCommand = 'D:\texmf\miktex\bin\latex.exe';
$wgDvipsCommand = 'D:\texmf\miktex\bin\dvips.exe';
$wgSVGConverter = 'ImageMagick';
$wgSVGConverters = array(
  'ImageMagick' => '"D:\texmf\imagick\convert.exe" -background white $input PNG:$output',
);
require_once "$IP/extensions/Math/Math.php";
$wgMathDisableTexFilter = true; // in Math.hooks.php
</pre>
 
===== Anpassungen "Math.php" und "MathRenderer.php" (Wiki-Code) =====
* in der Datei "Math.php" zwischen Z.191 und Z.192 die Klasse "LatexRender" hinzufügen
: <pre>#$wgAutoloadClasses['MathLatexRender.php'] // für HAWK HHG eingefügt 2016-04-25</pre>
* in der Datei "MathRenderer.php" bei der Funktion "getRenderer(...)" in Z.122f bei "default:"
: <code>
: default: // für HAWK HHG angepasst 2016-04-25
: $renderer = new MathLatexRender( $tex, $params ); #$renderer = new MathTexvc( $tex, $params );
: </code>
* von den beiden Dateien eine Sicherungskopie "Math_SW.php" und "MathRender_SW.php" vorsorglich für Änderungen durch Wiki-Updates speichern
 
===== Anpassungen Klasse "LatexRender" =====
 
In der alten Datei "Math.php" bzw. "Math_SW.php" waren 2 Klassen, nämlich die Klasse "MathRenderer" und die Klasse "LatexRender" enthalten, wobei "MathRenderer" im Vergleich zum Original nur rudimentär vorhanden war, um ein Objekt der Klasse, "LatexRender" zu erzeugen.
 
Aus diesen beiden Klassen wird für MW1.23 die Klasse "MathLatexRender" als Sub-Klasse der Klasse "MathRenderer" aus der Erweiterung "Math.
 
Anstatt der Klasse "MathRenderer" unterhalb der Klasse "LatexRender" wird nun in der Klasse "LatexRender" die Funktion "renderMath()" durch Umbenennung und Anpassung als Konstruktor-Funktion "__constructor(...)" verwendet, wobei die Konstruktor-Funktion auch die Funktion "LatexRender(...)", die bisher zur Initialisierung als Konstruktor diente, ersetzt.
 
Hinzu kommt eine neue Funktion "render()", die durch die Definition in der Datei "MathRenderer.php" erforderlich ist.
 
Zudem werden die Variablen $url und $text als Klassen-Variablen definiert.
 
Außerdem wird in der Funktion "cleanTemporaryDirectory()" eine Ergänzung vorgenommen, damit vor dem Löschen der Dateien deren Existenz überprüft wird, um Warnungen zu vermeiden.
 
Zusätzlich werden für neuere PHP-Versionen bei "htmlentities(...)" die Parameter für XHTML und UTF-8 hinzugefügt.
 
<pre>
/**
* LaTeX Rendering Class
* Copyright (C) 2003  Benjamin Zeiss <zeiss@math.uni-goettingen.de>
* -----------------------------------------------------------------------
* Changed to MathLatexRender Class for HAWK HHG by Gunnar Werner (C) 2016
* to be used with MW 1.23 LTS and extension Math REL-1_23...
* for Windows with GhostScript+ImageMagick+MikTeX instead of Texvc
* Notice 1: In file Math.php loading this class has to be added:
* $wgAutoloadClasses['MathLatexRender'] = $dir . 'MathLatexRender.php';
* Notice 2: In file MathRenderer.php new default object $renderer has to be changed:
* $renderer = new MathLatexRender( $tex, $params ); #$renderer = new MathTexvc( $tex, $params );
* -----------------------------------------------------------------------
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
...
* @author Benjamin Zeiss <zeiss@math.uni-goettingen.de>
* => @author Gunnar Werner for HAWK HHG <gunnar.werner@hawk-hhg.de>
* @version v0.8 => v0.8.2016.05
* @package latexrender => class MathLatexRender for extension Math
...
*/
...
// "extends MathRenderer" new by changes 2016
class MathLatexRender extends MathRenderer {
  ...
  // new by changes 2016
  var $url = "";
  var $text = "";
  ...
  /* function replaced with function __constructor() below by changes 2016
  function LatexRender($picture_path,$picture_path_httpd,$tmp_dir) {
    ...
  }
  */
  // new constructor combining old function LatexRender()
  // and function renderMath() from old class MathRenderer
  // by changes 2016
  public function __construct ($latex_formula, $params = array() ) {
    global $wgMathDirectory,
          $wgMathPath,
          $wgTmpDirectory,
          $wgLaTexCommand,
          $wgDvipsCommand,
          $wgImageMagickConvertCommand,
          $wgImageMagickIdentifyCommand;
 
    $latex_formula = '\displaystyle ' . $latex_formula;
 
    // from old function LatexRender()
    $this->_picture_path = $wgMathDirectory;
    $this->_picture_path_httpd = $wgMathPath;
    $this->_tmp_dir = $wgTmpDirectory;
    $this->_tmp_filename = md5(rand());
 
    // check Math dir
    if(!file_exists($wgMathDirectory)){@mkdir($wgMathDirectory);}
    if(!file_exists($wgTmpDirectory)){@mkdir($wgTmpDirectory);}
 
    // Objects $latex and $url replaced with $this by changes 2016
    $this->_latex_path = $wgLaTexCommand;
    $this->_dvips_path = $wgDvipsCommand;
    $this->_convert_path = $wgImageMagickConvertCommand;
    $this->_identify_path = $wgImageMagickIdentifyCommand;
 
    $this->url = $this->getFormulaURL($latex_formula);
 
    // htmlentities for newer PHP versions changed 2016
    $alt_latex_formula = htmlentities($latex_formula, ENT_QUOTES|ENT_XHTML, "UTF-8");
    $alt_latex_formula = str_replace("\r", "", $alt_latex_formula);
    $alt_latex_formula = str_replace("\n", "", $alt_latex_formula);
    $alt_latex_formula = str_replace('\displaystyle ', "", $alt_latex_formula);
 
    if($this->url != false){
      $this->text = '<img src="'.$this->url.'" title="'.$alt_latex_formula.'" alt="'.$alt_latex_formula.'" />';
    }
    else{
      $this->text = '[Unparseable or potentially dangerous latex formula. Error '.$this->_errorcode.' '.$this->_errorextra.']';
    }
  }
  ...
  // new for abstract function in "MathRenderer.php" by changes 2016
  public function render(){
    return $this->text."\n";
  }
  ...
  function renderLatex($latex_formula) {
    ...
    // create temporary dvi file
    ...
    $status_code = exec($command);
    // added checking file by changes 2016
    if (!$status_code || !file_exists($this->_tmp_filename.".dvi")) {
      ...
      $this->_errorcode = 4;
      return false;
    }
    ...
  }
  ...
  function cleanTemporaryDirectory() {
    ...
    // check existence before deleting to prevent warnings added by changes 2016
    /*
    unlink($this->_tmp_dir."/".$this->_tmp_filename.".tex");
    ...
    */
    $file_types = array("tex", "aux", "log", "dvi", "ps", $this->_image_format);
    foreach($file_types as $f_typ){
      $tmp_file = $this->_tmp_dir."/".$this->_tmp_filename.".".$f_typ;
      if(file_exists($tmp_file)){
        unlink($tmp_file);
      }
      $tmp_file = "";
    }
 
    chdir($current_dir);
  }
}
</pre>
 
==== LaTeXML für Math statt Texvc ====
 
Da LaTeXML nur bei einfachen Formeln funktioniert, kommt es nicht als Alternative zu Texvc in Betracht.
 
In der Datei "readme" gibt es folgende Hinweise:
* Seit MW1.19 beschränken sich die Rendering-Optionen auf "Always PNG" und "Leave it as TeX".
* Statt Bildern kann "MathML" mittels "LaTeXML" verwendet werden
** Für LaTeXML ist "php5-curl" erforderlich; bei Windows ist es im Verzeichnis "\php\ext\" die Datei "php_curl.dll", die als Modul in der Datei "php.ini" eingebunden sein muss
** In der Datei "LocalSettings.php" wird LaTeXML für die Konvertierung zu MathML verwendet: "$wgMathUseLaTeXML = true;"
** In der Datei "LocalSettings.php" wird für anonyme Seitenaufrufe  angegeben: "$wgDefaultUserOptions['math'] = MW_MATH_LATEXML"
** Empfohlen wird eine Core-Version von wmf/1.22wmf7 oder neuer
 
==== Texvc für Math kompilieren ====
 
Für die Kompilierung ist "MinGW" gegenüber "Cygwin" vorzuziehen, weil es unabhängig von den dll-Dateien und deren MS-Lizenzen mit der MSVC-Runtime funktioniert (siehe http://stackoverflow.com/questions/771756/what-is-the-difference-between-cygwin-and-mingw).
 
Da für "MinGW" keine verwertbare Ausgangsdatei zur Verfügung steht - , "makefile" wird nicht akzeptiert -, müssen "Cygwin" und "OCaml" (Version 4.02.3 32Bit + findlib + batteries) installiert werden (Dauer ca. 20 Min.). "OCaml" kann bei http://caml.inria.fr oder bei http://protz.github.io/ocaml-installer/ heruntergeladen werden.
 
'''Cygwin'''
 
Während der Installation von "OCaml" in das Verzeichnis "D:\texmf\" wird zusätzlich "Cygwin" im Verzeichnis "C:\cygwin\" installiert, sofern noch nicht vorhanden.
 
Für die Installation von "Cygwin" muss zum Herunterladen ein Mirror-Server ausgewählt werden, z. B. ftp://ftp.hawo.stw.uni-erlangen.de.
 
Vor dem Kompilieren müssen Dateien angepasst werden (siehe https://www.mediawiki.org/wiki/Texvc#Windows und https://www.mediawiki.org/wiki/MWWRender.ml):
* \Math\math\render.ml Z.42 und Z.48 (2 Backslashes statt einem Schrägstrich)
: <pre>...finalpath^"\\"^md5...</pre>
: <pre>...finalpath^"\\"^md5...</pre>
 
'''MinGW'''
 
"MinGW" (2013-10-26) kann als Installationsmanager, der während der Installation die ausgewählten "Packages" aus dem Internet lädt (Dauer ca. 10 Min.), heruntergeladen werden bei https://sourceforge.net/projects/mingw/files/ (Stand 2016-04-29).
 
"MinGW" wird als 32Bit-Version im Verzeichnis "C:\MinGW\" installiert und wird nicht in der Systemsteuerung bei den installierten Programmen aufgelistet. Das Programm-Unterverzeichnis "bin\" muss bei der Umgebungsvariablen "Path" hinzugefügt und der Server danach neu gestartet werden.
 
Im Installationsmanager bei <del>"Basic Setup"</del> "All Packages" alle Packages von "MinGW", aber nicht "MSYS" aktivieren. Danach im Menü "Installation => Apply changes" auswählen.
 
Kompilieren (siehe auch http://www.mingw.org/wiki/mingw_for_first_time_users_howto):
* Die DOS-Kommandozeile als Administrator öffnen
* zum "Math"-Verzeichnis wechseln
* Befehl zum Kompilieren eingeben
<pre>
C:\MinGW\bin\gcc makefile -o texvc.exe
</pre>
 
Fehlermeldung: "Das Programm kann nicht gestartet werden, da libiconv-2.dll auf dem Computer fehlt."
 
In "Systemsteuerung => Alle Systemsteuerungselemente => System => Erweiterte Systemeinstellungen => Umgebungsvariablen" bei "Path" am Ende einfügen:
<pre>;C:\MinGW\bin\</pre>
 
=== MwEmbedSupport ===
 
Die Erweiterung wird für die Wiedergabe von Videodateien mit der Erweiterung [[#TimedMediaHandler|"TimedMediaHandler"]] benötigt. Sie kann heruntergeladen werden bei https://www.mediawiki.org/wiki/Extension:MwEmbedSupport
 
=== OggHandler (JavaScript) ===
 
Die Erweiterung wird ab Mediawiki 1.24 nicht mehr unterstützt; empfohlen wird die Erweiterung "TimedMediaHandler", die die Erweiterung "MwEmbedSupport" benötigt und ebenfalls mit JavaScript funktioniert.
 
Diese Erweiterung dient zum Darstellen von Videodateien in SalzWiki-Artikeln. Da es sich beim OGG-Format um ein freies Format handelt, benötigt man keine Lizenz zum Darstellen der Inhalte.
'''Es ist noch zu klären, ob eventuell das MPEG Format für eine Hochschulanwendung lizenzfrei sein könnte.'''
 
'''Für die Erweiterung sind "PEAR" und "FFmpeg" erforderlich. '''
*"PEAR" ist in der PHP-Installation des Servers enthalten.
*"FFmpeg" ist herunterzuladen von heise.de und wird dann gespeichert unter "D:\ffmpeg-wiki\"
 
Installation der Erweiterung:
* Extension unter http://www.mediawiki.org/wiki/Extension:OggHandler herunterladen.
* Extrahieren der Dateien nach extensions/OggHandler
* In der Datei "LocalSettings.php" einfügen:
<pre>
## Repository: OggHanlder oder MwEmbedSupport und TimedMediaHandler
## OggHandler nur bis MW 1.23, danach MwEmbedSupport und TimedMediaHandler
require_once("$IP/extensions/OggHandler/OggHandler.php");
# FFmpeg auskommentiert, solange kostenfreie Lizenz für Hochschule ungeklärt ist
#$wgFFmpegLocation = "D:\ffmpeg-wiki\bin\ffmpeg";
</pre>
 
=== Piwik Integration ===
 
Die Erweiterung [https://www.mediawiki.org/wiki/Extension:Piwik_Integration "Piwik Integration"] für die Nutzung der Statistik-Anwendung "Piwik" kann ab den Versionen MW 1.14 und Piwik 0.4 verwendet werden.
 
* Dateien unter "extensions\Piwik\" speichern
* In der Datei "LocalSettings.php" einfügen:
<pre>
##
## EXTENSIONS
...
require_once( "$IP/extensions/Piwik/Piwik.php" );
$wgPiwikURL = $_SERVER['SERVER_NAME']."/analytics/piwik"; # ohne Protokoll-Angabe und ohne Schrägstrich am Ende!
$wgPiwikIDSite = "1"; # SalzWiki=1, SaltWiki=2, Repository=3
</pre>
 
Hinweis: Die Beispielangabe zu "$wgPiwikURL" bei der Internetseite, auf der die Erweiterung angeboten wird, ist nicht korrekt, weil die Erweiterung den Schrägstrich am Ende der Adresse im HTML-Quelltext beim Piwik-JS-Teil hinzufügt:
<pre>
$wgPiwikURL = "piwik-host.tld/dir/"; # ohne Protokoll-Angabe!
</pre>
 
=== QuestyCaptcha ===
 
Für SaltWiki wird zusätzlich zu "ConfirmEdit" als Erweiterung das Captcha "QuestyCaptcha" gegen Spam-Anmeldungen genutzt, da das Standard-Mathe-Captcha nicht ausreichte.
Die anderen angebotenen Captchas werden in zukünftigen Mediawiki-Versionen nicht mehr unterstützt oder funktionieren nicht mit allen gängigen Browsern oder funktionieren mit nicht-barrierefreien Bildern und/oder benötigen zusätzliche Installationen auf dem Wiki-Server mit Administrationsrechten, weshalb "QuestyCaptcha" trotz Beta-Status als einzig brauchbare Möglichkeit verwendet werden muss.
 
* Dateien "QuestyCaptcha.php", "QuestyCaptcha.class.php" und "QuestyCaptcha.i18n.php" unter http://www.mediawiki.org/wiki/Extension:QuestyCaptcha herunterladen und unter "extensions\ConfirmEdit\" speichern.
* In der Datei "LocalSettings.php" nach "require_once( "$IP/extensions/ConfirmEdit/ConfirmEdit.php" );" einfügen:
<pre>
##
## EXTENSIONS
...
require_once( "$IP/extensions/ConfirmEdit/QuestyCaptcha.php" );
$wgCaptchaClass = "QuestyCaptcha";
# Salzwiki
$wgCaptchaQuestions[] = array('question' => 'Welches Wort fehlt: "Eine Frage stellen, eine ... geben"?', 'answer' => '***' );
$wgCaptchaQuestions[] = array('question' => 'Um welche Art von Webseiteninhalt handelt es sich hier: Blog oder Wiki?', 'answer' => '***' );
$wgCaptchaQuestions[] = array('question' => 'Wie lautet der Name dieses Wikis?', 'answer' => $wgSitename );
$wgCaptchaQuestions[] = array('question' => 'Bitte das magische Wort - Salz - hier eingeben:', 'answer' => '***' );
$wgCaptchaQuestions[] = array('question' => 'Bitte das Spezialwort - 8Acht8 - hier eingeben:', 'answer' => '***' );
# Saltwiki
$wgCaptchaQuestions[] = array('question' => 'Which is the language of this question: Dutch, English, French, German or Spanish?', 'answer' => '***' );
$wgCaptchaQuestions[] = array( 'question' => 'Please write the following word backwards: '.$wgSitename, 'answer' => strrev($wgSitename) ); #'ikiwtlaS'
$wgCaptchaQuestions[] = array( 'question' => 'The taste of salt is neither bitter nor sweet nor sourish but &hellip;', 'answer' => '***' );
$wgCaptchaQuestions[] = array('question' => 'What is the missing word: "Ask a question, give an &hellip;"', 'answer' => ***'');
$wgCaptchaQuestions[] = array('question' => 'What kind of web content is this: Blog or Wiki?', 'answer' => '***');
$wgCaptchaQuestions[] = array( 'question' => 'What is this wiki\'s name (in capital letters)?', 'answer' => strtoupper($wgSitename) ); #'SALTWIKI'
# Repository
$wgCaptchaQuestions[] = array('question' => 'Which is the language of this question: Dutch, English, French, German or Spanish?', 'answer' => '***' );
$wgCaptchaQuestions[] = array( 'question' => 'Please write the following word backwards: '.$wgSitename, 'answer' => strrev($wgSitename) ); #'yrotisopeR'
$wgCaptchaQuestions[] = array( 'question' => 'The taste of salt is neither bitter nor sweet nor sourish but &hellip;', 'answer' => '***' );
$wgCaptchaQuestions[] = array('question' => 'What is the missing word: "Ask a question, give an &hellip;"', 'answer' => ***'');
$wgCaptchaQuestions[] = array('question' => 'What kind of web content is this: Blog or Wiki?', 'answer' => '***');
$wgCaptchaQuestions[] = array( 'question' => 'What is this wiki\'s name (in capital letters)?', 'answer' => strtoupper($wgSitename) ); #'REPOSITORY'
#$wgCaptchaQuestions[] = array('question' => 'Please write the magic secret, "salt", here:', 'answer' => '***');
#$wgCaptchaQuestions[] = array('question' => 'Type the code word, 8eight8, here:', 'answer' => '***');
 
## Auslöser für Captcha-Aktivierung
# Salzwiki/Saltwiki
$wgCaptchaTriggers['edit']          = true;
$wgCaptchaTriggers['create']        = true;
$wgCaptchaTriggers['addurl']        = true;
$wgCaptchaTriggers['createaccount'] = true;
$wgCaptchaTriggers['badlogin']      = true;
# Salzwiki/Saltwiki/Repository
$wgCaptchaTriggers['contactpage'] = true;
...
##
## EINSTELLUNGEN
...
## Salzwiki/Saltwiki
#captcha Hschwarz 12.02.2010
$wgGroupPermissions['*'            ]['skipcaptcha'] = false;
$wgGroupPermissions['user'        ]['skipcaptcha'] = false;
$wgGroupPermissions['autor'        ]['skipcaptcha'] = true;
$wgGroupPermissions['autoconfirmed']['skipcaptcha'] = false;
$wgGroupPermissions['bot'          ]['skipcaptcha'] = true; // registered bots
$wgGroupPermissions['sysop'        ]['skipcaptcha'] = true;
</pre>
 
=== SaltWiki (Wiki-Code) ===
 
Die Erweiterung "SaltWiki" ergänzt die Erweiterung [[#BibManager|"BibManager"]] für Volltexte und DOIs bei den BibTex-Attributen. Da sich in der verwendeten BibManager-Version der Dateipfad für eine Grafik geändert hat, muss der Code dieser Erweiterung angepasst werden.
 
Von der angepassten Datei "SaltWiki.php" wird eine Kopie mit dem Suffix "_SW" gespeichert.
 
==== Versionshinweis ====
Die Version 2015-05-25 enthält eine Korrektur in der Sprachdatei "SaltWiki.i18n.php", damit bei "de" nicht wie bei "de-formal" die Sie-Form verwendet wird.
 
==== Fehler (Wiki-Code) ====
In der Datei "SaltWiki.php" wird in der Funktion "sw_onBibManagerGetIcons(...)" in Z.161 eine Grafik aus dem Verzeichnis "\extensions\BibManager\client\images\" statt aus dem Verzeichnis "\extensions\BibManager\resources\images\" verwendet, weshalb der Alternativtext der Grafik angezeigt wird.
 
Z.159ff
<pre>
// für HAWK HHG und MW1.23LTS Pfad von "client" zu "resources" angepasst 2016-06-14
$icons['fulltext'] = array (
  'src' => $wgScriptPath . '/extensions/BibManager/resources/images/' . $icon,
  ...
);
</pre>
 
==== Veralteter Code ====
Es wird noch die Funktion "wfMsg()" anstatt von "wfMessage()" in der Datei "SaltWiki.php" verwendet.
 
=== SaltWikiUpload ===
 
Die Erweiterung "SaltWikiUpload" ergänzt die Erweiterung [[#BibManager|"BibManager"]] für das Hochladen von Dateien im Repositorium unter Berücksichtigung von Meta-Daten (Vergleich der Formulareingaben siehe weiter unten)
 
==== Versionshinweis ====
Die Version 2012-01-25 enthält
* in der Datei "SaltWikiUpload_body.php" ab Z.66 die Variable $aAuthorsLinks und in "foreach..." ab Z.104 Änderungen für $sFieldValue vor "$aText[]..."
* in der Sprachdatei "SaltWikiUpload.i18n.php" in den Zeilen 53, 105 und 157 ein Zusatzelement "help-various_bibtex"
* in der Datei "\includes\SaltWikiUpload_Fields.php" das Zusatzelement "help-various_bibtex"
* in der Datei "\includes\SaltWikiUpload_HTMLDateField.php" Korrekturen zur Darstellung von Monatszahlen kleiner als 10 mit vorangestellter 0
 
==== Fehler ====
* Das erweiterte Formular wird nicht angezeigt, sondern das MW-Upload-Formular
* Beim Hochladen mittels MW-Upload-Formular scheitert das Hochladen mit der Fehlermeldung "Es gibt fehlerhaft ausgefüllte Felder", wenn die Erweiterung in der Datei "LocalSettings.php" eingebunden wird.
* Die Sprachdatei "SaltWikiUpload.i18n.php" enthält bei "de" die Sie-Form wie bei "de-formal".
 
==== Veralteter Code ====
* Funktion "wfMsg" statt "wfMessage" in den Dateien
** "SaltWikiUpload_body.php"
** "\includes\SaltWikiUpload_Fields.php"
** "\includes\SaltWikiUpload_HTMLDateField.php"
 
==== Formularunterschiede ====
<b>SaltWikiUpload-Formular</b>
* Metadaten
** Beschreibung
** Quelle
** Datum
** Autor(en)
** Berechtigung
** Schlagwörter
** Typ
* Medium
** Medienart
* Quelldatei
** Quelldatei
* Dateibeschreibung
** Zielname
** Weitere Anmerkungen
 
<b>MW1.23LTS-Upload-Formular</b>
* Quelldatei
** Quelldatei
* Dateibeschreibung
** Zielname
** Beschreibung/Quelle
** Lizenz
* Hochladeoptionen
** Diese Datei beobachten
** Warnungen ignorieren
 
==== Quellcode der Version 2012-01-25 ====
Zeile 66ff unter "$aAuthors = explode(...);"
<pre>
$aAuthorsLinks = array();
foreach( $aAuthors as $sAuthor ){
  ...
  $aCategories[] = '[['.$sPrefixedCatText.']]';
  $aAuthorsLinks[] = '[[:'.$sPrefixedCatText.'|'.$oCategoryTitle->getText().']]';
}
</pre>
 
Zeile 104ff vor "$aText[] = ..."
<pre>
foreach( $aTemplate as $sFieldName => $sFieldValue ) {
  if( in_array( $sFieldName, array('literature_bibtex','grey_literature_bibtex','unpublished_reports_bibtex') ) && !empty($sFieldValue) ){
    $sFieldValue = '<bib id="'.$sFieldValue.'" />';
  }
  if( $sFieldName == 'literature_doi' && !empty($sFieldValue) ){
    $sFieldValue = 'http://dx.doi.org/'.$sFieldValue;
  }
  if( $sFieldName == 'general_author' && !empty($sFieldValue) ){
    $sFieldValue = implode('; ', $aAuthorsLinks);
  }
 
  $aText[] = '|'.$sFieldName.'='.$sFieldValue;
}
</pre>
 
=== Terminology ===
 
Diese Erweiterung wird seit 2010-07-29 nicht mehr weiterentwickelt. Sie gilt als ineffizient bei umfangreichen Glossars. Es wird die Erweiterung "Lingo" empfohlen: http://www.mediawiki.org/wiki/Extension:Lingo.
 
Die Extension dient zum Erstellen eines Glossars.
<br>Um Verwirrungen zu vermeiden wurde bei "Terminology" in der Datei "terminology.php" in den Zeilen 29 und 51 der Name der Wiki-Seite, in der alles gespeichert wird, von "Terminology" in "Glossar" bzw. für SaltWiki in "Glossary" umbenannt (nur in SalzWiki/SaltWiki, nicht im Repositorium):
*Z. 31
<pre>
$wgExtensionCredits['parserhook'][] = array(
  'name' => 'Glossar', //in Glossar umbenannt HJSChwarz 12.08.2010
</pre>
*Z. 53
<pre>
$rev = Revision::newFromTitle(Title::makeTitle(null, 'Glossar')); //in Glossar umbenannt HJSChwarz 12.08.2010
</pre>
 
* Extension unter http://www.mediawiki.org/wiki/Extension:Terminology herunterladen.
* Datei in das Verzeichnis "extensions" kopieren
* In der Datei "LocalSettings.php" einfügen:
<pre>require_once("$IP/extensions/terminology.php");</pre>
 
 
=== TimedMediaHandler (JavaScript) ===
 
Die Erweiterung steht ab Mediawiki 1.17 zur Verfügung und beinhaltet den "Kaltura HTML5 Player" (JavaScript, http://www.html5video.org/kaltura-player/docs). Unterstützt werden Streaming, WebM und Ogg sowie gegebenenfalls getID3.
 
Die Erweiterung benötigt zusätzlich
* die Erweiterung [[#MwEmbedSupport|"MwEmbedSupport"]]
* libwinpthread-1.dll für die Installation der Anwendung "ffmpeg"
* die Anwendungen
** "ffmpeg"
** "ffmpeg2theora"
** "oggThumb"
* eventuell auch die Anwendungen
** "PEAR File_Ogg", wenn nicht in "...\extensions\TimedMediaHandler\handlers\OggHandler\" die Datei "OggHandler.php" und das Verzeichnis "PEAR\" mit dem Unterverzeichnis "File_Ogg\" vorhanden sind
*** "PEAR Package Manager" oder "PEAR Pyras Installer"
*** "PEAR File_Ogg" 0.3.1 Beta 2010-08-27 (Stand 2016-06-21) wie bei Erweiterung "OggHandler" für "oggThumb"-Vorschaubilder
** "getID3()"
 
Für Details siehe https://phabricator.wikimedia.org/diffusion/ETMH/browse/master/README.
 
* Extensions herunterladen bei
** https://www.mediawiki.org/wiki/Extension:MwEmbedSupport
** https://www.mediawiki.org/wiki/Extension:TimedMediaHandler
* Dateien in das Verzeichnis "extensions" kopieren
* Datei "TimedMediaHandler.sql" für Tabelle "transcode" als Kopie mit Suffix "_SW" speichern, Kopie anpassen für Tabelle mit Präfix "sr_" und zur Erstellung der Tabelle "sr_transcode" als Admin mit der Konsole ausführen: mysql -u root -p -> USE repository[_draft]
* Zusatzsoftware herunterladen
** ffmpeg (Windows, 2016-05-10) bei www.heise.de oder https://ffmpeg.zeranoe.com/builds/ <del>http://firefogg.org/nightly/ffmpeg.exe (benötigt libwinpthread-1.dll)</del>
** ffmpeg2theora (Windows, 2014-03-06) bei www.heise.de oder http://v2v.cc/~j/ffmpeg2theora/ <del>http://firefogg.org/nightly/ffmpeg2theora.exe</del>
** oggThumb (2010-06-01) bei https://sourceforge.net/projects/oggvideotools/files/oggvideotools-win32/oggvideotools-0.8a-win32/OggVideoTools-0.8a-win32.exe (vormals http://www.streamnik.de/files.html)
** PEAR File_Ogg und Installer bei
*** http://pear.php.net/package/File_Ogg/download/File_Ogg-0.3.1.tgz (Beta, 2010-08-27)
*** http://pear.php.net/go-pear.phar, Installationsanleitung http://pear.php.net/manual/en/installation.getting.php
*** http://pear2.php.net
** getID3() Version 1.9.12 stable (2016-03-02) bei http://www.getid3.org
* Zusatzsoftware einrichten
** Verzeichnis "D:\ffmpeg_ogg\" erstellen
** "ffmpeg-20160620-afd0405-win32-static.zip" entpacken unter "D:\ffmpeg_ogg\" und Verzeichnis umbenennen in "\ffmpeg\"
** "ffmpeg2theora.exe" speichern unter "D:\ffmpeg_ogg\ffmpeg2theora\"
** "OggVideoTools-0.8a-win32.exe" installieren mit Auswahl "Add OggVideoTools to the system PATH for all users" und "Create...Desktop Icon" in Zielverzeichnis "D:\ffmpeg_ogg\OggVideoTools"
* In der Datei "LocalSettings.php" einfügen:
<pre>
## Repository: OggHanlder oder MwEmbedSupport und TimedMediaHandler
## OggHandler nur bis MW 1.23, danach MwEmbedSupport und TimedMediaHandler
#require_once("$IP/extensions/OggHandler/OggHandler.php");
# FFmpeg auskommentiert, solange kostenfreie Lizenz für Hochschule ungeklärt ist
#$wgFFmpegLocation = "D:\ffmpeg-wiki\bin\ffmpeg";
## TimedMediaHandler mit MwEmbedSupport statt OggHandler, 2015-09-21 G. Werner
require_once("$IP/extensions/MwEmbedSupport/MwEmbedSupport.php");
require_once("$IP/extensions/TimedMediaHandler/TimedMediaHandler.php");
# FFmpeg auskommentiert, solange kostenfreie Lizenz für Hochschule ungeklärt ist
#$wgFFmpegLocation = "D:\ffmpeg_ogg\ffmpeg\bin\ffmpeg";
$wgFFmpeg2theoraLocation = "D:\ffmpeg_ogg\ffmpeg2theora\ffmpeg2theora";
$wgOggThumbLocation = "D:\ffmpeg_ogg\OggVideoTools\bin\oggThumb";
</pre>
 
=== User Merge - Benutzername löschen ===
 
Das Löschen von benutzernamen, die nicht mehr benötigt werden, geschieht durch das Zusammenführen des zu löschenden Benuztzernamens mit dem Benutzername "Testuser" zu "Testuser" mit Hilfe der Extension UserMerge.
 
* Extension unter http://www.mediawiki.org/wiki/Extension:User_Merge_and_Delete herunterladen.
* Datei in das Verzeichnis extensions/UserMerge kopieren
* In den Localsettings eingefügen
 
<pre>
require_once( "$IP/extensions/UserMerge/UserMerge.php" );
# Assign the usermerge right to a usergroup, i.e. to the bureaucrats:
$wgGroupPermissions['bureaucrat']['usermerge'] = true;
</pre>
 
=== WhosOnline - Wer ist online ===
 
Die Extension WhosOnline dient dazu sich auf einer Specialpage anzeigen zu lassen, wer gerade online ist.
 
Für MediaWiki 1.23 ist im Herbst 2015 als älteste Version nur eine "REL1_25", also Version 1.4.0 für MW 1.25 erhältlich, die einen Script-Fehler verursacht, wenn in der Datei "WhosOnlineSpecialPage.php" bei der Funktion "getNavigationBar()" die Variable "$title" vom Typ String statt Objekt ist; zur Fehlerbehebung siehe weiter unten und https://www.mediawiki.org/wiki/Extension_talk:WhosOnline#Bug_in_MW_1.24_.3F
 
Bei MediaWiki 1.25 verursacht die Version 1.5.0 einen Fehler, wenn die Datei "upgrade.php" verwendet wird, weil die Datei "extension.json" in der Erweiterung fehlt; siehe https://www.mediawiki.org/wiki/Extension_talk:WhosOnline#Fatal_error_running_update.php_on_V1.5.0. Es muss deshalb in der Datei "LocalSettings.php" wie bei älteren Versionen "require_once ..." statt "wfLoadExtension(...)" verwendet werden.
 
*Dateien unter http://www.mediawiki.org/wiki/Extension:WhosOnline herunterladen und extrahieren
*Verzeichnis "WhosOnline" unter "Extensions" speichern
*Für MediaWiki 1.23 in der Datei "WhosOnlineSpecialPage.php" die Funktion "getNavigationBar()" anpassen
*SQL-Befehl in der Extension-Datei "WhosOnline.sql" für neue Datenbank-Tabelle anpassen (siehe weiter unten)
*Mit "phpMyAdmin" und geändertem SQL-Befehl eine neue Datenbank-Tabelle erstellen (siehe weiter unten)
*In der Datei "LocalSettings.php" einfügen:
<pre>
require_once("$IP/extensions/WhosOnline/WhosOnline.php");
$wgWhosOnlineShowAnons = true;
</pre>
 
'''Datei "WhosOnlineSpecialPage.php" für MW 1.23 anpassen'''
 
Die Funktion "getNavigationBar()" ab Zeile 75 kopieren, auskommentieren und die Kopie darunter einfügen.
In der Kopie die Variable $wgLang als Ersatz für $wgContLang und die entsprechenden Variablen für die return-Funktion hinzufügen:
<pre>
function getNavigationBar(){
  global $wgContLang, $wgLang;
  $link = $wgContLang->specialpage('WhosOnline');
  if(is_object($link)){
    $title = $link;
  }
  else{
    $title = Title::newFromText($link);
    if(is_null($title)){
      return false;
    }
  }
  $offset = $this->mOffset;
  $limit = $this->mLimit;
  $query = '';
  $query = wfCgiToArray('');
  $atend = $this->countUsersOnline() < ($this->mLimit + $this->mOffset); // show next link
 
  return $wgLang->viewPrevNext(
    $title,
    $offset,
    $limit,
    $query,
    $atend
  );
}
</pre>
 
'''Datei "WhosOnline.sql" anpassen'''
 
Den SQL-Befehl in der Extension-Datei "WhosOnline.sql" für die neue Datenbank-Tabelle in der ersten Zeile z. B. wie folgt mit Präfix "sw_" bzw. "sr_" anpassen:
<pre>CREATE TABLE `[datenbankname]`.`[praefix]online` (</pre>
 
'''Datenbank-Tabelle erstellen'''
 
Mit "phpMyAdmin" die MySQL-Datenbank für das Wiki auswählen und nach Auswahl des Karteikartenreiters/Tabs "SQL" die Tabelle "sw_online" bzw. "sr_online" durch Eingabe des folgenden SQL-Statements anlegen:
<pre>
CREATE TABLE  `[datenbankname]`.`[praefix]online`  (
`userid` int(5) NOT NULL default '0',
`username` varchar(255) NOT NULL default '',
`timestamp` char(14) NOT NULL default '',
PRIMARY KEY USING HASH (`userid`, `username`),
INDEX USING BTREE (`timestamp`)
) TYPE=MEMORY;
</pre>
 
=== WikiEditor (JavaScript) ===
 
'''Achtung: Funktioniert nur bei Browsern mit aktiviertem JavaScript und muss in den nachfolgend genannten Dateien und dem Grafiken-Verzeichnis nach jedem MediaWiki-Update auf Vorhandensein und Änderungen überprüft werden!'''
 
Die Erweiterung "WikiEditor" wird seit MW1.18 als Ersatz für den schlichten Editor mitgeliefert.
 
Um die Erweiterung einzubinden und sie für alle Nutzungskonten verfügbar zu machen, sind in der Datei "LocalSettings.php" in MW1.23 folgende Angaben nötig:
<pre>
require_once("$IP/extensions/WikiEditor/WikiEditor.php");
$wgDefaultUserOptions['usebetatoolbar'] = 1; // Editor bei allen Nutzungskonten standardmäßig aktivieren
$wgDefaultUserOptions['usebetatoolbar-cgd'] = 1; // Erweiterte Funktionen und Sonderzeichen bei allen Nutzungskonten standardmäßig aktivieren
$wgDefaultUserOptions['wikieditor-preview'] = 1; // Schaltfläche für Vorschau und Änderungen aktivieren
$wgDefaultUserOptions['wikieditor-publish'] = 1; // Schaltfläche für Speichern/Veröffentlichen und Abbrechen aktivieren
</pre>
 
Für die Nutzung zusätzlicher Funktionen siehe:
* https://www.mediawiki.org/wiki/Extension:WikiEditor/de
* Math, Durchgestrichen, HTML-Kommentar: https://www.mediawiki.org/wiki/Extension:WikiEditor/Toolbar_customization/Library
* https://www.mediawiki.org/wiki/Extension:WikiEditor/Toolbar_customization
* https://meta.mediawiki.org/wiki/User:Krinkle/Scripts/InsertWikiEditorButton
 
Das Symbol für die Erweiterung "Math", das im Standard-Editor automatisch hinzugefügt wird, fehlt bei der Erweiterung "WikiEditor".
 
Es gibt 4 Standard-"Sektionen"
* main für die Standard-Funktionen
* advanced für die erweiterten Funktionen
* characters für die Sonderzeichen
* help
 
Die "Sektionen" können "Gruppen" für Gruppierungen von Funktionen enthalten.
 
Die Funktionen sind über Schaltflächen (Text oder Symbol) oder Auswahllisten (Booklets) verfügbar.
 
==== Anpassungen ====
 
Folgende Dateien sind für zusätzliche Bearbeitungsfunktionen zu bearbeiten:
* Bilddatei "button-math.png" aus der Erweiterung "Math" kopieren in Verzeichnis "\extensions\WikiEditor\modules\images\toolbar\" und umbenennen in "insert-math.png"
* Sprach-Dateien im Verzeichnis "\extensions\WikiEditor\i18n\" ergänzen
* Im Verzeichnis "\extensions\WikiEditor\modules\" folgende Dateien ergänzen
** jquery.wikiEditor.toolbar.config.js Z.443 vor "redirect"
** optional: jquery.wikiEditor.dialogs.config.js Z. 17 "remove" und Z.71 "addToToolbar" vor "search"
 
'''Beispiel Sprachdatei''' "de.json" in Z.85 ergänzen:
<pre>
"wikieditor-toolbar-tool-math": "Formel",
"wikieditor-toolbar-tool-math-insert": "Formel einfügen",
</pre>
 
Datei "jquery.wikiEditor.toolbar.config.js" Z.443 vor "redirect" mit den offset-Werten von "redirect" ergänzen und "redirect" auskommentieren:
<pre>
// neu für HAWK HHG 2017-01-31
'math': {
'labelMsg': 'wikieditor-toolbar-tool-math',
'type': 'button',
'icon': {
  'default': 'insert-math.png',
  'default-rtl': 'insert-math.png'
},
'offset': {
  'default': [-70, -142],
  'default-rtl': [-70, -502]
},
'action': {
  'type': 'encapsulate',
  'options': {
  'pre': '<math>\n',
  'periMsg': 'wikieditor-toolbar-tool-math-insert',
  'post': '\n</math>',
  'ownline': true
  }
}
}/*,
'redirect': {
...
}
*/
</pre>
 
Datei "jquery.wikiEditor.dialogs.config.js" Z.17 vor ".wikiEditor( 'addToToolbar', {...} )" und Z.71 zwischen "group:insert tools:table" und "group:search" ergänzen:
<pre>
replaceIcons: function ( $textarea ) {
...
.wikiEditor( 'removeFromToolbar', { section: 'advanced', group: 'insert', tool: 'math' } )
}
...
// neu für HAWK HHG 2017-01-31
.wikiEditor( 'addToToolbar', {
section: 'advanced',
group: 'insert',
tools: {
  'math': {
  labelMsg: 'wikieditor-toolbar-tool-math',
  type: 'button',
  icon: 'insert-math.png',
  offset: [-70, -142],
  action: {
    type: 'dialog',
    module: 'insert-math'
  }
  }
}
} )
</pre>
 
== Eingabe von Formeln mittels Tex (Wiki-Code) ==
 
Damit mathematische und auch chemische Formeln dargestellt werden können, wird in Mediawiki "Texvc" benutzt. Dies funktioniert nicht unter Windows, sondern nur unter Linux. Siehe hierzu
* https://www.mediawiki.org/wiki/Extension_talk:Math#Math_REL-1_23_with_MW1.23LTS_on_Windows_with_ImageMagick.2C_MikTeX.2C_GhostScript_and_class_LatexRender
* https://www.mediawiki.org/wiki/Texvc#Option_C_-_Using_MathLatexRender_based_on_LatexRender_of_option_B
* https://www.mediawiki.org/wiki/Texvc#Windows)
 
Deshalb muss zusammen mit der Erweiterung [[#Math_.28Wiki-Code.29| Math (Wiki-Code)]] die Klasse LatexRender von Benjamin Zeiss in abgewandelter Form als Klasse MathLatexRender verwendet werden und muss folgende Software installiert werden:
# Windows Server 2012R2
## GPL GhostScript 9.10 (gs910w32.exe, 2013-09-02)
## ImageMagick 6.9.3-8-Q16-x86-dll.exe (16Bit dynamic, nicht static)
## MikTeX 2.9.5870 Net Installer 32Bit (complete, nicht basic)
# Windows Server 2008
## GPL GhostScript 8.70 (gs870w32.exe)
## ImageMagick 6.5.9-0-Q16-windows-dll.exe (16Bit dynamic, nicht static)
## MikTeX 2.8 Net Installer 32Bit (complete, nicht basic)
'''Nach jedem mediawiki-Update muss die Erweiterung "Math" mit den Dateien "Math.php" und "MathRenderer.php" auf Windows-Kompatibilität überprüft werden!'''
 
Die '''[[#Tats.C3.A4chliche_Installation|tatsächliche Installation ]]''' eines Tex-Systems erfolgt in Anlehnung an die [[#Alternative_Installationsmethode_gem.C3.A4.C3.9F_Mediawiki|alternative Methode]] auf der Mediawiki Seite
http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Windows#Alternative_Solution.
 
=== Tatsächliche Installation ===
 
Die Applikationen als Administrator für alle User im Verzeichnis "D:\texmf\" installieren:
 
# GhostScript im Unterverzeichnis "ghostscript\" installieren
## aus dem Unterverzeichnis "bin\" die Datei "gswin32c.exe" kopieren und die Kopie umbenennen zu "gs.exe"
## In der Systemsteuerung unter "Erweiterte Systemeinstellungen => Erweitert => Umgebungsvariablen" die Systemvariable "Path" erweitern mit ";D:\texmf\ghostscript\bin\"
# ImageMagick im Unterverzeichnis "imagick\" installieren
## ImageMagick dll-Datei (bei vorhandener Windows-Server-Konfigurationsberechtigung), sonst static-Datei (nur XAMPP-Zugriffsberechtigungen), inkl. "Create a desktop icon", "Add application directory to your system path", "Install FFmpeg" und "Install developement headers and libraries for C and C++"
## Testen mit der "Eingabeaufforderung/Konsole"
##* bei Windows Server 2012R2 durch Eingabe von
##*# convert wizard: wizard.jpg [=&gt;Enter drücken]
##*# convert wizard.jpg win: [=&gt;Enter drücken]
##*# =&gt; ein Bild soll angezeigt werden, Fenstertitel "IMDisplay - wizard.jpg"
##* bei Windows Server 2008 durch Eingabe von
##*# convert logo: logo.miff [=&gt;Enter drücken]
##*# imdisplay logo.miff [=&gt;Enter drücken]
##*# =&gt; ein Bild soll angezeigt werden
## PHP-Erweiterung für ImageMagick
##* Für PHP 5.6.14 "php_imagick-3.4.1-5.6-ts-vc11-x86.zip" von http://windows.php.net/downloads/pecl/releases/imagick/ oder alternativ die Datei "php_imagick-3.2.0RC1-5.6-ts-vc11-x86.zip" von http://www.peewit.fr/imagick/ herunterladen und die VC11-kompilierte ThreadSafe-Datei Datei "php_imagick.dll" in das PHP-Unterverzeichnis "ext/" kopieren
##* Für PHP 5.6.14 in der Datei "php.ini" im Bereich Windows Extensions die Datei "php_imagick.dll" einbinden:<br/>extension=php_imagick.dll
##* <del>Für PHP 5.2.9 die VC6-kompilierte Datei "php_imagick_dyn-Q16.dll" von [http://valokuva.org/outside-blog-content/imagick-windows-builds/080709/ valukova.org] herunterladen und in das PHP-Unterverzeichnis "ext/" kopieren und umbenennen zu "php_imagick_dyn_Q16.dll" (Unterstrich statt Bindestrich)</del>
##* <del>Für PHP 5.2.9 in der Datei "php.ini" im Bereich Windows Extensions die Datei "php_imagick_dyn_Q16.dll" einbinden:<br/>extension=php_imagick_dyn_Q16.dll</del>
# MiKTeX Installation
## Für Sophos-Ausnahme im Verzeichnis "D:\texmf\" ein Unterverzeichnis "miktex\" erstellen
## Für Sophos-Antivirus eine Ausnahme festlegen:
##: Konfigurieren => Antivirus => On--Access-Scans => Ausschlüsse => Hinzufügen => Ordner => D:\texmf\miktex\
## MikTeX herunterladen – kann bis zu einer Stunde dauern! – und installieren
### Zum Herunterladen der Installationsdateien die Datei "MiKTeX_NetInstall_Complete_2.9.5870_setup.exe" ausführen
###* "Download MiKTeX" statt "Install MiKTeX"
###* "Complete MiKTeX" statt "Basic MiKTeX"
###* Zielverzeichnis "D:\Install\MiKTeX_2.9_complete\"
### Die Datei "MiKTeX_NetInstall_Complete_2.9.5870_setup.exe" für Installation im Verzeichnis "D:\texfm\miktex\" ausführen mit
###* "Install MiKTeX" statt "Download MiKTeX"
###* "Complete MiKTeX" statt "Basic MiKTeX"
###* "Anyone who uses this computer (all users)" statt "Only for: [Useraccount (Username)]"
###* "Preferred paper: A4", "Install missing packags on-the-fly: Yes"
# Die Erweiterung [[#Math_.28Wiki-Code.29| Math (Wiki-Code)]] installieren und anpassen
#In der Datei "LocalSettings.php" ist jeweils einzufügen:
<pre>
$wgUseTeX = true;
# ImageMagick
$wgImageMagickConvertCommand = 'D:\texmf\imagick\convert.exe';
  $wgImageMagickIdentifyCommand = 'D:\texmf\imagick\identify.exe';
  # Tex
  $wgLaTexCommand = 'D:\texmf\miktex\miktex\bin\latex.exe';  
  $wgLaTexCommand = 'D:\texmf\miktex\miktex\bin\latex.exe';  
  $wgDvipsCommand = 'D:\texmf\miktex\miktex\bin\dvips.exe';
  $wgDvipsCommand = 'D:\texmf\miktex\miktex\bin\dvips.exe';
</pre>
$wgSVGConverter = 'ImageMagick';
 
$wgSVGConverters = array(
=== Alternative Installationsmethode gemäß Mediawiki ===
  'ImageMagick' => '"D:\texmf\imagick\convert.exe" -background white $input PNG:$output',
 
);
#install the complete [http://www.miktex.org/Setup.aspx MikTeX] (not the basic one, use the network installer) in D:\texfm\miktex - '''No: Since installing the complete version failed, we installed the basic one with administrator rights at last after installing GhostScript and installing ImageMagick.'''  
require_once "$IP/extensions/Math/Math.php";
#install the static (to be sure dependencies are embed) binary of [http://www.imagemagick.org/script/binary-releases.php#windows|ImageMagick für Windows] in D:\texmf\imagick (ensure there are no spaces in the path you choose) - '''No: We installed the dynamic version wih administrator rights.'''  
$wgMathDisableTexFilter = true; // in Math.hooks.php
#install AFPL [http://www.imagemagick.org/script/binary-releases.php#windows GhostScript] bzw. [http://sourceforge.net/projects/ghostscript/files/AFPL%20Ghostscript/8.54/|AFPL GhostScript 8.54] bzw. [http://sourceforge.net/projects/ghostscript/|GhostScript] in D:\texmf\ghostscript  
</pre>
#oder GPL [http://sourceforge.net/projects/ghostscript/files/GPL%20Ghostscript/9.10/|GPL GhostScript 9.10 (gs910w32.exe)] bzw. [https://sourceforge.net/projects/ghostscript/files/GPL%20Ghostscript|GPL GhostScript] in D:\texmf\ghostscript  
 
#copy D:\texfm\ghostscript\gs8.70\bin\gswin32c.exe to D:\texmf\ghostscript\gs8.70\bin\gs.exe (8.70 can be different depending on version you install)  
=== Alternative Installationsmethode gemäß Mediawiki ===
#add to the windows PATH environnement variable this path: D:\texmf\ghostscript\gs8.70\bin (again, 8.70 can be different depending on version you install)  
 
#If you installed MiKTeX for all users and are running IIS, you may also need to create MiKTeX folders under "C:\Documents and Settings\Default User\Application Data" and "C:\Documents and Settings\Default User\Local Settings\Application Data". Make sure the IIS working process account running PHP (IUSR_[whoever]) has both read and write permissions to these directories!  
#install the complete [http://www.miktex.org/Setup.aspx MikTeX] (not the basic one, use the network installer) in D:\texfm\miktex - '''No: Since installing the complete version failed, we installed the basic one with administrator rights at last after installing GhostScript and installing ImageMagick.'''  
#open a command line (start -&gt; execute -&gt; cmd.exe)  
#install the static (to be sure dependencies are embed) binary of [http://www.imagemagick.org/script/binary-releases.php#windows|ImageMagick für Windows] in D:\texmf\imagick (ensure there are no spaces in the path you choose) - '''No: We installed the dynamic version wih administrator rights.'''  
#verify that the following commands are working:  
#install AFPL [http://www.imagemagick.org/script/binary-releases.php#windows GhostScript] bzw. [http://sourceforge.net/projects/ghostscript/files/AFPL%20Ghostscript/8.54/|AFPL GhostScript 8.54] bzw. [http://sourceforge.net/projects/ghostscript/|GhostScript] in D:\texmf\ghostscript  
#:latex  
#oder GPL [http://sourceforge.net/projects/ghostscript/files/GPL%20Ghostscript/9.10/|GPL GhostScript 9.10 (gs910w32.exe)] bzw. [https://sourceforge.net/projects/ghostscript/files/GPL%20Ghostscript|GPL GhostScript] in D:\texmf\ghostscript  
#:dvips  
#copy D:\texfm\ghostscript\gs8.70\bin\gswin32c.exe to D:\texmf\ghostscript\gs8.70\bin\gs.exe (8.70 can be different depending on version you install)  
#:convert (not the microsoft convert)  
#add to the windows PATH environnement variable this path: D:\texmf\ghostscript\gs8.70\bin (again, 8.70 can be different depending on version you install)  
#:gs  
#If you installed MiKTeX for all users and are running IIS, you may also need to create MiKTeX folders under "C:\Documents and Settings\Default User\Application Data" and "C:\Documents and Settings\Default User\Local Settings\Application Data". Make sure the IIS working process account running PHP (IUSR_[whoever]) has both read and write permissions to these directories!  
#[edit] Settings
#open a command line (start -&gt; execute -&gt; cmd.exe)  
 
#verify that the following commands are working:  
*your wiki directory = $<br/>
#:latex  
replace the file $/includes/Math.php with code from http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Windows/math.php  
#:dvips  
*uncomment or insert in $/LocalSettings.php:
#:convert (not the microsoft convert)  
<pre>$wgUseTeX= true;</pre>
#:gs  
 
#[edit] Settings
*insert in $/LocalSettings.php:
 
 
*your wiki directory = $<br/>
- ImageMagick<br>
replace the file $/includes/Math.php with code from http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Windows/math.php  
<pre>
*uncomment or insert in $/LocalSettings.php:
$wgImageMagickConvertCommand    = 'D:\texmf\imagick\convert.exe';
<pre>$wgUseTeX= true;</pre>
$wgImageMagickIdentifyCommand  = 'D:\texmf\imagick\identify.exe';  
 
*insert in $/LocalSettings.php:
 
- ImageMagick<br>
<pre>
$wgImageMagickConvertCommand    = 'D:\texmf\imagick\convert.exe';
$wgImageMagickIdentifyCommand  = 'D:\texmf\imagick\identify.exe';  
</pre>
- Tex<br>
<pre>
$wgLaTexCommand                = 'D:\texmf\miktex\miktex\bin\latex.exe';
$wgDvipsCommand                = 'D:\texmf\miktex\miktex\bin\dvips.exe';
</pre>
 
*reboot if needed so that paths variables are updated for your services too
 
== Ausblenden der History ==
 
Diese Möglichkeit wurde nicht aktiviert.
 
Wenn nur Admins sowie Mitglieder der Gruppen "autor" und "Redakteur"/"Editor" die Versionsgeschichte einer Seite (History) sehen sollen, ist Folgendes in der Datei "LocalSettings.php" zu ergänzen:
<pre>
## Bei der angegebenen User-Gruppe wird der Versionen-Button angezeigt. Der Admin sieht diesen immer!
$groupToShowHistory = 'autor';
## Code um die Histroy zu verstecken - sreher 20101105
$wgHooks['SkinTemplateContentActions'][] = 'removeHistory';
function removeHistory( $content_actions ) {
global $wgUser, $groupToShowHistory;
# print_r ($wgUser);
if ( ! (in_array( $groupToShowHistory, $wgUser->mGroups ) or in_array( 'sysop', $wgUser-
>mGroups) ) ) {
#print "drin!";
unset( $content_actions['history'] ); // only this to remove an action
}
return true;
}
</pre>
</pre>
- Tex<br>
<pre>
$wgLaTexCommand                = 'D:\texmf\miktex\miktex\bin\latex.exe';
$wgDvipsCommand                = 'D:\texmf\miktex\miktex\bin\dvips.exe';
</pre>
*reboot if needed so that paths variables are updated for your services too


== Hilfeseiten  ==
== Hilfeseiten  ==

Aktuelle Version vom 8. Januar 2019, 12:26 Uhr

Dokumentation zur Bereitstellung von "SalzWiki", "SaltWiki" und "Repository"

Allgemeines[Bearbeiten]

In dieser Dokumentation werden die Installation und Konfiguration der Salzwikis (3 Wikisysteme) und der Erweiterungen (Extensions) beschrieben. Aktuell (seit 23.02.2016) ist Mediawiki Version 1.23.11 LTS installiert.

Ein Update kann durch Installation über die bestehende Version erfolgen oder durch Neuinstallation und Transfer von Konfigurationen und Daten. Um Altlasten in der neueren Version zu vermeiden empfiehlt sich Letzteres.

Das Repositorium-Wiki (deutsch) ist zusammen mit dem allgemeinen Salzwiki (deutsch) zu installieren, bevor die Konfigurationen in den Dateien "LocalSettings.php" geändert und Erweiterungen installiert werden, weil Zugriffe vom allgemeinen Salzwiki auf das Repositorium zu konfigurieren sind.

Sprachvarianten[Bearbeiten]

  • Das deutsche SalzWiki ist einsprachig "Deutsch".
  • Das englische Saltwiki ist einsprachig "English".
  • Das Repositorium ist seit 2012 einsprachig "Englisch" (zuvor "Deutsch") und soll 2-sprachig "Deutsch/English" werden.

Zur Konfiguration der Standardspracheinstellung siehe unter Wiki-Konfiguration -> Spracheinstellungen

Installationen[Bearbeiten]

Server und Anwendungen[Bearbeiten]

  1. Betriebssystem Windows-Server 2012 R2
  2. Webserver Apache 2.4.29 mit OpenSSL und anderen Zusatzmodulen
    • 64-Bit ohne XAMPP
    • 32-Bit von XAMPP
  3. Datenbank-Server (MySQL/)MariaDB 10.1.30
    • 64-Bit ohne XAMPP
    • 32-Bit von XAMPP
  4. Datenbank-Management-Anwendung phpMyAdmin
  5. Scriptsprache PHP ThreadSafe (für Apache unter Windows) mit Zusatzmodulen
    • 64-Bit ohne XAMPP
    • 32-Bit von XAMPP 7.2.1/7.2.2
    • Zusatzmodul php-imagick (TS => PECL)
      • 64-Bit
      • 32-Bit
  6. Statistik-Anwendung Webalizer 2.23-08
    • 32-Bit
  7. XAMPP-Paket 7.2.1/7.2.2 wegen notwendiger Bestandteile davon
    • 32-Bit
  8. Wikisystem MediaWiki 1.27.4 LTS mit Erweiterungen und Zusatz-Software
  9. GhostScript (für MediaWiki), AGPL statt GPL seit Version 9.07
    • AGPL Version 9.22 (2017-10-04) statt GPL-Version 9.10 (2013-09-02) bei https://www.ghostscript.com/
      • 64-Bit-Version gs922w64.exe ohne XAMPP-Anwendungen
      • 32-Bit-Version gs922w32.exe für XAMPP-Anwendungen
    • GPL bis Version 9.10 (2013-09-02) bei https://sourceforge.net/projects/ghostscript/
      • 64-Bit-Version gs910w64.exe ohne XAMPP-Anwendungen
      • 32-Bit-Version gs910w32.exe für XAMPP-Anwendungen
  10. ImageMagick (für MediaWiki)
    • Version 7.0.7-25-Q16-[HDRI-]x64-dll.exe ohne XAMPP-Anwendungen
    • Version 7.0.7-25-Q16-[HDRI-]x86-dll.exe für XAMPP-Anwendungen 32-Bit
    • Version 6.9.3-8-Q16-x64-dll.exe ohne XAMPP-Anwendungen
    • Version 6.9.3-8-Q16-x86-dll.exe für XAMPP-Anwendungen 32-Bit
  11. php-imagick
    • neue 64-Bit-Version statt 3.2.0RC1-5.6-zd-bv22-c86_peewit.zip ohne XAMPP-Anwendungen
    • neue 32-Bit-Version statt 3.2.0RC1-5.6-zd-bv22-c86_peewit.zip für XAMPP-Anwendungen
  12. MiKTeX 2.9.5870
  13. Statistik-Anwendung Piwik

Programme unter Systemsteuerung Windows Server 2012 R2[Bearbeiten]

Für MediaWiki 1.27.4 LTS[Bearbeiten]
  • GPL Ghostscript 9.22
  • ImageMagick 7.0.7-25 Q16 HDRI dll (dynamic)
  • Microsoft Visual C++ 2017 Redistributable [VC15]
    • (x64) - 14.13.26020.0
    • (x86) - 14.13.26020.0 14.11.25325.0
  • MikTeX 2.9
Für MediaWiki 1.23.11 LTS[Bearbeiten]
  • GPL Ghostscript 9.10
  • ImageMagick 6.9.3-8 Q16 (32-bit) (2016-04-10)
  • Microsoft Visual C++ 2008 Redistributable - x64 9.0.30729.6161
  • Microsoft Visual C++ 2008 Redistributable - x86 9.0.30729.4148
  • Microsoft Visual C++ 2008 Redistributable - x86 9.0.30729.6161
  • Microsoft Visual C++ 2012 Redistributable (x86) - 11.0.61030 Update 4
  • MikTeX 2.9

Programme unter Systemsteuerung Windows Server 2008 32 Bit[Bearbeiten]

Für MediaWiki 1.23.11 LTS und 1.16[Bearbeiten]
  • GPL GhostScript 8.70
  • ImageMagick 6.5.9-0 Q16 (2010-01-01)
  • Microsoft .Net Framework 3.5 Language Pack SP1 - DEU
  • Microsoft .Net Framework 3.5 SP1
  • Microsoft .Net Framework 4.5.2
  • Microsoft Visual C++ 2008 Redistributable - x86 9.0.30729.4148
  • Microsoft Visual C++ 2012 Redistributable (x86) - 11.0.61030 Update 4
  • MikTeX 2.8
  • MSXML 4.0 SP2 (KB954430)
  • MSXML 4.0 SP2 (KB973688)
  • OggVideoTools Ogg Video Tools
  • XAMPP 1.7.1

Verzeichnisse und Dateien[Bearbeiten]

Mit XAMPP[Bearbeiten]

XAMPP 5.6.30 und 5.6.14-0:

  • anonymous
  • apache
    • conf\extra\httpd-xampp.conf
    • error\XAMPP_FORBIDDEN.html.var
  • cgi-bin
  • contrib
  • FileZillaFTP
  • htdocs
    • Dateien: index.php, favicon.ico
    • dashboard
    • webalizer
    • xampp
    • Wiki-Verzeichnisse
  • install
  • licenses
  • locale
  • mailoutput
  • mailtodisk
  • MercuryMail
  • mysql
    • mysql_installservice.bat, mysql_uninstallservice.bat, resetroot.bat
    • bin\my.ini
  • perl
  • php
  • phpmyadmin
  • sendmail
  • src
  • tmp
  • tomcat
  • webalizer
  • webdav
  • Dateien:
    • apache_start.bat, apache_stop.bat, ... mysql_start.bat, mysql_stop.bat, ...
    • setup_xampp.bat
    • xampp-control.exe, xampp_start.exe, xampp_stop.exe
    • xampp-control.ini, xampp-control.log

XAMPP 5.6.30:

  • htdocs
    • Dateien: bitnami.css, applications.html
    • img

XAMPP 5.6.14-0:

  • security

Ohne XAMPP[Bearbeiten]

  • apache
  • htdocs
    • Angepasste Datei: index.php
    • Neu erstelltes Verzeichnis mit Datei: \info\phpinfo.php
    • Wiki-Verzeichnisse
  • mysql
  • php
  • phpmyadmin
  • tmp
  • Neu erstellte Dateien:
    • mysql_start.bat
    • mysql_stop.bat

Installationen mit XAMPP[Bearbeiten]

Das XAMPP-Paket ist als gepackte Datei, entweder zip oder 7z, zu verwenden, um eine Installation im System zu verhindern.

Nach dem Entpacken des XAMPP-Pakets ist

  • im Verzeichnis "D:\xampp\" das Unterverzeichnis "Apache24\" umzubenennen in "apache\"
  • die Datei "D:\xampp\setup_xampp.bat" auszuführen, um in den Konfigurationsdateien die Pfade für "D:\xampp\..." anpassen zu lassen.

Bei der Installation von XAMPP werden nicht erforderliche Anwendungen auf dem Server gespeichert, z. B.:

  • FileZilla
  • mailoutput
  • mailtodisk
  • MercuryMail
  • sendmail
  • Tomcat
  • Webalizer
  • Webdav

XAMPP absichern[Bearbeiten]

Verzeichniszugriff für "dashboard" einrichten[Bearbeiten]

Um das Verzeichnis "dashboard", das als localhost-Startverzeichnis im Browser geladen wird, vor öffentlichen Zugriffen zu schützen, wird die allgemeine Startseiten-Datei "index.php" angepasst und werden 2 Dateien angelegt.

Anpassung bei der allgemeinen Startseiten-Datei:

  • "xampp\htdocs\index.php" umbenennen zu "xampp\htdocs\index_original.php"
  • Datei "index.php" erstellen mit Verweisen zu den Wikis
  • Dtaei "index_localhost.php" erstellen für Zugriff auf das Verzeichnis "dashboard"

Die beiden neuen Dateien für Zugangsberechtigungen:

  • "xampp\htdocs\dashboard\.htaccess"
  • "xampp\security\dashboard.htpasswd"

Neu erstellte Datei "index.php":

<!DOCTYPE>
<html>
<head>
<title>SalzWiki SaltWiki RepositoryWiki</title>
</head>
<body>
<?php
if(!empty($_SERVER['HTTPS']) && ('on'==$_SERVER['HTTPS'])){
  $prot = 'https://';
}
else{
  $prot = 'http://';
}
?>
<ul>
  <li><a href="<?php echo $prot; ?>salzwiki.de" title="SalzWiki">SalzWiki: www.salzwiki.de</a></li>
  <li><a href="<?php echo $prot; ?>saltwiki.net" title="SaltWiki">SaltWiki: www.saltwiki.net</a></li>
  <li><a href="<?php echo $prot; ?>repository.hawk-hhg.de" title="RepositoryWiki">RepositoryWiki: repository.hawk-hhg.de</a></li>
</ul>
</body>
</html>

Neu erstellte Datei "index_localhost.php":

<?php
if($_SERVER['HTTP_HOST']=="localhost"){
  #var_dump($_SERVER['HTTP_HOST']);
  header('Location: http://'.$_SERVER['HTTP_HOST'].'/dashboard/');
}
else{
  header('Location: http://'.$_SERVER['HTTP_HOST'].'/index.php');
}
?>

Datei ".htaccess" mit "/" statt "\" in der Pfadangabe unter Windows wie bei Linux:

AuthType Basic
AuthName "XAMPP Dashboard"
AuthUserFile "../security/dashboard.htpasswd"
Require valid-user

Datei "dashboard.htpasswd", wobei "username" und "passwort" hier nur exemplarisch angegeben sind:

username:passwort

Installationen ohne XAMPP[Bearbeiten]

Die Server und Anwendungen werden wie bei einer XAMPP-Installation in ein Verzeichnis "D:\xampp\" installiert.

Sofern Apache, MySQL/MariaDB, PHP, phpMyAdmin und gegebenenfalls Webalizer aus einem XAMPP-Paket verwendet werden, sind Angaben in den Konfigurationsdateien sowie in den batch-Dateien für Starts und Stopps anzupassen.

Es ist im Verzeichnis "D:\xampp\htdocs\" ein Unterverzeichnis "info\" anzugelegen, in das die Datei "phpinfo.php" aus dem XAMPP-Verzeichnis "dashboard\" kopiert wird. Im Verzeichnis "htdocs\" wird die XAMPP-Datei "index.php" dahingehend angepasst, dass die Weiterleitung nicht zum Verzeichnis "/dashboard/", sondern zur Datei "/info/phpinfo.php" führt und dass in der letzten Zeile im Textbereich das Wort "XAMPP" entfernt wird.

Die Dienste für Apache und MySQL müssen per Kommandozeile, die als Administrator zu öffnen ist, installiert werden, damit sie bei einem Windows-Server-Neustart ebenfalls neu gestartet werden

Apache-Webserver[Bearbeiten]

Der Apache-Webserver ist als Dienst zu installieren, damit er nach Rechner-Neustarts durch Windows-Updates automatisch gestartet werden kann.

Konfiguration für HTTPS[Bearbeiten]

Es sind für HTTPS mit Verschlüsselung folgende Änderungen gegenüber HTTP ohne Verschlüsselung erforderlich:

  • Server-Zertifikat
    • Zertifikat von einer anerkannten Zertifizierungsstelle erstellen lassen
    • Anpassung einiger Zertifikat-Dateien für Apache unter Windows
  • Domain-Adresse für das Repositorium
  • Apache-Konfiguration
    • für Virtuelle Hosts mit Port 443 in der Datei "...\apache\extra\httpd-vhosts.conf"
    • für Deaktivierung des Passphrasen-Dialogs in der Datei "...\apache\extra\httpd-ssl.conf"
  • MediaWiki-Konfigurationsdatei "LocalSettings.php"
    • eigene PHP-Variable für das bei der Anfrage verwendete Protokoll
    • CreativeCommons-URLs mit https

Server-Zertifikat[Bearbeiten]

Das Server-Zertifikat wird vom Rechenzentrum der Hochschule beim DFN beantragt.

Zertifikat-Domains[Bearbeiten]

Das Zertifikat muss folgende Domain-Adressen abdecken:

  • salzwiki.de, www.salzwiki.de
  • saltwiki.net, www.saltwiki.net
  • repository.hawk-hhg.de, salzwiki.hawk-hhg.de, saltwiki.hawk-hhg.de
Zertifikat-Dateien[Bearbeiten]

Die Zertifikat-Dateien haben folgende Bezeichnungen:

  • **öffentlicher Schlüssel**: "cert-***.pem" wird umbenannt in "salzwiki_cert_pem.crt"
  • **Zertifikate-Kette**
    • "salzwiki.de.pem" enthält zwischen den Zertifikate-Blöcken Hinweise zum jeweiligen Zertifikat und kann von Apache nicht verwendet werden
    • "salzwiki_chain_pem.crt" wird als Kopie von "salzwiki.de.pem" ohne die Hinweise zwischen den Blöcken erstellt
  • privater Schlüssel
    • "salzwiki.de.key" ist mit einem Passwort geschützt und kann von Apache unter Windows nicht verwendet werden
    • "salzwiki.de.nopw.key" wird als Kopie von "salzwiki.de.key" ohne Passwortschutz erstellt

Um die Datei mit dem privaten Schlüssel ohne Passwortschutz verwenden zu können, müssen die Zugriffsrechte für das Verzeichnis "...\apache\conf\ssl.key\" erhöht werden. Das Verzeichnis darf nur vom Webserver ausgelesen werden können und nur mit Admin-Rechten zugänglich sein. Die Windows-Gruppe "Benutzer" muss von der Vererbung der übergeordneten Verzeichnisse befreit und aus den Verzeichnis-Berechtigungen entfernt werden.

Für die Erzeugung der Datei mit dem privaten Schlüssel ohne Passwortschutz kann die Datei "...\apache\bin\openssl.exe" verwendet werden, wenn der Webserver aus dem "XAMPP"-Paket installiert ist. Hierzu die geschützte Schlüsseldatei in dasselbe Verzeichnis einfügen, die Kommandozeile mit Admin-Rechten öffnen und folgenden Befehl eingeben:

openssl x509 -in salzwiki.de.key -out salzwiki.de.nopw.key

Die Zertifikate-Dateien werden in folgenden Unterverzeichnissen von "...\apache\conf\" gespeichert:

  • ssl.crt
    • salzwiki_cert_pem.crt
    • salzwiki_chain_pem.crt
  • ssl.key
    • salzwiki.de.key
    • salzwiki.de.nopw.key

Apache-Konfiguration ohne Passphrasen-Dialog[Bearbeiten]

Um unter Windows den Apache-Webserver bei Seitenaufrufen an der Passwort-Abfrage zu hindern ist in der Datei "httpd-ssl.conf" der Passphrasen-Dialog wie folgt auszukommentieren:

#SSLPassPhraseDialog builtin

Wiki-Konfiguration für Übertragungsprotokoll[Bearbeiten]

In der Datei "LocalSettings.php" wird bei Z.33ff eine Abfrage, welches Protokoll (http oder https) beim jeweiligen Seitenaufruf verwendet wird, eingefügt. Das Ergebnis wird in einer Variablen gespeichert und an mehreren Stellen in der Datei eingesetzt:

## The protocol and server name to use in fully-qualified URLs
if($_SERVER['HTTPS']==="on" OR !empty($_SERVER['HTTPS'])){$protokoll = "https";}
else{$protokoll = "http";}
$wgServer = $protokoll."://".$_SERVER['SERVER_NAME'];

Konfiguration für IP oder Domain[Bearbeiten]

"SalzWiki" und "Salt"Wiki" wurden ursprünglich durch Weiterleitungen von den "1&1"-Servern über folgende IP-Adressen eines "HAWK"-Servers zur Verfügung gestellt:

  • salzwiki.de => 193.175.110.91/salzwiki
  • saltwiki.net => 193.175.110.91/saltwiki

Das Repositorium war ohne Domain nur direkt über folgende IP-Adresse eines "HAWK"-Servers verfügbar:

  • 193.175.110.91/repository

Für eine Nutzung der Wikis per "HTTPS" mit SSL-Server-Zertifikat müssen Domain-Adressen statt IP-Adressen verwendet werden. Hierfür wurde bei den über "1&1" gehosteten Domains der DNS-Eintrag vom "1&1"-Server zum "HAWK"-Server geändert und die Weiterleitung aufgehoben.

Damit bei der Anmeldung im Repositorium vom Browser keine Sicherheitswarnung wegen eines fehlenden Server-Zertifikats erscheint, ist eine eigene Domain-Adresse für das Repositorium notwendig. Weil der Vertrag mit "1&1" keine Subdomains vorsieht, wurde hierfür bei der HAWK die Subdomain "repository.hawk-hhg.de" eingerichtet.

Konfiguration für IP[Bearbeiten]

Sofern die Wikis mit der IP-Adresse verwendet werden, sind keine besonderen Anpassungen in den Apache-Konfigurationsdateien erforderlich, abgesehen von den Unterschieden zwischen einer Installation mit oder ohne "XAMPP".

Konfiguration für Domain[Bearbeiten]

Sofern die Wikis mit den Domain-Adressen und "HTTPS" verwendet werden, sind Definitionen in folgenden Apache-Konfigurationsdateien im Unterverzeichnis "\extra\" erforderlich:

  • httpd-vhosts.conf für Virtual Hosts
  • httpd-ssl.conf eventuell für Anpassung der Standard-SSL-Konfiguration
Virtual Hosts[Bearbeiten]

Mehrere Domain-Adressen mit unterschiedlichen Inhalten auf einem Server werden als Virtual Hosts (VHosts) in der Datei "httpd-vhosts.conf" verwaltet.

Der zuerst definierte VHost ist der Standard-Server, beispielsweise "localhost", für Test-Wikis ohne Domain-Adresse und für nicht definierte Adressen mit dem Standard-Port 80 für "HTTP". Danach folgen die Definitionen für die Domain-Adressen und ihre Alias-Adressen mit dem Standard-Port 80 für "HTTP":

  • localhost (inkl. 193.175.110.91/salzwiki_draft, 193.175.110.91/saltwiki_draft, 193.175.110.91/repository_draft)
  • salzwiki.de alias www.salzwiki.de und salzwiki.hawk-hhg.de
  • saltwiki.net alias www.saltwiki.net und saltwiki.hawk-hhg.de
  • repository.hawk-hhg.de
  • subdomain-name.localhost

Für HTTPS-Verbindungen mit Port 443 erhalten folgende Domain-Adressen ebenfalls einen Eintrag in dieser VHosts-Datei – nicht in der Datei "httpd-ssl.conf":

  • localhost (mit selbst erstelltem SSL-Server-Zertifikat)
  • salzwiki.de alias www.salzwiki.de und salzwiki.hawk-hhg.de
  • saltwiki.net alias www.saltwiki.net und saltwiki.hawk-hhg.de
  • repository.hawk-hhg.de
Subdomains für localhost[Bearbeiten]

Subdomains für "localhost" können als "ServerAlias" oder für lokale Tests als "ServerName" festgelegt werden. Hierfür ist zusätzlich die "hosts"-Datei von Windows im Verzeichnis "C:\Windows\System32\drivers\etc\" zu ergänzen:

# Für Tests des Hornemann Instituts der HAWK eingefügt 2017-05-23
193.175.110.91   szw.localhost
193.175.110.91   stw.localhost
193.175.110.91   rpw.localhost
193.175.110.91   salzwiki.localhost
193.175.110.91   saltwiki.localhost
193.175.110.91   repository.localhost
Umstellung von IP-Adresse zu Domain-Adresse[Bearbeiten]

Bei einer Umstellung von IP-Adresse zu Domain-Adresse ändert sich das "root"-Verzeichnis von "htdocs" zum jeweiligen Wiki-Unterverzeichnis, das bei der VHost-Definition angegeben ist. Deshalb werden beim Standard-VHost für die bisher verwendeten Wiki-IP-Adressen Weiterleitungen zu den Wiki-Domain-Adressen eingerichtet, weil bei einer solchen Umstellung auch in den Wiki-Konfigurationsdateien "LocalSettings.php" in Z.30 der Pfad bei "$wgScriptPath" zu einem leeren String zu ändern ist:

$wgScriptPath = ""; #"/salzwiki"; #"/saltwiki"; #"/repository";

Vergleich zwischen IP-Adresse und Domain-Adresse:

  • SalzWiki
    • IP-Adresse: salzwiki.de als Weiterleitung zu "193.175.110.91/salzwiki/" mit $wgScriptPath = "/salzwiki";
    • Domain-Adresse: salzwiki.de als DNS-Eintrag zu "193.175.110.91" bei "1&1" mit Apache-VHost-Verzeichnis "/salzwiki" und mit $wgScriptPath = "";
  • SaltWiki
    • IP-Adresse: saltwiki.net als Weiterleitung zu "193.175.110.91/saltwiki/" mit $wgScriptPath = "/saltwiki";
    • Domain-Adresse: saltwiki.net als DNS-Eintrag zu "193.175.110.91" bei "1&1" mit Apache-VHost-Verzeichnis "/saltwiki" und mit $wgScriptPath = "";
  • Repository ohne Domain-Adresse
    • IP-Adresse: "193.175.110.91/repository/" mit $wgScriptPath = "/repository";
  • Repository mit Domain-Adresse
    • IP-Adresse: repository.hawk-hhg.de als Weiterleitung zu "193.175.110.91/repository/" mit $wgScriptPath = "/repository";
    • Domain-Adresse: repository.hawk-hhg.de als DNS-Eintrag zu "193.175.110.91" bei der HAWK mit Apache-VHost-Verzeichnis "/repository" und mit $wgScriptPath = "";
VHost-Definitionen[Bearbeiten]

Für HTTPS ist das öffentliche Ketten-Zertifikat "salzwiki_chain_pem.crt" als Standard-Zertifikat in der Direktive "SSLCertificateFile" anzugeben und die Direktive "SSLCertificateChainFile" auszukommentieren, weil sonst die Browser bei der Überprüfung hängen bleiben, wenn nicht gerade der Apache-Dienst im Task-Manager neu gestartet wurde.

Für HTTPS dürfen die Angaben für ServerName und ServerAlias keine Port-Angabe enthalten, weil "Google Chrome" sonst das Zertifikat als unsicher deklariert.

Einzutragende Definitionen in der Datei "httpd-vhosts.conf":

# Standard-VHost HTTP
<VirtualHost *:80>
 ServerName localhost
 ##ServerAlias 193.175.110.91
 ServerAdmin service@salzwiki.de
 DocumentRoot "D:/xampp/htdocs/"
 ErrorLog "logs/error.log"
 CustomLog "logs/access.log" combined
 RewriteEngine On
 RewriteCond %{REQUEST_URI} /salzwiki
 RewriteCond %{REQUEST_URI} !=/salzwiki_
 RewriteRule "^/salzwiki/(.*)$" "http://salzwiki.de/$1" [R=301,L] 
 RewriteCond %{REQUEST_URI} /saltwiki
 RewriteCond %{REQUEST_URI} !=/saltwiki_
 RewriteRule "^/saltwiki/(.*)$" "http://saltwiki.net/$1" [R=301,L]
 # Weiterleitung, sobald eine Subdomain repository.hawk-hhg.de eingerichtet ist
 RewriteCond %{REQUEST_URI} /repository
 RewriteCond %{REQUEST_URI} !=/repository_
 RewriteRule "^/repository/(.*)$" "http://repository.hawk-hhg.de/$1" [R=301,L] 
</VirtualHost>
# Standard-VHost HTTPS
<VirtualHost *:443>
 ServerName localhost
 ServerAdmin service@salzwiki.de
 DocumentRoot "D:/xampp/htdocs"
 <Directory "D:/xampp/htdocs">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
 </Directory>
 ErrorLog "logs/error.log"
 TransferLog "logs/access.log"
 CustomLog "logs/ssl_request.log" "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
 RewriteEngine On
 RewriteCond %{HTTP_HOST} salzwiki.localhost
 RewriteRule "^(.*)$" "https://salzwiki.de$1" [R=301,L]
 RewriteCond %{REQUEST_URI} /repository
 RewriteCond %{REQUEST_URI} !=/repository_
 RewriteRule "^(.*)$" "http://193.175.110.91/$1" [R=301,L]
 # Weiterleitung, sobald eine Subdomain repository.hawk-hhg.de eingerichtet ist
 RewriteCond %{REQUEST_URI} /repository
 RewriteCond %{REQUEST_URI} !=/repository_
 RewriteRule "^/repository/(.*)$" "https://repository.hawk-hhg.de/$1" [R=301,L] 
 SSLEngine on
 SSLCertificateFile "conf/ssl.crt/server.crt"
 SSLCertificateKeyFile "conf/ssl.key/server.key"
</VirtualHost>
# SalzWiki-VHost HTTP
<VirtualHost *:80>
 ServerName salzwiki.de
 ServerAlias www.salzwiki.de salzwiki.hawk-hhg.de salzwiki.localhost
 ServerAdmin service@salzwiki.de
 DocumentRoot "D:/xampp/htdocs/salzwiki"
 <Directory "D:/xampp/htdocs/salzwiki">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
 </Directory>
 ErrorLog "logs/error_salzwiki.log"
 CustomLog "logs/access_salzwiki.log" combined
 RewriteEngine On
 RewriteCond %{HTTP_HOST} salzwiki.localhost
 RewriteRule "^(.*)$" "http://193.175.110.91/salzwiki$1" [R=301,L]
 RewriteCond %{REQUEST_URI} /repository
 RewriteCond %{REQUEST_URI} !=/repository_
 RewriteRule "^(.*)$" "http://193.175.110.91/$1" [R=301,L] 
</VirtualHost>
# SalzWiki-VHost HTTPS
<VirtualHost *:443>
 ServerName salzwiki.de
 ServerAlias www.salzwiki.de salzwiki.hawk-hhg.de salzwiki.localhost
 ServerAdmin service@salzwiki.de
 DocumentRoot "D:/xampp/htdocs/salzwiki"
 <Directory "D:/xampp/htdocs/salzwiki">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
 </Directory>
 ErrorLog "logs/error_salzwiki.log"
 TransferLog "logs/access_salzwiki.log"
 CustomLog "logs/ssl_request.log" "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
 RewriteEngine On
 RewriteCond %{HTTP_HOST} salzwiki.localhost
 RewriteRule "^(.*)$" "https://salzwiki.de$1" [R=301,L]
 RewriteCond %{REQUEST_URI} /repository
 RewriteCond %{REQUEST_URI} !=/repository_
 RewriteRule "^(.*)$" "http://193.175.110.91/$1" [R=301,L]
 SSLEngine on
 SSLCertificateFile "conf/ssl.crt/salzwiki_chain_pem.crt"
 #SSLCertificateFile "conf/ssl.crt/salzwiki_cert_pem.crt"
 SSLCertificateKeyFile "conf/ssl.key/salzwiki.denopw.key"
 #SSLCertificateChainFile "conf/ssl.crt/salzwiki_chain_pem.crt"
 #SSLCertificateFile "conf/ssl.crt/server.crt"
 #SSLCertificateKeyFile "conf/ssl.key/server.key"
</VirtualHost>
# SaltWiki-VHost HTTP
<VirtualHost *:80>
 ServerName saltwiki.net
 ServerAlias www.saltwiki.net saltwiki.hawk-hhg.de saltwiki.localhost
 ServerAdmin service@saltwiki.net
 DocumentRoot "D:/xampp/htdocs/saltwiki"
 <Directory "D:/xampp/htdocs/saltwiki">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
 </Directory>
 ErrorLog "logs/error_saltwiki.log"
 CustomLog "logs/access_saltwiki.log" combined
 RewriteEngine On
 RewriteCond %{HTTP_HOST} saltwiki.localhost
 RewriteRule "^(.*)$" "http://193.175.110.91/saltwiki$1" [R=301,L]
 RewriteCond %{REQUEST_URI} /repository
 RewriteCond %{REQUEST_URI} !=/repository_
 RewriteRule "^(.*)$" "http://193.175.110.91/$1" [R=301,L] 
</VirtualHost>
# SaltWiki-VHost HTTPS
<VirtualHost *:443>
 ServerName saltwiki.net
 ServerAlias www.saltwiki.net saltwiki.hawk-hhg.de saltwiki.localhost
 ServerAdmin service@saltwiki.net
 DocumentRoot "D:/xampp/htdocs/saltwiki"
 <Directory "D:/xampp/htdocs/saltwiki">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
 </Directory>
 ErrorLog "logs/error_saltwiki.log"
 TransferLog "logs/access_saltwiki.log"
 CustomLog "logs/ssl_request.log" "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
 RewriteEngine On
 RewriteCond %{HTTP_HOST} saltwiki.localhost
 RewriteRule "^(.*)$" "https://saltwiki.net$1" [R=301,L]
 RewriteCond %{REQUEST_URI} /repository
 RewriteCond %{REQUEST_URI} !=/repository_
 RewriteRule "^(.*)$" "http://193.175.110.91/$1" [R=301,L]
 SSLEngine on
 SSLCertificateFile "conf/ssl.crt/salzwiki_chain_pem.crt"
 #SSLCertificateFile "conf/ssl.crt/salzwiki_cert_pem.crt"
 SSLCertificateKeyFile "conf/ssl.key/salzwiki.denopw.key"
 #SSLCertificateChainFile "conf/ssl.crt/salzwiki_chain_pem.crt"
 #SSLCertificateFile "conf/ssl.crt/server.crt"
 #SSLCertificateKeyFile "conf/ssl.key/server.key"
</VirtualHost>
# Repositorium-VHost HTTP
<VirtualHost *:80>
 ServerName repository.hawk-hhg.de
 ServerAlias repository.localhost
 ServerAdmin service@salzwiki.de
 DocumentRoot "D:/xampp/htdocs/repository"
 <Directory "D:/xampp/htdocs/repository">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
 </Directory>
 ErrorLog "logs/error_repository.log"
 CustomLog "logs/access_repository.log" combined
 # Weiterleitung, solange keine Subdomain repository.hawk-hhg.de eingerichtet ist
 RewriteEngine On
 RewriteCond %{HTTP_HOST} repository.localhost [OR]
 RewriteCond %{HTTP_HOST} repository.hawk-hhg.de
 RewriteRule "^(.*)$" "http://193.175.110.91/repository$1" [R=301,L] 
</VirtualHost>
# Repositorium-VHost HTTPS
<VirtualHost *:443>
 ServerName repository.hawk-hhg.de
 ServerAlias repository.localhost
 ServerAdmin service@salzwiki.de
 DocumentRoot "D:/xampp/htdocs/repository"
 <Directory "D:/xampp/htdocs/repository">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
 </Directory>
 ErrorLog "logs/error_repository.log"
 TransferLog "logs/access_repository.log"
 CustomLog "logs/ssl_request.log" "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
 # Weiterleitung, solange keine Subdomain repository.hawk-hhg.de eingerichtet ist
 #RewriteEngine On
 #RewriteCond %{HTTP_HOST} repository.localhost [OR]
 #RewriteCond %{HTTP_HOST} repository.hawk-hhg.de
 #RewriteRule "^(.*)$" "https://193.175.110.91/repository$1" [R=301,L] 
 SSLEngine on
 SSLCertificateFile "conf/ssl.crt/salzwiki_chain_pem.crt"
 #SSLCertificateFile "conf/ssl.crt/salzwiki_cert_pem.crt"
 SSLCertificateKeyFile "conf/ssl.key/salzwiki.denopw.key"
 #SSLCertificateChainFile "conf/ssl.crt/salzwiki_chain_pem.crt"
 #SSLCertificateFile "conf/ssl.crt/server.crt"
 #SSLCertificateKeyFile "conf/ssl.key/server.key"
</VirtualHost>

######## Beginn Draft-Wikis für Tests ########
<VirtualHost *:80>
 ServerName szw.localhost
 ServerAdmin service@salzwiki.de
 DocumentRoot "D:/xampp/htdocs/salzwiki_draft"
 <Directory "D:/xampp/htdocs/salzwiki_draft">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
 </Directory>
 ErrorLog "logs/error_salzwiki_draft.log"
 CustomLog "logs/access_salzwiki_draft.log" combined
 RewriteEngine On
 RewriteCond %{HTTP_HOST} szw.localhost
 RewriteRule "^(.*)$" "http://193.175.110.91/salzwiki_draft$1" [R=301,L] 
</VirtualHost>
<VirtualHost *:80>
 ServerName stw.localhost
 ServerAdmin service@saltwiki.net
 DocumentRoot "D:/xampp/htdocs/saltwiki_draft"
 <Directory "D:/xampp/htdocs/saltwiki_draft">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
 </Directory>
 ErrorLog "logs/error_saltwiki_draft.log"
 CustomLog "logs/access_saltwiki_draft.log" combined
 RewriteEngine On
 RewriteCond %{HTTP_HOST} stw.localhost
 RewriteRule "^(.*)$" "http://193.175.110.91/saltwiki_draft$1" [R=301,L] 
</VirtualHost>
<VirtualHost *:80>
 ServerName rpw.localhost
 ServerAdmin service@salzwiki.de
 DocumentRoot "D:/xampp/htdocs/repository_draft"
 <Directory "D:/xampp/htdocs/repository_draft">
  Options -Indexes +FollowSymLinks -Includes -ExecCGI
  AllowOverride All
  Require all granted
 </Directory>
 ErrorLog "logs/error_repository_draft.log"
 CustomLog "logs/access_repository_draft.log" combined
 RewriteEngine On
 RewriteCond %{HTTP_HOST} rpw.localhost
 RewriteRule "^(.*)$" "http://193.175.110.91/repository_draft$1" [R=301,L] 
</VirtualHost>
######## Ende Draft-Wikis für Tests ########

conf-Dateien mit und ohne XAMPP[Bearbeiten]

Konfigurationsdateien mit Verzeichnispfaden:

  • Datei "apache\conf\httpd.conf
  • Dateien im Verzeichnis "apache\conf\extra\"
    • httpd-autoindex.conf
    • httpd-dav.conf
    • httpd-manual.conf
    • httpd-multilang-errordoc.conf
    • httpd-ssl.conf
    • httpd-vhosts.conf
  • XAMPP-Konfiguration "apache\conf\extra\httpd-xampp.conf"

Apache ohne XAMPP[Bearbeiten]

Für die Nutzung von Apache ohne XAMPP ist zu berücksichtigen, dass der Apache-Webserver für Windows nicht bei apache.org erhältlich ist. Es empfiehlt sich die Verwendung des Apache aus einem XAMPP-Paket von apachefriends.org. Eventuell können auch die Portable-Versionen von ApacheHTTPD_PHP_Portable_2.4.6 und portable-apache-2.2.17-win32-x86 verwendet werden.

Verzeichnisumbenennung[Bearbeiten]

Sofern das Verzeichnis für Apache "Apache24" lautet, wird es in "apache" umbenannt.

Die Pfadangaben in den Konfigurationsdateien mit der Dateiendung "conf" und in den batch-Dateien für Starts und Stopps mit der Dateiendung "bat" sind anschließend an die Bezeichnung "apache" anzupassen.

Apache als Dienst installieren[Bearbeiten]

Nachdem die Kommandozeile als Administrator geöffnet wurde, den Apache-Dienst installieren:

D:
cd xampp\apache\bin
httpd -k install

Start und Stopp im Produktivbetrieb[Bearbeiten]

Unter "Systemsteuerung => System und Sicherheit => Verwaltung => Dienste" prüfen, ob der Dienst "Apache2.4" den Starttyp "Automatisch" aufweist, damit er nach einem Rechner-Neustart automatisch gestartet wird.

Um den Apache-Dienst zu starten oder anzuhalten, wird unter "Verwaltung => Dienste" nach Auswahl des Dienstes "Apache2.4" entweder im Menü unter "Aktion" oder mit der rechten Maustaste im Kontextmenü der jeweilige Vorgang ausgewählt.

Start und Stopp im Testbetrieb[Bearbeiten]

Der Apache-Webserver kann entweder mit Hilfe des Apache-Monitors oder per Kommandozeile gestartet und angehalten werden:

NET start Apache2.4

cd D:\xampp\
apache\bin\pv -f -k httpd.exe -q

Konfiguration allgemein[Bearbeiten]

Bei einer Installation von Apache ohne XAMPP werden die Verwendung von PHP und die Berechtigungen etwas anders als bei einer Installation mit XAMPP festgelegt. Die Haupt-Konfiguration unterscheidet sich je nach Installation wie folgt:

  • ohne XAMPP: in der Datei "apache\conf\httpd.conf"
  • mit XAMPP: zusätzlich in der Datei "apache\conf\extra\httpd-xampp.conf"

httpd.conf mit und ohne XAMPP[Bearbeiten]

ServerRoot "D:/xampp/apache"
Listen 80
...
LoadModule acces_compat_module modules/mod_access_compat.so
LoadModule actions_module modules/mod_actions.so
LoadModule alias_module modules/mod_alias.so
LoadModule allowmethods_module modules/mod_allowmethods.so
LoadModule asis_module modules/mod_asis.so
LoadModule auth_basic_module modules/mod_auth_basic.so
LoadModule authn_core_module modules/mod_authn_core.so
LoadModule authn_file_module modules/mod_authn_file.so
LoadModule authz_core_module modules/mod_authz_core.so
LoadModule authz_groupfile_module modules/mod_authz_groupfile.so
LoadModule authz_host_module modules/mod_authz_host.so
LoadModule authz_user_module modules/mod_authz_user.so
LoadModule autoindex_module modules/mod_autoindex.so
LoadModule dir_module modules/mod_dir.so
LoadModule env_module modules/mod_env.so
LoadModule include_module modules/mod_include.so
LoadModule isapi_module modules/mod_isapi.so
LoadModule log_config_module modules/mod_log_config.so
LoadModule mime_module modules/mod_mime.so
LoadModule negotiation_module modules/mod_negotiation.so
LoadModule rewrite_module modules/mod_rewrite.so
#LoadModule session_module modules/mod_session.so
#LoadModule session_cookie_module modules/mod_session_cookie.so
#LoadModule session_crypto_module modules/mod_session_crypto.so
LoadModule setenvif_module modules/mod_setenvif.so
LoadModule ssl_module modules/mod_ssl.so
LoadModule status_module modules/mod_status.so
...
ServerAdmin webmaster@hornemann-institut.de
ServerName localhost:80
...
DocumentRoot D:/xampp/htdocs
...
<IfModule dir_module>
  DirectoryIndex index.php index.shtml index.html index.htm \
                 default.php default.shtml default.html default.htm \
                 home.php home.shtml home.html home.htm
</IfModule>
...
<Files ".ht*">
  Require all denied
</Files>

httpd.conf ohne XAMPP[Bearbeiten]

Bei einer Installation von Apache ohne XAMPP werden die Verwendung von PHP und die Berechtigungen nicht in der Datei "\conf\extra\httpd-xampp.conf", sondern in der Datei "httpd.conf" wie folgt festgelegt.

...
#### aus "/extras/httpd-xampp.conf"
LoadFile "/xampp/php/php5ts.dll"
LoadFile "/xampp/php/libpq.dll"
...
#### aus "/extras/httpd-xampp.conf"
LoadModule php5_module D:/xampp/php/php5apache2_4.dll
...
#### aus "/extras/httpd-xampp.conf"
<IfModule env_module>
  SetEnv MIBDIRS "/xampp/php/extras/mibs"
  SetEnv MYSQL_HOME "\\xampp\\mysql\\bin"
  SetEnv OPENSSL_CONF "/xampp/apache/bin/openssl.cnf"
  SetEnv PHP_PEAR_SYSCONF_DIR "\\xampp\\php"
  SetEnv PHPRC "\\xampp\\php"
  SetEnv TMP "\\xampp\\tmp"
</IfModule>
...
<IfModule mime_module>
  ...
  #AddType text/html .shtml
  #AddOutputFilter INCLUDES .shtml
  #### Fuer PHP aus "/extras/httpd-xampp.conf"
  AddType text/html .php
  #AddType text/html .php .phps
</IfModule>
...
#### aus "/extras/httpd-xampp.conf"
<IfModule php5_module>
  PHPIniDir "/xampp/php"
  #PHPIniDir "D:/xampp/php"
</IfModule>
...
# XAMPP settings
#Include "conf/extra/httpd-xampp.conf"
...
#### aus "/extras/httpd-xampp.conf"
<FilesMatch "\.php$">
  SetHandler application/x-httpd-php
</FilesMatch>
#<FilesMatch "\.phps$">
#  SetHandler application/x-httpd-php-source
#</FilesMatch>

#### aus "/extras/httpd-xampp.conf" abgewandelt
<LocationMatch "^/(?i:(?:phpmyadmin|info))">
  Require local
  Require ip 193.175.110.
  Require ip 10.104.5.
  Require ip 172.16.100.2
</LocationMatch>

httpd.conf für XAMPP[Bearbeiten]

Bei einer Installation mit XAMPP werden die Verwendung von PHP und die Berechtigungen in der Datei "\conf\extra\httpd-xampp.conf" festgelegt, welche in der Datei "httpd.conf" in Z.250 eingebunden wird.

...
# XAMPP settings
Include "conf/extra/httpd-xampp.conf"
...

Verzeichnisauflistungen verhindern[Bearbeiten]

Um Auflistungen von Dateien und Verzeichnissen im Browser zu verhindern, ist die Angabe "-Indexes" in der Konfigurationsdatei "apache\conf\httpd.conf" Z.227ff und Z.246ff erforderlich:

<Directory />
  Options -Indexes +FollowSymLinks
  AllowOverride none
  Require all denied
</Directory>
...
<Directory "/xampp/htdocs">
  Options -Indexes +FollowSymLinks +Includes -ExecCGI
  AllowOverride All
  Require all granted
</Directory>

Verzeichniszugriff per Authentifizierung[Bearbeiten]

Um den Zugriff auf bestimmte Verzeichnisse per Browser nur für bestimmte Anmeldenamen mit Passwort zu erlauben, sind Angaben in folgenden Konfigurationsdateien erforderlich:

  • "xampp\apache\conf\httpd.conf"
  • "xampp\apache\conf\extra\httpd-default.conf"
  • für phpMyAdmin ohne XAMPP
    • "xampp\phpMyAdmin\config.inc.php"
  • für XAMPP
    • "xampp\htdocs\dashboard\.htaccess"
    • "xampp\security\dashboard.htpasswd"

Apache-Datei "httpd.conf"[Bearbeiten]

Z.288ff und Z.520f

<Files ".ht*">
  Require all denied
<Files>
...
# XAMPP settings
Include "conf/extra/httpd-xampp.conf"

Apache-Datei "httpd-default.conf"[Bearbeiten]

Z.45

AccessFileName .htaccess

XAMPP-Dashboard-Datei ".htaccess"[Bearbeiten]

Datei "\xampp\dashboard\.htaccess"

AuthType Basic
AuthName "XAMPP Dashboard"
AuthUserFile "../security/dashboard.htpasswd"
Require valid-user

XAMPP-Dashboard-Datei "htpasswd"[Bearbeiten]

Datei "\xampp\security\dashboard.htpasswd":

username:password

Verzeichniszugriff für bestimmte Rechner-IPs[Bearbeiten]

Um von einem Rechner aus, der sich in einem bestimmten Netz befindet oder per VPN mit einer bestimmten IP verbunden ist, per Browser die Verzeichnisse nicht nur mit "localhost" aufrufen zu können, müssen zusätzliche Angaben mit "Require ip ..." erfolgen; die Fehlermeldung für einen unzulässigen Aufruf wird mit "ErrorDocument ..." erzeugt.

Verzeichniszugriff für IPs mit XAMPP[Bearbeiten]

Das XAMPP-Sicherheitskonzept ab XAMPP 1.8 erlaubt den Zugriff per Browser auf bestimmte Verzeichnisse wie "phpmyadmin" nur noch vom Server aus ("Require local").

Beispiel XAMPP 5.6.14, Datei "xampp\apache\conf\extra\httpd-xampp.conf" Z.108ff

# New XAMPP security concept
<LocationMatch "^/(?i:(?:xampp|security|licenses|phpmyadmin|webalizer|server-status|server-info))">
  Require local
  Require ip 193.175.110
  Require ip 10.104.5
  Require ip 172.16.100.2
  ErrorDocument 403 /error/XAMPP_FORBIDDEN.html.var
</LocationMatch>

Verzeichniszugriff für IPs ohne XAMPP[Bearbeiten]

Beispiel ohne XAMPP, Datei "xampp\apache\conf\httpd.conf" am Ende:

<LocationMatch "^/(?i:(?:info|phpmyadmin))">
  Require local
  Require ip 193.175.110
  Require ip 10.104.5
  Require ip 172.16.100.2
</LocationMatch>

Server-Software auf Fehlerseiten nicht anzeigen[Bearbeiten]

Standardmäßig werden auf den Fehlerseiten folgende Details des Webservers angezeigt:

  • Webserver-Bezeichnung "Apache"
  • Webserver-Version
  • Betriebssystem-Art "Win32"
  • OpenSSL-Version

Um dies aus Sicherheitsgründen zu unterbinden, ist in der Datei "D:\xampp\apache\error\include\bottom.html" im span-Element für die Variable "SERVER_SOFTWARE" hinter dem öffnenden HTML-Kommentar ein Leerzeichen einzufügen:

<span><!-- #echo var="SERVER_SOFTWARE" --></span>

Datenbank-Server[Bearbeiten]

Der MySQL-Datenbank-Server ist als Dienst zu installieren, damit er nach Rechner-Neustarts durch Windows-Updates automatisch gestartet werden kann.

MySQL/MariaDB ohne XAMPP[Bearbeiten]

Nachdem die Kommandozeile als Administrator geöffnet wurde, den MySQL-Dienst installieren:

D:
cd xampp\mysql\bin
mysqld --install

Start und Stopp im Produktivbetrieb[Bearbeiten]

Unter "Systemsteuerung => System und Sicherheit => Verwaltung => Dienste" prüfen, ob der Dienst "mysql" den Starttyp "Automatisch" aufweist, damit er nach einem Rechner-Neustart automatisch gestartet wird.

Um den mysql-Dienst zu starten oder anzuhalten, wird unter "Verwaltung => Dienste" nach Auswahl des Dienstes "mysql" entweder im Menü unter "Aktion" oder mit der rechten Maustaste im Kontextmenü der jeweilige Vorgang ausgewählt.

Start und Stopp im Testbetrieb[Bearbeiten]

Für Testzwecke aus dem XAMPP-Paket folgende Dateien in das Verzeichnis "D:\xampp\" kopieren:

  • mysql_start.bat
  • mysql_stop.bat

Auf dem Desktop jeweils eine Verknüpfung zu den beiden bat-Dateien anlegen.

Der MySQL-Server kann per Batch-Datei oder Kommandozeile gestartet und angehalten werden:

D:
cd xampp\mysql\
bin\mysqld.exe --defaults-file=mysql\bin\my.ini

D:
cd xampp\mysql
bin\mysqld.exe -q
del data\%computername%.pid

PHP[Bearbeiten]

PHP-Versionen[Bearbeiten]

PHP 7.2.2[Bearbeiten]

  • Core-Erweiterung "Cite" erzeugt Fehler "Umcommitted DB writes"
  • Core-Erweiterung "ImageMap" erzeugt Fehler "Fatal exception of type MWException"

PHP 7.1[Bearbeiten]

Laut https://wiki.php.net/internals/windows/compiler soll PHP 7.1 zwar mit VC14 und VC15 funktionieren, doch wird dies nicht offiziell unterstützt.

PHP 7.0[Bearbeiten]

Das Support-Ende für PHP 7.0 ist früher als für PHP 5.6.

php.ini[Bearbeiten]

Module[Bearbeiten]

Folgende Module sind aktiviert:

  • bz2
  • curl
  • gd2
  • gettext
  • mbstring
  • exif ; Must be after mbstring
  • mysql
  • mysqli
  • openssl
  • pdo_mysql
  • pdo_sqlite
  • soap
  • sockets
  • sqlite3
  • xmlrpc
  • xsl

php-Konfiguration[Bearbeiten]

engine = On short_open_tag = On allow_call_time_pass_reference = Off safe_mode = Off expose_php = Off error_reporting = E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED enable_dl = On file_uploads = On allow_url_fopen = On allow_url_include = Off

phpMyAdmin[Bearbeiten]

Fehler bei Konto-Erstellung[Bearbeiten]

In phpMyAdmin 4.6.5.2 ist ein Bug, der eine Fehlermeldung erzeugt, wenn versucht wird, ein neues Datenbank-Nutzungskonto zu erstellen, weil im Verzeichnis "D:\xampp\mysql\" die Unterverzeichnisse "lib\plugin\ fehlen:

SHOW PLUGINS SONAME LIKE '%_password_check%'
MySQL meldet:
#1018 - Verzeichnis von 'D:\xampp\mysql\lib\plugin\' nicht lesbar (Fehler: 2 "No such file or directory")

Die Lösung besteht darin, im Verzeichnis "D:\xampp\mysql\" die Unterverzeichnisse "lib\plugin\" zu erstellen.

phpMyAdmin-Datei "config.inc.php"[Bearbeiten]

Um die Anmeldung bei der Nutzung von "phpMyAdmin" per HTTP-Authentifizierung durchzuführen, sind folgende Angaben in der Konfigurationsdatei ab Z.18 erforderlich:

/* Authentication type and info */
#$cfg['Servers'][$i]['auth_type'] = 'config';
$cfg['Servers'][$i]['auth_type'] = 'http';
#$cfg['Servers'][$i]['user'] = 'root';
#$cfg['Servers'][$i]['password'] = '';
$cfg['Servers'][$i]['extension'] = 'mysqli';
$cfg['Servers'][$i]['AllowNoPassword'] = true;

Anmeldename und Passwort werden bei der HTTP-Anmeldung mit den Einträgen in der Tabelle "user" der Datenbank "mysql" verglichen.

Test mit phpMyAdmin-Datei ".htaccess"[Bearbeiten]

Datei "\xampp\phpMyAdmin\.htaccess"

AuthType Basic
AuthName "phpMyAdmin"
AuthUserFile "../security/phpmyadmin.htpasswd"
Require valid-user

Datei "\xampp\security\dashboard.htpasswd":

username:password

Statistik-Anwendung Piwik[Bearbeiten]

Zusätzlich zu "Piwik" ist die MW-Erweiterung "Piwik Integration" erforderlich oder muss der Code in der Datei "MonoBook.php" hinter dem Footer-Bereich mit dem "Piwik"-Code ergänzt werden.

Die Anwendung "Piwik" wird im Verzeichnis "xampp\htdocs\analytics\piwik\" zuerst auf dem Test-Server installiert.

Die Administration von "Piwik" erfolgt im Browser über die Adresse "localhost/analytics/piwik/index.php".

Die Datei "...\htdocs\robots.txt" ist zu ergänzen:

Disallow:/analytics/

Die Apache-Konfiguration ist dahingehend anzupassen, dass die Verzeichnisse "analytics\" und "piwik\" nach dem Vorbild von "phpmyadmin\" nur lokal erreichbar sind.

Installationshinweise[Bearbeiten]

Bei der Installation gibt es eine Warnung zur PHP-Konfiguration, wenn in der Datei "php.ini" nicht "always_populate_raw_post_data=-1" gesetzt ist. Dieser Parameter gilt als "deprecated" und entfällt mit PHP 7.0.0, weshalb sein Wert auf "-1" gesetzt werden soll.

Für die Installation per Browser muss JavaScript (JS) aktiviert sein oder muss mit dem Firefox-Plugin "Firebug" im HTML-Code bei select-Elementen die CSS-Definition "display:none;" entfernt werden. Ohne JS oder CSS-Anpassung fehlt

  • bei der Datenbank-Konfiguration der Adapter
  • bei der Website-Konfiguration die Zeitzone

Es wird empfohlen, für die "piwik"-Datenbank ein eigenes Nutzungskonto, das nur für diese Datenbank Berechtigungen hat, zu verwenden. Die Datenbank-Einrichtung von "Piwik" per Browser-Installation schlägt jedoch fehl, wenn das hierfür verwendete neue Benutzungskonto für "MySql" nicht existiert. Das Konto und die Datenbank sind deshalb vorab mit "phpMyAdmin" zu erstellen.

Konfiguration[Bearbeiten]

Die Piwik-System-Konfigurationsdatei "config.ini.php" befindet sich im Verzeichnis "...\analytics\piwik\config\".

Benutzungskonten[Bearbeiten]

Standardmäßig gibt es folgende Benutzungskonten:

  • [SuperUserName], Alias [...], Hauptadministrator WAHR
  • anonymous, Alias anonymous, Ansicht deaktiviert (rot), Administrator N/A
    • Kein Zugriff: "Für alle Websites anwenden" deaktiviert (rot)
    • Kein Zugriff: "SalzWiki" bzw. "SaltWiki" bzw. "Repository" aktiviert (grün)

Zusätzlich zum Hauptadmin-Konto wird für die Ansicht der Statistiken und für die Erstellung von Statistik-Berichten ein Benutzungskonto für Beschäftigte des Hornemann Instituts eingerichtet, womit es folgende Konten gibt:

  • Hauptadministration
  • Statistiknutzung
  • anonymous
Konto für Hauptadministration[Bearbeiten]

Das Nutzungskonto "SW_piwik" für die Hauptadministration wird bei der Installation von "Piwik" erstellt.

Der E-Mail-Versand wird unter "Einstellungen => System => Allgemeine Einstellungen => E-Mail-Server-Einstellungen" konfiguriert und sieht in der Piwik-System-Konfigurationsdatei "...\piwik\config\config.ini.php" wie folgt aus, nachdem :

[mail]
transport = "smtp"
port = "587"
host = "smtp.1und1.de"
type = "Login"
username = "service@salzwiki.de"
password = "***"
encryption = "ssl"

Damit als Absender nicht "noreply@localhost" gesendet wird, muss folgende Zeile in der Konfigurationsdatei im Abschnitt "[mail]" hinzugefügt werden:

defaultHostnameIfEmpty = "salzwiki.de"
Konto für Statistiknutzung[Bearbeiten]

Mit dem Hauptadmin-Konto wird unter "Einstellungen => System => Benutzer" ein Konto "Hornemann" erstellt. Dabei ist darauf zu achten, dass oben bei "Zugriffsverwaltung" nicht nur eines der Wikis, sondern "Für alle Websites anwenden" ausgewählt ist.

Das Konto hat folgende Einstellungen:

  • Benutzer Hornemann, Alias H.I.-SW-Statistik
  • E-Mail webmaster@hornemann-institut.org
  • Kein Zugriff deaktiviert (rot)
  • Ansicht
    • "Für alle Websites anwenden" aktiviert (grün), wird nach Auswahl einer Seite wie "SalzWiki" bei der Rückkehr deaktiviert (rot)
    • "SalzWiki" bzw. "SaltWiki" bzw. "Repository" aktiviert (grün)
  • Administrator deaktiviert (rot)
  • Hauptadministrator deaktiviert (rot)

Statistik-Berichte[Bearbeiten]

Für jedes Wiki wird ein eigener Bericht jeweils vom Typ HTML und PDF erstellt:

  • SalzWiki
    • HTML
    • PDF
  • SaltWiki
    • HTML
    • PDF
  • Repository
    • HTML
    • PDF

Bei dem Konto für die Statistiknutzung wird unter "Einstellungen => Persönlich => E-Mail-Berichte" festgelegt, welche Art von Bericht wann per E-Mail übermittelt wird.

  • Website: SalzWiki|SaltWiki|Repository
  • Beschreibung: Monatlicher Statistikbericht
  • Segment: Alle Besuche
  • Zeitplan: Monatlich
  • Uhrzeit: 1|2 (1 Uhr für HTML, 2 Uhr für PDF)
  • Versand via: E-Mail
  • Berichtsformat: HTML|PDF
  • Bericht senden an: An mich senden
  • Anzeigeoptionen: Tabellen und Graphen für alle Berichte anzeigen
  • Beinhaltete Statistiken
    • Alle Websites: Dashboard aller Websites
    • Verweise: Verweisart, Alle Verweise, Suchbegriffe, Suchmaschinen Websites, Soziale Netzwerke
    • Besucher: Besucherüberblick, Benutzer, Gerätetyp, Gerätemodell, Gerätemarke, Bildschirmauflösungen, Betriebssystem-Versionen, Browser, Browser-Version, Land, Kontinent, Region, Browsersprache, Stadt, Besuchslänge, Seiten pro Besuch
    • Aktionen: Aktionen - Kernmetriken, Seiten URL, Einstiegsseiten, Ausstiegsseiten, Ausgehende Verweise, Downloads

Statistik-Anwendung Webalizer[Bearbeiten]

Webalizer gibt es bei www.webalizer.org nicht für Windows, sondern nur als DOS-Quellcode, zuletzt in der Version 2.23-08 von 2013. Andere Varianten wie die der Firma "Stone Steps Inc." basieren auf Version 2.01-10. Die aktuellste Windows-Variante ist in XAMPP enthalten, beispielsweise in XAMPP 5.6.14 als Webalizer Version 2.23-04 vermutlich mit Stand März 2011.

Installiert wird die XAMPP-Variante.

Log-Format[Bearbeiten]

Als Log-Format wird das Standardformat CLF ("NCSA Common Log Format" bzw. "NCSA Combined Log Format") für die Auswertung der Apache-Log-Datei "access.log" verwendet, siehe auch https://en.wikipedia.org/wiki/Common_Log_Format. Es enthält folgende Angaben:

 * IP-Adresse des anfordernden Hosts
 * Ungenutzt für RFC-1413-Identität
 * Nutzername aus einer HTTP-Authentifizierung, ansonsten "-"
 * Zeitstempel (Datum, Uhrzeit und UTC-Abweichung)
 * Übermittlungsart, angeforderte Adresse und Übertragungsprotokoll mit Version, z. B. "GET /index.php HTTP/1.1"
 * HTTP-Statuscode
 * Menge der gesendeten Daten in Byte, ansonsten "-" (bei Umleitungen usw.) 
 * Ausgangsadresse des anfordernden Hosts
 * Systemangaben zum anfordernden Host wie Browser mit Version und Betriebssystem mit Version
 * Cookie

Common Log Format[Bearbeiten]

host rfc931 username date:time request statuscode bytes

Combined Log Format[Bearbeiten]

host rfc931 username date:time request statuscode bytes referrer user_agent cookie

Konfiguration[Bearbeiten]

Für jedes Wiki wird eine eigene Statistik-Konfigurationsdatei erstellt:

  • salzwiki.conf
  • saltwiki.conf
  • repository.conf

In diesen Dateien wird jeweils festgelegt, welche Webserver-Log-Datei ausgewertet wird und in welchem Verzeichnis die Auswertung gespeichert wird.

Wenn bei der Apache-Webserver-Konfiguration jedes Wiki als virtueller Host eine eigene Log-Datei zugewiesen bekommen hat, können diese VHost-Log-Dateien ausgewertet werden, ansonsten muss die allgemeine Log-Datei ausgewertet werden:

  • allgemeine Log-Datei: "access.log"
  • gesonderte VHost-Log-Dateien
    • "access_salzwiki.log"
    • "access_saltwiki.log"
    • "access_repository.log"

Welches Wiki ausgewertet wird, erfolgt über die Angabe der Host-Namen mit "IgnoreSite" und "IncludeSite":

# Internet-Adresse für Wiki:
IgnoreSite  *
# für Seiten inkl. Mediadateien aus dem Repositorium
IncludeSite 193.175.110.91
# für Seiten ohne Mediadateien aus dem Repositorium
#IncludeSite 193.175.110.91/salzwiki/
#IncludeSite 193.175.110.91/saltwiki/
IncludeSite salzwiki.de
IncludeSite www.salzwiki.de
IncludeSite salzwiki.hawk-hhg.de
#IncludeSite saltwiki.net
#IncludeSite www.saltwiki.net
#IncludeSite saltwiki.hawk-hhg.de
#IncludeSite repository.hawk-hhg.de

Die Auswertung für das jeweilige Wiki betrifft nur Aufrufe der index-Datei und der Dateien in den hexadezimal benannten Unterverzeichnissen im Verzeichnis "\wikiname\images\". Diese URLs werden folgendermaßen mit "IgnoreURL" und "IncludeURL" angegeben:

# Pfad für Wiki
IgnoreURL  *
IncludeURL /index.php*
IncludeURL /images/0/*
IncludeURL /images/1/*
IncludeURL /images/2/*
IncludeURL /images/3/*
IncludeURL /images/4/*
IncludeURL /images/5/*
IncludeURL /images/6/*
IncludeURL /images/7/*
IncludeURL /images/8/*
IncludeURL /images/9/*
IncludeURL /images/a/*
IncludeURL /images/b/*
IncludeURL /images/c/*
IncludeURL /images/d/*
IncludeURL /images/e/*
IncludeURL /images/f/*
IncludeURL /wikiname/index.php*
IncludeURL /wikiname/images/0/*
IncludeURL /wikiname/images/1/*
IncludeURL /wikiname/images/2/*
IncludeURL /wikiname/images/3/*
IncludeURL /wikiname/images/4/*
IncludeURL /wikiname/images/5/*
IncludeURL /wikiname/images/6/*
IncludeURL /wikiname/images/7/*
IncludeURL /wikiname/images/8/*
IncludeURL /wikiname/images/9/*
IncludeURL /wikiname/images/a/*
IncludeURL /wikiname/images/b/*
IncludeURL /wikiname/images/c/*
IncludeURL /wikiname/images/d/*
IncludeURL /wikiname/images/e/*
IncludeURL /wikiname/images/f/*

Folgende Definitionen sind zusätzlich erforderlich:

LogFile Pfadangabe/logdateiname
LogType clf
OutputDir Pfadangabe/wikiname
HistoryName wikiname.hist
Incremental yes
IncrementalName wikiname.current
ReportTitle Usage Statistics for
HostName wikiname
HTMLExtension html
PageType htm*
PageType php*
#UseHTTPS no
#DNSCache dns_cache.db
#DNSChildren 20
Quiet no
ReallyQuiet no
GMTTime no
VisitTimeout 1800
CountryGraph yes
GraphLegend yes
GraphLines 10
TopURLs 20
TopReferrers 20
TopAgents 10
TopCountries 50
TopSearch 20
AllSites no
AllURLs yes
AllReferrers yes
AllAgents yes
AllSearchStr yes
AllUsers no
#IndexAlias home.htm
#IndexAlias homepage.htm
DefaultIndex no
HideSite localhost
HideReferrer localhost/
HideReferrer 193.175.110.91/
HideReferrer salzwiki.de
HideReferrer www.salzwiki.de
HideReferrer salzwiki.hawk-hhg.de
HideReferrer Direct Request

HideURL *.css
HideURL *.ico
HideURL *.ICO
HideURL *.js
HideURL *.ra
HideURL robots.txt
HideURL api.php
HideURL load.php
HideURL opensearch_desc.php
HideURL /docs/
HideURL /extensinos/
HideURL /images/common/
HideURL /images/math/
HideURL /includes/
HideURL /languages/
HideURL /maintenance/
HideURL /mw-config/
HideURL /resources/
HideURL /serialized/
HideURL /skins/
HideURL /tests/

Dateien[Bearbeiten]

Die nachfolgenden Informationen sind in der Datei "D:\xampp\webalizer\INFO_WikiStatistiken.txt" gespeichert.

Bis Ende Mai 2017 war eine einzige Log-Datei für alle Wikis beim Apache-Webserver konfiguriert. Ab Ende Mai 2017 sind für die 3 Wikis eigene Log-Dateien beim Apache-Webserver konfiguriert.

2017-06-20: Die Log-Dateien des Apache-Webservers, access.log und access.old1.log, enthalten für Januar bis April 2017 identische Aufzeichnungen.

Für die Auswertung durch Webalizer wurden die großen Log-Dateien access.log und access.old1.log vom Apache-Log-Verzeichnis zu den Verzeichnissen "\webalizer\logs\access_20170612\" und "\webalizer\logs\access_old1_2016\" kopiert. Anschließend wurden die großen Dateien mit "7-zip" in kleine Dateien für jeden Monat aufgeteilt. Hierzu wird mit "Hinzufügen" die Kompressionsstärke "Speichern" ausgewählt und "In Teildaten aufsplitten (Bytes)" verwendet. Dann werden die Inhalte der Teildateien so zusammengestellt, dass für jeden Monat eine Datei "access_YYYY_Monat00.log" vorhanden ist. Für den Monat Mai 2017 wurde wegen der Umstellung auf Wiki-Log-Dateien jeweils die Datei "access_2017_Monat05.log" mit der Datei "access_2017_Monat05_02_wikiname.log" zur Datei "access_2017_Monat05_wikiname.log zusammengefügt". Für die Monate von Juni 2017 bis einschließlich Dezember 2017 werden die Wiki-Log-Dateien wie die alten, großen Dateien in Teildateien für jeden Monat aufgeteilt, beispielsweise "access_YYYY_Monat00_wikiname.log". Ab Januar 2018 werden die Wiki-Log-Dateien in Teildateien für jeden Monat nach dem Schema "wikiname_YYYY_Monat00.log" aufgeteilt.

Für die Statistiken bis einschließlich April 2017 wird in den Konfigurationsdateien der Wikis, "wikiname_YYYY_Monate.conf", die Monatsdatei "access_YYYY_Monat00.log", die aus der großen log-Datei stammt, angegeben. Für die Statistiken ab Mai 2017 wird in den Konfigurationsdateien der Wikis, "wikiname_YYYY_Monate.conf", die Monatsdatei "access_YYYY_Monat00_wikiname.log", die aus den einzelnen Wiki-Log-Dateien stammt, angegeben.

Die Batch-Datei "webalizer_YYYY_Monate.bat" wird für jeden Monat nach Anpassung der conf-Dateien ausgeführt.

  • Statistiken für 2018:
    • Log-Dateien-Verzeichnis für Webalizer: \logs\access_2018\access_wikiname.log => wikiname_2018_Monat00.log
    • Statistik-Verzeichnisse: \stats\wikiname\
    • Konfigurationsdateien: wikiname_[2018_]monate.conf
    • Batch-Datei: webalizer_[2018_]monate.bat
  • Statistiken für 2017:
    • Log-Dateien-Verzeichnis für Webalizer bis Juli: \logs\access_20170612\access_2017.log => access_2017_Monat00.log, access_wikiname.log => access_2017_Monat00_wikiname.log
    • Log-Dateien-Verzeichnis für Webalizer ab August: \logs\access_20171231\access_wikiname_2017_Hj2.log => access_2017_Monat00_wikiname.log
    • Statistik-Verzeichnisse: \stats_2017\wikiname\ => \stats_2017\wikiname\
    • Konfigurationsdateien: wikiname_2017_monate.conf
    • Batch-Datei: webalizer_2017_monate.bat
  • Statistiken für 2016:
    • Log-Dateien-Verzeichnis für Webalizer: \logs\access_old1_2016\access.old2016.log => access_2016_Monat00.log
    • Statistik-Verzeichnisse: \stats_2016\wikiname\
    • Konfigurationsdateien: wikiname_2016.conf
    • Batch-Datei: webalizer_2016.bat

DNS-Cache[Bearbeiten]

Anhand der IPs – sowohl IPv4 als auch IPv6 – erfolgt eine Zuordnung von Domains und abgeleitet von den First-Level-Domains eine Zuordnung von Ländern. Die Zuordnungen werden standardmäßig in einer DNS-Cache-Datei namens "dnscache.db" zwischengespeichert.

Der DNS-Zwischenspeicher wird mit folgenden Parametern festgelegt:

  1. DNSCache: Dateiname
  2. DNSChildren: Anzahl der Prozesse (1-100) für die DNS-Zuordnungen
  3. CacheIPs: IPs speichern, wenn keine Domain-Zuordnung möglich ist [yes|no]
  4. CacheTTL: Gültigkeitsdauer in Tagen (1-100) für jede zwischengespeicherten Adresse

Bei der Konfiguration kann der Cache für IPs, die nicht in Domainnamen aufgelöst werden können, aktiviert werden, wenn dies häufig vorkommt, damit bei der nächsten Auswertung nicht noch einmal eine Auflösung versucht wird:

CacheIPs yes

Suchmaschinen[Bearbeiten]

robots.txt[Bearbeiten]

Damit Test-Wikis während der Erprobungsphase, das Repositorium und verschiedene Wiki-Unterverzeichnisse nicht von Suchmaschinen durchsucht werden, wird eine Datei "robots.txt" im Verzeichnis "htdocs" gespeichert.
Damit kein Robot irgendetwas liest:

User-agent: *
Disallow:

Angaben nach dem Upgrade auf MW1.23 am 26.02.2016, damit der "Riddler"-Robot (hohe Zugriffszahlen) gar nichts und andere Robots nur das jeweilige Hauptverzeichnis von SalzWiki und SaltWiki und sonst nichts durchsuchen:

# robots.txt für Salzwiki und Saltwiki, damit Robots weder Unterverzeichnisse noch das Repositorium noch Test-Wikis durchsuchen
User-agent: Riddler
Disallow:/

User-agent: *
Disallow:/dashboard/
Disallow:/webalizer/
Disallow:/xampp/
Disallow:/salzwiki/cache/
Disallow:/salzwiki/docs/
Disallow:/salzwiki/extensions/
Disallow:/salzwiki/images/
Disallow:/salzwiki/includes/
Disallow:/salzwiki/languages/
Disallow:/salzwiki/maintenance/
Disallow:/salzwiki/mw-config/
Disallow:/salzwiki/resources/
Disallow:/salzwiki/serialized/
Disallow:/salzwiki/skins/
Disallow:/salzwiki/tests/
Disallow:/saltwiki/cache/
Disallow:/saltwiki/docs/
Disallow:/saltwiki/extensions/
Disallow:/saltwiki/images/
Disallow:/saltwiki/includes/
Disallow:/saltwiki/languages/
Disallow:/saltwiki/maintenance/
Disallow:/saltwiki/mw-config/
Disallow:/saltwiki/resources/
Disallow:/saltwiki/serialized/
Disallow:/saltwiki/skins/
Disallow:/saltwiki/tests/
Disallow:/repository/
Disallow:/salzwiki_draft/
Disallow:/saltwiki_draft/
Disallow:/repository_draft/
Disallow:/salz_salt_repo/
Disallow:/mediawiki_1_23_11/

Im jeweiligen Wiki-Hauptverzeichnis:

# Robots sollen keine Unterverzeichnisse durchsuchen
User-agent: Riddler
Disallow:/

User-agent: *
Disallow:/cache/
Disallow:/docs/
Disallow:/extensions/
Disallow:/images/
Disallow:/includes/
Disallow:/languages/
Disallow:/maintenance/
Disallow:/mw-config/
Disallow:/resources/
Disallow:/serialized/
Disallow:/skins/
Disallow:/tests/

Setzen von Keywords für den Head-Bereich eines Wikis[Bearbeiten]

Hierzu ist in der Datei "LocalSettings.php" die Funktion "efSetKeywords()" mit den entsprechenden Keywords einzufügen. Hier am Beispiel von SaltWiki. Diese sind jedoch nur bei Zugang über die IP-Adresse und nicht über den Frame von 1&1 sichtbar. Damit Keywords über den Frame sichtbar sind, sind diese für unseren Zugang bei 1&1 bei der Einrichtung der Website mit anzugeben. Dasselbe gilt für "description".

##Setzen von keywords
function efSetKeywords(){
   global $wgOut;
   $wgOut->addKeyword( 'salt' );
   $wgOut->addKeyword( 'desalination' );
   $wgOut->addKeyword( 'salt decay' );   
   $wgOut->addKeyword( 'cultural heritage' );   
   $wgOut->addKeyword( 'salt damage' );
   $wgOut->addKeyword( 'conservation' );
}

E-Mail-Versand[Bearbeiten]

Die HAWK-Outlook-Adressen können nicht für den Versand per SMTP als Absender verwendet werden, sondern nur als Zieladresse.

Die Datei "localSettings.php" wurde in den Verzeichnissen

  • salzwiki/
  • repository/
  • saltwiki/

folgendermaßen für E-Mail-Versand angepasst:

Salzwiki/Repositorium

## E-Mail-Versand angepasst 15.01.2016 G. Werner
$wgEmergencyContact = "salzwiki.fb@hawk-hhg.de";
$wgPasswordSender = "service@salzwiki.de"; 
$wgSMTP = array( 
 'host' => "smtp.1und1.de", 
 'IDHost' => "1und1.de", 
 'port' => "587", 
 'auth' => true, 
 'username' => "service@salzwiki.de", 
 'password' => "********" 
);
$wgEnotifUserTalk = true; # UPO
$wgEnotifWatchlist = true; # UPO
$wgEmailAuthentication = true;

Saltwiki

## E-Mail-Versand angepasst 15.01.2016 G. Werner
$wgEmergencyContact = "saltwiki.fb@hawk-hhg.de";
$wgPasswordSender = "service@saltwiki.net"; 
$wgSMTP = array( 
 'host' => "smtp.1und1.de", 
 'IDHost' => "1und1.de", 
 'port' => "587", 
 'auth' => true, 
 'username' => "service@saltwiki.net", 
 'password' => "********" 
);
$wgEnotifUserTalk = true; # UPO
$wgEnotifWatchlist = true; # UPO
$wgEmailAuthentication = true;

Externe Links[Bearbeiten]

Damit externe Links in einem neuen Fenster geöffnet werden, ist in die "localsettings.php" einzufügen:

##Externe links erscheinen in einem neuen Fenster
$wgExternalLinkTarget = '_blank';

Datenbank-Fehler[Bearbeiten]

Falls ein Hinweis "A database query error has occured" angezeigt wird, kann man sich weitere Angaben anzeigen lassen, indem man in der Datei "LocalSettings.php" unten einfügt:

$wgShowSQLErrors = 1;

Versionshinweise[Bearbeiten]

Betriebssystem und Wiki-Serversysteme[Bearbeiten]

Datenbanksystem[Bearbeiten]

  • MySQL-Upgrade von Version 5.1 zu Version 5.6 ist nur möglich über Version 5.5
  • XAMPP hat zuletzt in Version 1.8.2-6 die MySQL-Version 5.5.x, danach die Version 5.6
  • XAMPP hat bis Version 5.5.28 bzw. 5.6.12 als Datenbanksystem MySQL, danach MariaDB
  • XAMPP hat in Version 5.6.14.0 die MariaDB-Version 10.0.x, aber in Version 5.6.14.3 die MariaDB-Version 10.1.x

XAMPP[Bearbeiten]

XAMPP 5.6.30[Bearbeiten]

  • PHP 5.6.30 32Bit
  • VC11 MS Visual C++ 2012 redistributable x86 Update 4
  • MariaDB 10.1.21 Win32 (Server), libmysql - mysqlnd 5.0.11dev (Client)
  • Apache 2.4.25 Win32
  • phpMyAdmin 4.6.5.2, Zeichensatz MySQL-Verbindung utf8mb4_unicode_ci
  • OpenSSL 1.0.2j
  • XAMPP Control Panel 3.2.2

In phpMyAdmin 4.6.5.2 ist ein Bug, der eine Fehlermeldung erzeugt, wenn versucht wird, ein neues Datenbank-Nutzungskonto zu erstellen. Die Lösung besteht darin, im Verzeichnis "D:\xampp\mysql\" die Unterverzeichnisse "lib\plugin\" zu erstellen.

XAMPP 5.6.14.3[Bearbeiten]

  • PHP 5.6.14 32Bit
  • VC11 MS Visual C++ 2012 redistributable x86 Update 4
  • MariaDB 10.1.8 Win32 (Server), libmysql - mysqlnd 5.0.11dev (Client)
  • Apache 2.4.17 Win32
  • phpMyAdmin 4.5.1, Zeichensatz MySQL-Verbindung utf8mb4_unicode_ci
  • OpenSSL 1.0.2d
  • XAMPP Control Panel 3.2.2

XAMPP 5.5.30/5.6.14.0[Bearbeiten]

  • PHP 5.5.30/5.6.14 32Bit + Pear, MS VC11 x86 32Bit ThreadSafe
  • VC11 MS Visual C++ 2012 redistributable x86 Update 4
  • MariaDB 10.0.17 Win32 (Server), libmysql - mysqlnd 5.0.11dev (Client)
  • Apache 2.4.17 Win32
  • phpMyAdmin 4.5.0.2, Zeichensatz MySQL-Verbindung utf8mb4_unicode_ci
  • OpenSSL 1.0.2d
  • XAMPP Control Panel 3.2.1

XAMPP 5.5.28/5.6.12[Bearbeiten]

  • PHP 5.5.28/5.6.12 + Pear, MS VC11 x86 32Bit ThreadSafe
  • MySQL 5.6.26-Community
  • Apache 2.4.16 Win32
  • phpMyAdmin 4.4.14
  • openSSL 1.0.1i

XAMPP 1.8.2-6[Bearbeiten]

  • PHP 5.4.31, MS VC9
  • MySQL 5.5.32-Community
  • Apache 2.4.4 Win32
  • phpMyAdmin 4.0.4
  • openSSL 0.9.8y mit OpenSSL-Bug "Heartbleed"

XAMPP 1.8.0[Bearbeiten]

Neues Sicherheitskonzept: Zugriff per Browser auf Verzeichnisse wie "phpmyadmin" nur noch direkt vom Server aus ("Require local")

XAMPP 1.7.1[Bearbeiten]

  • PHP 5.2.9, MS Visual C++ 2008 redistributable x86 9.0...
  • MySQL 5.1.33-Community Client 5.0.51a
  • Apache 2.2.11 Win32
  • phpMyAdmin 3.1.3.1

MediaWiki[Bearbeiten]

Informationen zu

MW Version 1.30[Bearbeiten]

  • Hooks
    • $wgExceptionHooks['MWException'][] entfällt

MW Version 1.27[Bearbeiten]

  • Datei "LocalSettings.php" anpassen
    • $wgScriptExtension entfällt
  • Skins-Element
    • $wgCopyrightIcon wird ersetzt durch $wgFooterIcons['copyright']['copyright']
  • Core-Variablen
    • $wgSessionHandler gilt als veraltet

MW Version 1.26[Bearbeiten]

MW Version 1.25[Bearbeiten]

Skin-Registrierung

wfLoadSkin("MonoBook"); //statt require_once "$IP/skins/MonoBook.php";

Erweiterungen-Registrierung

wfLoadExtension("Cite"); //statt require_once "$IP/extensions/Cite/Cite.php";

MW Version 1.24[Bearbeiten]

  • Logo-Speicherort geändert von "skins/common/images/" zu "resources/assets/" bzw. "images/..."
  • Bisher mitgelieferte Skins sind nicht mehr enthalten; die jeweiligenSkins-php-Dateien und Ordner sind gegebenenfalls aus dem Verzeichnis "skins/" zu entfernen:
    • CologneBlue.php, cologneblue
    • Modern.php, modern
    • MonoBook.php, monobook
    • Vector.php, vector
  • Datei "LocalSettings.php" eventuell an neue Skin-Registrierung anpassen
require_once "$IP/skins/MonoBookSW.php"; //statt $wgDefaultSkin = "monobooksw";
  • Nicht mehr unterstützt wird "register_globals => Bei PHP vor Version 5.4 in der Datei "php.ini" angeben "register_globals=Off"
  • Erweiterung "OggHandler" wird nicht mehr unterstützt

MW Version 1.23[Bearbeiten]

  • Skins werden anders eingebunden
    • Das jeweilige Skin-Unterverzeichnis sollte wie die php-Datei die Groß-Klein-Schreibweise berücksichtigen ("monobooksw/" => "MonoBookSW/")
    • Kleinbuchstaben bei $wgDefaultSkin = "monobooksw"; in der Datei "LocalSettings.php"
    • Die Skin-php-Datei, z. B. "MonoBookSW.php", ist nicht mehr im Verzeichnis "skins/", sondern im Unterverzeichnis, z. B. "skins/MonoBookSW/"
    • Die Skin-Datei "MonoBookSW.php" anpassen an die neue Version, siehe www.mediawiki.org/wiki/Manual:Skin_autodiscovery#Migration_guide
  • "Autodiscovery mechanism" für "Core Skins" gilt als "deprecated" und schreibt Warnungen in die Log-Dateien. Folgende Dateien und Ordner sind gegebenenfalls aus dem Verzeichnis "skins/" zu entfernen:
    • Chick.php, chick
    • Nostalgia.php, nostalgia
    • Simple.php, simple
    • Standard.php, standard
  • "The info page action, which provides useful statistics for any given page, has been improved and turned on by default."
  • Bei "Spezialseiten" wird die "ISBN-Suche" unter "Daten und Werkzeuge" statt unter "Andere Spezialseiten" angezeigt.
  • $wgPasswordSenderName wurde abgeschafft; der Name für die E-Mail-Adresse von $wgPasswordSender kann nur noch in der Seite "MediaWiki:Emailsender" angepasst werden

MW Version 1.21[Bearbeiten]

  • implementierte Erweiterungen
    • Cite
    • ImageMap
    • TitleBlacklist
    • SpamBlacklist
    • Interwiki bzw. SpecialInterwiki u. a.
  • Änderungen
    • Die Funktion "wfLoadExtensionMessages()" existiert nicht mehr, wird aber von BibManager REL1_23 verwendet und muss auskommentiert werden

MW Version 1.20[Bearbeiten]

  • PHP 5.3.2 oder neuer ist erforderlich
  • Erweiterungen, die Elemente der neuen Version voraussetzen
    • ApprovedRevs
    • Cite u. a.

MW Version 1.19[Bearbeiten]

  • $wgEnableCreativeCommonsRdf für "LocalSettings.php" wird nicht mehr unterstützt; stattdessen gibt es eine Erweiterung "CreativeCommonsRdf", die Beta-Status hat (2015-09-21).

MW Version 1.18[Bearbeiten]

  • MySQL 5.0.2 oder neuer ist erforderlich
  • mehr Genderneutralität bei Sprachdateien
  • Neue "Hooks"
    • BaseTemplateToolbox
  • implementierte Erweiterungen
    • ConfirmEdit
    • ParserFunctions mit Control Structure Functions ohne Loops
    • RenameUser
    • Nuke u. a.
  • Neue Erweiterungen
    • "Math", bisher Datei "\includes\math.php", siehe https://www.mediawiki.org/wiki/Texvc/de, verwendet "texvc", welches 3 Zusatzprogramme benötigt:
      • ocaml
      • LaTeX
      • dvipng
    • "WikiEditor", bisher Datei "\includes\EditPage.php" bzw. JS-Erweiterung "Extra Edit Buttons (XEB)", siehe en.wikipedia.org/wiki/User:MarkS/Extra_edit_buttons und en.wikipedia.org/wiki/User:MarkS/extraeditbuttons.js

MW Version 1.17[Bearbeiten]

  • PHP 5.2.3 oder neuer ist erforderlich
  • neuer Installationsvorgang
  • Kategoriensortierung geändert
  • Interwiki-Verweise werden in gesonderten Tabellen gespeichert
  • Standard-Skin "vector" statt "monobook"
  • neue Variable $wgPasswordSenderName (existiert nur bis Version 1.22)

SalzWiki SaltWiki Repository[Bearbeiten]

Anpassungen an Systemdateien[Bearbeiten]

Verzeichnisse und Dateien im jeweiligen Wiki:

  • includes
    • EditPage.php
    • HttpFunctions.php
    • Skin.php für 2 Varianten des linken Menüs
    • SkinTemplate.php für Werkzeuge ohne Datei-Upload
    • SkinTemplate.php für Werkzeuge ohne Spezialseiten
    • specialpage\SpecialPageFactory.php für Werkzeuge ohne Spezialseiten
  • languages
    • i18n\de-formal.json für Text bei Kontaktformular
  • skins
    • MonoBook.php für Footer-Elemente und eingeschränkte Sichtbarkeit von Werkzeugen
    • monobook\main.css für allgemeine Farben und für Farben in bestimmten Seitenbereichen

Upgrade vorhandener Wikis[Bearbeiten]

  1. neue Wiki-Version 1.31 entpacken nach "D:\noxampp\[wikiname]"
  2. Erweiterungen
    1. Erweiterungen für aktuelle Version herunterladen
    2. aktuelle Erweiterungen entpacken nach "D:\noxampp\[wikiname]\extensions"
  3. Datei "LocalSettings.php" umbenennen zu "LocalSettings_original_131.php"
  4. Dateien vom alten Server zum neuen Server kopieren
    1. ...\[wikiname]\images inkl. eigenem Unterverzeichnis "commons\"
    2. ...\[wikiname]\LocalSettings.php
  5. Wiki-Datenbanken
    1. Datenbankdaten auf dem alten Server sichern
    2. Datenbankdaten vom alten zum neuen Server kopieren
    3. Datenbankdaten auf dem neuen Server wiederherstellen
  6. Wiki-Anpassungen
    1. Datei "LocalSettings.php" vergleichen mit Angaben in "LocalSettings_original_131.php" und anpassen
    2. Datei "...\[wikiname]\maintenance\runJobs.php" mit php.exe auf der Admin-Kommandozeile ausführen
    3. Datei "...\[wikiname]\maintenance\upgrade.php" mit php.exe auf der Admin-Kommandozeile ausführen

Datenbanken sichern[Bearbeiten]

Kommandozeile als Administrator öffnen und folgenden Befehl eingeben:

D:
cd xampp\mysql\bin
mysqldump -uroot -p --databases db_wikiname > D:\Backup_193.175.110.91\Laufwerk_D\Backups
mysqldump --user=root --password --databases db_wikiname > D:\Backup_193.175.110.91\Laufwerk_D\Backups\db_wikiname_MW1.16_MariaDBv10.0.17_yyyymmdd.sql

Datenbanken wiederherstellen[Bearbeiten]

Kommandozeile als Administrator öffnen und folgenden Befehl eingeben:

D:
cd xampp\mysql\bin
mysql -uroot -p --execute="source D:\Backups\db_wikiname_MW1.16_MariaDBv10.0.17_yyyymmdd.sql" --force
mysql --user=root --password --execute="source D:\Backups\db_wikiname_MW1.16_MariaDBv10.0.17_yyyymmdd.sql" --force

Datenbank mittels XAMPP und phpmyAdmin anlegen[Bearbeiten]

Seit der Version 1.16.1 kann die jeweilige Datenbank statt mit phpMyAdmin während der Installation mittels Browser (/[wikiverzeichnis]/config/index.php) angelegt werden, sofern der Superuser-Account (Datenbank-Hauptadministrator) bekannt ist:

salzwiki[Bearbeiten]

Database name: salzwiki
Benutzer: SW_sawi 
Host: localhost 
Global Rechte: all privileges 
Grant: ja 
database table prefix: sw_

repository[Bearbeiten]

Database name: repository 
Benutzer: SW_repo 
Host: localhost 
Global Rechte: all privileges 
Grant: ja 
database table prefix: sr_

saltwiki[Bearbeiten]

Database name: saltwiki 
Benutzer: SW_sawi 
Host: localhost 
Global Rechte: all privileges 
Grant: ja 
database table prefix: sw_

Mediawiki Installieren[Bearbeiten]

  • Für die jeweiligen Wikis einen entsprechenden Wiki- und Verzeichnisnamen festlegen: "salzwiki", "repository", "saltwiki".
  • Die Dateien und Verzeichnisse aus der tar.gz-Datei in das jeweilige Wiki-Verzeichnis entpacken:
"D:\xampp\htdocs\[wikiverzeichnisname]\"
  • Nach Installationsanweisung das jeweilige Wiki installieren; hierzu im Browser die Adresse "D:\xampp\htdocs\[wikiverzeichnisname]\mw-config\index.php" aufrufen.
    • Contact e-mail: service@salzwiki.hawk-hhg.de
    • Language: Je nach Wiki Deutsch oder English
    • Copyright/license: Creative Commons
    • Admin username: Hornemann
    • Object caching: No
    • E-Mail
      • E-mail features: enabled
      • User-to-user e-mail: enabled
      • E-mail notification: enabled for discussion pages nad watchlists
      • E-mail address authentication: enabled
    • Datenbank
      • Database type: MySQL
      • Database host: localhost
      • Database name: [wikiname]
      • DB username: SW_sawi (SalzWiki, SaltWiki) bzw. SW_repo (Repositorium) hi_wiki_1
      • Superuser account: yes
      • Superuser name: root
      • Database table prefix: sw_ (SalzWiki, Saltwiki) bzw. sr_ (Repositorium)
      • Storage Engine: InnoDB
      • Database character set: MySQL 4.1/5.0 binary
    • Wiki
      • SalzWiki bzw. SaltWiki bzw. Repository
      • Projektraum entspricht Namen des Wikis
      • Benutzername: Hornemann
      • E-Mail-Adresse: salzwiki@hornemann-institut.de
    • Optionen
      • ausschließlich berechtigte Bearbeiter (SalzWiki, SaltWiki) bzw. geschlossenes Wiki (Repository)

Lizenz für das jeweilige Wiki[Bearbeiten]

Verwendet werden Creative-Commons-Lizenzen. Für SalzWiki wird die deutsche Variante, für SaltWiki und Repository wird die Standard-Variante vom Typ "cc-by-nc-sa" – Version 3.0 (Stand 2017-07-21) – eingesetzt.

Da die Grafiken unter "\skins\images\common\cc-..." keine Unterscheidung nach Versionsnummer und Länderversion anbieten, werden die Grafiken von "Creative Commons" heruntergeladen, umbenannt und gespeichert unter "[wikiname]\images\common\":

Die Lizenzkonfiguration erfolgt in der Datei "LocalSettings.php":

  • Salzwiki
## For attaching licensing metadata to pages, and displaying an 
## appropriate copyright notice / icon. GNU Free Documentation 
## License and Creative Commons licenses are supported so far. 
$wgRightsPage = ""; # Set to the title of a wiki page that describes your license/copyright 
## Deutsch
$wgRightsUrl = "https://creativecommons.org/licenses/by-nc-sa/3.0/de/"; 
$wgRightsText = "Namensnennung-Nicht-kommerziell-Weitergabe unter gleichen Bedingungen 3.0 Deutschland"; 
// bei MW 1.23
#$wgRightsIcon = "https://i.creativecommons.org/l/by-nc-sa/3.0/de/88x31.png";
#$wgRightsIcon = "{$wgStylePath}/common/images/cc-by-nc-sa.png";
$wgRightsIcon = $wgScriptPath."/common/images/CC_BY_NC_SA_3.0_de_88x31.png";
# $wgRightsCode = "[license_code]"; # Not yet used
  • Saltwiki und Repositorium
## For attaching licensing metadata to pages, and displaying an 
## appropriate copyright notice / icon. GNU Free Documentation 
## License and Creative Commons licenses are supported so far. 
$wgRightsPage = ""; # Set to the title of a wiki page that describes your license/copyright 
## English und Repositorium
$wgRightsUrl = "https://creativecommons.org/licenses/by-nc-sa/3.0/"; 
$wgRightsText = "Attribution-Noncommercial-Share Alike 3.0 Unported"; 
// bei MW 1.23
#$wgRightsIcon = "https://i.creativecommons.org/l/by-nc-sa/3.0/88x31.png";
#$wgRightsIcon = "{$wgStylePath}/common/images/cc-by-nc-sa.png";
$wgRightsIcon = $wgScriptPath."/common/images/CC_BY_NC_SA_3.0_en_88x31.png";
# $wgRightsCode = "[license_code]"; # Not yet used

Style/Skin[Bearbeiten]

MW 1.23 LTS MonoBook[Bearbeiten]

Das Design für das Salzwiki basiert wegen der Hintergrundgrafik und der links angeordneten Footer-Icons weiter auf dem Stil (Skin) "Monobook", obwohl der Stil seit MW 1.17 von "Vector" als Standardstil abgelöst wurde. Dazu wird die Original-Datei "MonoBook.php" wegen der veralteten Auto-discovery-Funktion, die "Monobook" bei MW 1.23 LTS noch hat, als Kopie namens "MonoBook_Original.php" im Verzeichnis "skins\monobook\" gespeichert.

In der Datei "LocalSettings.php" heißt die entsprechende Zuweisung dann
$wgDefaultSkin = "monobook";.

Zusätzlich sind darunter folgende Zeilen erforderlich:

  // CC-Icon rechts unten für "MonoBook" angepasst 2015-09-28:
  $wgFooterIcon_copyright['copyright'] = array(
    "src" => $wgRightsIcon, // Icon
    "url" => $wgRightsUrl,
    "alt" => $wgRightsText,
    //"height" => "", // Icon-Höhe
    //"width" => "" // Icon-Breite
  );
  unset($wgFooterIcons['copyright']);
  $wgFooterIcons_r['poweredby'] = array_merge($wgFooterIcon_copyright,$wgFooterIcons['poweredby']);
  // für "MonoBook" und "Vector" ergänzt
  ## FOOTER-Icons links, wobei der erste Schlüssel zu <li id="footer-...ico"> verarbeitet wird
  $wgFooterIcons_l['copyright']['hornemanninstitut'] = array(
    "src" => "$wgScriptPath/images/common/HI.png", // Icon
    "url" => "http://www.hornemann-institut.de",
    "alt" => "Hornemann Institut",
    //"height" => "", // Icon-Höhe
    //"width" => "" // Icon-Breite
  );
  $wgFooterIcons_l['copyright']['hawk'] = array(
    "src" => "$wgScriptPath/images/common/hawk.png", // Icon
    "url" => "http://www.hawk-hhg.de",
    "alt" => "HAWK HHG",
    //"height" => "", // Icon-Höhe
    //"width" => "" // Icon-Breite
  );
  $wgFooterIcons_l['copyright']['dfg'] = array(
    "src" => "$wgScriptPath/images/common/DFG.jpg", // Icon
    "url" => "http://www.dfg.de",
    "alt" => "DFG",
    //"height" => "", // Icon-Höhe
    //"width" => "" // Icon-Breite
  );
  // für "Vector"
  #$wgFooterIcons_r = $wgFooterIcons;
  unset($wgFooterIcons);
  $wgFooterIcons = array_merge($wgFooterIcons_l, $wgFooterIcons_r);

MW 1.23 LTS Vector[Bearbeiten]

Bei der Verwendung von "Vector" wird die Original-Datei "skins\Vector.php" wegen der veralteten Auto-discovery-Funktion, die "Vector" bei MW 1.23 LTS noch hat, als Kopie namens "Vector_Original.php" im Verzeichnis "skins\vector\" gespeichert.

In der Datei "LocalSettings.php" heißt die entsprechende Zuweisung dann
$wgDefaultSkin = "vector";.

Im Verzeichnis "vector/components/footer.less" wird für die eigenen Icons im Footer unten links die Definition von "#footer-icons" kopiert und umbenannt in "#footer-icons-left" und folgendermaßen angepasst:

/* SalzWiki eingefügt 2015-09-28 */
#footer-icons-left {
  float: left;
  li {
    float: left;
    margin-right: 0.5em;
    line-height: 2em;
    text-align: left;
  }
}

Im Verzeichnis "vector/images/" wird die Datei "headbg.jpg" für ein eigenes Hintergrundbild eingefügt.

Im Verzeichnis "vector/components/common.less" wird für das Hintergrundbild "body" folgendermaßen angepasst:

body {
  /* SalzWiki eingefügt 2015-09-28 */
  background: #F9F9F4 url("headbg.jpg");
  /*background-color: @menu-background-color*/
}

HAWK-Design[Bearbeiten]

Für Anpassungen der StyleSheets an das HAWK-Design siehe Adm:HAWK-Design.

[Bearbeiten]

Die Datei für das Logo links oben ist hochzuladen und in der Datei "LocalSettings.php" zuzuweisen:

  • Salzwiki
##Logo MW1.23
$wgLogo = $wgScriptPath."/images/common/Logo_Salz.png";
  • Saltwiki
##Logo MW1.23
$wgLogo = $wgScriptPath."/images/common/Logo_Salt.png";
  • Repositorium
##Logo MW1.23
$wgLogo = $wgScriptPath."/images/common/Logo_Repo.png";

Fußzeile "Footer" anpassen[Bearbeiten]

Um "Footer"-Verweise auszublenden und anzupassen sowie eigene Logos mit Verlinkung einzufügen, sind folgende Schritte notwendig:

LocalSettings.php anpassen[Bearbeiten]

Änderungen in der Datei "LocalSettings.php" "MonoBookSW.php": Zeile 141ff:

Ausblendung des Besuche-Zählers[Bearbeiten]

Die Anzeige der Texte von "Anzahl der Seitenabrufe" wird bei MW1.23 wie folgt unterbunden:

$wgDisableCounters = true;
Anpassung für Logos links und rechts[Bearbeiten]

Die Logos und Verweise links für "Hornemann Institut", "HAWK" und "SIK" sowie rechts für "CC-Lizenz" und "Powered by MediaWiki" werden wie folgt festgelegt:

#### Beginn FOOTER ab Version MW1.23
// CC-Icon rechts unten für "MonoBook" angepasst 2015-09-28:
$wgFooterIcon_copyright['copyright'] = array(
  "src" => $wgRightsIcon, // Icon
  "url" => $wgRightsUrl,
  "alt" => $wgRightsText,
  //"height" => "", // Icon-Höhe
  //"width" => "" // Icon-Breite
);
unset($wgFooterIcons['copyright']);
$wgFooterIcons_r['poweredby'] = array_merge($wgFooterIcon_copyright,$wgFooterIcons['poweredby']);
// für "MonoBook" und "Vector" ergänzt
## FOOTER-Icons links, wobei der erste Schlüssel zu <li id="footer-...ico"> verarbeitet wird
$wgFooterIcons_l['copyright']['hornemanninstitut'] = array(
  "src" => "$wgScriptPath/images/common/HI.png", // Icon
  "url" => "http://www.hornemann-institut.de",
  "alt" => "Hornemann Institut",
  //"height" => "", // Icon-Höhe
  //"width" => "" // Icon-Breite
);
$wgFooterIcons_l['copyright']['hawk'] = array(
  "src" => "$wgScriptPath/images/common/hawk.png", // Icon
  "url" => "http://www.hawk-hhg.de",
  "alt" => "HAWK HHG",
  //"height" => "", // Icon-Höhe
  //"width" => "" // Icon-Breite
);
$wgFooterIcons_l['copyright']['sik'] = array(
  "src" => "$wgScriptPath/images/common/SIK.png", // Icon
  "url" => "http://http://www.salze-kulturgut.de",
  "alt" => "SIK",
  "height" => "30px", // Icon-Höhe
  "width" => "30px" // Icon-Breite
);
// für "Vector"
#$wgFooterIcons_r = $wgFooterIcons;
unset($wgFooterIcons);
$wgFooterIcons = array_merge($wgFooterIcons_l, $wgFooterIcons_r);
#### Ende FOOTER ab Version MW1.23
Anpassung mittlerer Fußzeilen-Elemente[Bearbeiten]

Die Änderung von "Über [Wiki-Name]" zu "Forschungsverbund"/"Projektverbund" findet nicht mehr statt. Stattdessen muss "Disclaimer" durch "Impressum" ersetzt werden und wird "about" weggelassen.

Die Anzeige der Texte von "lastmodified", "about" und "CC-Lizenz" im mittleren Bereich kann mit einem "Hook" wie folgt unterbunden werden:

#### Beginn mittlerer FOOTER ab Version MW1.23
// Elemente verbergen
$wgHooks['SkinTemplateOutputPageBeforeExec'] = 'lfHide';
function lfHide( $skin, &$template ) {
  $template->set( "lastmod", "");
  $template->set( "copyright", "");
  $template->set( "about", "");
  return true;
};
// "Haftungsausschluss" wird auf der Seite "MediaWiki:Disclaimers" durch "Impressum" ersetzt
// Datenschutz ist bei MW1.31 mit "privacy" standardmäßig enthalten
// Projektverbund soll nicht mehr im Fußbereich erscheinen
#### Ende mittlerer FOOTER ab Version MW1.23

Für neue, geänderte und ausgeblendete Footer-Verweise, siehe auch https://www.mediawiki.org/wiki/Manual:Footer. Nicht mehr erforderliche Festlegungen:

// "Haftungsausschluss" wird auf der Seite "MediaWiki:Disclaimers" durch "Impressum" ersetzt
#$wgHooks['SkinTemplateOutputPageBeforeExec'][] = function ($sk, &$tpl){
#  $tpl->set('impressum', $sk->footerLink('impressum', 'Impressum'));
#  $tpl->data['footerlinks']['places'][] = 'impressum';
#  return true;
#}
// Datenschutz ist bei MW1.23 standardmäßig enthalten
#$wgHooks['SkinTemplateOutputPageBeforeExec'][] = function ($sk, &$tpl){
#  $tpl->set('datenschutz', $sk->footerLink('datenschutz', 'Datenschutz'));
#  $tpl->data['footerlinks']['places'][] = 'datenschutz';
#  return true;
#}
// Projektverbund soll nicht mehr im Fußbereich erscheinen
#$wgHooks['SkinTemplateOutputPageBeforeExec'][] = function ($sk, &$tpl){
#  $tpl->set('projektverbund', $sk->footerLink('projektverbund', 'Projektverbund'));
#  $tpl->data['footerlinks']['places'][] = 'projektverbund';
#  return true;
#}

Angeblich können auch nicht erwünschte "Footer"-Seiten ausgeblendet werden, indem im Namensraum "MediaWiki:..." der enthaltene Text durch einen Bindestrich ersetzt wird, siehe https://www.mediawiki.org/wiki/Manual:Footer#Customizing_the_Built-in_items letzte Zeile. Dann müsste aber bei der entsprechenden Seite für jede Sprache die Änderung erfolgen.

Ursprüngliche Texte für "de-formal":

  • "MediaWiki:About": Über
  • "MediaWiki:Copyright": Der Inhalt ist verfügbar unter der Lizenz $1, sofern nicht anders angegeben.
  • "MediaWiki:Lastmodifiedat": Diese Seite wurde zuletzt am $1 um $2 Uhr bearbeitet.

MonoBook.php nicht mehr anpassen (Wiki-Code)[Bearbeiten]

Wenn die Datei "[wikiname]\skins\MonoBook.php" bearbeitet wird, ist im Verzeichnis "[wikiname]\skins\monobook" eine Kopie der Datei als "MonoBook_original.php" uz speichern und von der geänderten Datei als Backup für Wiki-Updates ebenfalls im Verzeichnis "\monobook" eine Kopie als "MonoBookSW.php" zu speichern.

Wird kein "Hook" in der Datei "LocalSettings.php" verwendet, können in der Datei "MonoBook.php" die Texte von "lastmodified" und "CC-Lizenz" sowie der Verweis zu "Über" bzw. "About" durch eigenen Code unter Zeile 154 herausgefiltert werden:

<?php
      foreach ( $validFooterLinks as $aLink ) { ?>
        <?php if($aLink!=="lastmod" && $aLink!=="copyright" && $aLink!=="about"){ /*eingefügt für HAWK HHG 2015-12-07 u. 2016-03-29*/ ?>
    <li id="<?php echo $aLink ?>"><?php $this->html( $aLink ) ?>
<?php   } /*eingefügt für HAWK HHG 2015-12-07*/
      }
?>

Original:

<?php
      foreach ( $validFooterLinks as $aLink ) { ?>
    <li id="<?php echo $aLink ?>"><?php $this->html( $aLink ) ?>
<?php
      }
?>

CSS-Anpassungen als Alternative (Wiki-Code)[Bearbeiten]

Alternativ kann in der Datei "\skins\monobook\main.css" unterhalb der Angaben für den Footerbereich in Zeile 550 die Anzeige verhindert werden, wobei der HTML-Quelltext für die Listenelemente aber trotzdem erzeugt wird:

/* eingefügt für HAWK HHG 2015-12-07 */
#f-list #lastmod, #f-list #copyright {
  display:none;
}

HTML-Footer-Elemente[Bearbeiten]

Bei MW1.17 bis 1.23 kann die Variable $wgFooterIcons für Icons links und rechts unten im Footer erweitert werden. Wie bei MW1.16 gibt es auch noch die Variable $wgCopyrightIcon, mit der nur der Bereich rechts unten im Footer angepasst werden kann.

Bei MW1.23 besteht der Footer-Container aus folgenden Bereichen:

  • div id="footer"
    • div id="f-copyrightico" (unterer Footer-Bereich links)
    • div id="f-poweredbyico" (unterer Footer-Bereich rechts)
    • ul id="f-list" (oberer=mittlerer Footer-Bereich)
      • li id="lastmod"
      • li id="viewcount"
      • li id="copyright"
      • li id="privacy"
      • li id="about"
      • li id="disclaimer"

Bei MW1.16 bestand der Footer-Container aus folgenden Bereichen:

  • ul id="footer-info" (oberer Footer-Bereich)
    • li id="footer-info-lastmod"
    • li id="footer-info-copyright"
  • ul id="footer-places" (unterer Footer-Bereich links)
    • ul id="footer-places-privacy"
    • ul id="footer-places-about"
    • ul id="footer-places-disclaimer"
  • ul id="footer-icons" (unterer Footer-Bereich rechts)
    • ul id="footer-copyrightico"
    • ul id="footer-poweredbyico"

"Forschungsverbund"/"Projektverbund" statt "Über [Wiki-Name]"[Bearbeiten]

Damit im "Footer" statt auf die Seite "Über SalzWiki" auf die Seite "Forschungsverbund" "Projektverbund" bzw. "Research Network" verlinkt wird, sind Änderungen an "Aboutsite" und "Aboutpage" vorzunehmen. Hierzu entweder über "Spezialseiten->Systemdaten und Werkzeuge->MediaWiki-Systemtexte" gehen oder folgende Adressen eingeben:

"[Wiki-Verzeichnis]/index.php?title=MediaWiki:Aboutsite/de[-formal|-at|-ch]&action=edit"
bzw.
"[Wiki-Verzeichnis]/index.php?title=MediaWiki:Aboutpage/de&action=edit"
  • Link-Text in "aboutsite" bearbeiten:
Projektverbund
<!--Über {{SITENAME}}-->
  • Seitenname, zu dem verlinkt wird, in "aboutpage" bearbeiten:
Project:Über

ersetzen durch

Forschungsverbund

Diese Änderungen müssen auf allen Sprach-Subpages für Aboutsite und Aboutpage - nämlich für "de", "de-formal", "de-at" und "de-ch" - durchgeführt werden, da die Änderungen an den Seiten "Aboutpage" und "Aboutsite" sich nur bei den Standard-Sprachversion wie "de" auswirken, jedoch nicht z. B. bei "de-formal". Deshalb wurden als auszuwählende Sprachen "de-formal", "de-at" und "de-ch" vorerst deaktiviert in der Datei [wikiverzeichnisname]\languages\Names.php Wenn ein User in den Profileinstellungen die Sprache abweichend von der Festlegung "de-formal" in der Datei "LocalSettings.php" auf "de" einstellt, funktioniert eventuell "Forschungsverbund" erst, nachdem "English" oder eine andere nicht-deutsche Sprache eingestellt wurde.

'de' => 'Deutsch',		# German ("Du")
##'de-at' => 'Österreichisches Deutsch',	# Austrian German
##'de-ch' => 'Schweizer Hochdeutsch',		# Swiss Standard German
##'de-formal' => 'Deutsch (Sie-Form)',		# German - formal address ("Sie") 

Um im "Footer" den Hyperlink "Forschungsverbund" statt "Projektverbund" angezeigt zu bekommmen, wird in der Skin-Datei der Code angepasst.

  • MW 1.23 Datei "MonoBook.php"
<?php foreach ($validFooterLinks as $aLink) { ?>
...
<?php } ?>

Favicon[Bearbeiten]

Damit in der Browser-Adresszeile ein Favicon dargestellt wird, ist eine Datei "salzwiki.ico" in das jeweilige Wiki-Verzeichnis hochzuladen und folgender Eintrag in der jeweiligen Datei "LocalSettings.php" vorzunehmen:

$wgFavicon = "/[wikiverzeichnisname]/salzwiki.ico";

Darstellung in einem Frame[Bearbeiten]

Diese Funktionalität war nötig, solange die Wikis über die IP durch Frame-"Weiterleitung" bei "1&1" erreichbar waren. Sie wurde im ersten Halbjahr 2017 überflüssig nach Änderung des DNS-Eintrags auf die HAWK-IP bei "1&1" im Rahmen der Umstellung auf HTTPS und Server-Zertifikate.

Seit MW Version 1.16.1 gibt es Vorkehrungen gegen CrossSiteScripting, was Seiten, die in Frames dargestellt werden und somit die Weiterleitung des Salzwiki-Hosters zur IP des HAWK-Rechenzentrumsservers, betrifft.

Die neuen Versionen des Internet Explorers und des Firefox zeigen eine Fehlermeldung, wenn man sich anmelden möchte, da der Inhalt in einem Frame angezeigt werden soll. Meist hilft die Nutzung eines Links zur IP-Seite weiter.

Dies ist zu umgehen, d.h. es tritt keine Fehlermeldung auf, wenn man in den localsetting.php einfügt:

$wgEditPageFrameOptions = 'false'; 

Hierzu näheres unter http://webcache.googleusercontent.com/search?q=cache:H1KG7SKYpvoJ:100thpriest.appspot.com/www.mediawiki.org/wiki/Project:Support_desk+mediawiki+1.16.1+frame+warnung+anmelden&cd=3&hl=de&ct=clnk&gl=de&client=firefox-a&source=www.google.de

* The X-Frame-Options header to send on pages sensitive to clickjacking
* attacks, such as edit pages. This prevents those pages from being displayed
* in a frame or iframe. The options are:
*
*   - 'DENY': Do not allow framing. This is recommended for most wikis.
*
*   - 'SAMEORIGIN': Allow framing by pages on the same domain. This can be used
*         to allow framing within a trusted domain. This is insecure if there
*         is a page on the same domain which allows framing of arbitrary URLs.
*
*   - false: Allow all framing. This opens up the wiki to XSS attacks and thus
*         full compromise of local user accounts. Private wikis behind a
*         corporate firewall are especially vulnerable. This is not
*         recommended.
*
* For extra safety, set $wgBreakFrames = true, to prevent framing on all pages,
* not just edit pages. 

Wiki-Konfiguration[Bearbeiten]

Die Konfiguration eines Wikis erfolgt hauptsächlich mit PHP-Variablen in der Datei "xampp\htdocs\[wikiname]\LocalSettings.php".

Z.23ff bei Verwendung der Domain-Adressen mit HTTP oder HTTPS

...
$wgSitename = "Salzwiki"; # "Salzwiki" "Saltwiki" "Repository"
...
$wgScriptPath = ""; # "/salzwiki" "/saltwiki" "/repository"
$wgScriptExtension = ".php";
...
## The protocol and server name to use in fully-qualified URLs
if($_SERVER['HTTPS']==="on" OR !empty($_SERVER['HTTPS'])){$protokoll = "https";}
else{$protokoll = "http";}
$wgServer = $protokoll."://".$_SERVER['SERVER_NAME'];
...

Z.23ff bei Verwendung der IP-Adresse

...
$wgSitename = "Salzwiki"; # "Salzwiki" "Saltwiki" "Repository"
...
$wgScriptPath = "/salzwiki"; # "/salzwiki" "/saltwiki" "/repository"
$wgScriptExtension = ".php";
...
## The protocol and server name to use in fully-qualified URLs
$wgServer = "http://".$_SERVER['SERVER_NAME'];
...

Spracheinstellungen[Bearbeiten]

Standardsprache[Bearbeiten]

Die Standardsprache wird in der Datei "LocalSettings.php" festgelegt, kann von den Usern in den Profileinstellungen aber nach den persönnlichen Bedürfnissen angepasst werden.

  • Salzwiki: $wgLanguageCode = "de-formal";
  • Saltwiki: $wgLanguageCode = "en";
  • Repositorium: $wgLanguageCode = "en";

de-formal korrigieren (Wiki-Code)[Bearbeiten]

Die Datei "[wikiname]\languages\i18n\de-formal.json" wird wegen einer Du-Form ergänzt. Zuvor ist die Datei als Kopie "de-formal_original.json" zu speichern. Nach der Korrektur ist für Wiki-Updates eine Kopie als "de-formalSW.json" zu speichern.

Für die Sie-Form wird aus der Datei "de.json" von Zeile 1759 "emailccme" mit Du-Form verwendet: "Sende eine Kopie der E-Mail an mich"; deshalb ist in der Datei "de-formal.json" in Zeile 216f zwischen "emailpagetext" und "emailccsubject" einzufügen:

"emailccme": "Eine Kopie der E-Mail an mich senden",

Zugangsberechtigungen[Bearbeiten]

Gruppen für Berechtigungen[Bearbeiten]

  • Administratoren = Chef-Redakteure für Accounts erstellen/sperren, Systemtexte bearbeiten, Wiki-Inhalte verschieben, löschen, importieren etc.
  • autor = Autor/in für Wiki-Inhalte
  • Benutzer = nur Diskussionsseiten
  • Bots (Systemgruppe)
  • Bürokraten = Rechtevergabe, Account-Vereinigung
  • Editor (saltwiki, repository) = Wiki-Inhalte-Kontrolle
  • Redakteur (salzwiki) = siehe Editor
  • Sicherheit = Seitensperre für Spezialseiten und gesperrte Seiten bei deaktiviertem JavaScript
  • Salzwiki, HAWK etc. = Gruppen im Repository
  • sysop = Hauptadministrator

Vergabe von Nutzerrechten durch den Hauptadministrator (sysop)[Bearbeiten]

Damit die unten beschriebenen Rechtevergaben umgesetzt werden können, erhält "sysop" zunächst den Zugang zu den SpecialPages, um auch nach Änderung der Datei "SpecialPage.php" Zugriff auf die Spezialseiten zu haben. Folgende Zeile ist in "LocalSettings.php" einzufügen:

    1. HJschwarz 22.02.2011, Ersteinstellung für "restrictusers" zum Einstellen der Rechte
$wgGroupPermissions['sysop']['restrictusers'] = true;	

Anschließend über SpecialPages->UserRightsManagement->[Username] die Rechte erweitern und alle Gruppen aktivieren.

Nutzerrechte bis zum Freischalten von Saltwiki[Bearbeiten]

Kein "normaler" Nutzer kann Seiten in SaltWiki lesen:

$wgGroupPermissions['*']['read'] = false;

Als Ausnahme werden mit $wgWhitelistRead alle im Array genannten Seiten dennoch für alle zum Lesen freigegegben, beispielsweise die Startseite und die Anmeldeseite.

Benutzer-Rechte in allen 3 Wikis[Bearbeiten]

Das Benutzerrechteschema sieht folgendermaßen aus:

// Salzwiki (auskommentiert)
#$wgWhitelistRead = arry(":Hauptseite", "Spezial:Userlogin", "Salzwiki:Impressum", "General_disclaimer");
// Saltwiki
#$wgWhitelistRead = arry("Welcome_to_SaltWiki", "Saltwiki:About", "Saltwiki:General disclaimer", "Saltwiki:Privacy policy");
// Repository
#$wgWhitelistRead = arry(":home", "Spezial:Userlogin");
// Salzwiki/Saltwiki
$wgWhitelistedit = "talk";
// Salzwiki/Saltwiki
$wgGroupPermissions['Sysadmin']['editadmin'] = true;
# alle duerfen lesen, alle dürfen nicht editieren
$wgGroupPermissions['*']['read']          = true;
$wgGroupPermissions['*']['edit']          = false;
$wgGroupPermissions['*']['createpage']    = false;
$wgGroupPermissions['*']['createaccount'] = false; // Salzwiki: true, Saltwiki/Repository: false
$wgGroupPermissions['*']['createtalk']    = false;
$wgGroupPermissions['*']['writeapi']      = false;
$wgGroupPermissions['*']['restrictusers'] = false; // Salzwiki/Saltwiki: false, Repository: auskommentiert

# Benutzer duerfen: lesen, Diskussionsseiten erstellen
$wgGroupPermissions['user']['read']            = true; // Salzwiki/Saltwiki: true, Repository: false
$wgGroupPermissions['user']['createtalk']      = true; // Salzwiki/Saltwiki: true, Repository: false
$wgGroupPermissions['user']['move']            = false;	
$wgGroupPermissions['user']['move-rootuserpages'] = false;
$wgGroupPermissions['user']['move-subpages']   = false;
$wgGroupPermissions['user']['edit']            = true;		
$wgGroupPermissions['user']['createpage']      = false;			
$wgGroupPermissions['user']['upload']          = false;		
$wgGroupPermissions['user']['reupload']        = false;		
$wgGroupPermissions['user']['reupload-shared'] = false;		
$wgGroupPermissions['user']['minoredit']       = false;		
$wgGroupPermissions['user']['purge']           = false;
$wgGroupPermissions['user']['writeapi']        = false;
$wgGroupPermissions['user']['restrictusers']   = false;
#$wgGroupPermissions['user']['sendemail']      = false; Repository: false, Salzwiki/Saltwiki: fehlt

# Spezialgruppe Autor
$wgGroupPermissions['autor']['emailconfirmed'] = true;
$wgGroupPermissions['autor']['createpage'] = true;
$wgGroupPermissions['autor']['createaccount'] = false; // Salzwiki: true, Saltwiki: false, Repository: auskommentiert
$wgGroupPermissions['autor']['createtalk'] = true;
$wgGroupPermissions['autor']['edit'] = true;
$wgGroupPermissions['autor']['protect'] = true; // Salzwiki/Saltwiki: true, Repository: auskommentiert
$wgGroupPermissions['autor']['editprotected'] = true; // Salzwiki/Saltwiki: true, Repository: auskommentiert
$wgGroupPermissions['autor']['read'] = true;
$wgGroupPermissions['autor']['upload'] = true;
$wgGroupPermissions['autor']['move'] = true;
$wgGroupPermissions['autor']['restrictusers'] = true; // Spezialseiten lesen

# Spezialgruppe Redakteur (Salzwiki) bzw. Editor (Saltwiki/Repository)
$wgGroupPermissions['Redakteur']['emailconfirmed'] = true;
$wgGroupPermissions['Redakteur']['createpage'] = true;
$wgGroupPermissions['Redakteur']['createtalk'] = true;
$wgGroupPermissions['Redakteur']['edit'] = true;
$wgGroupPermissions['Redakteur']['protect'] = true;
$wgGroupPermissions['Redakteur']['editprotected'] = true;
$wgGroupPermissions['Redakteur']['read'] = true;
$wgGroupPermissions['Redakteur']['upload'] = true;
$wgGroupPermissions['Redakteur']['patrol'] = true;
$wgGroupPermissions['Redakteur']['move'] = true;
$wgGroupPermissions['Redakteur']['createaccount'] = true;
$wgGroupPermissions['Redakteur']['movefile'] = true;
$wgGroupPermissions['Redakteur']['deletedtext'] = true;
$wgGroupPermissions['Redakteur']['deletedhistory'] = true;
$wgGroupPermissions['Redakteur']['noratelimit'] = true;
$wgGroupPermissions['Redakteur']['undelete'] = true;
$wgGroupPermissions['Redakteur']['restrictusers'] = true; // Salzwiki/Saltwiki: true, Repository: false
$wgGroupPermissions['Redakteur']['skipcaptcha'] = true;
$wgGroupPermissions['Redakteur']['approverevisions'] = true;

##Benutzergruppe um zu verhindern, dass Seiten der Specialpages 
##von jedem anderen außer Bürokraten und Admin und Sicherheit 
##aufgerufen werden können. Risos 08.02.2012
$wgGroupPermissions['Sicherheit']['read'] = true;
$wgGroupPermissions['Sicherheit']['Sicherheit'] = true;

# Prevent new user registrations except by sysops
$wgWhitelistAccount = array( "user" => 0, "sysop" => 1, "developer" => 1 );
#$wgGroupPermissions['sysop']['createaccount'] = false; // Salzwiki: fehlt, Saltwiki: false, Repository: auskommentiert

## Freischalten der Spezialseiten
$wgGroupPermissions['sysop']['restrictusers'] = true;
## Special Pages nur für Autoren lesbar
##$wgNamespaceProtection[NS_spezial] = array( 'spezial-read');
##$wgGroupPermissions['autor']['spezial-read'] = true;

#$wgGroupPermissions['emailconfirmed']['emailconfirmed'] = true;

Benutzer-Rechte in Repository[Bearbeiten]

Das für das Repositorium erweiterte Benutzerrechteschema enthält folgende Angaben:

# Repository
##---------------------------------------------------------------------------------
# Spezialgruppe HAWK eingefügt HSChwarz 4.10.2011
$wgGroupPermissions['HAWK']['emailconfirmed'] = true;
$wgGroupPermissions['HAWK']['createpage'] = true;
$wgGroupPermissions['HAWK']['createtalk'] = true;
$wgGroupPermissions['HAWK']['edit'] = true;
$wgGroupPermissions['HAWK']['read'] = true;
$wgGroupPermissions['HAWK']['move'] = true;
$wgGroupPermissions['HAWK']['restrictusers'] = false;
## Anlegen von Rechteschema für Projekte
# Spezialgruppe SalzWiki eingefügt HSChwarz 27.07.2010
$wgGroupPermissions['SalzWiki']['emailconfirmed'] = true;
$wgGroupPermissions['SalzWiki']['createpage'] = true;
$wgGroupPermissions['SalzWiki']['createtalk'] = true;
$wgGroupPermissions['SalzWiki']['edit'] = true;
$wgGroupPermissions['SalzWiki']['read'] = true;
$wgGroupPermissions['SalzWiki']['move'] = true;
$wgGroupPermissions['SalzWiki']['restrictusers'] = false;
# Spezialgruppe SIP eingefügt HSChwarz 27.07.2010
$wgGroupPermissions['SIP']['emailconfirmed'] = true;
$wgGroupPermissions['SIP']['createpage'] = true;
$wgGroupPermissions['SIP']['createtalk'] = true;
$wgGroupPermissions['SIP']['edit'] = true;
$wgGroupPermissions['SIP']['read'] = true;
$wgGroupPermissions['SIP']['move'] = true;
$wgGroupPermissions['SIP']['restrictusers'] = false;

## Erweiterung ApprovedRevs nicht zusammen mit "AccessControl" einsetzbar
#$wgGroupPermissions['sysop']['approverevisions'] = true;
#$wgGroupPermissions['*']['viewlinktolatest'] = false;
#$wgGroupPermissions['autor']['viewlinktolatest'] = true; // Salzwiki/Saltwiki: true, Repository: auskommentiert
#$wgGroupPermissions['sysop']['viewlinktolatest'] = true;

## BibManager-Berechtigungen eingefügt 2016-02-23
$wgGroupPermissions['*']['bibmanagercreate'] = false;
$wgGroupPermissions['*']['bibmanageredit'] = false;
$wgGroupPermissions['*']['bibmanagerdelete'] = false;
$wgGroupPermissions['autor']['bibmanager'create] = true;
$wgGroupPermissions['autor']['bibmanageredit'] = true;
#$wgGroupPermissions['autor']['bibmanagerdelete'] = true;
$wgGroupPermissions['Redakteur']['bibmanager'create] = true;
$wgGroupPermissions['Redakteur']['bibmanageredit'] = true;
$wgGroupPermissions['Redakteur']['bibmanagerdelete'] = true;
$wgGroupPermissions['sysop']['bibmanager'create] = true;
$wgGroupPermissions['sysop']['bibmanageredit'] = true;
$wgGroupPermissions['sysop']['bibmanagerdelete'] = true;
/*
## Salzwiki/Saltwiki: Erweiterung ConfirmEdit
#captcha Hschwarz 12.01.2010
$wgGroupPermissions['*']['skipcaptcha'] = false;
$wgGroupPermissions['user']['skipcaptcha'] = false;
$wgGroupPermissions['autor']['skipcaptcha'create] = true;
$wgGroupPermissions['autoconfirmed']['skipcaptcha'] = false;
#$wgGroupPermissions['bot']['skipcaptcha'] = true; // registered bots
$wgGroupPermissions['sysop']['skipcaptcha'] = true;
*/
## to allow interwiki-linking
$wgGroupPermissions['*']['interwiki'] = false;
$wgGroupPermissions['sysop']['interwiki'] = true;

Spezial-Seiten[Bearbeiten]

Für die Spezialseiten gibt es die Berechtigungsgruppe "Sicherheit" mit entsprechender Konfiguration in der Datei "LocalSettings.php".

Spezial-Seiten mit Sonderrechten[Bearbeiten]

Spezialseiten, die nur mit besonderen Berechtigungen verfügbar sind, werden nach Anmeldung bei einem Konto mit besonderen Berechtigungen auf der Seite "Spezialseiten" per CSS fett-formatiert dargestellt:

<li class="mw-specialpagerestricted">...
Spezial-Seiten verbergen[Bearbeiten]

Werden die Spezial-Seiten in der linken Menüleiste verborgen - siehe Sidebar-Einschränkung - sind sie dennoch über die Adresszeile des Browsers erreichbar, beispielsweise mit "https://wikiname.tld/index.php/Spezial:Spezialseiten".

Um derartige Seitenaufrufe zu unterbinden sind in der Datei "LocalSettings.php" Berechtigungen festzulegen.

Spezialseiten mit Gruppenberechtigung[Bearbeiten]

Es sollen nur Mitglieder bestimmter Gruppen die Spezialseiten im Namensraum "NS_SPECIAL" lesen dürfen, aber nicht unangemeldete Gäste oder Mitglieder anderer Gruppen. Gruppen mit Leserecht:

  • Administratoren
  • autor
  • Redakteur
  • Sicherheit
  • sysop

Für Berechtigungen von Spezialseiten siehe auch

In der Datei "LocalSettings.php" wird am Ende des Blocks "Namensräume" ein "Hook" namens "SpecialPage_initList" eingefügt. Der "Hook" wird in der Datei "SpecialPagesFactory.php" in der Funktion "getPageList()" ausgeführt. Verarbeitet werden die Angaben aus der Variablen $coreList.

Damit alle, die nicht Mitglied der berechtigten Gruppen sind, bestimmte Spezialseiten dennoch aufrufen können, wird Folgendes in der Datei "LocalSettings.php" eingegeben:

$wgHooks['SpecialPage_initList'][] = 'groupspecificSpecialpages';
function groupspecificSpecialpages(&$aSpecialPages){
  global $wgUser;
  $groups = $wgUser->getEffectiveGroups();
  if($wgUser->isAnon() || ( !in_array("sysop", $groups)
    && !in_array("autor", $groups) && !in_array("Administratoren", $groups)
    && !in_array("Redakteur", $groups) && !in_array("Editor", $groups)
    && !in_array("forschung", $groups)
  ) ){
    $aSpecialPages = array(
      "Specialpages" => "SpecialSpecialpages",
      "UserLogin" => "SpecialUserLogin",
      "UserLogout" => "SpecialUserLogout", // Seite nach der Abmeldung
      "CreateAccount" => "SpecialCreateAccount", // für Registrierung
      "Contact" => "SpecialContact", // Letzte Änderung im Menü links
      "Recentchanges" => "SpecialRecentChanges", // Kontaktseite im Menü links
      "BibManager" => "BibManager", // Bibliographie im Menü links
    );
  }
}
Anpassungen in vorigen MW-Versionen (Wiki-Code)[Bearbeiten]

Festlegungen in der Datei "LocalSettings.php" wirkten bei Aufruf der Spezialseiten in der Browser-Adresszeile nicht, unter anderem, weil

  • sich $wgNamespaceProtection nur auf "edit" und nicht auf "read" anwenden lässt
  • der Namensraum mit "NS_SPECIAL" statt mit "NS_spezial" angegeben werden muss
  • die Nutzungsfunktion "spezial-read" dem System nicht bekannt ist

Die unwirksame Konfiguration:

## Freischalten der Spezialseiten
$wgGroupPermissions['sysop']['restrictusers'] = true;
## SpecialPages nur für Autoren lesbar
$wgNamespaceProtection[NS_spezial] = array('spezial-read');
$wgGroupPermissions['autor']['spezial-read'] = true;

Achtung: Bei MW1.23 sind keine Anpassungen in der Datei "[wikiname]\includes\skins\SkinTemplate.php" vorzunehmen! Erfolgen dennoch Änderungen siehe auch http://nullraffer.de/wiki/index.php?title=Mediawiki_absichern.

Bei MW1.16 waren die Anpassungen im Wiki-Code der Datei "SpecialPage.php" sowie in der Konfigurationsdatei erforderlich. Bei MW1.31/1.27/1.23 heißt die Datei "SpecialPageFactory.php" statt "SpecialPage.php". Die gleichnamige Klasse mit der Funktion "getRestrictedPages(...)" gilt ab MW1.32 als veraltet.

Achtung: Bei MW 1.23 ist der Wiki-Code anders als bei MW 1.16! Wiki-Code bei MW 1.23 im Vergleich zu MW 1.16:

  • Datei "includes\specialpage\SpecialPageFactory.php" statt Datei "includes\SpecialPage.php"
  • Variable "private static $list" statt "static public $mList"
  • Assoziative Array-Elemente haben geänderte Werte, die nicht mehr in Arrays, sondern nur noch als Text-Strings angegeben sind
    • Bereich "Media reports and uploads" ab Zeile 114
    • Bereich "Unlisted / redirects" in Zeile 171
// Media reports and uploads
'Listfiles' => 'SpecialListFiles,
'Filepath' => 'SpecialFilePath',
...
// Unlisted / redirects
'Specialpages' => 'SpecialSpecialpages',
...

Weiterleitungen[Bearbeiten]

Für einige Seiten werden Weiterleitungen eingerichtet. Für eine Übersicht der bestehenden Weiterleitungen siehe bei den Spezialseiten http://193.175.110.91/[wikiverzeichnis]/index.php/Spezial:Weiterleitungen bzw. http://193.175.110.91/[wikiverzeichnis]/index.php/Special:ListRedirects:

Für die Navigation links (Sidebar), den Footer-Bereich und dergleichen gibt es folgende Weiterleitungen:

  • SalzWiki
    • Aktuelles => Startseite#Aktuelles
    • Bibliographie => Special:BibMangerList
    • Forschungsverbund => Informationen zum DFG-Projekt#Projektverbund
    • Hauptseite => Startseite
    • Projektverbund => Informationen zum DFG-Projekt#Projektverbund
    • Willkommen im SalzWiki => Informationen zum DFG-Projekt
    • Über => Informationen zum DFG-Projekt
    • Über SalzWiki => Informationen zum DFG-Projekt
    • Über Salzwiki => Informationen zum DFG-Projekt
    • Diskussion:Hauptseite => Diskussion:Startseite
    • Diskussion:Willkommen im SalzWiki => Diskussion:Informationen zum DFG-Projekt
    • Salzwiki:Forschungsverbund => Informationen zum DFG-Projekt#Projektverbund
    • Salzwiki:Portal => Informationen zum DFG-Projekt
    • Salzwiki:Projektverbund => Informationen zum DFG-Projekt#Projektverbund
    • Salzwiki Diskussion:Portal => Diskussion:Informationen zum DFG-Projekt
    • Hilfe:Variables => Help:Magic words
    • Adm:ToDo-Liste => Salzwiki:ToDo-Liste
  • SaltWiki
    • Literature and Data => Literature and Programs
    • News => Home
    • Project Network => About the project#Research Network
    • Research Network => About the project#Research Network
    • Welcome to SaltWiki => About the project
    • Talk:Welcome to SaltWiki => Talk:About the project
    • Saltwiki:Portal => Home
    • Saltwiki:Research Network => About the project#Research Network
    • Help:Tex/de => Help:TeX/de
    • Help:Variables => Help:Magic words
  • Repository
    • Hauptseite => Repository
    • Main Page => Repository
    • Main Page/de => Repository
    • Repository:About => VRE/Repository

Sidebar anpassen[Bearbeiten]

Logo-Hyperlink[Bearbeiten]

Die Seite, die beim Klick auf das Logo aufgerufen werden soll, wird in der Seite "MediaWiki:Mainpage" angegeben.

Navigation links mit 2 Varianten[Bearbeiten]

Es gibt zwei Varianten:

  • die Standard-Variante für
    • nicht-angemeldete Gäste, welche Wiki-Seiten nur ansehen können
    • angemeldete Standard-User
  • die Autor-Variante für
    • Autor/inn/en
    • Administrator/inn/en
    • Forscher/innen
Navigation links Standard-Variante[Bearbeiten]

Die Standard-Variante ist zu erreichen über:
http://193.175.110.91/[wikiverzeichnis]/index.php/MediaWiki:Sidebar
https://[wiki-domain]/index.php/MediaWiki:Sidebar

<!-- Salzwiki -->
*navigation
**Mainpage|Startseite
<del>**Salzwiki:Portal|SalzWiki:Portal</del>
<!--**Informationen zum DFG-Projekt|SalzWiki-Portal-->
<!--**Aktuelles|Aktuelles-->
Special:BibManager_Overview|Bibliographie
**Glossar|Glossar
<!--**Autorenanmeldung|Autorenanmedlung-->
**Redaktion SalzWiki|Redaktion
**Autoren/innen_von_SalzWiki|Autor/inn/en
**recentchanges-url|Recentchanges
**special:contact|Kontakt
**Hilfe:Contents/de|Hilfe

*SEARCH
<!--*Umfrage-->
<!--**http://www.worktogether51.net/gc/wsl.php?I=Y4TTY7YTOTTYT47TTUTTBT4NTTYT4BT40 |Ihre Meinung zu SalzWiki-->

*TOOLBOX

*andere Sprachen
**https://www.saltwiki.net/|English
<-- Repositorium -->
*Navigation 
**Hauptseite|Home

*Other Wikis
**https://www.salzwiki.de/|SalzWiki
**https://www.saltwiki.net/|SaltWiki
<-- Saltwiki -->
* navigation
** mainpage|Home
<!--** portal-url|SaltWiki-Portal-->
<!--** About_the_project|SaltWiki Portal-->
<!--** News|News-->
** Special:BibManager_Overview|Bibliography|Literature
** Glossary|Glossary
** Editorial Board|Editorial Board
** Authors in SaltWiki|Authors
** Special:Contact|Contact
** Help:Contents|Help

* SEARCH

* TOOLBOX

*Languages
**https://www.salzwiki.de/|German
Navigation links Autor-Variante[Bearbeiten]

Die Autor-Variante muss durch Erstellung einer neuen Seite (Adminrechte erforderlich) erfolgen:

  • Erst folgende Adresse im Browser eingeben:
    http://193.175.110.91/[wikiverzeichnis]/index.php/MediaWiki:Autor_sidebar
    https://[wiki-domain]/index.php/MediaWiki:Autor_sidebar
  • Danach mit Karteikarte "Erstellen" folgenden Quelltext eingeben:
<!-- Salzwiki -->
*Navigation
**Mainpage|Startseite
<del>**SalzWiki:Portal|SalzWiki:Portal</del>
<!--**Informationen zum DFG-Projekt|SalzWiki-Portal-->
<!--**Aktuelles|Aktuelles-->
<!--**http://193.175.110.91/repository/index.php/Main_Page |Repositorium-->
**https://repository.hawk-hhg.de/ |Repositorium
**Spezial:Bibliographieeinträge_verwalten|Bibliographie
**Glossar|Glossar
**Redaktion_SalzWiki|Redaktion
**Autoren/innen von SalzWiki|Autor/inn/en
**recentchanges-url|recentchanges
**special:contact|Kontakt
**help:contents/de|help
<!--
*Umfrage
**http://www.worktogether51.net/gc/wsl.php?I=Y4TTY7YTOTTYT47TTUTTBT4NTTYT4BT40ON84RMK758E |Ihre Meinung als Autor zu SalzWiki 
**http://www.worktogether51.net/gc/wsl.php?I=Y4TTY7YTOTTYT47TTUTTBT4NTTYT4BT40 |Ihre Meinung als Nutzer zu SalzWiki -->

* Autor/inn/en-Seiten
**Autoren|Richtlinien/Übersichten
**Nutzungsrechte|Nutzungsrechte
**Review|Review
**Kategorie|Kategorienbaum
**Vorlagen|Vorlagen
<!--**sandkasten|Sandbox-->

*SEARCH

*TOOLBOX

*Andere Sprachen
**https://www.saltwiki.net/ |English


<-- Saltwiki -->
*Navigation
**Mainpage|Home
<!--**Saltwiki:Community_portal|SaltWiki:Portal-->
<!--**About_the_Project|SaltWiki Portal-->
<!--**News|News-->
<!--**http://193.175.110.91/repository/index.php/Main_Page |Repository-->
**https://repository.hawk-hhg.de/ |Repository
**Special:BibManager_Overview|Bibliography
**Glossary|Glossary
**Editorial_Board|Editorial Board
**Authors in Saltwiki|Authors
**recentchanges-url|recentchanges 
**Special:Contact|Contact
**Help:Contents|Help
<!--**Helppage|help-->

* Author Pages
**Authors_Page|Guidelines
**Rights|Rights
**Review|Review
**categories|Category tree
**Templates|Templates
<!--**sandbox|Sandbox-->

*SEARCH

*TOOLBOX

*Languages
**https://www.salzwiki.de/ |German


<-- Repositorium -->
*Navigation
<!--*Research Environment-->
**Mainpage|Home
<!--**Repository Portal|Repository Portal-->
**News|News
**Projekte|Projects
**Communication|Communication
**Publications|Publication

* 
**Special:BibManager_Overview|Bibliography
**terminology|Glossary
**Category:Author|Authors' Contents
**recentchanges-url|Recent changes
**Special:Contact|Contact
**Help:Contents|Help

* author pages
**Rights|Rights
**Kategorienbaum|Category tree

* other wikis
**Vorlagen|Templates
**https://www.salzwiki.de/ |SalzWiki
**https://www.saltwiki.net/ |SaltWiki

*SEARCH

*TOOLBOX

*LANGUAGES

Navigationsbereich mit Einschränkungen versehen[Bearbeiten]

Um die linke Navigationsleiste abhängig von der Gruppenzugehörigkeit in der Menüauswahl zu beschränken werden folgende "Hooks" statt Änderungen am Wiki-Code verwendet:

Änderungen am Wiki-Code der Datei "[wikiname]\includes\Skin.php" für die zu verwendende Sidebar-Variante sind nicht mehr erforderlich, da mit dem "Hook" die Auswahl für die Menü-Variante je nach Gruppenzugehörigkeit festgelegt werden kann.

Änderungen am Wiki-Code der Datei "[wikiname]\skins\MonoBook\MonoBookTemplate.php" für den Umfang der Werkzeuge sind nicht mehr erforderlich, da mit dem "Hook" die Einschränkungen bei den Werkzeugen je nach Gruppenzugehörigkeit festgelegt werden können.

Sidebar-Einschränkung[Bearbeiten]

Mit den nachfolgend beschriebenen Änderungen gibt es zwei Sidebar-Varianten (Menü-Varianten links). Welche Variante angezeigt wird, richtet sich dabei nach der Gruppen-Zugehörigkeit.

Bei MW1.31/1.27/1.23 können die Änderungen mit einem "Hook" in der Datei "LocalSettings.php" vorgenommen werden und sind für alle Layouts ("Skins") gültig, während bei MW1.16 Wiki-Code in der Datei "Skin.php" des jeweiligen Layouts angepasst wurde und sich nur auf den jeweiligen "Skin" auswirkte.

Sidebar-Anpassungen mit "Hook"[Bearbeiten]

Der "Hook" für die Auswahl der Sidebar-Variante heißt "SkinBuildSidebar" und steht seit MW1.14 zur Verfügung.

In der Datei "LocalSettings.php" wird oberhalb der Anpassungen für die "Toolbox" (Werkzeuge) folgender Code eingefügt:

#### Beginn SIDEBAR je nach Gruppenzugehörigkeit
$wgHooks['SkinBuildSidebar'] = 'groupspecificSidebar';
function groupspecificSidebar( $skin, &$sidebar ) {
  global $wgUser;
  $groups = $wgUser->getEffectiveGroups();
  $sidebar = array();
  if (in_array("autor", $groups) || in_array("Administrator", $groups) || in_array("forschung", $groups)) {
    $skin->addToSidebar($sidebar, 'autor_sidebar');
  }
  else{
    $skin->addToSidebar($sidebar, 'sidebar');
  }
  return true;
};
#### Ende SIDEBAR je nach Gruppenzugehörigkeit

Sidebar-Anpassungen ohne "Hook" (Wiki-Code)[Bearbeiten]

ACHTUNG: Wenn Mediawiki aktualisiert wird, muss die Änderung in der Datei "Skin.php" wieder eingefügt werden, um die Funktionalität zu erhalten! Deshalb ist von der geänderten Datei "Skin.php" zusätzlich eine Kopie "Skin_SW.php" im Verzeichnis "includes" zu speichern.

In der Datei "includes\Skin.php" in der Funktion "function buildSidebar()" in der zweiten Zeile die globale Variable "$wgUser" mit Kommentar hinzufügen, um später die Gruppenrechte abfragen zu können:

<!--MW1.23, Z.1249-->
global $wgMemc, $wgEnableSidebarCache, $wgSidebarCacheExpiry, $wgUser; // for HAWK HHG $wgUser added

Nach der Zeile mit "$bar = array();" (MW1.23 Z.1263, MW1.16 Z.2085) folgende Zeile auskommentieren:

#$this->addToSidebar( $bar, 'sidebar' ); // changed for HAWK HHG 2015-12-22

und folgenden Code einfügen:

// new for HAWK HHG 2015-12-22
$groups = $wgUser->getEffectiveGroups();
## add here admin support
if (in_array("autor", $groups) || in_array("Administrators", $groups) || in_array("forschung", $groups)) {
  //$lines = explode( "\n", wfMsgForContent( 'autor_sidebar' ) );
  $this->addToSidebar( $bar, 'autor_sidebar' );
} else {
  //$lines = explode( "\n", wfMsgForContent( 'sidebar' ) );
  $this->addToSidebar( $bar, 'sidebar' );
}

Die Zeile "$lines = explode( "\n", wfMsgForContent( 'sidebar' ) );" muss auskommentiert oder gelöscht werden. Die explode-Funktion wird als Wiki-Code in "addToSidebarPlain(...)" verwendet.

Nun gibt es zwei Sidebars die man unterschiedlich "bestücken" kann.

Sollte es danach PHP-Warnungen wie "Warning: Call-time pass-by-reference has been deprecated ..." geben, gibt es folgende vorübergehende Notlösung: In der Datei "php.ini" in Zeile 165 "allow_call_time_pass_reference = On" statt "Off" setzen. Diese Möglichkeit gilt als veraltet und wird in Zukunft nicht mehr von PHP unterstützt werden, so dass der oben beschriebene Code der Funktion dann geändert werden muss!

Werkzeuge/Toolbox[Bearbeiten]

Änderungen an der Datei "skins\MonoBook\MonoBookTemplate.php" sind bei MW1.31/1.27/1.23 nicht mehr erforderlich, da mit einem "Hook" namens "BaseTemplateToolbox" die Einschränkungen bei den Werkzeugen je nach Gruppenzugehörigkeit in der Datei "LocalSettings.php festgelegt werden können.

Anpassungen mittels "Hook" in der Datei "LocalSettings.php" wirken sich auf alle "Skins" aus, wohingegen sich Anpassungen in der Datei "MonoBookTemplate.php" nur auf das Layout "MonoBook" auswirken, wenn nicht in der Datei "[wikiname]\includes\skins\SkinTemplate.php" Änderungen entsprechend denen für die Spezialseiten erfolgen.

Werkzeuge-Anpassung mit "Hook"[Bearbeiten]

Der verwendete "Hook" für den Umfang der zur Verfügung stehenden Werkzeuge heißt "BaseTemplateToolbox" und steht seit MW1.18 zur Verfügung.

In der Datei " in LocalSettings.php" ist folgender Code einzufügen:

#### Beginn TOOLBOX je nach Gruppenzugehörigkeit nur 'print' oder alles
$wgHooks['BaseTemplateToolbox'][] = 'groupspecificToolbox';
function groupspecificToolbox( BaseTemplate $baseTemplate, array &$toolbox ) {
  global $wgUser;
  $groups = $wgUser->getEffectiveGroups();
  if (!in_array("autor", $groups) && !in_array("Administrator", $groups) && !in_array("forschung", $groups)) {
    foreach($toolbox as $k => $v_array){
      if($k!=="print" && isset($toolbox[$k])){
        unset($toolbox[$k]);
      }
    }
  }
  return true;
}
#### Ende TOOLBOX je nach Gruppenzugehörigkeit nur 'print' oder alles

Werkzeuge-Anpassungen ohne "Hook" (Wiki-Code)[Bearbeiten]

Die Sidebar im Bereich "Werkzeuge" wird mit einem Eingriff in den Wiki-Code bei "skins/MonoBook.php" für alle Gruppen außer "autor", "admin" und "forschung" manipuliert. Hierzu wird in der Funktion "toolbox()" Z.254ff die Variable "global $wgUser;" eingefügt und bei "foreach" die Z.262 bei "$this->makeListItem" mit einer Bedingung versehen:

function toolbox();
  global $wgUser; // Für HAWK HHG
  $groups = $wgUser->getEffecitveGroups(); // Für HAWK HHG
  ...
  foreach ( $this->getToolbox() as $key => $tbitem ) {
    // Für HAWK HHG: Alle Werkzeuge für die Gruppen autor, Administrators und forschung, sonst nur Werkzeug "Druckversion"
    if(in_array("autor", $groups) || in_array("Administrators", $groups) || in_array("forschung", $groups) || $key==="print"){
      <?php echo $this->makeListItem( $key, $tbitem); ?>
    }
  }

Achtung: Code-Anpassung muss in "skins/MonoBook.php" nach jedem mediawiki-Update auf Vorhandensein und Funktion überprüft werden!

Eventuell muss auch die Datei "\includes\SkinTemplate.php" bei der Funktion "buildNavUrls()" in den Zeilen 1247 und 1262 angepasst werden, um Datei-Uploads auszublenden - siehe http://nullraffer.de/wiki/index.php?title=Mediawiki_absichern:

global $wgUploadNavigationUrl;
global $wgUser; // eingefügt 2015-12-04 für HAWK HHG
...
// Bedingung eingefügt 2015-12-04 für HAWK HHG
if(!$wgUser->isAnon()){
  $nav_urls['specialpages'] = array( 'href' => self::makeSpecialUrl( 'Upload' ) );
}
...

Werkzeuge-Schlüsselwörter[Bearbeiten]

  • Links auf diese Seite: key = whatlinkshere
  • Änderungen an verlinkten Seiten: key = recentchangeslinked
  • Datei hochladen: key = upload
  • Spezialseiten: key = specialpages
  • Druckversion: key = print
  • Permanenter Link: key = permalink
  • Seiteninformationen: key = info

sichtbare Toolbox-Menüpunkte[Bearbeiten]

  • SalzWiki, Repositorium: alle Gruppen und User
    • Druckversion
  • SaltWiki: alle Gruppen und User
    • Printable version

ausgeblendete Toolbox-Menüpunkte[Bearbeiten]

  • SalzWiki: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
    • "Links auf diese Seite" (Special:WhatLinksHere/Main_Page)
    • "Änderungen an verlinkten Seiten" (Spezial:%C3%84nderungen_an_verlinkten_Seiten)
    • "Hochladen" (Special:Upload)
    • "Spezialseiten" (Special:SpecialPages)
    • "Permanenter Link" (Main_page&oldid=921)
    • "Seiteninformationen" ([Seitentitel]&action=info])
  • SaltWiki: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
    • "What links here" (Special:WhatLinksHere/Main_Page)
    • "Related changes" (Special:RecentChangesLinked)
    • "Hochladen" (Special:Upload)
    • "Spezialseiten" (Special:SpecialPages)
    • "Permanent link" (Main_page&oldid=921)
    • "Page information" ([Seitentitel]&action=info])
  • Repository: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
    • "Links auf diese Seite" (Special:WhatLinksHere/Main_Page)
    • "Änderungen an verlinkten Seiten" (Spezial:%C3%84nderungen_an_verlinkten_Seiten)
    • "Datei Hochladen" (Special:Upload)
    • "Spezialseiten" (Spezial:Spezialseiten)
    • "Permanent link" (Main_page&oldid=9522)
    • "Seiteninformationen" ([Seitentitel]&action=info])

Überschrift der Hauptseite/Mainpage ändern[Bearbeiten]

Die Überschrift ist auf der Systemseite "Mediawiki:Mainpage" eingetragen und muss dort geändert werden. Die Überschrift, die per Voreinstellung Main Page (Hauptseite in der deutschen Übersetzung) heißt, ist in die entsprechende Titelzeile zu ändern.

Repositorium-Dateien im SalzWiki[Bearbeiten]

Für das wiki-übergreifende Hochladen und Anzeigen von Media-Dateien sind in der Datei "LocalSettings.php" folgende Variablen anzupassen:

  • $wgUploadNavigationUrl
  • $wgSharedUploadPath
  • $wgRepositoryBaseUrl
Logo Wiki-Header-Leiste
Datei Diskussion auf einem gemeinsam genutzten Medienarchiv ansehen $wgRepositoryBaseUrl
Navigation


Suche

Werkzeuge
 Datei hochladen
 $wgUploadNavigatonUrl

Abschnitt "Datei"
  • bei vorhandener Quelle:
    • Datei-Verweis: $wgSharedUploadPath
    • Dateibeschreibungsseite-Verweis: $wgRepositoryBaseUrl
  • bei nicht gefundener Quelle
    • moved-Verweis: $wgRepositoryBaseUrl
Abschnitte aus anderem Wiki mittels $wgRepositoryBaseUrl
  • "Metadaten"
  • "Summary"
  • "Licensing" aus Vorlage im anderen Wiki mit relativem Pfad im Verweis für Icons
Abschnitt "Dateiversionen" mit Verweis zu "Version vom": $wgSharedUploadPath
Abschnitt "Dateiverwendung" mit Datei-Verweis: $wgRepositoryBaseUrl
Wiki-Footer-Leiste

Hochladen von Dateien[Bearbeiten]

Das Hochladen von Dateien geschieht immer in das Repositorium. Hierfür sind Anpassungen in der Konfigurationsdatei erforderlich.

Konfigurationsdatei anpassen[Bearbeiten]

Für das Hochladen ins Repositorium über "Werkzeuge => Datei hochladen" bzw. "tools => Upload file" sind folgende Änderungen in der Datei "LocalSettings.php" des SalzWikis bzw. SaltWikis vorzunehmen, siehe auch https://www.mediawiki.org/wiki/Manual:$wgUploadNavigationUrl:

## für $wgUploadNavigationUrl, $wgSharedUploadPath und $wgRepositoryBaseUrl
## bei Verwendung einer IP-Adresse statt Domain-Adresse
#$url_repository = "/repository/";
## bei Verwendung von Domain-Adresse statt IP-Adresse ohne Protokoll wg. Inhalten bei "https"
$url_repository = "repository.hawk-hhg.de/";
...
## relative IP-Adresse "..._draft"
#$wgUploadNavigationUrl = "/repository_draft/index.php/Special:Upload";
#$wgUploadNavigationUrl = $url_repository."index.php/Special:Upload";
## bei Verwendung von Domain-Adresse statt IP-Adresse mit Protokoll
$wgUploadNavigationUrl = $protokoll."://".$url_repository."index.php/Special:Upload";
$wgEnableUploads       = false;  ##damit kein Upload in SalzWiki bzw. SaltWiki möglich ist

Zudem sind folgende Änderungen in der Datei "LocalSettings.php" des Repositoriums vorzunehmen:

$wgEnableUploads       = true;
## Erlaubte Dateitypen
$wgFileExtensions = array('avi','bib','doc','docx','gif','jpeg','jpg','mov','mpeg','odt','ods','oga','ogg','ogv',
'pdf','png','svg','tif','tiff','txt','xls','xlsx','xml');
Text der Upload-Spezialseite[Bearbeiten]

Es gibt folgende MW-Seiten für den Text der Seite "Special:Upload":

  • MediaWiki:Uploadtext (Standard "en")
  • MediaWiki:Uploadtext/de
  • MediaWiki:Uploadtext/de-formal
  • MediaWiki:Uploadtext/[Sprachenkürzel] (andere Sprachen)

In den Textdefinitionen unter "...\[wikiname]\languages\i18n\" gibt es ebenfalls Texte für die Uploadseite, welche scheinbar nicht verwendet werden; diese Texte befinden sich in den json-Dateien im Element "uploadtext":

  • en.json Z.1286
  • de.json Z.1290
  • de-formal.json Z.176

Übergreifende Darstellung[Bearbeiten]

Für den Zugriff vom SalzWiki bzw. SaltWiki auf Dateien und deren Seiten im Repositorium mittels "http" bzw. "https" durch anonyme User sind Anpassungen wie nachfolgend beschrieben erforderlich.

Da alle Dateien wie z.B Fotos mit den dazugehörigen Metadaten und Lizenzhinweisen im Repositorium liegen, muss vom SalzWiki aus der Zugriff nicht nur auf die Dateien, sondern auch auf die dazugehörigen Metadaten und Lizenzhinweise erfolgen.

Bei Seiten-Aufrufen mit https wird die Seite aus dem Repositorium mit den Metadaten, der Zusammenfassung und den Lizenzhinweisen ignoriert.

Anzupassende Dateien:

  • Konfigurationsdatei "LocalSettings.php" des SalzWikis bzw. SaltWikis
  • PHP-Konfigurationsdatei "php.ini"
Wiki-Konfigurationsdatei[Bearbeiten]

Findet das Salzwiki eine Datei oder ein Bild nicht im eigenen Wiki, schaut es mit Hilfe von Shared-Einstellungen automatisch im Repositorium nach und sucht dort. Wird auf ein englischsprachiges Repositorium verwiesen, ist in der Wiki-Konfigurationsdatei "Datei:" durch "File:" zu ersetzen, damit die Metadaten ausgelesen werden können.

Zusammenhang zwischen Variablen und Darstellung[Bearbeiten]
  • $wgSharedUploadPath
    • Abschnitt "Datei": Verweis zur Datei
  • $wgRepositoryBaseUrl
    • Karteikartenreiter "Auf einem gemeinsam genutzten Medienarchiv ansehen" bzw. "View on a shared repository"
    • Abschnitt "Datei": Verweis zur Dateibeschreibungsseite, anderenfalls Verweis "moved"
    • Abschnitt "Dateiversionen": Verweis zur "Version vom"
    • Abschnitt "Dateiverwendung": Verweis zur Ursprungsdatei der erzeugten Duplikatdatei
    • Zusätzliche Inhalte (Metadata, Summary, Licencing) der Datei-Seite im Repositorium benötigen "http" als Base-URL-Protokoll
Anpassungen in der Konfigurationsdatei[Bearbeiten]
## Zugriff auf das Repositorium
$wgFetchCommonsDescriptions  = true;
## für $wgUploadNavigationUrl, $wgSharedUploadPath und $wgRepositoryBaseUrl
## bei Verwendung von IP-Adresse statt Domain-Adresse
#$url_repository = "/repository/";
## bei Verwendung von Domain-Adresse statt IP-Adresse ohne Protokoll wg. Inhalten bei "https"
$url_repository = "repository.hawk-hhg.de/";
...
## shared uploads: Das Laden der Daten erfolgt immer aus dem Repositorium
## Damit automatisch im Repository nach "Dateien" gesucht wird:
$wgUseSharedUploads = true;
## bei Verwendung von IP-Adresse statt Domain-Adresse
#$wgSharedUploadPath = "/repository/images";
#$wgSharedUploadPath = $url_repository."images";
## bei Verwendung von Domain-Adresse statt IP-Adresse mit Protokoll
$wgSharedUploadPath = $protokoll."://".$url_repository."images";
$wgSharedUploadDirectory = "D:/xampp/htdocs/repository/images";
$wgHashedSharedUploadDirectory = true;
$wgSharedUploadDBname = "repository";
$wgSharedUploadDBprefix  = "sr_";
## IP-Adresse mit Protokoll "http" wg. fehlendem Serverzertifikat
#$wgRepositoryBaseUrl = 'http://193.175.110.91/repository/index.php/Datei:';  
#$wgRepositoryBaseUrl = 'http://'.$_SERVER['SERVER_NAME'].'/repository/index.php/File:';
#$wgRepositoryBaseUrl = 'http://'.$_SERVER['SERVER_ADDR'].'/repository/index.php/File:';
## Domain-Adresse mit Protokoll "http" bei "https"-Aufruf wg. Seiteninhalten mit CC-Icons u. Ä., 2018-02-06
#$wgRepositoryBaseUrl = "http://".$url_repository."index.php/Datei:";
$wgRepositoryBaseUrl = "http://".$url_repository."index.php/File:";
## Verwendung der Klasse ForeignDBRepo
$wgForeignFileRepos[] = array(
 'class' => 'ForeignDBRepo',
 'name' => 'repository',
 'url' => $wgSharedUploadPath,
 'directory' => $wgSharedUploadDirectory,
 'hashLevels' => 2, // This must be the same for the other family member
 'dbType' => $wgDBtype,
 'dbServer' => $wgDBserver,
 'dbUser' => $wgDBuser,
 'dbPassword' => $wgDBpassword,
 'dbFlags' => DBO_DEFAULT,
 'dbName' => $wgSharedUploadDBname,
 'tablePrefix' => $wgSharedUploadDBprefix,
 'hasSharedCache' => false,
 'descBaseUrl' => $wgRepositoryBaseUrl,
 'fetchDescription' => $wgFetchCommonsDescriptions
);
PHP-Konfigurationsdatei[Bearbeiten]

Die Funktion "fopen()" muss ausgeführt werden können, um Beschreibungsdaten wie Metadaten und Zusammenfassungen sowie Lizenzhinweise vom Repositorium zu holen. Hierfür muss in der PHP-Konfigurationsdatei "php.ini" in Zeile 523 folgende Einstellung vorhanden sein:

allow_url_fopen = On
Grafiken für Lizenz[Bearbeiten]

Die Grafiken für die CC-Lizenz werden im Repositorium in der Vorlage "CC-by-nc-nd" verwendet und haben eine interne Adresse. Diese Lizenz-Grafiken werden bei Aufrufen mit "http" und "https" nur im Repositorium, aber nicht im SalzWiki bzw. SaltWiki angezeigt, wenn das Repositorium mit einer Domain-Adresse statt mit einer IP-Adresse konfiguriert ist. Ein Änderung in der Interwiki-Tabelle von "ja" zu "nein" bei "lokales Wiki" bewirkt nichts.

Für Seiten im SalzWiki und SaltWiki, die Media-Dateien des Repositoriums verwenden, sind für http-/https-Aufrufe deshalb folgende Unterverzeichnisse und Dateien aus dem Repositorium in die beiden anderen Wikis zu kopieren:

  • [wikiverzeichnis]\images\thumb\
    • 0\07\Pict-nd.png\30px-Pict-nd.png
    • 1\1f\Pict-nc.png\30px-Pict-nc.png
    • d\d6\Pict-by.png\30px-Pict-by.png

MediaWiki-Datei anpassen (Wiki-Code)[Bearbeiten]

Die nachfolgend beschriebene Vorgehensweise erlaubt es, auf ein für den normalen User gesperrtes Wiki wie das Repositorium zuzugreifen und die Metadaten der Abbildungen/Dateien auszulesen und in SalzWiki widerzugeben. Nach jedem mediawiki-Update muss die Datei "includes/httpFunctions.php" auf Änderungen überprüft werden!

  • Zunächst ist die Datei "httpFunctions.php" im Verzeichnis includes von SalzWiki sowohl für https als auch für die Erweiterung "Snoopy" zu modifizieren, siehe https://phabricator.wikimedia.org/T27563. Dazu wird von der Datei eine Kopie "httpFunctions_original.php" gespeichert; danach wird folgender Code angepasst:
    • für die Mediawiki-Version 1.23:
--- HttpFunctions.php	2010-06-09 05:49:34.000000000 +0200
+++ HttpFunctions_sw.php	2018-01-29
@@ -131,1 +131,1 @@
-		if ( preg_match( '!^http://([\w.-]+)[/:].*$!' ) ) {
+		if ( preg_match( '!^http://([\w.-]+)[/:].*$!' ) || preg_match( '!^https://([\w.-]+)[/:].*$!' ) ) {
@@ -790,11 +790,97 @@
-		$curlRes = curl_exec( $curlHandle );
-		if ( curl_errno ($curlHandle ) == CURLE_OPERATION_TIMEOUTED ) {
-			$this->status->fatal( 'http_timed_out', $this->url );
-		} elseif ($curlRes === false ) {
-			$this->status->fatal( 'http-curl-error', curl_error( $curlHandle ) );
-		} else {
-			$this->headerList = explode( "\r\n", $this->headerText );
-		}
-
-		curl_close( $curlHandle );
-
+		/*  Neuer Code für "Snoopy" ungeprüft bei MW1.23 übernommen von MW1.16
+		 *  START:
+		 *  Add code to access restricted repositories. 
+		 *  Add the following line in the LocalSettings.php 		 
+		 * 		$wgAuthenticatedRepository = true;
+		 * 		$wgAuthenticatedRepositoryUser = 'WikiSysop';
+		 * 		$wgAuthenticatedRepositoryPassword = 'dev2010wer';
+		 * 		$wgShowAuthenticatedRepositoryError = true;
+		 */
+
+    global $wgAuthenticatedRepository, $wgAuthenticatedRepositoryUser, $wgAuthenticatedRepositoryPassword, $wgShowAuthenticatedRepositoryError;
+    $error = true;
+    $text = '';
+    $token2 = array();
+
+		/* run the code only if the user activate is in the LocalSettings.php*/
+    if ( $wgAuthenticatedRepository ) {
+      require_once 'extensions/Snoopy-1.2.4/Snoopy.class.php';
+      $index = '';
+      $login = '';
+      
+      /* Get all relevat url informations */
+      /* URL: http://localhost/mediawiki/mediawiki-repository/index.php/File:MediawikiExampleImageFlower.jpg?action=render&uselang=en */
+      $wikiPath = "";
+      if (!preg_match('/(.*)\/index.php\/(.*)\?(.*)/', $this->url, $matches)) {
+          echo "nicht gefunden";
+      } else {
+          $wikiPath = $matches[1];
+				  /* If the url contains special characters, when these characters must be convert */
+			  	$title = rawurldecode($matches[2]);
+      }
+      
+      $apiPath = "$wikiPath/api.php";
+      $indexPath = "$wikiPath/index.php";
+
+      $snoopy = new Snoopy;
+      /* Start request to get an token */
+      $request_vars = array('action' => 'login', 'lgname' => $wgAuthenticatedRepositoryUser, 'lgpassword' => $wgAuthenticatedRepositoryPassword, 'format' => 'php');
+      if(!$snoopy->submit($apiPath, $request_vars))
+      	$this->status->fatal("Snoopy error: {$snoopy->error}");
+      
+      // We're only really interested in the cookies
+      $snoopy->setcookies();
+      $token = unserialize($snoopy->results);
+      
+      /* Use the Token to login */
+      if ( $token['login']['result'] == 'NeedToken') { 
+    	  $request_vars = array('action' => 'login', 'lgname' => $wgAuthenticatedRepositoryUser, 'lgpassword' => $wgAuthenticatedRepositoryPassword,  'lgtoken' => $token['login']['token'], 'format' => 'php');
+    	  if(!$snoopy->submit($apiPath, $request_vars))
+   				$this->status->fatal("Snoopy error: {$snoopy->error}");
+    	  $token2 = unserialize($snoopy->results);
+      }
+      else if ( ($token['login']['result'] == 'NoName') ) {
+        wfDebug( __METHOD__ . ": Wrong or no User for wgAuthenticatedRepositoryUser in the LocalSetting. \n" );
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no User for <i>wgAuthenticatedRepositoryUser</i> in the LocalSetting.<br/>";
+      }
+            
+      /* If the login was successful, get the Information from the File Description */
+      if ( ($token2['login']['result'] == 'Success') or ($token['login']['result'] == 'Success') ) { 
+    	  $request_vars = array('action' => 'render', 'title'=> $title, 'lgtoken' => $token['login']['token'], 'format' => 'php');
+    	  if(!$snoopy->submit($indexPath, $request_vars))
+   				$this->status->fatal("Snoopy error: {$snoopy->error}");
+    	  $this->content = $snoopy->results;
+      }
+      else if ( ($token2['login']['result'] == 'WrongPass') or ($token2['login']['result'] == 'WrongPluginPass') or ($token2['login']['result'] == 'EmptyPass') ) {
+        wfDebug( __METHOD__ . ": Wrong or no Password for wgAuthenticatedRepositoryPassword in the LocalSetting." );
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no Password for <i>wgAuthenticatedRepositoryPassword</i> in the LocalSetting.<br/>";
+      }
+      else if ( ($token2['login']['result'] == 'NotExists') ) {
+        wfDebug( __METHOD__ . ": Wrong or no User for wgAuthenticatedRepositoryUser in the LocalSetting. \n" );
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no User for <i>wgAuthenticatedRepositoryUser</i> in the LocalSetting.<br/>";
+      }
+      $this->headerList = explode("\r\n", $this->headerText);      
+    }
+    else 
+    {    
+			/*
+			 *  START: Original Code - now in a if statement
+			 */
+
+  		if ( false === curl_exec( $curlHandle ) ) {
+  			$code = curl_error( $curlHandle );
+  
+  			if ( isset( self::$curlMessageMap[$code] ) ) {
+  				$this->status->fatal( self::$curlMessageMap[$code] );
+  			} else {
+  				$this->status->fatal( 'http-curl-error', curl_error( $curlHandle ) );
+  			}
+  		} else {
+  			$this->headerList = explode("\r\n", $this->headerText);
+  		}
+  		curl_close( $curlHandle );
+  		
+			/*
+			 *  END: Original Code - now in a if statement
+			 */
+  	}
+		/*
+		 *  END: Add code to access restricted repositories
+		 */
+  
 		$this->parseHeader();
 		$this->setStatus();
 		return $this->status;
	}
}

**für die Mediawiki-Version '''16.0''':
<pre>
--- HttpFunctions.php	2010-06-09 05:49:34.000000000 +0200
+++ HttpFunctions_new.php	2010-11-22 17:09:33.000000000 +0100
@@ -758,14 +758,97 @@
-		if ( false === curl_exec( $curlHandle ) ) {
-			$code = curl_error( $curlHandle );
-
-			if ( isset( self::$curlMessageMap[$code] ) ) {
-				$this->status->fatal( self::$curlMessageMap[$code] );
-			} else {
-				$this->status->fatal( 'http-curl-error', curl_error( $curlHandle ) );
-			}
-		} else {
-			$this->headerList = explode("\r\n", $this->headerText);
-		}
-
-		curl_close( $curlHandle );
-
+		/*
+		 *  START:
+		 *  Add code to access restricted repositories. 
+		 *  Add the following line in the LocalSettings.php 		 
+		 * 		$wgAuthenticatedRepository = true;
+		 * 		$wgAuthenticatedRepositoryUser = 'WikiSysop';
+		 * 		$wgAuthenticatedRepositoryPassword = 'dev2010wer';
+		 * 		$wgShowAuthenticatedRepositoryError = true;
+		 */
+
+    global $wgAuthenticatedRepository, $wgAuthenticatedRepositoryUser, $wgAuthenticatedRepositoryPassword, $wgShowAuthenticatedRepositoryError;
+    $error = true;
+    $text = '';
+    $token2 = array();
+
+		/* run the code only if the user activate is in the LocalSettings.php*/
+    if ( $wgAuthenticatedRepository ) {
+      require_once 'extensions/Snoopy-1.2.4/Snoopy.class.php';
+      $index = '';
+      $login = '';
+      
+      /* Get all relevat url informations */
+      /* URL: http://localhost/mediawiki/mediawiki-repository/index.php/File:MediawikiExampleImageFlower.jpg?action=render&uselang=en */
+      $wikiPath = "";
+      if (!preg_match('/(.*)\/index.php\/(.*)\?(.*)/', $this->url, $matches)) {
+          echo "nicht gefunden";
+      } else {
+          $wikiPath = $matches[1];
+				  /* If the url contains special characters, when these characters must be convert */
+			  	$title = rawurldecode($matches[2]);
+      }
+      
+      $apiPath = "$wikiPath/api.php";
+      $indexPath = "$wikiPath/index.php";
+
+      $snoopy = new Snoopy;
+      /* Start request to get an token */
+      $request_vars = array('action' => 'login', 'lgname' => $wgAuthenticatedRepositoryUser, 'lgpassword' => $wgAuthenticatedRepositoryPassword, 'format' => 'php');
+      if(!$snoopy->submit($apiPath, $request_vars))
+      	$this->status->fatal("Snoopy error: {$snoopy->error}");
+      
+      // We're only really interested in the cookies
+      $snoopy->setcookies();
+      $token = unserialize($snoopy->results);
+      
+      /* Use the Token to login */
+      if ( $token['login']['result'] == 'NeedToken') { 
+    	  $request_vars = array('action' => 'login', 'lgname' => $wgAuthenticatedRepositoryUser, 'lgpassword' => $wgAuthenticatedRepositoryPassword,  'lgtoken' => $token['login']['token'], 'format' => 'php');
+    	  if(!$snoopy->submit($apiPath, $request_vars))
+   				$this->status->fatal("Snoopy error: {$snoopy->error}");
+    	  $token2 = unserialize($snoopy->results);
+      }
+      else if ( ($token['login']['result'] == 'NoName') ) {
+        wfDebug( __METHOD__ . ": Wrong or no User for wgAuthenticatedRepositoryUser in the LocalSetting. \n" );
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no User for <i>wgAuthenticatedRepositoryUser</i> in the LocalSetting.<br/>";
+      }
+            
+      /* If the login was successful, get the Information from the File Description */
+      if ( ($token2['login']['result'] == 'Success') or ($token['login']['result'] == 'Success') ) { 
+    	  $request_vars = array('action' => 'render', 'title'=> $title, 'lgtoken' => $token['login']['token'], 'format' => 'php');
+    	  if(!$snoopy->submit($indexPath, $request_vars))
+   				$this->status->fatal("Snoopy error: {$snoopy->error}");
+    	  $this->content = $snoopy->results;
+      }
+      else if ( ($token2['login']['result'] == 'WrongPass') or ($token2['login']['result'] == 'WrongPluginPass') or ($token2['login']['result'] == 'EmptyPass') ) {
+        wfDebug( __METHOD__ . ": Wrong or no Password for wgAuthenticatedRepositoryPassword in the LocalSetting." );
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no Password for <i>wgAuthenticatedRepositoryPassword</i> in the LocalSetting.<br/>";
+      }
+      else if ( ($token2['login']['result'] == 'NotExists') ) {
+        wfDebug( __METHOD__ . ": Wrong or no User for wgAuthenticatedRepositoryUser in the LocalSetting. \n" );
+        if ( $wgShowAuthenticatedRepositoryError ) $this->content = "Wrong or no User for <i>wgAuthenticatedRepositoryUser</i> in the LocalSetting.<br/>";
+      }
+      $this->headerList = explode("\r\n", $this->headerText);      
+    }
+    else 
+    {    
+			/*
+			 *  START: Original Code - now in a if statement
+			 */
+
+  		if ( false === curl_exec( $curlHandle ) ) {
+  			$code = curl_error( $curlHandle );
+  
+  			if ( isset( self::$curlMessageMap[$code] ) ) {
+  				$this->status->fatal( self::$curlMessageMap[$code] );
+  			} else {
+  				$this->status->fatal( 'http-curl-error', curl_error( $curlHandle ) );
+  			}
+  		} else {
+  			$this->headerList = explode("\r\n", $this->headerText);
+  		}
+  		curl_close( $curlHandle );
+  		
+			/*
+			 *  END: Original Code - now in a if statement
+			 */
+  	}
+		/*
+		 *  END: Add code to access restricted repositories
+		 */
+  
 		$this->parseHeader();
 		$this->setStatus();
 		return $this->status;
	}
}
 
class PhpHttpRequest extends HttpRequest {

Es wurden hauptsächlich Anpassungen gemacht, die den Text zurückgeben, sowie an der Abarbeitung von Fehlern.
Für das korrekte Bearbeiten von Sonderzeichen in der url wurde rawurldecode() hinzugefügt.

  • Die geänderte Datei "httpFunctions.php" als Sicherung für Mediawiki-Updates kopieren und speichern als "httpFunctions_sw.php".
  • Die Erweiterung "Snoopy-1.2.4" von "http://sourceforge.net/projects/snoopy/" herunterladen, zip-Dateien auspacken und die Erweiterung in das Verzeichnis "extensions" des SalzWikis bzw. Saltwikis kopieren.
  • Das Modul "curl" muss beim Apache-Webserver aktiviert sein; dazu kommentiert man in der Datei "D:\xampp\php\php.ini" die folgende Zeile ein:
extension=php_curl.dll 

Den Apache-Dienst über das XAMPP-Control-Panel neu starten, damit die Änderungen wirksam werden.

  • Der Zugriff auf das Repositorium wird gesperrt durch folgenden Eintrag in der Datei "LocalSettings.php" des Repositoriums:
$wgGroupPermissions['*']['read'] = false;
  • Um den Zugriff auf das geschützte Repositorium durchführen zu können, ist folgende Konfiguration der Datei "LocalSettings.php" des Salzwikis bzw. Saltwikis vorzunehmen:
$wgAuthenticatedRepository = true;
$wgAuthenticatedRepositoryUser = 'WikiSysop';
$wgAuthenticatedRepositoryPassword = 'xxx';
$wgShowAuthenticatedRepositoryError = false;

$wgAuthenticatedRepository - aktiviert den Zugriff auf ein gesichertes Repository. Wenn dies nicht notwendig ist, bitte abstellen, da die Funktion zusätzliche Abfragen schickt, was die Zugriffe bei hoher Last verlangsamen kann.
$wgShowAuthenticatedRepositoryError - Gibt Fehlermeldungen in die Log Dateien. Für den Live Betrieb bitte abstellen.

Vorlagen[Bearbeiten]

Vorlagen = Templates finden sich beispielhaft auf der Seite Vorlagen dargestellt.

Die einzelnen Vorlagen sind im Namensraum "Vorlage" bzw. "Template" zu finden. Für jede Vorlage ist eine eigene Wiki-Seite zu erstellen, um diese Vorlage dann im Wiki mit {{Vorlagenname}} verwenden zu können. Die Vorlage ist anschließend auf der Seite "Vorlagen" beispielhaft aufzuführen. Die vorhandene Vorlage "Languages" wird ersetzt durch eine eigene Vorlage.

Für Vorlagen mit Beispieltexten unter Verwendung des Vorlagennamens im "noinclude"-Bereich siehe weiter unten bei Code-Probleme und deren Lösungen, Abschnitt "Timeout durch Template-Name im Template-Text" – betrifft insbesondere die Erweiterung "AccessControl".

  • Vorlagen für SalzWiki
    • FreeForTranslation
  • Vorlagen für SalzWiki und Saltwiki
    • Infobox_Salz bzw. Infobox_Salt
    • MetadatenFoto_upload (wird im Artikel Vorlagen/Templates verwendet)
  • Vorlagen für das Repositorium
    • MetadatenFoto_upload
    • MetadatenDaten_upload
    • MetadatenLiteratur_upload
    • MetadatenProben_upload
    • MetadatenText_upload
    • Untersuchungsmethoden
  • Lizenzvorlagen: Eine neue Kategorie "Kategorie:Lizenzenvorlagen" erstellen mit folgenden Vorlagen:
    • CC-by-nc-nd,CC-by-nc-nd/de
    • CC-by-nc-sa,CC-by-nc-sa/de
    • PD
    • PD Help Page, PD Help Page/de, PD Help Page/fr
    • GFDL,GFDL/de (nur im Repositorium)

Alle anderen Vorlagen wurden beim Einbinden der Hilfeseiten bzw. Extensions eingestellt.

Lizenzen-Auswahl im Upload-Formular[Bearbeiten]

Um neue Lizenzen im Klappfeld im Upload-Formular einzugeben muss die Datei Mediawiki:Licenses (http://193.175.110.91/repository_1.16.1/index.php?title=MediaWiki:Licenses) editiert werden, nach dem vorgegebene Schema:

*Free licenses:           <!-- Lizenztyp -->
**PD|PD: public domain    <!--einzelne Lizenz-->
**GNU|GFDL: GNU Free Documentation License 

*Creative Commons
**CC-by-nc-nd|Attribution-NonCommercial-NoDerivs 3.0 Unported (CC BY-NC-ND 3.0) 
**CC-by-nc-sa|Attribution-NonCommercial-ShareAlike 3.0 Unported (CC BY-NC-SA 3.0)

Editor (JavaScript)[Bearbeiten]

Achtung: Alle üblichen Editoren zur Bearbeitung von Seiteninhalten funktionieren nur mit JavaScript. Dies gilt auch für die Erweiterung WikiEditor.

Standard-Editor (Wiki-Code, JS)[Bearbeiten]

Achtung: Funktioniert nur bei Browsern mit aktiviertem JavaScript und muss in den 3 nachfolgend genannten Dateien und dem Grafiken-Verzeichnis nach jedem MediaWiki-Update auf Vorhandensein und Änderungen überprüft werden!

Folgende Dateien werden vom Standard-Editor verwendet:

  • "/includes/EditPage.php"
  • Symbole/Grafiken: "skins/common/images/..."
  • "/languages/i18n/..."

Vorhanden sind folgende Funktionen:

  • bold, italic
  • link (wiki), ext. link
  • headline size 2
  • file embedded, media
  • nowiki, signatur
  • horizontal line

Das Schaltflächen-Symbol für Weiterleitungen ist bei MW 1.23 im Gegensatz zu MW 1.16 nicht vorhanden und wird für die Salz-Wikis auch nicht mehr durch Anpassungen hinzugefügt.

Das Schaltflächen-Symbol für mathematische Formeln wird von der Erweiterung "Math" hinzugefügt, u. a. in folgenden Dateien:

  • "/extensions/Math/Math.hooks.php" für die Modul-Aktivierung von "math.editbuttons"
  • "/extensions/Math/modules/ext.math.editbuttons.js"
  • "/extensions/Math/i18n/de.json" für Texte zur Schaltfläche

Ergänzt werden sollen folgende Funktionen (siehe "Anpassungen" weiter unten):

  • Zeilenumbruch
  • Durchgestrichen
  • Hoch gestellt
  • Tief gestellt
  • Zitat
  • Fußnoten-Verweis
  • Versteckter Kommentar
  • Tabelle einfügen
Anpassungen[Bearbeiten]

Für Anpassungen siehe auch https://www.mediawiki.org/wiki/Manual:Custom_edit_buttons#Classic_edit_toolbar

  • neues Unterverzeichnis "/editor_default_sw/" für Grafiken der Schaltflächen
  • neue Einträge in den Sprachdateien im Verzeichnis "/languages/i18n/"
  • Code-Anpassungen in der Core-Datei "EditPage.php"

Es wird ein neues Unterverzeichnis "editor_default_sw" im Verzeichnis "/skins/common/images/" erstellt, da vom Wiki-Code für den Editor aus diesem Verzeichnis die Grafiken geholt werden. In das neu erstellte Verzeichnis werden folgende Grafiken aus der älteren Wiki-Installation oder von https://commons.wikimedia.org/wiki/Mediawiki_edit_toolbar kopiert und gespeichert:

  • "Button_Bibliogryphy.png" umbenennen zu "Button_bibliography.png"
  • "Button_blockquote.png"
  • "Button_enter.png"
  • "Button_hide_comment.png" umbenennen zu "Button_hidden_comment.png"
  • "Button_insert_table.png"
  • "Button_lower_letter.png" umbennen zu "Button_sub_letter.png"
  • "Button_redirect.png"
  • "Button_reflink.png"
  • "Button_small.png"
  • "Button_strike.png"
  • "Button_upper_letter.png" umbenennen zu "Button_sup_letter.png"


de.json Z.626 unter "hr_tip" wie folgt ergänzen und anschließend eine Kopie der Datei als "de_SW.json" speichern:

"enter_tip": "Zeilenumbruch",
"strike_sample": "durchgestrichener Text",
"strike_tip": "Durchgestrichen",
"sup_letter_sample": "hoch gestellter Text",
"sup_letter_tip": "Hoch gestellt",
"sub_letter_sample": "tief gestellter Text",
"sub_letter_tip": "Tief gestellt",
"blockquote_sample": "Zitat",
"blockquote_tip": "Zitierter Text",
"reflink_sample": "Fußnoten-Text",
"reflink_tip": "Fußnoten-Verweis",
"hidden_comment_sample": "Kommentar",
"hidden_comment_tip": "Versteckter Kommentar",
"insert_table_sample": "! Kopf1\n! Kopf2\n! Kopf3\n|-\n| Reihe1 Spalte1\n| Reihe1 Spalte2\n| Reihe1 Spalte3\n|-\n| Reihe2 Spalte1\n| Reihe2 Spalte2\n| Reihe2 Spalte3",
"insert_table_tip": "Tabelle einfügen (Tabellenkopf, 3 Spalten, 2 Reihen)",
"redirect_sample": "Seitenname",
"redirect_tip": "Weiterleitung",
"bibliography_sample": "Nachname:2017",
"bibliography_tip": "Literaturzitat einfügen",

en.json Z.593 unter "hr_tip" wie folgt ergänzen und anschließend eine Kopie derDatei als "en_SW.json" speichern:

"enter_tip": "Line break",
"strike_sample": "Strike-through text",
"strike_tip": "Strike",
"sup_letter_sample": "Superscript text",
"sup_letter_tip": "Superscript",
"sub_letter_sample": "Subscript text",
"sub_letter_tip": "Subscript",
"blockquote_sample": "Block quote",
"blockquote_tip": "Quoted text",
"reflink_sample": "Footnote text",
"reflink_tip": "footnote reference",
"hidden_comment_sample": "Comment",
"hidden_comment_tip": "Hidden comment",
"insert_table_sample": "! header 1\n! header 2\n! header 3\n|-\n| row 1, cell 1\n| row 1, cell 2\n| row 1, cell 3\n|-\n| row 2, cell 1\n| row 2, cell 2\n| row 2, cell 3",
"insert_table_tip": "Insert table (table head, 3 columns, 2 rows)",
"redirect_sample": "Page name",
"redirect_tip": "Redirect",
"bibliography_sample": "Surname:2017",
"bibliography_tip": "Insert literature blockquote",


Nachfolgenden Code in der Datei "/includes/EditPage.php" bei der Array-Variablen "$Toolarray" (ab Zeile 3385) am Ende einfügen (Z. 3475); hierbei das erste Komma nicht vergessen.

 ,
 array(
  'image'  => "editor_default_sw/Button_enter.png",
  'id'     => 'mw-editbutton-enter',
  'open'   => '<br />',
  'close'  => '',
  'sample' => '',
  'tip'    => wfMessage( 'enter_tip' )->text()
 ),
 array(
  'image'  => "editor_default_sw/Button_strike.png",
  'id'     => 'mw-editbutton-strike',
  'open'   => '<s>',
  'close'  => '</s>',
  'sample' => wfMessage( 'strike_sample' )->text(),
  'tip'    => wfMessage( 'strike_tip' )->text()
 ),
 array(
  'image'  => "editor_default_sw/Button_sup_letter.png",
  'id'     => 'mw-editbutton-sup-letter',
  'open'   => '<sup>',
  'close'  => '</sup>',
  'sample' => wfMessage( 'sup_letter_sample' )->text(),
  'tip'    => wfMessage( 'sup_letter_tip' )->text()
 ),
 array(
  'image'  => "editor_default_sw/Button_sub_letter.png",
  'id'     => 'mw-editbutton-sub-letter',
  'open'   => '<sub>',
  'close'  => '</sub>',
  'sample' => wfMessage( 'sub_letter_sample' )->text(),
  'tip'    => wfMessage( 'sub_letter_tip' )->text()
 ),
 array(
  'image'  => "editor_default/Button_redirect.png",
  'id'     => 'mw-editbutton-redirect',
  'open'   => "#REDIRECT[[",
  'close'  => ']]',
  'sample' => wfMessage( 'redirect_sample' )->text(),
  'tip'    => wfMessage( 'redirect_tip' )->text(),
  'key'    => 'F'
 ),
 array(
  'image'  => "editor_default_sw/Button_reflink.png",
  'id'     => 'mw-editbutton-reflink',
  'open'   => '<ref>',
  'close'  => '</ref>',
  'sample' => wfMessage( 'reflink_sample' )->text(),
  'tip'    => wfMessage( 'reflink_tip' )->text()
 ),
 array(
  'image'  => "editor_default_sw/Button_blockquote.png",
  'id'     => 'mw-editbutton-blockquote',
  'open'   => '<blockquote>'."\n",
  'close'  => "\n".'</blockquote>',
  'sample' => wfMessage( 'blockquote_sample' )->text(),
  'tip'    => wfMessage( 'blockquote_tip' )->text()
 ),
 array(
  'image'  => "editor_default_sw/Button_Bibliography.png",
  'id'     => 'mw-editbutton-bibliography',
  'open'   => '<bib id="',
  'close'  => '"/>',
  'sample' => wfMessage( 'bibliography_sample' )->text(),
  'tip'    => wfMessage( 'bibliography_tip' )->text()
 ),
 array(
  'image'  => "editor_default_sw/Button_hidden_comment.png",
  'id'     => 'mw-editbutton-hidden-comment',
  'open'   => '<!-- ',
  'close'  => ' -->',
  'sample' => wfMessage( 'hidden_comment_sample' )->text(),
  'tip'    => wfMessage( 'hidden_comment_tip' )->text()
 ),
 array(
  'image'  => "editor_default_sw/Button_insert_table.png",
  'id'     => 'mw-editbutton-insert-table',
  'open'   => '{| class="wikitable"'."\n".'|-'."\n",
  'close'  => "\n".'|}',
  'sample' => wfMessage( 'insert_table_sample' )->text(),
  'tip'    => wfMessage( 'insert_table_tip' )->text()
 )

Die Texte für "tip" und "sample" befinden sich in den json-Sprachdateien im Verzeichnis "/includes/i18n/".

ACHTUNG: Nach jedem mediawiki-Update muss überprüft werden, ob die vorgenommene Änderung in der Datei "EditPage.php" noch existiert und funktioniert. Deshalb ist im Verzeichnis "/includes/" von der Datei eine Kopie namens "EditPage_SW.php" zu speichern.

Erweiterung WikiEditor oder alter Standard-Editor ???[Bearbeiten]

Beispiel für einzufügenden HTML-Kommentar in Datei ??? ("ext.wikiEditor.js"? oder "ext.wikiEditor.toolbar.js"? im Verzeichnis "/extensions/WikiEditor/modules/"?):

if(mw.toolbar){
  mw.toolbar.addButton({
    imageFile: '//upload.wikimedia.org/wikipedia/en/3/34/Button_hide_comment.png',
    speedTip: 'Comment visible only for editors',
    tagOpen: '<!-- ',
    tagClose: ' -->',
    sampleText: 'Insert comment here',
    imageId: 'button-comment'
  });
}

Namensräume[Bearbeiten]

Übersicht der vorhandenen Namensräume[Bearbeiten]

Eine Übersicht sowohl der MediaWiki-Namensräume als auch der selbst erstellten Namensräume wird aufgelistet durch Eingabe folgender Adresse:
localhost/[wikiname]/api.php?action=query&meta=siteinfo&siprop=namespaces

Einrichten von Namensräumen[Bearbeiten]

Es werden folgende Namensräume eingerichtet:

  1. "ADM" bzw. "Access": "ADM" bei Salzwiki und Saltwiki, "Access" bei Repository) für Dokumente der Administratoren, den nur diese bearbeiten können,
  2. "Bearbeitung": nur bei Saltwiki zum erstmaligen Erstellen von Dokumenten, die kein Leser sehen soll
  3. "Literature": für die Bibliographie - Achtung: Bei der Zuweisung in $wgExtraNamespaces ist ein Leerzeichen vor "_talk"!
  4. "SalzeImPorenraum": nur bei Repository
  5. "RBKLuebeck": nur bei Repository - Achtung: Ursprüngliche Konstante "RBK-Luebeck" mit Bindestrich erzeugt bei MW 1.23 eine Fehlermeldung und Bindestrich ist auch nicht bei $wgExtraNamespaces enthalten

Leerzeichen und Bindestriche sind für selbst definierte Namensräume (custom namespaces) nicht zulässig, siehe https://www.mediawiki.org/wiki/Manual:Using_custom_namespaces

Salzwiki

# Einrichten der Namensräume Adm, Bearbeitung und Literature
define("NS_ADM", 100);
define("NS_ADM_TALK", 101);
#define("NS_Bearbeitung", 120);
#define("NS_Bearbeitung_TALK", 121);
define("NS_Literature", 110);
define("NS_Literature_TALK", 111);
# Create namespaces
$wgExtraNamespaces = array(
NS_ADM => 'Adm',
NS_ADM_TALK => 'Adm_talk',
#NS_Bearbeitung => 'Bearbeitung',
#NS_Bearbeitung_TALK => 'Bearbeitung_talk',
NS_Literature => 'Literature',
NS_Literature_TALK => 'Literature _talk'
);
$wgNamespacesWithSubpages[NS_HELP] = true;            #subpages enabled for the Helpnamespace
$wgNamespaceProtection[NS_ADM] = array( 'editadm' ); #permission "editadmin" required to edit the Adm namespace
$wgNamespacesWithSubpages[NS_ADM] = true;            #subpages enabled for the ADM namespace
$wgGroupPermissions['Administrator']['editadm'] = true;

Saltwiki

# Einrichten der Namensräume Adm, Bearbeitung und Literature
define("NS_ADM", 100);
define("NS_ADM_TALK", 101);
define("NS_Bearbeitung", 120);
define("NS_Bearbeitung_TALK", 121);
define("NS_Literature", 110);
define("NS_Literature_TALK", 111);
# Create namespaces
$wgExtraNamespaces = array(
NS_ADM => 'Adm',
NS_ADM_TALK => 'Adm_talk',
NS_Bearbeitung => 'Bearbeitung',
NS_Bearbeitung_TALK => 'Bearbeitung_talk',
NS_Literature => 'Literature',
NS_Literature_TALK => 'Literature _talk'
);

$wgNamespacesWithSubpages[NS_HELP] = true;           #subpages enabled for the Helpnamespace
$wgNamespaceProtection[NS_ADM] = array( 'editadm' ); #permission "editadmin" required to edit the Adm namespace
$wgNamespacesWithSubpages[NS_ADM] = true;            #subpages enabled for the ADM namespace
$wgGroupPermissions['Sysadmin']['editadm'] = true;

Repository

# Einrichten der Namensräume Adm, Bearbeitung und Literature
define("NS_Access", 100);
define("NS_Access_TALK", 101);
#define("NS_Bearbeitung", 120);
#define("NS_Bearbeitung_TALK", 121);
define("NS_Literature", 110);
define("NS_Literature_TALK", 111);
# Create namespaces
$wgExtraNamespaces = array(
NS_Access => 'Access',
NS_Access_TALK => 'Access_talk',
#NS_Bearbeitung => 'Bearbeitung',
#NS_Bearbeitung_TALK => 'Bearbeitung_talk',
NS_Literature => 'Literature',
NS_Literature_TALK => 'Literature _talk'
);

##Anlegen von Namensräumen für Projekte
define('NS_SalzeImPorenraum', 1010);
define('NS_SalzeImPorenraum_TALK', 1011);
$wgExtraNamespaces[NS_SalzeImPorenraum] = 'SIPP';
$wgExtraNamespaces[NS_SalzeImPorenraum_TALK] = 'SIPP_talk';
#define('NS_RBK-Luebeck', 1020); //Achtung: Bindestrich darf nicht sein und ist auch nicht bei $wgExtraNamespaces enthalten
#define('NS_RBK-Luebeck_TALK', 1021);  //Achtung: Bindestrich darf nicht sein und ist auch nicht bei $wgExtraNamespaces enthalten
define('NS_RBKLuebeck', 1021);
define('NS_RBKLuebeck_TALK', 1021);
$wgExtraNamespaces[NS_RBKLuebeck] = 'Rbkl';
$wgExtraNamespaces[NS_RBKLuebeck_TALK] = 'Rbkl_talk';

#$wgNamespacesWithSubpages[NS_HELP] = true;            #subpages enabled for the Helpnamespace
#$wgNamespaceProtection[NS_ADM] = array( 'editadm' ); #permission "editadmin" required to edit the Adm namespace
#$wgNamespacesWithSubpages[NS_ADM] = true;            #subpages enabled for the ADM namespace
#$wgGroupPermissions['Sysadmin']['editadm'] = true;

Extensions[Bearbeiten]

Welche Erweiterungen in welcher Distribution enthalten sind, erfährt man auf der Seite https://www.mediawiki.org/wiki/Comparison_of_extensions_in_distributions


AccessControl[Bearbeiten]

Verwendungszweck[Bearbeiten]

Die Erweiterung dient dazu, Seiten beispielsweise auch zum Lesen zu sperren, wenn wie im Repositorium Inhalte zwar bereits bearbeitet und ins Wiki eingestellt werden, aber noch nicht öffentlich zugänglich sein sollen.

Der Zugang auf eine Seite wird durch Eingabe einer Nutzergruppe (Beispiel: "parole") erlaubt, die vorher z.B. in "LocalSettings.php" definiert wird:

$wgGroupPermissions['parole']['read'] = true;

Damit nur Mitglieder der Gruppe "parole" Zugang zu einer Seite erhalten, wird auf der jeweiligen Seite oben folgende Zeile eingegeben (siehe dazu auch http://www.mediawiki.org/wiki/Extension:AccessControl):

<accesscontrol>parole</accesscontrol>

AccessControl v2.4 fehlerhaft bei MW 1.23[Bearbeiten]

Für MW 1.23 wurde versucht, AccessControl v2.5 zu verwenden. Der Download enthält aber nicht wie in Aussicht gestellt Version 2.5, sondern Version v2.4, bei welcher in der Datei "changelog.txt" nur Änderungen bis v2.3 aufgelistet sind. Die Version 2.4 hat mehrere Fehler:

  • Z.21: "$wgAccessControlRedirect = true;" fehlt
  • Z.136: in Funktion getTemplatePage() ist ein Rückgabewert auskommentiert
  • Z.173: php-Warnung, weil "isset($allow)" fehlt
  • Z.225: php-Warnung, weil "isset($rights)" fehlt
  • Z.202, Z.210: in Funktion fromTemplates() wird dieselbe Funktion evtl. endlos aufgerufen
  • Z.284: in Funktion allRightsTag() wird die Funktion fromTemplates() aufgerufen, die wiederum evtl. die Funktion allRightsTag() in Z.213, Z.218 und Z.220 endlos aufruft
  • Funktion doRedirect() ist im Vergleich zu v2.5 anders

AccessControl v2.5 für MW 1.23[Bearbeiten]

Siehe auch https://www.mediawiki.org/wiki/Extension:AccessControl

Für die Gruppe "autor" wird standardmäßig beispielsweise die Seite "Autor" nach einer Liste mit Kontonamen durchsucht, wobei unterschieden wird zwischen "write"-Berechtigung und durch das Suffix "(ro)", was "readonly" bedeutet, "read"-Berechtigung.

Da eine Vielzahl Benutzungskonten zur Gruppe "autor" gehört und die Seite "Autor" in SalzWiki anderweitig verwendet wird, muss die Gruppenzugehörigkeit mit der Zuordnung in der MW-Datenbank überprüft werden und der Code der Erweiterung in der Funktion "makeGroupArray(...)" angepasst werden.

Installationshinweise[Bearbeiten]

Achtung: Version 2.5 ist nicht zum Herunterladen bei REL1.23, sondern erst bei REL1.24 verfügbar.

  • Die Extension wird als (REL1.24 oder) REL1.26 heruntergeladen und nach dem Extrahieren in das Verzeichnis "extensions" kopiert.
    • v2.5 "...REL1.26...", Datei "version": 2016-01-09T22:48:53 1a2ce27 [verwendet]
    • v2.5 "...REL1.24...", Datei "version": 2016-01-09T22:48:53 c7e1e54 [nicht verwendet]
    • v2.4 "...REL1.23...", Datei "version": 2015-06-16T21:00:32 befc02e [nicht verwendet]
  • Einfügen in Datei "LocalSettings.php":
require_once("$IP/extensions/AccessControl/AccessControl.php");
$wgUseMediaWikiGroups = true;
Code-Probleme und deren Lösungen[Bearbeiten]

undefinierte Variablen

PHP erzeugt evtl. eine Meldung "Notice: Undefined variable: allow ... on line 174". Es fehlt bei $allow die Abfrage "isset(...)".

Die Datei "AccessControl.php" ist zur Verhinderung von php-Warnungen wie folgt zu bearbeiten:
In Zeile 174 "if(is_array($allow)){" mit "isset($allow) &&" ergänzen:

if(isset($allow) && is_array($allow)){

Gruppenzugehörigkeit mit Datenbank statt Gruppen-Seite prüfen

Die Überprüfung der Gruppenberechtigung darf nicht mit einer Seite für die Gruppe mit Kontenliste, sondern muss mit den Angaben in der Wiki-Datenbank ausgeführt werden

  • Datei "LocalSettings.php" mit "$wgUseMediaWikiGroups" ergänzen
  • Datei "\extensions\AccessControl\AccessControl.php" in der Funktion "makeGroupArray(...)" anpassen


Datei "LocalSettings.php":

require_once("$IP/extensions/AccessControl/AccessControl.php");
$wgUseMediaWikiGroups = true;

Datei "AccessControl.php" Z.89ff:

function makeGroupArray( $accesslist ) {
  ...
  $usersreadonly = Array();
  // für HAWK HHG eingefügt 2016-05-17
  // users of group from wiki database
  global $wgUseMediaWikiGroups, $wgUser;
  if($wgUseMediaWikiGroups === true){
    if( in_array($accesslist, $wgUser->getGroups()) ){
      $userswrite[] = $wgUser->getName();
    }
    return array($userswrite, $usersreadonly);
  }
  // users from group-page with list of users and their rights for writing or reading
  $users = getUsersFromPages( $accesslist );
  ...
}

Timeout durch Template-Name im Template-Text

Weitere Probleme mit Script-Timeout wie bei AccessControl v2.4:

  • Z.206, Z.214: in Funktion fromTemplates() wird dieselbe Funktion evtl. endlos aufgerufen
  • Z.290: in Funktion allRightsTag() wird die Funktion fromTemplates() aufgerufen, die wiederum evtl. die Funktion allRightsTag() in Z.217, Z.222 und Z.224 endlos aufruft

Timeout-Ursache sind in den Templates "Ynotice", "Baustelle" und "FreeForTranslation" die noinclude-Bereiche, in denen der Template-Name erneut auftaucht. Der erste Buchstabe muss entweder kleingeschrieben werden oder - besser - durch Hexadezimal-HTML-Zeichen ersetzt werden:


<noinclude>
=== Beispielvorlage ===
{{&#98;notice|text=
}}
</noinclude>

<noinclude>
=== Beispielvorlage ===
{{&#66;austelle}}
</noinclude>

<noinclude>
=== Beispielvorlage ===
{{&#70;reeForTranslation}}
</noinclude>


Verarbeitung von Rückgabewert NULL

In den Funktionen "getTemplatePage(...)" Z.130ff und "getUsersFromPages(...)" Z.144ff muss wie bei der Funktion "getContentPage(...)" für die Verwendung der Methode "getNativeData()" der Wert, der sich zuvor aus der Methode "getContent()" ergibt, auf "NULL" überprüft werden.

function getTemplatePage( $template ) {
  ...
  if ( method_exists('WikiPage', 'getContent' ) ){
    // für HAWK HHG angepasst 2016-05-17
    #$contentPage = new WikiPage( $gt );
    #return $contentPage->getContent()->getNativeData();
    $contentPage = WikiPage::factory( $gt );
    $contentPageContent = $contentPage->getContent( Revision::RAW )
    if ( $contentPageContent != NULL ){
      return ContentHandler::getContentText( $contentPageContent );
    }
  } else {
    // create Article and get the content
    $contentPage = new Article( $gt, 0 );
    return $contentPage->fetchContent( 0 );
  }
}

function getUsersFromPages( $group ) {
  ...
  if ( method_exists('WikiPage', 'getContent' ) ){
    // für HAWK HHG angepasst 2016-05-17
    #$groupPage = new WikiPage( $gt );
    #$allowedUsers = $groupPage->getContent()->getNativeData();
    $groupPage = WikiPage::factory( $gt );
    $groupContent = $groupPage->getContent( Revision::RAW )
    if ( $groupContent != NULL ){
      $allowedUsers = ContentHandler::getContentText( $groupContent );
    }
  } else {
    // create Article and get the content
    $groupPage = new Article( $gt, 0 );
    $allowedUsers = $groupPage->fetchContent( 0 );
  }
}


weitere Fehlerquellen

Abhilfe schaffen folgende Änderungen von https://www.mediawiki.org/wiki/Extension_talk:AccessControl#Selected_fixes_against_2.5:

//function makeGroupArray(...)
//Z.94
$usersreadonly[] = (string)$user;   #$usersreadonly[] = $user;
//Z.97
$userswrite[] = (string)$user;   #$userswrite[] = $user;

//function getUsersFromPages(...)
//Z.150
$gt = $Title->newFromText( $group );    #$gt = $Title->makeTitle( 0, $group );

//function fromTemplates(...)
//Z.231
if ( $wgUser->isAnon() ) {    #if ( $wgUser->mID === 0 ) {
//Z.236
if ( in_array( 'sysop', $wgUser->getGroups(), true) ) {    #if ( in_array( 'sysop', $wgUser->mGroups, true) ) {
//Z.244
if ( ! in_array( $wgUser->getName(), $users[0], true) ) {    #if ( ! in_array( $wgUser->mName, $users[0], true) ) {
//Z.255
if ( ! in_array( $wgUser->getName(), $users[1], true) ) {    #if ( ! in_array( $wgUser->mName, $users[1], true) ) {

// function allRightTags(...)
//Z.285
$gt = $Title->newFromText( $redirecttarget );    #$gt = $Title->makeTitle( 0, $redirecttarget );

//function hookUserCan(...)
//Z.322
if ( $wgUser->isAnon() ) {    #if ( $wgUser->mID === 0 ) {
//Z.338
if ( $wgUser->isAnon() ) {    #if ( $wgUser->mID === 0 ) {
//Z.351
if ( in_array( $wgUser->getName(), $users[0], true) ) {    #if ( in_array( $wgUser->mName, $users[0], true) ) {
//Z.364
if ( in_array( $wgUser->getName(), $users[1], true) ) {    #if ( in_array( $wgUser->mName, $users[1], true) ) {


Funktion "fromTemplates"

Bei der Funktion "fromTemplates($string)" bei Z.219ff hat möglicherweise die Variable $rights den Wert NULL, weil sie die verschachtelteten Funktionen "allRightTags( getContentPage( 10, $templatepage) )" mit dem Namensraum 10 (ID für Templates) und mit dem Inhalt anstatt mit dem Seitentitel verwendet:

} elseif ( ctype_alnum( substr( $templatepage, 0, 1 ) )) {
  // für HAWK HHG angepasst 2016-05-17
  $context = new RequestContext();
  $gt2 = $context->getTitle();
  // The check of included template
  if (strpos( $tempatepage, '|' ) > 0) {
    $templatename = substr( $templatepage, 0, strpos( $templatepage, '|' ) );
    #$rights = allRightTags( getContentPage( 10, $templatename ) );
    $rights = allRightTags( getContentPage( $gt2->getNamespace(), $templatename ) );
  } else {
    #$rights = allRightTags( getContentPage( 10, $templatepage ) );
    $rights = allRightTags( getContentPage( $gt2->getNamespace(), $gt2->getFullText() ) );
  }
}
Lösungsversuche ohne Erfolg[Bearbeiten]

Funktion "getContentPage(...)"

Fehlversuch Z. 121ff hinzufügen von "else{...}"

if ( method_exists( 'WikiPage', 'getContent' ) ) {
 $contentPage = WikiPage::factory( $gt ); #$contentPage = new WikiPage( $gt );
 if ( $contentPage->getContent (Revision::RAW) != NULL ) {
  ...
 }
 // für HAWK HHG nicht eingefügt 2016-05-10 wegen Endlosscript
 else{
  $context = new RequestContext();
  $gt2 = $context->getTitle();
  $contentArticle = new Article( $gt2, $namespace);
  if($contentArticle->getPage()->getContent() != NULL){
   return $contentArticle->getPage()->getContent(Revision::RAW)->getNativeData()
  }
 }
} else {
 // create Article and get the content
...
}

Einrichten einer Nutzungsgruppe[Bearbeiten]

Eine Gruppe von Usern, die alleine Zugang auf bestimmte Seiten haben soll, wird z. b. beim Repositorium im Namensrauam "ACCESS" wie unten eingerichtet.

Speichern der Liste auf der Seite Access:SIP
<accesscontrol>Access:SIP</accesscontrol># Schutz der eigenen Seite
*Hschwarz                                                 # einfache Liste der User
*HJuling
*MSteiger
*SLaue
*SBrueggerhoff
*Testuser

ApprovedRevs[Bearbeiten]

Einschränkung[Bearbeiten]

Diese Erweiterung kann nicht verwendet werden, wenn die Erweiterung "AccessControl" verwendet wird; siehe https://www.mediawiki.org/wiki/Extension:ApprovedRevs.

Verwendungszweck[Bearbeiten]

Mit dieser Erweiterung können Revisionen (Versionen einer SalzWiki-Seite) bestätigt oder abgelehnt werden. Die bestätigte Version wird allen Usern angezeigt.

Approved Revs-1.jpg

Installation der Erweiterung "ApprovedRevs"[Bearbeiten]

  • Die Erweiterung wird mit der Version 0.7.0 REL1.23 2015-06-16T21:01:12 513cff5 heruntergeladen und nach dem Extrahieren in das Extensions-Verzeichnis des jeweiligen Wikis kopiert.
  • Es muss bei einem neuen Wiki eine Datenbank-Tabelle mit dem Präfix "sw_" (SalzWiki, SaltWiki) bzw. "sr_" (Repository) und dem Namen "approved_revs" angelegt werden. Hierzu gibt es zwei Möglichkeiten:
    • Das Skript "update.php" von "MediaWiki's/maintenance" benutzen oder
    • Mittels "phpMyAdmin" in der Datenbank die Tabelle mit den beiden SQL-Befehlen, die in der Datei "ApprovedRevs.sql" der Erweiterung zu finden sind, erstellen.
  • Die Erweiterung in der Datei "LocalSettings.php" aktivieren
// SalzWiki, SaltWiki, Repository
require_once( "$IP/extensions/ApprovedRevs/ApprovedRevs.php" );

Konfiguration von "ApprovedRevs"[Bearbeiten]

Diejenigen, die das Recht "viewlinktolatest" haben, sehen einen Hyperlink unter dem Titel des Artikels, um zur aktuellen unbestätigten Version zu kommen.

Diejenigen, die das Recht "approverevisions" haben, können in der History (Versionen-Übersicht) eine Version "bestätigen" oder "ablehnen".

Damit nur Admins und Mitglieder der Gruppen "Redakteur"/"Editor" eine Version bestätigen bzw. ablehnen können und zusätzlich Mitglieder der Gruppe "autor" den Verweis zur aktuellen unbestätigten Version zur Verfügung gestellt bekommen, sind in der Datei "LocalSettings.php" folgende Angaben erforderlich:

// SalzWiki
$wgGroupPermissions['Redakteur']['approverevisions'] = true;
$wgGroupPermissions['sysop']['approverevisions'] = true;
$wgGroupPermissions['autor']['viewlinktolatest'] = true;
$wgGroupPermissions['*']['viewlinktolatest'] = false;
$wgGroupPermissions['sysop']['viewlinktolatest'] = true;
// SaltWiki
$wgGroupPermissions['Editor']['approverevisions'] = true;
$wgGroupPermissions['sysop']['approverevisions'] = true;
$wgGroupPermissions['autor']['viewlinktolatest'] = true;
$wgGroupPermissions['*']['viewlinktolatest'] = false;
$wgGroupPermissions['sysop']['viewlinktolatest'] = true;
// Repository
$wgGroupPermissions['Editor']['approverevisions'] = true;
$wgGroupPermissions['sysop']['approverevisions'] = true;
#$wgGroupPermissions['autor']['viewlinktolatest'] = true;
$wgGroupPermissions['*']['viewlinktolatest'] = false;
$wgGroupPermissions['sysop']['viewlinktolatest'] = true;

Beispiele:

  • damit z. B. alle Mitglieder der Gruppe "autor" Seiten als geprüft markieren können
$wgGroupPermissions['autor']['approverevisions'] = true;
  • um den ApprovedRevs-Hyperlink standardmäßig zu deaktivieren
$wgGroupPermissions['*']['viewlinktolatest'] = false;
  • um den ApprovedRevs-Hyperlink allen Admins und Mitgliedern der Gruppe "autor" zur Verfügung zu stellen
$wgGroupPermissions['autor']['viewlinktolatest'] = true;
$wgGroupPermissions['sysops']['viewlinktolatest'] = true;

Bibliography[Bearbeiten]

Die Extension Bibliography wurde durch die Erweiterung BibManager ersetzt. Siehe hierzu unter "Erweiterungen - BibManager".


BibManager[Bearbeiten]

Die Erweiterung "BibManager" wird zur Erstellung und Verwaltung der Literaturhinweise bzw. zum Einbinden der Zitate in Artikel benutzt und verwendet den Namensraum "NS_CITATION" ("Cit") mit der Nummer 800 sowie "NS_CITATION_TALK" ("Cit_talk") mit der Nummer 801.

Die Erweiterung besteht aus

  • der Grunderweiterung "BibManager"
  • und den von "HalloWelt" für die HAWK HHG programmierten Zusatzerweiterungen

Mit der Erweiterung "SaltWiki" können im SalzWiki/SaltWiki/Repository weitere Felder, die nicht im original "BibTeX" spezifiziert sind, wie DOI und Fulltext, verwendet werden.

Die Erweiterung "SaltWikiUpload" soll im Repositorium das Hochladen von Dateien mit BibTex-Angaben erleichtern, doch wird bei MW1.23LTS nur das MW-Standard-Upload-Formular angezeigt.

Versionen[Bearbeiten]

Für MediaWiki 1.23 LTS wird wegen diverser Probleme bei der BibManager-Version v1.1.0 die Version 1.23 REL1.26 2015-11-17T01:01:50 d824ce8 installiert.

  • BibManager
    • v1.23.0 master 2016-01-15T07:01:22 951b12f
    • v1.23.0 REL1.26 2015-11-17T01:01:50 d824ce8 verwenden bei MW1.23LTS
    • v1.1.0 REL1.23 2015-06-16T21:02:02 6218f71 (angeboten für MW 1.22+)
    • v1 (verwendet bei MW1.16)
  • SaltWiki
    • SaltWiki mit Datum 2012-05-25 verwenden bei MW1.23LTS
    • SaltWiki mit Datum 2012-01-20 (verwendet bei MW1.16)
  • SaltWikiUpload
    • SaltWikiUpload mit Datum 2012-01-25 verwenden bei MW1.23LTS Repository
    • SaltWikiUpload mit Datum 2012-01-11 (verwendet bei MW1.16 Repository)

BibManager-Versionsangaben befinden sich in folgenden Dateien:

  • version: REL1.26 2015-11-17T01:01:50
  • BibManager.php: 1.23.0
  • BibManager.i18n.php: compatibility back to MediaWiki 1.17

Installation[Bearbeiten]

Bei der Installation werden die Erweiterungen in folgende Ordner kopiert:

  • "\extensions\BibManager\"
  • "\extensions\SaltWiki\"
  • "\extensions\SaltWikiUpload\"

In der Datei "LocalSettings.php" wird Folgendes eingefügt:

## Namensräume
...
 // für Erweiterung BibManager
 define("NS_CITATION", 800);
 define("NS_CITATION_TALK", 801);
 $wgExtraNamespaces[NS_CITATION] = 'Cit';
 $wgExtraNamespaces[NS_CITATION_TALK] = 'Cit_talk';
 ...
## EXTENSIONS
...
 require_once('extensions/BibManager/BibManager.php');
 require_once('extensions/SaltWiki/SaltWiki.php' );
 #nur im Repositorium:
 require_once('extensions/SaltWikiUpload/SaltWikiUpload.php' );
 ...
## Einstellungen
...
## Erweiterung BibManager
# Namensraum berücksichtigen
$wgBibManagerCitationArticleNamespace = NS_CITATION;
# BibManager-Anpassung an die gewünschte Zitierweise
$wgBibManagerCitationFormats = array (
  '-' => '%author%: %title%, %year% %url%, %doi%.',
  'article' => '%author% (%year%): %title%. <em>%journal%</em>, <b>%volume%</b> (%number%), %pages%, %url%, %doi%.',
  'book' => '%editor% %author% (%year%): <em>%title%, %edition%, %publisher%, %address%, %pages%</em>, %url%., %doi%',
  'booklet' => '%title% %url%, %doi%.',
  'conference' => '%author% (%year%): %title%. %booktitle% %url%, %doi%.',
  'inbook' => '%author% (%year%): <em>%title%. In: %editor%: %edition%, %publisher%, %address%, %pages%</em> %url%, %doi%.',
  'incollection' => '%author% (%year%): %title%. In: %editor%: %booktitle%, <em>%publisher%</em>, %pages%, %url%, %doi%.',
  'inproceedings' => '%author% (%year%): %title%. In: %editor%: %booktitle%,<em>%publisher%</em>, %pages%, %url%, %doi%.',
  'manual' => '%title% %url%, %doi%.',
  'mastersthesis' => '%author% (%year%): %title%, %type%, %school%, %address%, %url%, %doi%.',
  'misc' => '%author% (%year%): %title%, %howpublished%, %pages% %url%, %doi%.',
  'phdthesis' => '%author% (%year%): %title%. %type%, %school%, %url%, %doi%.',
  'proceedings' => '%editor% (%year%): %title%,<em> %publisher%</em>, %url%, %doi%.',
  'techreport' => '%author% (%year%): %title%. %institution% %url%, %doi%.',
  'unpublished' => '%author% (%year%): %title%. %note%, %url%, %doi%.'
);
BibManager v1.23 REL1_26 und v1.23 master[Bearbeiten]
  • Fehler bei "Edit" mit Fehlermeldung zu bereits vorhandenem Schlüssel
  • Fehler bei "Delete" wegen fehlender Datensatzkennung
  • Bei "Verwalten" fehlen rechts die Icons für "Edit" und "Delete" sowie die Trennung zwischen beiden Texten: css-Datei fehlt im head-Bereich
  • In der Datei "\extensions\BibManager\includes\BibManagerHooks.php" ist in der Funktion "getIcons(...)" der Pfad 2-mal hart-codiert statt mit einer Variablen angegeben:
    ... htmlspecialchars( $wgScriptPath . '/extensions/BibManager/resources/images/[pencil.png|book.png]' );
BibManager v1.1.0 REL1_23[Bearbeiten]
  • Fehler bei "Create", "Edit" und "Delete" wegen fehlender Datensatzkennung.
  • In der Datei "\extensions\BibManager\includes\BibManagerHooks.php" ist in der Funktion "onBeforePageDisplay(...)" der Pfad zur Erweiterung 3-mal hart-codiert statt mit einer Variablen angegeben:
    ... htmlspecialchars( $wgScriptPath . '/extensions/BibManager/client/[BibManagerCommon.css|BibManagerEdit.js|BibManagerList.js]' );
  • Für ebenfalls hart-codierte Pfadangaben in der Funktion "getIcons(...)" siehe #BibManager 1.23 REL1_26 und 1.23 master

Spezialseiten-Gruppe[Bearbeiten]

Verfügbarkeit in Abhängigkeit vom Status

  • Ohne Anmeldung sollen nur die Verweise zu "Bibliographien anzeigen: Autoren" und "Bibliographien verwalten" sichtbar sein. Bei "Bibliographien verwalten" sind dann die Funktionen "Edit" und "Delete" nicht vorhanden, sondern nur "Export".
  • Nach Anmeldung sind auch die Funktionen "Bibliographieeintrag anlegen" und "Bibliographien importieren" verfügbar.

Von den zu ändernden Dateien bzw. Verzeichnissen ist nach den Anpassungen jeweils eine Kopie mit dem Suffix "SW" im Dateinamen bzw. Verzeichnisnamen zu speichern, um nach Updates von MediaWiki oder Erweiterungen die Änderungen übernehmen zu können.

Es sollte eine Datei "\i18n\qqq.json" mit folgendem Code erstellt werden:

{
  "@metadata": {
    "authors": []
  },
  "bibmanager": "BibManager",
  "bibmanager-desc": "{{desc}}"
}
BibManager v1.23.0 REL1.26 Datei-Anpassungen[Bearbeiten]
  • \i18n\ => \i18nSW\
    • de.json
    • de-formal.json
    • en.json
    • qqq.json
  • \includes\
    • BibManagerHooks.php => BibManagerHooksSW.php
    • BibManagerPagerList.php =>BibManagerPagerListSW.php
  • \includes\specials\
    • SpecialBibManagerDelete.php => SpecialBibManagerDeleteSW.php
    • SpecialBibManagerEdit.php => SpecialBibManagerEditSW.php
  • \resources\ext.bibManager.css =ext.bibManagerSW.css>
BibManager v1.1.0 REL1.23 Datei-Anpassungen[Bearbeiten]
  • BibManager.php => BibManagerSW.php
  • BibManager.alias.php => BibManager.aliasSW.php
  • \i18n\ => \i18nSW\
    • de.json
    • de-formal.json
    • en.json
    • qqq.json
  • \specialpages\ => \specialpagesSW\
    • BibManagerCreate_body.php
    • BibManagerDelete_body.php
    • BibManagerEdit_body.php
    • BibManagerExport_body.php
    • BibManagerImport_body.php
    • BibManagerList_body.php
    • BibManagerListAuthors_body.php

Die Spezialseiten-Gruppe "BibManager" und die darin angezeigten Spezialseiten werden in der Datei "\extensions\BibManager\i18n\[Sprache].json" festgelegt; siehe https://www.mediawiki.org/wiki/Manual:Special_pages#The_localisation_file. Die Einbindung funktioniert mit MW1.23 fehlerhaft: Entweder werden die Seiten nicht angezeigt (Schlüssel mit Großbuchstaben wie bisher) oder werden die Seiten nicht gefunden (Schlüssel insgesamt in Kleinbuchstaben).

In den Zeilen 5 und 13 der json-Sprachdateien wäre der Array-Schlüssel von "BibManager" in Kleinbuchstaben zu ändern:

...
  "specialpages-group-bibmanager": "BibManager",
...
  "bibmanager": "BibManager",
...

Die Variable $wgSpecialPageGroups in der Datei "BibManager.php" gilt als "deprecated" seit MW 1.21 (https://gerrit.wikimedia.org/r/#/c/220819/3) und kann auskommentiert werden, wenn im Verzeichnis "\specialpages\" in den jeweiligen Dateien "BibManager..._body.php" am Ende der Klasse folgende Funktion eingefügt wird (https://www.mediawiki.org/wiki/Manual:Special_pages => Special page group):

  protected function getGroupName(){
    return 'bibmanager';
  }
Systemnachrichten für Gruppe prüfen[Bearbeiten]

Ob die Gruppe "BibManager" in den Systemnachrichten auftaucht, lässt sich durch Aufruf der MediaWiki-Systemnachrichten, die sich bei den Spezialseiten in der Rubrik "Daten und Werkzeuge" befinden, überprüfen, indem als Präfixfilter "Specialpages-group" angegeben wird. Dann sollte bei den Ergebnissen der Name "specialpages-group-bibmanager" mit dem Text "BibManager" aufgelistet werden.

Einschränkungen für Darstellung in der Spezialseiten-Gruppe überprüfen[Bearbeiten]

Wenn die BibManager-Spezialseiten nicht angezeigt werden, folgendes prüfen:

  • In den Dateien "BibManager.php" oder "LocalSettings.php" die Gruppenberechtigung ändern:
    • Bibliographien anlegen: $wgGroupPermissions['sysop']['bibmanagercreate'] => $wgGroupPermissions['*']['bibmanagercreate']
    • Bibliographien importieren: $wgGroupPermissions['sysop']['bibmanageredit'] => $wgGroupPermissions['*']['bibmanageredit']
  • Beim Klassen-Konstruktor "parent::__construct('...', '...')" den 2. Parameter (Kleinbuchstaben) für $restriction weggelassen in folgenden Dateien:
    • "\specialpages\BibManagerCreate_body.php" in Zeile 6
    • "\specialpages\BibManagerImport_body.php" in Zeile 6

Fehler korrigieren[Bearbeiten]

Fehler beim Speichern nach Bearbeitung[Bearbeiten]

Der bearbeitete Datensatz kann nicht gespeichert werden, weil die Prüfung des Bearbeitungsmodus fehlerhaft ist und der Datensatz wie ein Neueintrag auf einen bereits vorhandenen Zitatschlüssel überprüft wird.

In der Datei "\extensions\BibManager\includes\specials\SpecialBibManagerEdit.php" muss in der Funktion "execute(...)" in Zeile 69 "bm_edit_mode" zu "wpbm_edit_mode" geändert werden:

$editMode = $wgRequest->getBool( 'wpbm_edit_mode' ); #$editMode = $wgRequest->getBool( 'bm_edit_mode' ); für HAWK HHG geändert 2016-02-16

Anschließend ist eine Kopie der Datei mit dem Suffix "SW" zu speichern.

Fehler bei Löschvorgang[Bearbeiten]

Der Datensatz kann wegen fehlender Angaben nach der Löschbestätigung nicht gelöscht werden:

  • Element "bm_bibtexCitation" existiert nicht im Formular, sondern "wpbm_bibtexCitation"
  • Element "bm_delete" existiert nicht im Formular, sondern "wpbm_delete"
  • $deleteSubmit ist immer falsch, weil String (Zeichenkette) mit Boolean (Wahrheitswert) verglichen wird

In der Datei "\extensions\BibManager\includes\specials\SpecialBibManagerDelete.php" folgende Anpassungen vornehmen:

  • Bei Array "$formDescriptor" einen Namen für das Formularfeld "bm_delete" vorgeben
  • Bei Array "$formDescriptor" einen Namen für das Formularfeld "bm_bibtexCitation" vorgeben
  • In Funktion "formSubmit(...)" bei der Prüfung von "$formdata['bm_delete']" Umwandlung von Boolean in String einfügen
//Z.59ff
$formDescriptor = array (
  'bm_delete' = array (
    'class' => 'HTMLHiddenField';
    'default' => true,
    'name' => 'bm_delete', // für HAWK HHG eingefügt 2016-02-09
  )
  'bm_bibtexCitation' = array (
    'class' => 'HTMLHiddenField';
    'default' => $citation,
    'name' => 'bm_bibtexCitation', // für HAWK HHG eingefügt 2016-02-09
  )
);
//Z.89
if ( empty( $formData['bm_delete'] ) || $formData['bm_delete'] !== (string)true ) // für HAWK HHG ergänzt mit (string) 2016-02-09
Falscher Text nach Löschvorgang[Bearbeiten]

Nachdem ein Eintrag gelöscht wurde, erscheint "Ihre Daten wurden erfolgreich gespeichert!" (auch schon in MW1.16).

In der Datei "\extensions\BibManager\includes\specials\SpecialBibManagerDelete.php" in der Funktion "formSubmit(...)" wird in Z.94 fälschlicherweise "bm_success_save-complete" verwendet. Da es kein Text-Element "bm_success_delete" gibt, muss es in den Dateien "\i18n\[en|de|de-formal].json" für "en", "de" und "de-formal" in der Zeile nach "bm_success_save-complete" ergänzt werden, damit es in der Datei "BibManagerDelete_body.php" verwendet werden kann.

Nach den Anpassungen ist die Delete-Datei als Kopie mit dem Suffix "SW" im Verzeichnis "specials" und das Verzeichnis "i18n" als Kopie "i18nSW" zu speichern.

//de.json Z.135f
  "bm_success_save-complete": "<div class=\"successbox\"><strong>Deine Daten wurden erfolgreich gespeichert!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
  "bm_success_delete": "<div class=\"successbox\"><strong>Die Daten wurden erfolgreich gelöscht!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",

//de-formal.json Z.135f
  "bm_success_save-complete": "<div class=\"successbox\"><strong>Ihre Daten wurden erfolgreich gespeichert!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
  "bm_success_delete": "<div class=\"successbox\"><strong>Die Daten wurden erfolgreich gelöscht!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",

//en.json Z.135f
  "bm_success_save-complete": "<div class=\"successbox\"><strong>Your data was successfully saved!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
  "bm_success_delete": "<div class=\"successbox\"><strong>The data were successfully deleted!</strong></div><div class=\"visualClear\" id=\"mw-pref-clear\"></div>",
//SpecialBibManagerDelete.php Z.92ff
// für HAWK HHG geändert zu "delete"-Text statt "save-complete" 2016-02-15
if ( $result === true ) {
  $wgOut->addHtml( wfMessage( 'bm_success_delete') ); #wfMsg( 'bm_success_save-complete') für HAWK HHG korrigiert 2016-02-08
  ...
}

Außerdem kann in der Datei "SpecialBibManagerDelete.php" wie in Z.94 die Funktion "wfMsg()" ersetzt werden durch "wfMessage()" in den Zeilen 24, 29, 35, 43, 54, 71.

Fehler im HTML-Code korrigieren[Bearbeiten]

Bei der BibManager-Übesicht wird für jede Tabellenzeile ein statt eines erzeugt (auch schon in MW1.16). Im Verzeichnis "BibManager\includes\" in der Datei "bibManagerPagerList.php" in Zeile 133 den fehlenden Schrägstrich einfügen:

  $tablerow[] = '</tr>'; // Schrägstrich für schließendes Tag eingefügt 2012-09-17 G. Werner
Fehlende Icons bei Verweisen rechts für "edit" und "delete"[Bearbeiten]

In der BibManager-Übersicht sind rechts Text-Hyperlinks ohne Abstand für "edit" und "delete" anstatt Icons; es sind in folgenden Dateien Anpassungen vorzunehmen:

  • "\extensions\BibManager\includes\BibManagerHooks.php"
  • "\extensions\BibManager\resources\ext.bibManager.css"
  • "\extensions\BibManager\includes\BibManagerPagerList.php"

Nach den Anpassungen ist jeweils eine Kopie der Datei mit dem Suffix "SW" zu speichern.

Bei "BibManagerHooks.php" ist in Funktion "onBeforePageDisplay(...)" am Anfang, vor Zeile 29 (Eindbindung der JS-Module), die Einbindung der css-Datei einzufügen:

  // für HAWK HHG eingefügt 2016-02-12
  $out->addModuleStyles( 'ext.bibManager.styles' );

Bei "ext.bibManager.css" in Zeile 96 einen Kommentar einfügen und zwischen "width: 16px;" und "text-indent: 9999px;", Z.99f, eine neue Zeile "height: 15px;" einfügen

/* für HAWK HHG wg. nicht sichtbarer Icons, die bei BibManager v1 ohne "overflow:hidden" sehr weit rechts waren, geändert 2016-02-15 */
#bm_table a.icon {
  ...
  height: 15 px; /*text-indent: 9999px;*/	
  ...
}

Bei "BibManagerPagerList.php" in Funktion "formatRow(...)" in den Zeilen 104, 108, 117 und 120 die "wfMsg"-Funktionen ersetzen durch "wfMessage"-Funktionen:

if ($wgUser->isAllowed('bibmanageredit')){
  // für HAWK HHG "wfMsg()" zu "wfMessage()" geändert 2016-02-15
  $editLink = Linker::link(
    SpecialPage::getTitleFor( 'BibManagerEdit' ),
    wfMessage( 'bm_list_table_edit' ), /*wfMsg( 'bm_list_table_edit' )*/
    array (
      'class' => 'icon edit',
      'title' => wfMessage( 'bm_list_table_edit' ) /*wfMsg( 'bm_list_table_edit' )*/
    ),
    $specialPageQuery
  );
}

if ($wgUser->isAllowed('bibmanagerdelete')){
  $deleteLink = Linker::link(
    SpecialPage::getTitleFor( 'BibManagerDelete' ),
    wfMessage( 'bm_list_table_delete' ),
    array (
      ...
    ),
    $specialPageQuery
  );
}


Fehlendes Icon "Link zum Volltext" bei Detailseite[Bearbeiten]

Auf der Detailseite eines Bibliographieeintrags wird rechts statt des Icons der Alternativtext "Link zum Volltext" bzw. "Fulltext link" angezeigt; es ist folgende Datei anzupassen:

  • "\extensions\SaltWiki\SaltWiki.php"

Nach den Anpassungen ist jeweils eine Kopie der Datei mit dem Suffix "_SW" zu speichern.

Bei "SaltWiki.php" ist in der Funktion "sw_onBibManagerGetIcons(...)" vor Zeile 160 ein Kommentar einzufügen und in Zeile 161 der Pfad von "client" zu "resources" anzupassen:

function sw_onBibManagerGetIcons ( $entry, &$icons) {
 ...
 // für HAWK HHG und MW1.23LTS Pfad von "client" zu "resources" angepasst 2016-06-14
 $icons['fulltext'] = array (
  'src' = $wgScriptPath . '/extensions/BibManager/resources/images/' . $icon,
  ...
 );
 ...
}
In BibManager v1.1.0 Fehler bei SpecialPageAliases[Bearbeiten]

In der Datei "BibManager.alias.php" müssen die Array-Schlüssel von $specialPageAliases wie z. B. 'BibManagerCreate' für die jeweilige Sprache in Kleinbuchstaben angegeben werden, damit die BibManager-Seiten bei den Spezialseiten aufgelistet werden, allerdings werden die Seiten dann nicht mehr gefunden, wenn man auf die Verweise klickt.

Einzige Lösung scheint zu sein, in der Datei "BibManager.php" die Zeile 66 auszukommentieren:

#$wgExtensionMessagesFiles['BibManagerAlias'] = $dir . 'BibManager.alias.php'; // Fehlfunktion in MW 1.23
In BibManager v1.1.0 fehlerhafte Funktionen auskommentieren bzw. ändern[Bearbeiten]

BibManager v1.1.0 (REL1.23) verwendet in mehreren Dateien die Funktion "wfLoadExtensionMessages()", die seit MW 1.21 nicht mehr existiert, so dass die Zeile in folgenden Dateien auskommentiert werden muss:

  • "\specialpages\BibManagerCreate_body.php" in Zeile 7
  • "\specialpages\BibManagerEdit_body.php" in Zeile 7
  • "\specialpages\BibManagerDelete_body.php" in Zeile 7
  • "\specialpages\BibManagerList_body.php" in Zeile 7
  • "\specialpages\BibManagerListAuthors_body.php" in Zeile 7

BibManager v1.1.0 (REL1.23) verwendet in der Datei "\specialpages\BibManagerList_body.php" in den Zeilen 25 und 29 die Methode "SpecialPageFactory::getPage('...')->getDescription()", die einen Fehler "Call to a member function getDescription() on null" verursacht, weil "getPage('...') als Ergebnis NULL hat und "getDescription()" nicht darauf angewendet werden kann. Ursache ist der Name bei "getPage('...')", der mit dem Alias ersetzt werden muss. Der Alias der Sprachvarianten befindet sich in der Datei "\BibManager\BibManager.alias.php". Um den Alias für "getPage('...')" zu erhalten, wird die Methode "SpecialPageFactory::getLocalNameFor('...')" benötigt:

// $linkDescription eingefügt und $createLink angepasst 2015-12-01 G. Werner für HAWK HHG
$linkDescription = array();
if(SpecialPageFactory::getPage(SpecialPageFactory::getLocalNameFor('BibManagerCreate'))===NULL){
  $linkDescription['Create'] = NULL;
}
else{
  $linkDescription['Create'] = SpecialPageFactory::getPage(SpecialPageFactory::getLocalNameFor('BibManagerCreate'))->getDescription();
}
if(SpecialPageFactory::getPage(SpecialPageFactory::getLocalNameFor('BibManagerImport'))===NULL){
  $linkDescription['Import'] = NULL;
}
else{
  $linkDescription['Import'] = SpecialPageFactory::getPage(SpecialPageFactory::getLocalNameFor('BibManagerImport'))->getDescription();
}
$createLink = Linker::link(
  SpecialPage::getTitleFor('BibManagerCreate'),
  /*SpecialPageFactory::getPage('BibManagerCreate')->getDescription()*/
  $linkDescription['Create']
);
$importLink = Linker::link(
  SpecialPage::getTitleFor('BibManagerImport'),
  /*SpecialPageFactory::getPage('BibManagerImport')->getDescription()*/
  $linkDescription['BibManagerImport']
);
In BibManager v1.1.0 Fehler bei neuem Eintrag und Eintragsbearbeitung[Bearbeiten]

Der Fehler bei einem Neueintrag in BibManager v1.1.0 REL1.23 2015-06-16 resultiert aus der Weiterleitung zur Datei für Bearbeitungen "specialpages\BibManagerEdit_body.php".

In der Datei "specialpages\BibManagerCreate_body.php" kann in der Funktion "execute()" das Array "$formDescriptor" zwischen "id" und "options" um die Angabe eines Namens ergänzt werden, damit das Formularfeld "bm_select_type" nicht "wpbm_select_type" heißt:

//Z.26ff
$formDescriptor = array (
  'bm_select_type' => array (
    'class' => 'HTMLSelectField',
    ...
    'id' => '',
    'name' => 'bm_select_type',
    'options' => ...
  )
)

BibManager-Berechtigungen[Bearbeiten]

Rechte-Vergabe für BibManager

In der Datei "LocalSettings.php" werden zwischen "include_once(...)" und dem Array für die Zitierweise folgende Berechtigungen definiert, wobei im deutschen Salzwiki "Redakteur" statt "Editor" anzugeben ist:

## Berechtigungen eingefügt 2012-05-11
$wgGroupPermissions['*']['bibmanagercreate'] = false;
$wgGroupPermissions['*']['bibmanageredit'] = false;
$wgGroupPermissions['*']['bibmanagerdelete'] = false;
$wgGroupPermissions['autor']['bibmanagercreate'] = true;
$wgGroupPermissions['autor']['bibmanageredit'] = true;
#$wgGroupPermissions['autor']['bibmanagerdelete'] = false;
$wgGroupPermissions['Redakteur|Editor']['bibmanagercreate'] = true;
$wgGroupPermissions['Redakteur|Editor']['bibmanageredit'] = true;
$wgGroupPermissions['Redakteur|Editor']['bibmanagerdelete'] = true;
$wgGroupPermissions['sysop']['bibmanagercreate'] = true;
$wgGroupPermissions['sysop']['bibmanageredit'] = true;
$wgGroupPermissions['sysop']['bibmanagerdelete'] = true;

Entfernen der Löschen- und Editier-Buttons ohne Rechte-Vergabe

Das Entfernen der Schaltflächen funktionierte bis April 2012 auf nachfolgend beschriebene Weise, solange es noch kein Rechte-Management für den BibManager gab.

In der Datei BibManager/includes/BibManagerPagerList.php werden in den Zeilen 57ff dazu die Variablen "$editLink" und "$deleteLink" entfernt.

Mit ein wenig PHP-Kenntnissen kann man auch die Anzeige des Links schaltbar machen:

  $tablerow = array ( );

$tablerow[] = ''; $tablerow[] = ' ' . $citationLink . ''; $tablerow[] = ' ' . $format . ''; #$tablerow[] = ' ' . $editLink . $deleteLink . ''; if($_REQUEST['showDelete'] == 1){$tablerow[] = ' ' . $editLink . $deleteLink . '';} else{$tablerow[] = ' ' . $editLink . '';} $tablerow[] = ' ' . $exportLink . ''; $tablerow[] = ''; So würde der Link nur angezeigt werden, wenn in der Url "&showDelete=1" vorkommt. Wenn die Löschen-Funktion vollständig deaktiviert und nicht nur den Link versteckt werden soll, müssen in der Datei BibManager/BibManager.php folgende Zeilen auskommentiert werden: $wgAutoloadClasses['BibManagerDelete'] = $dir . 'specialpages/BibManagerDelete_body.php'; $wgSpecialPages['BibManagerDelete'] = 'BibManagerDelete';

Anleitung anpassen und installieren[Bearbeiten]

Die von halloWelt! gelieferte Datei "manual.xml" enthält alle 4 Anleitungen: Benutzerhandbuch, User manual, Administrationshandbuch und Admin manual, die jeweils durch die <page>-Elemente gegliedert sind.

  • Für das SalzWiki ist nur der <page>-Bereich "BibManager:Benutzerhandbuch" für den Import relevant, so dass eine Kopie der Datei unter "bibmanager_manual_user_de.xml" gespeichert wird und in dieser Datei die 3 anderen <page>-Bereiche entfernt werden.
  • Für das SaltWiki und das Repositorium ist jeweils nur der <page>-Bereich "BibManager:User manual" für den Import relevant, so dass eine Kopie der Datei unter "bibmanager_manual_user_en.xml" gespeichert wird und in dieser Datei die 3 anderen <page>-Bereiche entfernt werden.
  • Der Bilder-Import für das Handbuch findet nur im Repositorium statt.

Anleitung anpassen[Bearbeiten]

Im <title>-Element nach <page> ist jeweils "HalloWelt:" vor "BibManager:..." zu entfernen:

<page>
 <title>HalloWelt:BibManager:...</title>

Ebenso ist der Teil "Project:" vor "BibManager:..." in den Admin-Anleitungen am Ende des <text>-Elementes zu entfernen:

  [[Project:BibManager:...]]
  [[Project:BibManager:...]]</text>
  </revision>
</page>

Anleitung im Wiki installieren[Bearbeiten]

  • Die angepasste xml-Datei über "Spezialseiten->Import" ins Wiki laden.
  • Anschließend sind die Bilder für das Project:BibManager:... im Repositorium mittels DOS-Konsole und PHP hochzuladen, um sie ins Wiki zu bringen:
D:\
xampp\php\php.exe xampp\htdocs\saltwiki\maintenance\importImages.php xampp\htdocs\saltwiki\images_en

CategoryTree[Bearbeiten]

Die Extension dient zur Darstellung der Kategorienbäzme, damit schnell den Artikeln und Dokumenten die richtigen Kategorien zugewiesen werden können.

$wgUseAjax = true; ##muss von false auf true geändert werden, falls noch nicht geschehen
require_once("{$IP}/extensions/CategoryTree/CategoryTree.php"); 

CharacterEscapes, LOParserFunctions, ControlStructureFunctions[Bearbeiten]

Notwendig für #if: und #switch-Anweisungen (z. B. beim Einsetzen des Seitentitels im Kopf von Vorlage:Infobox_Salz und bei den Hilfe-Seiten. "ControlStructureFunctions" soll laut "mediawiki.org" nur bis Version 1.12 erforderlich und danach im Wiki-Code integriert sein, was aber scheinbar nicht zutrifft.
Alternativ zu "LOParserFunctions" und "ControlStructureFunctions" kann möglicherweise auch die Erweiterung "ParserFunctions" (http://www.mediawiki.org/wiki/Help:ParserFunctions) in Kombination mit der Erweiterung "Loop" (http://www.mediawiki.org/wiki/Help:Loop) verwendet werden, wobei Folgendes zu berücksichtigen ist:

Don't These Parser Functions Already Exist?
Yes and no. The ParserFunctions extension has
 #if, #ifeq, #ifexpr, #switch, and #ifexist, 
and Loop Functions extension has
 #for and #foreach. 
The limitation of all those parser functions is 
that wiki markup is parsed before any parameters are passed to the underlying function. 
These functions bypass that limitation through character escapes (see below), 
and allow wiki markup to be parsed after the parameters have been passed.
  • Erweiterungen in Datei "LocalSettings.php" eingefügen.
##Extension CharacterEscapes fuer Helppages
require_once("extensions/CharacterEscapes/CharacterEscapes.php");

##Extension LOParserFunctions  fuer Helppages
require_once( "extensions/LOParserFunctions/LOParserFunctions.php" );

##Extension  ControlStructureFunctions fuer Helppages
# require_once( "extensions/ControlStructureFunctions/ControlStructureFunctions.php" );

CharInsert[Bearbeiten]

Diese Extension dient dazu Editierhilfen zum Einfügen von Spezialzeichen und Formatierungshilfen zur Verfügung zu stellen.Diese Hilfe wird im Bearbeitungsmodus und beim UpLoad-Formular zur Verfügung gestellt. Diese Erweiterung wurde Testweise installiert und dann wieder deaktiviert.

Die Extension wird bei http://www.mediawiki.org/wiki/Extension:CharInsert heruntergeladen und in ...Extensions/CharInsert extrahiert.

In die localsettings ist einzufügen:

require_once("$IP/extensions/CharInsert/CharInsert.php");

In Mediawiki:Edittools werden die entsprechenden Zeichen bzw. Hilfen mit

<charinsert> .. </charinsert> 

eingefügt.

Cite[Bearbeiten]

Die Erweiterung "Cite" dient zum Erstellen von Fußnoten in Wiki-Artikeln.

  • Erweiterung unter http://www.mediawiki.org/wiki/Cite herunterladen.
  • Extrahieren der Dateien nach "\[wikiname]\extensions\Cite\"
  • Erweiterung in der Datei "LocalSettings.php" einfügen
require_once("$IP/extensions/Cite/Cite.php");

Siehe näheres zum Einfügen von Fußnoten unter http://193.175.110.91/salzwiki/index.php/Autor#Fu.C3.9Fnoten.

CiteThisPage[Bearbeiten]

Die Erweiterung "CiteThisPage" dient zum Erstellen von Zitierhilfen für Wiki-Artikel. Sie ist erst ab MW Version 1.24 einsetzbar.

require_once("$IP/extensions/CiteThisPage/CiteThisPage.php");

ConfirmEdit[Bearbeiten]

Registrierte Nutzer dürfen auf die Diskussionseiten schreiben. Damit dies etwas sicherer vonstatten geht, wird mit ConfirmEdit ein Captcha eingeführt (bisher nur bei Salzwiki und Saltwiki, nicht bei Repositorium).

require_once( "$IP/extensions/ConfirmEdit/ConfirmEdit.php" );

ContactPage - Kontaktseite (Wiki-Code de-Formal)[Bearbeiten]

Für Mitteilungen allgemeiner Art wird eine Kontaktformular-Seite eingesetzt, die im Repositorium nur nach Anmeldung zur Verfügung steht. Bei Versand einer Kopie an eine im Formular eingetragene E-Mail-Adresse steht im Betreff: "Kopie Ihrer Nachricht an Hornemann (von [Ihr Name])"

Für das Kontaktformular muss als Empfangsadresse ein bestehendes Wiki-Konto angegeben werden und muss als E-Mail-Absender wegen Authentifizierung beim Versand die Angabe von $wgPasswordSender übernommen werden:

$wgContactConfig['default'] = array(
 'RecipientUser' => 'Hornemann', //'WikiUser' // Must be a valid account //vormals $wgContactUser
 ...
 'SenderEmail' => null, // Defaults to $wgPasswordSender, may be changed as required
...);

Im jeweiligen Wiki-Konto "Hornemann" wird als E-Mail-Adresse "service@salzwiki.de" bzw. "service@saltwiki.net" angegeben. Es kann auch "salzwiki.fb@hawk-hhg.de" bzw. "saltwiki.fb@hawk-hhg.de" angegeben werden.

Für das Formular wird die Erweiterung "ContactPage" benutzt. Die Sie-Form der Wiki-Übersetzungsdatei ist um einen Eintrag zu ergänzen.

Das Absenden des Kontaktformulars wird bei Nutzung ohne Anmeldung zum Verhindern von Spam über ein Captcha abgesichert. Hierfür sind bei der Erweiterung für MW 1.23 (REL1_23) Anpassungen am Code der Dateien "ContactPage_body.php", "\i18n\de.json" und "\i18n\en.json" sowie "\i18n\qqq.json" erforderlich.

  • Dateien unter http://www.mediawiki.org/wiki/Extension:ContactPage bzw. für MW 1.23 unter https://git.wikimedia.org/zip/?r=mediawiki/extensions/ContactPage&h=daa666dec4793a2ce9675dbb8b6c365d105e8986&format=zip herunterladen und die Dateien unter "Extensions/ContactPage" speichern.
  • Für MediaWiki 1.23 in den Übersetzungsdateien "de.json", "en.json" und "qqq.json" Zeilen einfügen (siehe weiter unten)
  • In der Wiki-Systemtexte-Datei vor "'emailccsubject '=> '...'" das Array-Element "'emailccme' => 'Sende eine Kopie der E-Mail an mich'," einfügen und an Sie-Form anpassen: "Eine Kopie der E-Mail an mich senden"
    • Für MediaWiki 1.23 im Verzeichnis "[wikiverzeichnis]\languages\i18n\" aus der Datei "de.json" aus Zeile 1759 in Datei "de-formal.json" in Zeile 217 einfügen
  • Erweiterung mit Variablenzuweisungen in der Datei "LocalSettings.php" einfügen

ACHTUNG: Nach jedem mediawiki-Update muss überprüft werden, ob die vorgenommene Änderung in den Sprachdateien noch existiert. Deshalb ist von den Dateien jeweils eine Kopie "...SW.json" bzw. "...SW.php" zu speichern:

  • MW1.23
    • "[wikiverzeichnis]\languages\i18n\de.json"
    • "...\extensions\ContactPage\i18n\de.json", "...de-formal.json", "...en.json" und "...qqq.json"

MW 1.23 Code-Anpassungen[Bearbeiten]

Zur Code-Anpassung siehe auch https://gerrit.wikimedia.org/r/#/c/156052/

In der Datei "\extensions\ContactPage\i18n\qqq.json" Ergänzung bei "authors" hinter "Shirayuki" sowie in Zeile 25 am Ende ein Komma und darunter eine Zeile für "contactpage-captcha-error" einfügen:

{
  "metadata": {
    "authors": [
      ...
      "Shirayuki",
      "Gunnar Werner HAWK HHG"
    ]
  },
  ...
  "contactpage-usermailererror": "...",
  "contactpage-captcha-error": "Error message displayed when ehter was a CAPTCHA error (i.e. the user failed to enter the correct CAPTCHA, or didn't enter one at all, etc.)"
}

In der Datei "\extensions\ContactPage\i18n\en.json" Ergänzung bei "authors" hinter "Reedy" sowie in Zeile 20 am Ende ein Komma einfügen und darunter eine Zeile für "contactpage-captcha-error" einfügen:

{
  "metadata": {
    "authors": [
      ...
      "Umherirrender",
      "Gunnar Werner HAWK HHG"
    ]
  },
  ...
  "contactpage-usermailererror": "Mail object returned error:",
  "contactpage-captcha-error": "CAPTCHA error"
}

In der Datei "\extensions\ContactPage\i18n\de.json" Ergänzung bei "authors" hinter "Umherirrender", außerdem die Menüleisten-Bezeichnung "Kontaktseite" sowie Captcha-Texte einfügen:

{
  "metadata": {
    "authors": [
      ...
      "Umherirrender",
      "Gunnar Werner HAWK HHG"
    ]
  },
  "contact": "Kontaktseite",
  ...
  "contactpage-captcha": "Um die Nachricht senden zu können, bitte das Captcha lösen ([[Special:Captcha/help|weitere Informationen]])",
  "contactpage-captcha-error": "Captcha-Fehlfunktion",
  "contactpage-captcha-failed": "Captcha-Test nicht bestanden! ([[Special:Captcha/help|weitere Informationen]])"
}

Datei "ContactPage_body.php" vor Zeile 185 und nach Zeile 217+11 (228), vor Zeile 341+11+1 (353), nach Zeile 393+11+1+6 (411):

...
// Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
if ( $this->useCaptcha() ) {
  $formItems['Captcha'] = array(
    'label-message' => 'captcha-label',
    'type' => 'info',
    'default' => $this->getCaptcha(),
    'raw' => true,
  );
}

$form = new HTMLForm( $formItems, $this->getContext(), "contactpage-{$this->formType}" );
...
public function processInput( $formData ) {
  global $wgUserEmailUseReplyTo, $wgPasswordSender;
  global $wgCaptcha; // Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
...
// Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
if ( $this->useCaptcha() && !$wgCaptcha->passCaptcha() ) {
  // TODO proper i18n message
  return wfMessage( 'contactpage-captcha-error' )->plain();
}
// Stolen from Special:EmailUser
$error = '';
...
  private static function getYesOrNoMsg( $value ) {
    return wfMessage( $value ? 'htmlform-yes' : 'htmlform-no' )->inContentLanguage()->text();
  }
  // Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
  /**
  * @return boolean True if CAPTCHA should be used, false otherwise
  */
  private function useCaptcha() {
    global $wgCaptchaClass, $wgCaptchaTriggers;
 
    return $wgCaptchaClass &&
      isset( $wgCaptchaTriggers['contactpage'] ) &&
      $wgCaptchaTriggers['contactpage'] &&
      !$this->getUser()->isAllowed( 'skipcaptcha' );
  }
  // Captcha-Verwendung eingefügt für HAWK HHG 2015-12-07
  /**
  * @return string CAPTCHA form HTML
  */
  private function getCaptcha() {
    // NOTE: make sure we have a session. May be required for CAPTCHAs to work.
    wfSetupSession();
 
    $captcha = ConfirmEditHooks::getInstance();
    $captcha->trigger = 'contactpage';
    $captcha->action = 'contact';
 
    return '<div class="captcha">' .
      $captcha->getForm() .
      "</div>\n";
  }
}

LocalSettings.php[Bearbeiten]

// Version 2.2 für MediaWiki 1.25
#wfLoadExtension("ContactPage.php");
// Version 2.2 für MediaWiki 1.23
require_once( "$IP/extensions/ContactPage/ContactPage.php" );
$wgContactConfig['default'] = array(
  'RecipientUser' => 'Hornemann', //'WikiUser' // Must be the name of a valid account //vormals $wgContactUser
  'SenderName'=> 'Kontaktformular ' . $wgSitename, //"Contact Form " // "Contact Form on" needs to be translated //vormals $wgContactSenderName
  'SenderEmail'=> null // Defaults to $wgPasswordSender, may be changed as required
  'RequireDetails'=> true, // Whether users will be required to supply a name and an email address on Special:Contact
  'IncludeIP'=> false, // Whether the form will include a checkbox offering to put the IP address of the submitter in the subject line
  'AdditonalFields'=> array(
    'Text'=> array(
      'label-message'=> 'E-Mail-Nachricht', //'e-mail-message' //'emailmessage',
      'type'=> 'textarea',
      'rows'=> 20,
      'cols'=> 80,
      'required' => true, //Pflichtfeld
    ),
  ),
  // Added in MW 1.26
  #'DisplayFormat' => 'table', // See HTMLForm documentation for available values.
  #'RLModules' => array(), // Resource loader modules to add to the form display page.
  #'RLStyleModules' => array(), // Resource loader CSS modules to add to the form display page.
);

CreativeCommonsRdf[Bearbeiten]

Die Erweiterung soll ab MW-Version 1.19 die Variable "$wgEnableCreativeCommonsRdf" in der Datei "LocalSettings.php" ersetzen, hat aber noch Beta-Status (2015-09-21). Die 3 Dateien der Erweiterung können heruntergeladen werden bei https://www.mediawiki.org/wiki/Extension:CreativeCommonsRdf

DynamicPageList[Bearbeiten]

Es gibt 3 Erweiterungen mit der Bezeichnung "DynamicPageList", wobei die erste mit dem Alias "Intersection" nicht verwendet wird (siehe auch https://www.mediawiki.org/wiki/Extension:DPL).

MediaWiki 1.23[Bearbeiten]

include("$IP/extensions/DynamicPageList3/DynamicPageList.php");


Inline SVG Extension[Bearbeiten]

Diese Erweiterung wird ab Mediawiki 1.23 nicht mehr verwendet, weil die üblichen Browser inzwischen SVG-Elemente darstellen können.

Die php-Datei "SVGtag.php" sorgt dafür, dass Inline-SVG-Code im Upload-Verzeichnis gespeichert und in einem "iframe" geladen wird. Dies ist erforderlich für ältere Browser, insbesondere für Internet Explorer bis einschließlich Version 8.

require_once("$IP/extensions/SVGtag.php");

Interwiki[Bearbeiten]

Die Erweiterung "Interwiki" ist in Mediawiki seit Version 1.21 enthalten und hieß ehemals "SpecialInterwiki", bevor sie umbenannt wurde.

Diese Erweiterung fügt die Seite Special:Interwiki zu Mediawiki hinzu, um die Interwiki-Tabelle sehen und editieren zu können. Es werden auch alle Änderungen aufgezeichnet. Mit dieser InterWiki Tabelle kann man einerseits einfach zu Inhalten in anderen Wikis verlinken, auch zu Wikipedia, andererseits ist es damit möglich durch das Setzen von $wgEnableScaryTranscluding = true; Inhalte eines anderen Wikis zu "transcludieren".

Die Erweiterung für MW 1.23 wird bei http://www.mediawiki.org/wiki/Extension:Interwiki heruntergeladen und in das Verzeichnis "[wikiname]\extensions\Interwiki" extrahiert.

In der Datei "LocalSettings.php" eines jeden Wikis ist dann einzufügen:

##to allow interwiki-linking, für Version MW 1.23 anderer Dateiname
#require_once("$IP/extensions/Interwiki/SpecialInterwiki.php");
require_once("$IP/extensions/Interwiki/Interwiki.php");
$wgGroupPermissions['*']['interwiki'] = false;
$wgGroupPermissions['sysop']['interwiki'] = true; ## nur sysops können die InterWiki Tabelle ändern und sehen
$wgEnableScaryTranscluding = true;                ## Seiten von anderen Wikis können eingebunden werden

Diese Erweiterung wurde in SalzWiki, SaltWiki und im Repositorium installiert.

Anpassungen für geänderte Server-Adresse[Bearbeiten]

Für die Umstellung der Wikis von IP-Adressen auf Domain-Adressen sind die Datenbank-Einträge der Tabelle "..._interwiki" zu bearbeiten. Hierzu wird unter "Daten und Werkzeuge => Interwikidaten ansehen und bearbeiten" bzw. "Data and Tools => View and edit interwiki data" die entsprechende Spezial-Seite "Spezial:Interwikitabelle" bzw. "Special:Interwiki" aufgerufen.

Anpassungen für HTTPS[Bearbeiten]

Bei InterWikis in der Tabelle, für die sowohl "Als lokales Wiki definiert" als auch "Einbinden zulässig" aktiviert ist, die URL von "http" zu "https" ändern. Beispiel:

wikipedia | https://de.wikipedia.org/wiki/$1 | ja | ja

JavaScript[Bearbeiten]

Entfällt bei MW 1.23.11 LTS und wird ersetzt durch eine Anpassung in der Datei "skins\MonoBook.php".

Die Erweiterung hat den Status "unmaintained" (Stand 2015-09-15); die Version 3.0.8 (2012-02-15) kann wegen einer ungültigen Internetadresse nicht heruntergeladen werden, doch gibt es auf der Internetseite https://www.organicdesign.co.nz/Extension:Javascript den Hinweis, dass die Erweiterung obsolet ist, seitdem MediaWiki den ResourceLoader bereitstellt, siehe https://www.mediawiki.org/wiki/ResourceLoader.

Diese Erweiterung diente zusammen mit der von S. Reher gelieferten Datei "customizeSidebar.js" dazu, den Navigationsbereich "Werkzeuge" in der Sidebar entsprechend dem Anmeldestatus zu manipulieren - siehe hierzu Sidebar anpassen. Dies funktionierte allerdings nur, wenn beim Browser JavaScript aktiviert war.

sichtbare Toolbox-Menüpunkte[Bearbeiten]

  • SalzWiki: alle Gruppen und User
    • Druckversion
  • SaltWiki: alle Gruppen und User
    • Printable version
  • Repository: alle Gruppen und User
    • Printable version

ausgeblendete Toolbox-Menüpunkte[Bearbeiten]

  • SalzWiki: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
    • "Links auf diese Seite" (Special:WhatLinksHere/Main_Page)
    • "Änderungen an verlinkten Seiten" (Spezial:%C3%84nderungen_an_verlinkten_Seiten)
    • "Hochladen" (Special:Upload)
    • "Spezialseiten" (Special:SpecialPages)
    • "Permanenter Link" (Main_page&oldid=921)
    • "Seiteninformationen" ([Seitentitel]&action=info])
  • SaltWiki: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
    • "What links here" (Special:WhatLinksHere/Main_Page)
    • "Related changes" (Special:RecentChangesLinked)
    • "Hochladen" (Special:Upload)
    • "Spezialseiten" (Special:SpecialPages)
    • "Permanent link" (Main_page&oldid=921)
    • "Page information" ([Seitentitel]&action=info])
  • Repository: Nicht-Mitglieder der Gruppen "autor", "Administrators", "forschung"
    • "Links auf diese Seite" (Special:WhatLinksHere/Main_Page)
    • "Änderungen an verlinkten Seiten" (Spezial:%C3%84nderungen_an_verlinkten_Seiten)
    • "Datei Hochladen" (Special:Upload)
    • "Spezialseiten" (Spezial:Spezialseiten)
    • "Permanent link" (Main_page&oldid=9522)
    • "Seiteninformationen" ([Seitentitel]&action=info])

Math (Wiki-Code)[Bearbeiten]

"Math" kann heruntergeladen werden von https://www.mediawiki.org/wiki/Extension:Math/de. Es ist inzwischen eine Erweiterung; bei MW1.16 wurde hingegen die Datei "[wikiname]\includes\Math.php" angepasst.

Die Erweiterung "Math" ist für die Darstellung von Formeln erforderlich und nutzt standardmäßig "texvc" (TeX validator and converter), wobei das mitgelieferte "texvc" nur unter Linux genutzt werden kann und für Windows erst kompiliert werden muss und problembehaftet ist.

Somit scheidet "texvc" unter Windows aus. Stattdessen muss für die Nutzung von GhostScript, ImageMagick und MikTeX wie bei MW1.16 der Wiki-Code angepasst und die Klasse "LatexRender" in der Datei "Math_SW.php" mit Anpassungen als Klasse "MathLatexRender" weiterverwendet werden. Der Quelltext von "LatexRender" für alte MediaWikiVersionen wie MW1.16 steht zur Verfügung bei "https://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Windows/math.php".

Getestet werden kann die Erweiterung "Math" über die Kommandozeile:

D:
cd xampp\htdocs\[wikiname]
D:\xampp\php\php.exe tests\phpunit\phpunit.php extensions\Math\tests\

Zur Installation und Konfiguration von GhostScript, ImageMagick und MikTeX siehe Eingabe_von_Formeln_mittels_Tex_(Wiki-Code)

Symbol im Editor[Bearbeiten]

Bei Verwendung des einfachen Standard-Editors wird diesem automatisch ein Symbol für "Math" mit den entsprechenden Funktionen hinzugefügt.

Bei Verwendung der Erweiterung "WikiEditor" muss die Editor-Erweiterung angepasst werden, um das "Math"-Symbol mit den Bearbeitungsfunktionen nutzen zu können.

Installation "Math"[Bearbeiten]

  • Die heruntergeladene Erweiterung entpacken in das Verzeichnis "extensions\"
  • Die Dateien "Math.php" und "MathRenderer.php" umbenennen in "Math_original.php" und "MathRenderer_original.php"; davon Kopien "Math.php" und "MathRenderer.php" erstellen und die Kopien wie nachfolgend beschrieben anpassen
  • Die Erweiterung in der Datei "LocalSettings.php" einbinden
    require_once "$IP/extensions/Math/Math.php";
  • Existenz der Datenbanktabelle "math" überprüfen, ansonsten erstellen
    • entweder SQL-Befehl für MySQL/MariaDB aus der Datei "\extensions\Math\db\math.sql" mit phpMyAdmin ausführen
    • oder per Kommandozeile eine Aktualisierung ausführen, aber nur wenn die Tabelle noch nicht exisitiert:
      D:\xampp\php\php.exe D:\xampp\htdocs\[wikiname]\maintenance\update.php

ImageMagick und MikTeX für Math statt Texvc[Bearbeiten]

Bei MW1.23 soll zwar "Math" ohne "ImageMagick" verwendet werden (siehe https://www.mediawiki.org/Manual:Running_MediaWiki_on_Windows#ImageMagick), doch funktioniert dies nicht mit "texvc" unter Windows. Deshalb wird in der Datei "LocalSettings.php" weiterhin "ImageMagick" mit "true" aktiviert statt mit "false" deaktiviert und außerdem "Texvc" für die Datei "Math.hooks.php" deaktiviert:

$wgUseImageMagick = true;
#ImageMagick
$wgImageMagickConvertCommand = 'D:\texmf\imagick\convert.exe';
$wgImageMagickIdentifyCommand = 'D:\texmf\imagick\identify.exe';
#TeX
$wgLaTexCommand = 'D:\texmf\miktex\bin\latex.exe';
$wgDvipsCommand = 'D:\texmf\miktex\bin\dvips.exe';
$wgSVGConverter = 'ImageMagick';
$wgSVGConverters = array(
  'ImageMagick' => '"D:\texmf\imagick\convert.exe" -background white $input PNG:$output',
);
require_once "$IP/extensions/Math/Math.php";
$wgMathDisableTexFilter = true; // in Math.hooks.php
Anpassungen "Math.php" und "MathRenderer.php" (Wiki-Code)[Bearbeiten]
  • in der Datei "Math.php" zwischen Z.191 und Z.192 die Klasse "LatexRender" hinzufügen
#$wgAutoloadClasses['MathLatexRender.php'] // für HAWK HHG eingefügt 2016-04-25
  • in der Datei "MathRenderer.php" bei der Funktion "getRenderer(...)" in Z.122f bei "default:"
default: // für HAWK HHG angepasst 2016-04-25
$renderer = new MathLatexRender( $tex, $params ); #$renderer = new MathTexvc( $tex, $params );
  • von den beiden Dateien eine Sicherungskopie "Math_SW.php" und "MathRender_SW.php" vorsorglich für Änderungen durch Wiki-Updates speichern
Anpassungen Klasse "LatexRender"[Bearbeiten]

In der alten Datei "Math.php" bzw. "Math_SW.php" waren 2 Klassen, nämlich die Klasse "MathRenderer" und die Klasse "LatexRender" enthalten, wobei "MathRenderer" im Vergleich zum Original nur rudimentär vorhanden war, um ein Objekt der Klasse, "LatexRender" zu erzeugen.

Aus diesen beiden Klassen wird für MW1.23 die Klasse "MathLatexRender" als Sub-Klasse der Klasse "MathRenderer" aus der Erweiterung "Math.

Anstatt der Klasse "MathRenderer" unterhalb der Klasse "LatexRender" wird nun in der Klasse "LatexRender" die Funktion "renderMath()" durch Umbenennung und Anpassung als Konstruktor-Funktion "__constructor(...)" verwendet, wobei die Konstruktor-Funktion auch die Funktion "LatexRender(...)", die bisher zur Initialisierung als Konstruktor diente, ersetzt.

Hinzu kommt eine neue Funktion "render()", die durch die Definition in der Datei "MathRenderer.php" erforderlich ist.

Zudem werden die Variablen $url und $text als Klassen-Variablen definiert.

Außerdem wird in der Funktion "cleanTemporaryDirectory()" eine Ergänzung vorgenommen, damit vor dem Löschen der Dateien deren Existenz überprüft wird, um Warnungen zu vermeiden.

Zusätzlich werden für neuere PHP-Versionen bei "htmlentities(...)" die Parameter für XHTML und UTF-8 hinzugefügt.

/**
 * LaTeX Rendering Class
 * Copyright (C) 2003  Benjamin Zeiss <zeiss@math.uni-goettingen.de>
 * -----------------------------------------------------------------------
 * Changed to MathLatexRender Class for HAWK HHG by Gunnar Werner (C) 2016
 * to be used with MW 1.23 LTS and extension Math REL-1_23...
 * for Windows with GhostScript+ImageMagick+MikTeX instead of Texvc
 * Notice 1: In file Math.php loading this class has to be added:
 * $wgAutoloadClasses['MathLatexRender'] = $dir . 'MathLatexRender.php';
 * Notice 2: In file MathRenderer.php new default object $renderer has to be changed:
 * $renderer = new MathLatexRender( $tex, $params ); #$renderer = new MathTexvc( $tex, $params );
 * -----------------------------------------------------------------------
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
...
 * @author Benjamin Zeiss <zeiss@math.uni-goettingen.de>
 * => @author Gunnar Werner for HAWK HHG <gunnar.werner@hawk-hhg.de>
 * @version v0.8 => v0.8.2016.05
 * @package latexrender => class MathLatexRender for extension Math
...
*/
...
// "extends MathRenderer" new by changes 2016
class MathLatexRender extends MathRenderer {
  ...
  // new by changes 2016
  var $url = "";
  var $text = "";
  ...
  /* function replaced with function __constructor() below by changes 2016
  function LatexRender($picture_path,$picture_path_httpd,$tmp_dir) {
    ...
  }
  */
  // new constructor combining old function LatexRender()
  // and function renderMath() from old class MathRenderer
  // by changes 2016
  public function __construct ($latex_formula, $params = array() ) {
    global $wgMathDirectory,
           $wgMathPath,
           $wgTmpDirectory,
           $wgLaTexCommand,
           $wgDvipsCommand,
           $wgImageMagickConvertCommand,
           $wgImageMagickIdentifyCommand;

    $latex_formula = '\displaystyle ' . $latex_formula;

    // from old function LatexRender()
    $this->_picture_path = $wgMathDirectory;
    $this->_picture_path_httpd = $wgMathPath;
    $this->_tmp_dir = $wgTmpDirectory;
    $this->_tmp_filename = md5(rand());

    // check Math dir
    if(!file_exists($wgMathDirectory)){@mkdir($wgMathDirectory);}
    if(!file_exists($wgTmpDirectory)){@mkdir($wgTmpDirectory);}

    // Objects $latex and $url replaced with $this by changes 2016
    $this->_latex_path = $wgLaTexCommand;
    $this->_dvips_path = $wgDvipsCommand;
    $this->_convert_path = $wgImageMagickConvertCommand;
    $this->_identify_path = $wgImageMagickIdentifyCommand;

    $this->url = $this->getFormulaURL($latex_formula);

    // htmlentities for newer PHP versions changed 2016
    $alt_latex_formula = htmlentities($latex_formula, ENT_QUOTES|ENT_XHTML, "UTF-8");
    $alt_latex_formula = str_replace("\r", "", $alt_latex_formula);
    $alt_latex_formula = str_replace("\n", "", $alt_latex_formula);
    $alt_latex_formula = str_replace('\displaystyle ', "", $alt_latex_formula);

    if($this->url != false){
      $this->text = '<img src="'.$this->url.'" title="'.$alt_latex_formula.'" alt="'.$alt_latex_formula.'" />';
    }
    else{
      $this->text = '[Unparseable or potentially dangerous latex formula. Error '.$this->_errorcode.' '.$this->_errorextra.']';
    }
  }
  ...
  // new for abstract function in "MathRenderer.php" by changes 2016
  public function render(){
    return $this->text."\n";
  }
  ...
  function renderLatex($latex_formula) {
    ...
    // create temporary dvi file
    ...
    $status_code = exec($command);
    // added checking file by changes 2016
    if (!$status_code || !file_exists($this->_tmp_filename.".dvi")) {
      ...
      $this->_errorcode = 4;
      return false;
    }
    ...
  }
  ...
  function cleanTemporaryDirectory() {
    ...
    // check existence before deleting to prevent warnings added by changes 2016
    /*
    unlink($this->_tmp_dir."/".$this->_tmp_filename.".tex");
    ...
    */
    $file_types = array("tex", "aux", "log", "dvi", "ps", $this->_image_format);
    foreach($file_types as $f_typ){
      $tmp_file = $this->_tmp_dir."/".$this->_tmp_filename.".".$f_typ;
      if(file_exists($tmp_file)){
        unlink($tmp_file);
      }
      $tmp_file = "";
    }

    chdir($current_dir);
  }
}

LaTeXML für Math statt Texvc[Bearbeiten]

Da LaTeXML nur bei einfachen Formeln funktioniert, kommt es nicht als Alternative zu Texvc in Betracht.

In der Datei "readme" gibt es folgende Hinweise:

  • Seit MW1.19 beschränken sich die Rendering-Optionen auf "Always PNG" und "Leave it as TeX".
  • Statt Bildern kann "MathML" mittels "LaTeXML" verwendet werden
    • Für LaTeXML ist "php5-curl" erforderlich; bei Windows ist es im Verzeichnis "\php\ext\" die Datei "php_curl.dll", die als Modul in der Datei "php.ini" eingebunden sein muss
    • In der Datei "LocalSettings.php" wird LaTeXML für die Konvertierung zu MathML verwendet: "$wgMathUseLaTeXML = true;"
    • In der Datei "LocalSettings.php" wird für anonyme Seitenaufrufe angegeben: "$wgDefaultUserOptions['math'] = MW_MATH_LATEXML"
    • Empfohlen wird eine Core-Version von wmf/1.22wmf7 oder neuer

Texvc für Math kompilieren[Bearbeiten]

Für die Kompilierung ist "MinGW" gegenüber "Cygwin" vorzuziehen, weil es unabhängig von den dll-Dateien und deren MS-Lizenzen mit der MSVC-Runtime funktioniert (siehe http://stackoverflow.com/questions/771756/what-is-the-difference-between-cygwin-and-mingw).

Da für "MinGW" keine verwertbare Ausgangsdatei zur Verfügung steht - , "makefile" wird nicht akzeptiert -, müssen "Cygwin" und "OCaml" (Version 4.02.3 32Bit + findlib + batteries) installiert werden (Dauer ca. 20 Min.). "OCaml" kann bei http://caml.inria.fr oder bei http://protz.github.io/ocaml-installer/ heruntergeladen werden.

Cygwin

Während der Installation von "OCaml" in das Verzeichnis "D:\texmf\" wird zusätzlich "Cygwin" im Verzeichnis "C:\cygwin\" installiert, sofern noch nicht vorhanden.

Für die Installation von "Cygwin" muss zum Herunterladen ein Mirror-Server ausgewählt werden, z. B. ftp://ftp.hawo.stw.uni-erlangen.de.

Vor dem Kompilieren müssen Dateien angepasst werden (siehe https://www.mediawiki.org/wiki/Texvc#Windows und https://www.mediawiki.org/wiki/MWWRender.ml):

  • \Math\math\render.ml Z.42 und Z.48 (2 Backslashes statt einem Schrägstrich)
...finalpath^"\\"^md5...
...finalpath^"\\"^md5...

MinGW

"MinGW" (2013-10-26) kann als Installationsmanager, der während der Installation die ausgewählten "Packages" aus dem Internet lädt (Dauer ca. 10 Min.), heruntergeladen werden bei https://sourceforge.net/projects/mingw/files/ (Stand 2016-04-29).

"MinGW" wird als 32Bit-Version im Verzeichnis "C:\MinGW\" installiert und wird nicht in der Systemsteuerung bei den installierten Programmen aufgelistet. Das Programm-Unterverzeichnis "bin\" muss bei der Umgebungsvariablen "Path" hinzugefügt und der Server danach neu gestartet werden.

Im Installationsmanager bei "Basic Setup" "All Packages" alle Packages von "MinGW", aber nicht "MSYS" aktivieren. Danach im Menü "Installation => Apply changes" auswählen.

Kompilieren (siehe auch http://www.mingw.org/wiki/mingw_for_first_time_users_howto):

  • Die DOS-Kommandozeile als Administrator öffnen
  • zum "Math"-Verzeichnis wechseln
  • Befehl zum Kompilieren eingeben
C:\MinGW\bin\gcc makefile -o texvc.exe

Fehlermeldung: "Das Programm kann nicht gestartet werden, da libiconv-2.dll auf dem Computer fehlt."

In "Systemsteuerung => Alle Systemsteuerungselemente => System => Erweiterte Systemeinstellungen => Umgebungsvariablen" bei "Path" am Ende einfügen:

;C:\MinGW\bin\

MwEmbedSupport[Bearbeiten]

Die Erweiterung wird für die Wiedergabe von Videodateien mit der Erweiterung "TimedMediaHandler" benötigt. Sie kann heruntergeladen werden bei https://www.mediawiki.org/wiki/Extension:MwEmbedSupport

OggHandler (JavaScript)[Bearbeiten]

Die Erweiterung wird ab Mediawiki 1.24 nicht mehr unterstützt; empfohlen wird die Erweiterung "TimedMediaHandler", die die Erweiterung "MwEmbedSupport" benötigt und ebenfalls mit JavaScript funktioniert.

Diese Erweiterung dient zum Darstellen von Videodateien in SalzWiki-Artikeln. Da es sich beim OGG-Format um ein freies Format handelt, benötigt man keine Lizenz zum Darstellen der Inhalte. Es ist noch zu klären, ob eventuell das MPEG Format für eine Hochschulanwendung lizenzfrei sein könnte.

Für die Erweiterung sind "PEAR" und "FFmpeg" erforderlich.

  • "PEAR" ist in der PHP-Installation des Servers enthalten.
  • "FFmpeg" ist herunterzuladen von heise.de und wird dann gespeichert unter "D:\ffmpeg-wiki\"

Installation der Erweiterung:

## Repository: OggHanlder oder MwEmbedSupport und TimedMediaHandler
## OggHandler nur bis MW 1.23, danach MwEmbedSupport und TimedMediaHandler
require_once("$IP/extensions/OggHandler/OggHandler.php");
# FFmpeg auskommentiert, solange kostenfreie Lizenz für Hochschule ungeklärt ist
#$wgFFmpegLocation = "D:\ffmpeg-wiki\bin\ffmpeg";

Piwik Integration[Bearbeiten]

Die Erweiterung "Piwik Integration" für die Nutzung der Statistik-Anwendung "Piwik" kann ab den Versionen MW 1.14 und Piwik 0.4 verwendet werden.

  • Dateien unter "extensions\Piwik\" speichern
  • In der Datei "LocalSettings.php" einfügen:
##
## EXTENSIONS
...
require_once( "$IP/extensions/Piwik/Piwik.php" );
$wgPiwikURL = $_SERVER['SERVER_NAME']."/analytics/piwik"; # ohne Protokoll-Angabe und ohne Schrägstrich am Ende!
$wgPiwikIDSite = "1"; # SalzWiki=1, SaltWiki=2, Repository=3

Hinweis: Die Beispielangabe zu "$wgPiwikURL" bei der Internetseite, auf der die Erweiterung angeboten wird, ist nicht korrekt, weil die Erweiterung den Schrägstrich am Ende der Adresse im HTML-Quelltext beim Piwik-JS-Teil hinzufügt:

$wgPiwikURL = "piwik-host.tld/dir/"; # ohne Protokoll-Angabe!

QuestyCaptcha[Bearbeiten]

Für SaltWiki wird zusätzlich zu "ConfirmEdit" als Erweiterung das Captcha "QuestyCaptcha" gegen Spam-Anmeldungen genutzt, da das Standard-Mathe-Captcha nicht ausreichte. Die anderen angebotenen Captchas werden in zukünftigen Mediawiki-Versionen nicht mehr unterstützt oder funktionieren nicht mit allen gängigen Browsern oder funktionieren mit nicht-barrierefreien Bildern und/oder benötigen zusätzliche Installationen auf dem Wiki-Server mit Administrationsrechten, weshalb "QuestyCaptcha" trotz Beta-Status als einzig brauchbare Möglichkeit verwendet werden muss.

  • Dateien "QuestyCaptcha.php", "QuestyCaptcha.class.php" und "QuestyCaptcha.i18n.php" unter http://www.mediawiki.org/wiki/Extension:QuestyCaptcha herunterladen und unter "extensions\ConfirmEdit\" speichern.
  • In der Datei "LocalSettings.php" nach "require_once( "$IP/extensions/ConfirmEdit/ConfirmEdit.php" );" einfügen:
##
## EXTENSIONS
...
require_once( "$IP/extensions/ConfirmEdit/QuestyCaptcha.php" );
$wgCaptchaClass = "QuestyCaptcha";
# Salzwiki
$wgCaptchaQuestions[] = array('question' => 'Welches Wort fehlt: "Eine Frage stellen, eine ... geben"?', 'answer' => '***' );
$wgCaptchaQuestions[] = array('question' => 'Um welche Art von Webseiteninhalt handelt es sich hier: Blog oder Wiki?', 'answer' => '***' );
$wgCaptchaQuestions[] = array('question' => 'Wie lautet der Name dieses Wikis?', 'answer' => $wgSitename );
$wgCaptchaQuestions[] = array('question' => 'Bitte das magische Wort - Salz - hier eingeben:', 'answer' => '***' );
$wgCaptchaQuestions[] = array('question' => 'Bitte das Spezialwort - 8Acht8 - hier eingeben:', 'answer' => '***' );
# Saltwiki
$wgCaptchaQuestions[] = array('question' => 'Which is the language of this question: Dutch, English, French, German or Spanish?', 'answer' => '***' );
$wgCaptchaQuestions[] = array( 'question' => 'Please write the following word backwards: '.$wgSitename, 'answer' => strrev($wgSitename) ); #'ikiwtlaS'
$wgCaptchaQuestions[] = array( 'question' => 'The taste of salt is neither bitter nor sweet nor sourish but …', 'answer' => '***' );
$wgCaptchaQuestions[] = array('question' => 'What is the missing word: "Ask a question, give an …"', 'answer' => ***'');
$wgCaptchaQuestions[] = array('question' => 'What kind of web content is this: Blog or Wiki?', 'answer' => '***');
$wgCaptchaQuestions[] = array( 'question' => 'What is this wiki\'s name (in capital letters)?', 'answer' => strtoupper($wgSitename) ); #'SALTWIKI'
# Repository
$wgCaptchaQuestions[] = array('question' => 'Which is the language of this question: Dutch, English, French, German or Spanish?', 'answer' => '***' );
$wgCaptchaQuestions[] = array( 'question' => 'Please write the following word backwards: '.$wgSitename, 'answer' => strrev($wgSitename) ); #'yrotisopeR'
$wgCaptchaQuestions[] = array( 'question' => 'The taste of salt is neither bitter nor sweet nor sourish but …', 'answer' => '***' );
$wgCaptchaQuestions[] = array('question' => 'What is the missing word: "Ask a question, give an …"', 'answer' => ***'');
$wgCaptchaQuestions[] = array('question' => 'What kind of web content is this: Blog or Wiki?', 'answer' => '***');
$wgCaptchaQuestions[] = array( 'question' => 'What is this wiki\'s name (in capital letters)?', 'answer' => strtoupper($wgSitename) ); #'REPOSITORY'
#$wgCaptchaQuestions[] = array('question' => 'Please write the magic secret, "salt", here:', 'answer' => '***');
#$wgCaptchaQuestions[] = array('question' => 'Type the code word, 8eight8, here:', 'answer' => '***');

## Auslöser für Captcha-Aktivierung
# Salzwiki/Saltwiki
$wgCaptchaTriggers['edit']          = true; 
$wgCaptchaTriggers['create']        = true; 
$wgCaptchaTriggers['addurl']        = true; 
$wgCaptchaTriggers['createaccount'] = true;
$wgCaptchaTriggers['badlogin']      = true;
# Salzwiki/Saltwiki/Repository
$wgCaptchaTriggers['contactpage'] = true;
...
##
## EINSTELLUNGEN
...
## Salzwiki/Saltwiki
#captcha Hschwarz 12.02.2010
$wgGroupPermissions['*'            ]['skipcaptcha'] = false;
$wgGroupPermissions['user'         ]['skipcaptcha'] = false;
$wgGroupPermissions['autor'        ]['skipcaptcha'] = true;
$wgGroupPermissions['autoconfirmed']['skipcaptcha'] = false;
$wgGroupPermissions['bot'          ]['skipcaptcha'] = true; // registered bots
$wgGroupPermissions['sysop'        ]['skipcaptcha'] = true;

SaltWiki (Wiki-Code)[Bearbeiten]

Die Erweiterung "SaltWiki" ergänzt die Erweiterung "BibManager" für Volltexte und DOIs bei den BibTex-Attributen. Da sich in der verwendeten BibManager-Version der Dateipfad für eine Grafik geändert hat, muss der Code dieser Erweiterung angepasst werden.

Von der angepassten Datei "SaltWiki.php" wird eine Kopie mit dem Suffix "_SW" gespeichert.

Versionshinweis[Bearbeiten]

Die Version 2015-05-25 enthält eine Korrektur in der Sprachdatei "SaltWiki.i18n.php", damit bei "de" nicht wie bei "de-formal" die Sie-Form verwendet wird.

Fehler (Wiki-Code)[Bearbeiten]

In der Datei "SaltWiki.php" wird in der Funktion "sw_onBibManagerGetIcons(...)" in Z.161 eine Grafik aus dem Verzeichnis "\extensions\BibManager\client\images\" statt aus dem Verzeichnis "\extensions\BibManager\resources\images\" verwendet, weshalb der Alternativtext der Grafik angezeigt wird.

Z.159ff

// für HAWK HHG und MW1.23LTS Pfad von "client" zu "resources" angepasst 2016-06-14
$icons['fulltext'] = array (
  'src' => $wgScriptPath . '/extensions/BibManager/resources/images/' . $icon,
  ...
);

Veralteter Code[Bearbeiten]

Es wird noch die Funktion "wfMsg()" anstatt von "wfMessage()" in der Datei "SaltWiki.php" verwendet.

SaltWikiUpload[Bearbeiten]

Die Erweiterung "SaltWikiUpload" ergänzt die Erweiterung "BibManager" für das Hochladen von Dateien im Repositorium unter Berücksichtigung von Meta-Daten (Vergleich der Formulareingaben siehe weiter unten)

Versionshinweis[Bearbeiten]

Die Version 2012-01-25 enthält

  • in der Datei "SaltWikiUpload_body.php" ab Z.66 die Variable $aAuthorsLinks und in "foreach..." ab Z.104 Änderungen für $sFieldValue vor "$aText[]..."
  • in der Sprachdatei "SaltWikiUpload.i18n.php" in den Zeilen 53, 105 und 157 ein Zusatzelement "help-various_bibtex"
  • in der Datei "\includes\SaltWikiUpload_Fields.php" das Zusatzelement "help-various_bibtex"
  • in der Datei "\includes\SaltWikiUpload_HTMLDateField.php" Korrekturen zur Darstellung von Monatszahlen kleiner als 10 mit vorangestellter 0

Fehler[Bearbeiten]

  • Das erweiterte Formular wird nicht angezeigt, sondern das MW-Upload-Formular
  • Beim Hochladen mittels MW-Upload-Formular scheitert das Hochladen mit der Fehlermeldung "Es gibt fehlerhaft ausgefüllte Felder", wenn die Erweiterung in der Datei "LocalSettings.php" eingebunden wird.
  • Die Sprachdatei "SaltWikiUpload.i18n.php" enthält bei "de" die Sie-Form wie bei "de-formal".

Veralteter Code[Bearbeiten]

  • Funktion "wfMsg" statt "wfMessage" in den Dateien
    • "SaltWikiUpload_body.php"
    • "\includes\SaltWikiUpload_Fields.php"
    • "\includes\SaltWikiUpload_HTMLDateField.php"

Formularunterschiede[Bearbeiten]

SaltWikiUpload-Formular

  • Metadaten
    • Beschreibung
    • Quelle
    • Datum
    • Autor(en)
    • Berechtigung
    • Schlagwörter
    • Typ
  • Medium
    • Medienart
  • Quelldatei
    • Quelldatei
  • Dateibeschreibung
    • Zielname
    • Weitere Anmerkungen

MW1.23LTS-Upload-Formular

  • Quelldatei
    • Quelldatei
  • Dateibeschreibung
    • Zielname
    • Beschreibung/Quelle
    • Lizenz
  • Hochladeoptionen
    • Diese Datei beobachten
    • Warnungen ignorieren

Quellcode der Version 2012-01-25[Bearbeiten]

Zeile 66ff unter "$aAuthors = explode(...);"

$aAuthorsLinks = array();
foreach( $aAuthors as $sAuthor ){
  ...
  $aCategories[] = '[['.$sPrefixedCatText.']]';
  $aAuthorsLinks[] = '[[:'.$sPrefixedCatText.'|'.$oCategoryTitle->getText().']]';
}

Zeile 104ff vor "$aText[] = ..."

foreach( $aTemplate as $sFieldName => $sFieldValue ) {
  if( in_array( $sFieldName, array('literature_bibtex','grey_literature_bibtex','unpublished_reports_bibtex') ) && !empty($sFieldValue) ){
    $sFieldValue = '<bib id="'.$sFieldValue.'" />';
  }
  if( $sFieldName == 'literature_doi' && !empty($sFieldValue) ){
    $sFieldValue = 'http://dx.doi.org/'.$sFieldValue;
  }
  if( $sFieldName == 'general_author' && !empty($sFieldValue) ){
    $sFieldValue = implode('; ', $aAuthorsLinks);
  }
  
  $aText[] = '|'.$sFieldName.'='.$sFieldValue;
}

Terminology[Bearbeiten]

Diese Erweiterung wird seit 2010-07-29 nicht mehr weiterentwickelt. Sie gilt als ineffizient bei umfangreichen Glossars. Es wird die Erweiterung "Lingo" empfohlen: http://www.mediawiki.org/wiki/Extension:Lingo.

Die Extension dient zum Erstellen eines Glossars.
Um Verwirrungen zu vermeiden wurde bei "Terminology" in der Datei "terminology.php" in den Zeilen 29 und 51 der Name der Wiki-Seite, in der alles gespeichert wird, von "Terminology" in "Glossar" bzw. für SaltWiki in "Glossary" umbenannt (nur in SalzWiki/SaltWiki, nicht im Repositorium):

  • Z. 31
$wgExtensionCredits['parserhook'][] = array(
  'name' => 'Glossar', //in Glossar umbenannt HJSChwarz 12.08.2010
  • Z. 53
$rev = Revision::newFromTitle(Title::makeTitle(null, 'Glossar')); //in Glossar umbenannt HJSChwarz 12.08.2010
require_once("$IP/extensions/terminology.php");


TimedMediaHandler (JavaScript)[Bearbeiten]

Die Erweiterung steht ab Mediawiki 1.17 zur Verfügung und beinhaltet den "Kaltura HTML5 Player" (JavaScript, http://www.html5video.org/kaltura-player/docs). Unterstützt werden Streaming, WebM und Ogg sowie gegebenenfalls getID3.

Die Erweiterung benötigt zusätzlich

  • die Erweiterung "MwEmbedSupport"
  • libwinpthread-1.dll für die Installation der Anwendung "ffmpeg"
  • die Anwendungen
    • "ffmpeg"
    • "ffmpeg2theora"
    • "oggThumb"
  • eventuell auch die Anwendungen
    • "PEAR File_Ogg", wenn nicht in "...\extensions\TimedMediaHandler\handlers\OggHandler\" die Datei "OggHandler.php" und das Verzeichnis "PEAR\" mit dem Unterverzeichnis "File_Ogg\" vorhanden sind
      • "PEAR Package Manager" oder "PEAR Pyras Installer"
      • "PEAR File_Ogg" 0.3.1 Beta 2010-08-27 (Stand 2016-06-21) wie bei Erweiterung "OggHandler" für "oggThumb"-Vorschaubilder
    • "getID3()"

Für Details siehe https://phabricator.wikimedia.org/diffusion/ETMH/browse/master/README.

## Repository: OggHanlder oder MwEmbedSupport und TimedMediaHandler
## OggHandler nur bis MW 1.23, danach MwEmbedSupport und TimedMediaHandler
#require_once("$IP/extensions/OggHandler/OggHandler.php");
# FFmpeg auskommentiert, solange kostenfreie Lizenz für Hochschule ungeklärt ist
#$wgFFmpegLocation = "D:\ffmpeg-wiki\bin\ffmpeg";
## TimedMediaHandler mit MwEmbedSupport statt OggHandler, 2015-09-21 G. Werner
require_once("$IP/extensions/MwEmbedSupport/MwEmbedSupport.php");
require_once("$IP/extensions/TimedMediaHandler/TimedMediaHandler.php");
# FFmpeg auskommentiert, solange kostenfreie Lizenz für Hochschule ungeklärt ist
#$wgFFmpegLocation = "D:\ffmpeg_ogg\ffmpeg\bin\ffmpeg";
$wgFFmpeg2theoraLocation = "D:\ffmpeg_ogg\ffmpeg2theora\ffmpeg2theora";
$wgOggThumbLocation = "D:\ffmpeg_ogg\OggVideoTools\bin\oggThumb";

User Merge - Benutzername löschen[Bearbeiten]

Das Löschen von benutzernamen, die nicht mehr benötigt werden, geschieht durch das Zusammenführen des zu löschenden Benuztzernamens mit dem Benutzername "Testuser" zu "Testuser" mit Hilfe der Extension UserMerge.

require_once( "$IP/extensions/UserMerge/UserMerge.php" );
# Assign the usermerge right to a usergroup, i.e. to the bureaucrats:
$wgGroupPermissions['bureaucrat']['usermerge'] = true;

WhosOnline - Wer ist online[Bearbeiten]

Die Extension WhosOnline dient dazu sich auf einer Specialpage anzeigen zu lassen, wer gerade online ist.

Für MediaWiki 1.23 ist im Herbst 2015 als älteste Version nur eine "REL1_25", also Version 1.4.0 für MW 1.25 erhältlich, die einen Script-Fehler verursacht, wenn in der Datei "WhosOnlineSpecialPage.php" bei der Funktion "getNavigationBar()" die Variable "$title" vom Typ String statt Objekt ist; zur Fehlerbehebung siehe weiter unten und https://www.mediawiki.org/wiki/Extension_talk:WhosOnline#Bug_in_MW_1.24_.3F

Bei MediaWiki 1.25 verursacht die Version 1.5.0 einen Fehler, wenn die Datei "upgrade.php" verwendet wird, weil die Datei "extension.json" in der Erweiterung fehlt; siehe https://www.mediawiki.org/wiki/Extension_talk:WhosOnline#Fatal_error_running_update.php_on_V1.5.0. Es muss deshalb in der Datei "LocalSettings.php" wie bei älteren Versionen "require_once ..." statt "wfLoadExtension(...)" verwendet werden.

  • Dateien unter http://www.mediawiki.org/wiki/Extension:WhosOnline herunterladen und extrahieren
  • Verzeichnis "WhosOnline" unter "Extensions" speichern
  • Für MediaWiki 1.23 in der Datei "WhosOnlineSpecialPage.php" die Funktion "getNavigationBar()" anpassen
  • SQL-Befehl in der Extension-Datei "WhosOnline.sql" für neue Datenbank-Tabelle anpassen (siehe weiter unten)
  • Mit "phpMyAdmin" und geändertem SQL-Befehl eine neue Datenbank-Tabelle erstellen (siehe weiter unten)
  • In der Datei "LocalSettings.php" einfügen:
require_once("$IP/extensions/WhosOnline/WhosOnline.php");
$wgWhosOnlineShowAnons = true;

Datei "WhosOnlineSpecialPage.php" für MW 1.23 anpassen

Die Funktion "getNavigationBar()" ab Zeile 75 kopieren, auskommentieren und die Kopie darunter einfügen. In der Kopie die Variable $wgLang als Ersatz für $wgContLang und die entsprechenden Variablen für die return-Funktion hinzufügen:

function getNavigationBar(){
  global $wgContLang, $wgLang;
  $link = $wgContLang->specialpage('WhosOnline');
  if(is_object($link)){
    $title = $link;
  }
  else{
    $title = Title::newFromText($link);
    if(is_null($title)){
      return false;
    }
  }
  $offset = $this->mOffset;
  $limit = $this->mLimit;
  $query = '';
  $query = wfCgiToArray('');
  $atend = $this->countUsersOnline() < ($this->mLimit + $this->mOffset); // show next link

  return $wgLang->viewPrevNext(
    $title,
    $offset,
    $limit,
    $query,
    $atend
  );
}

Datei "WhosOnline.sql" anpassen

Den SQL-Befehl in der Extension-Datei "WhosOnline.sql" für die neue Datenbank-Tabelle in der ersten Zeile z. B. wie folgt mit Präfix "sw_" bzw. "sr_" anpassen:

CREATE TABLE `[datenbankname]`.`[praefix]online` (

Datenbank-Tabelle erstellen

Mit "phpMyAdmin" die MySQL-Datenbank für das Wiki auswählen und nach Auswahl des Karteikartenreiters/Tabs "SQL" die Tabelle "sw_online" bzw. "sr_online" durch Eingabe des folgenden SQL-Statements anlegen:

CREATE TABLE  `[datenbankname]`.`[praefix]online`  (
	`userid` int(5) NOT NULL default '0',
	`username` varchar(255) NOT NULL default '',
	`timestamp` char(14) NOT NULL default '',
	PRIMARY KEY USING HASH (`userid`, `username`),
	INDEX USING BTREE (`timestamp`)
) TYPE=MEMORY;

WikiEditor (JavaScript)[Bearbeiten]

Achtung: Funktioniert nur bei Browsern mit aktiviertem JavaScript und muss in den nachfolgend genannten Dateien und dem Grafiken-Verzeichnis nach jedem MediaWiki-Update auf Vorhandensein und Änderungen überprüft werden!

Die Erweiterung "WikiEditor" wird seit MW1.18 als Ersatz für den schlichten Editor mitgeliefert.

Um die Erweiterung einzubinden und sie für alle Nutzungskonten verfügbar zu machen, sind in der Datei "LocalSettings.php" in MW1.23 folgende Angaben nötig:

require_once("$IP/extensions/WikiEditor/WikiEditor.php");
$wgDefaultUserOptions['usebetatoolbar'] = 1; // Editor bei allen Nutzungskonten standardmäßig aktivieren
$wgDefaultUserOptions['usebetatoolbar-cgd'] = 1; // Erweiterte Funktionen und Sonderzeichen bei allen Nutzungskonten standardmäßig aktivieren
$wgDefaultUserOptions['wikieditor-preview'] = 1; // Schaltfläche für Vorschau und Änderungen aktivieren
$wgDefaultUserOptions['wikieditor-publish'] = 1; // Schaltfläche für Speichern/Veröffentlichen und Abbrechen aktivieren

Für die Nutzung zusätzlicher Funktionen siehe:

Das Symbol für die Erweiterung "Math", das im Standard-Editor automatisch hinzugefügt wird, fehlt bei der Erweiterung "WikiEditor".

Es gibt 4 Standard-"Sektionen"

  • main für die Standard-Funktionen
  • advanced für die erweiterten Funktionen
  • characters für die Sonderzeichen
  • help

Die "Sektionen" können "Gruppen" für Gruppierungen von Funktionen enthalten.

Die Funktionen sind über Schaltflächen (Text oder Symbol) oder Auswahllisten (Booklets) verfügbar.

Anpassungen[Bearbeiten]

Folgende Dateien sind für zusätzliche Bearbeitungsfunktionen zu bearbeiten:

  • Bilddatei "button-math.png" aus der Erweiterung "Math" kopieren in Verzeichnis "\extensions\WikiEditor\modules\images\toolbar\" und umbenennen in "insert-math.png"
  • Sprach-Dateien im Verzeichnis "\extensions\WikiEditor\i18n\" ergänzen
  • Im Verzeichnis "\extensions\WikiEditor\modules\" folgende Dateien ergänzen
    • jquery.wikiEditor.toolbar.config.js Z.443 vor "redirect"
    • optional: jquery.wikiEditor.dialogs.config.js Z. 17 "remove" und Z.71 "addToToolbar" vor "search"

Beispiel Sprachdatei "de.json" in Z.85 ergänzen:

"wikieditor-toolbar-tool-math": "Formel",
"wikieditor-toolbar-tool-math-insert": "Formel einfügen",

Datei "jquery.wikiEditor.toolbar.config.js" Z.443 vor "redirect" mit den offset-Werten von "redirect" ergänzen und "redirect" auskommentieren:

// neu für HAWK HHG 2017-01-31
'math': {
 'labelMsg': 'wikieditor-toolbar-tool-math',
 'type': 'button',
 'icon': {
  'default': 'insert-math.png',
  'default-rtl': 'insert-math.png'
 },
 'offset': {
  'default': [-70, -142],
  'default-rtl': [-70, -502]
 },
 'action': {
  'type': 'encapsulate',
  'options': {
   'pre': '<math>\n',
   'periMsg': 'wikieditor-toolbar-tool-math-insert',
   'post': '\n</math>',
   'ownline': true
  }
 }
}/*,
'redirect': {
...
}
*/

Datei "jquery.wikiEditor.dialogs.config.js" Z.17 vor ".wikiEditor( 'addToToolbar', {...} )" und Z.71 zwischen "group:insert tools:table" und "group:search" ergänzen:

replaceIcons: function ( $textarea ) {
 ...
 .wikiEditor( 'removeFromToolbar', { section: 'advanced', group: 'insert', tool: 'math' } )
}
...
// neu für HAWK HHG 2017-01-31
.wikiEditor( 'addToToolbar', {
 section: 'advanced',
 group: 'insert',
 tools: {
  'math': {
   labelMsg: 'wikieditor-toolbar-tool-math',
   type: 'button',
   icon: 'insert-math.png',
   offset: [-70, -142],
   action: {
    type: 'dialog',
    module: 'insert-math'
   }
  }
 }
} )

Eingabe von Formeln mittels Tex (Wiki-Code)[Bearbeiten]

Damit mathematische und auch chemische Formeln dargestellt werden können, wird in Mediawiki "Texvc" benutzt. Dies funktioniert nicht unter Windows, sondern nur unter Linux. Siehe hierzu

Deshalb muss zusammen mit der Erweiterung Math (Wiki-Code) die Klasse LatexRender von Benjamin Zeiss in abgewandelter Form als Klasse MathLatexRender verwendet werden und muss folgende Software installiert werden:

  1. Windows Server 2012R2
    1. GPL GhostScript 9.10 (gs910w32.exe, 2013-09-02)
    2. ImageMagick 6.9.3-8-Q16-x86-dll.exe (16Bit dynamic, nicht static)
    3. MikTeX 2.9.5870 Net Installer 32Bit (complete, nicht basic)
  2. Windows Server 2008
    1. GPL GhostScript 8.70 (gs870w32.exe)
    2. ImageMagick 6.5.9-0-Q16-windows-dll.exe (16Bit dynamic, nicht static)
    3. MikTeX 2.8 Net Installer 32Bit (complete, nicht basic)

Nach jedem mediawiki-Update muss die Erweiterung "Math" mit den Dateien "Math.php" und "MathRenderer.php" auf Windows-Kompatibilität überprüft werden!

Die tatsächliche Installation eines Tex-Systems erfolgt in Anlehnung an die alternative Methode auf der Mediawiki Seite http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Windows#Alternative_Solution.

Tatsächliche Installation[Bearbeiten]

Die Applikationen als Administrator für alle User im Verzeichnis "D:\texmf\" installieren:

  1. GhostScript im Unterverzeichnis "ghostscript\" installieren
    1. aus dem Unterverzeichnis "bin\" die Datei "gswin32c.exe" kopieren und die Kopie umbenennen zu "gs.exe"
    2. In der Systemsteuerung unter "Erweiterte Systemeinstellungen => Erweitert => Umgebungsvariablen" die Systemvariable "Path" erweitern mit ";D:\texmf\ghostscript\bin\"
  2. ImageMagick im Unterverzeichnis "imagick\" installieren
    1. ImageMagick dll-Datei (bei vorhandener Windows-Server-Konfigurationsberechtigung), sonst static-Datei (nur XAMPP-Zugriffsberechtigungen), inkl. "Create a desktop icon", "Add application directory to your system path", "Install FFmpeg" und "Install developement headers and libraries for C and C++"
    2. Testen mit der "Eingabeaufforderung/Konsole"
      • bei Windows Server 2012R2 durch Eingabe von
        1. convert wizard: wizard.jpg [=>Enter drücken]
        2. convert wizard.jpg win: [=>Enter drücken]
        3. => ein Bild soll angezeigt werden, Fenstertitel "IMDisplay - wizard.jpg"
      • bei Windows Server 2008 durch Eingabe von
        1. convert logo: logo.miff [=>Enter drücken]
        2. imdisplay logo.miff [=>Enter drücken]
        3. => ein Bild soll angezeigt werden
    3. PHP-Erweiterung für ImageMagick
      • Für PHP 5.6.14 "php_imagick-3.4.1-5.6-ts-vc11-x86.zip" von http://windows.php.net/downloads/pecl/releases/imagick/ oder alternativ die Datei "php_imagick-3.2.0RC1-5.6-ts-vc11-x86.zip" von http://www.peewit.fr/imagick/ herunterladen und die VC11-kompilierte ThreadSafe-Datei Datei "php_imagick.dll" in das PHP-Unterverzeichnis "ext/" kopieren
      • Für PHP 5.6.14 in der Datei "php.ini" im Bereich Windows Extensions die Datei "php_imagick.dll" einbinden:
        extension=php_imagick.dll
      • Für PHP 5.2.9 die VC6-kompilierte Datei "php_imagick_dyn-Q16.dll" von valukova.org herunterladen und in das PHP-Unterverzeichnis "ext/" kopieren und umbenennen zu "php_imagick_dyn_Q16.dll" (Unterstrich statt Bindestrich)
      • Für PHP 5.2.9 in der Datei "php.ini" im Bereich Windows Extensions die Datei "php_imagick_dyn_Q16.dll" einbinden:
        extension=php_imagick_dyn_Q16.dll
  3. MiKTeX Installation
    1. Für Sophos-Ausnahme im Verzeichnis "D:\texmf\" ein Unterverzeichnis "miktex\" erstellen
    2. Für Sophos-Antivirus eine Ausnahme festlegen:
      Konfigurieren => Antivirus => On--Access-Scans => Ausschlüsse => Hinzufügen => Ordner => D:\texmf\miktex\
    3. MikTeX herunterladen – kann bis zu einer Stunde dauern! – und installieren
      1. Zum Herunterladen der Installationsdateien die Datei "MiKTeX_NetInstall_Complete_2.9.5870_setup.exe" ausführen
        • "Download MiKTeX" statt "Install MiKTeX"
        • "Complete MiKTeX" statt "Basic MiKTeX"
        • Zielverzeichnis "D:\Install\MiKTeX_2.9_complete\"
      2. Die Datei "MiKTeX_NetInstall_Complete_2.9.5870_setup.exe" für Installation im Verzeichnis "D:\texfm\miktex\" ausführen mit
        • "Install MiKTeX" statt "Download MiKTeX"
        • "Complete MiKTeX" statt "Basic MiKTeX"
        • "Anyone who uses this computer (all users)" statt "Only for: [Useraccount (Username)]"
        • "Preferred paper: A4", "Install missing packags on-the-fly: Yes"
  4. Die Erweiterung Math (Wiki-Code) installieren und anpassen
  5. In der Datei "LocalSettings.php" ist jeweils einzufügen:
 $wgUseTeX = true;
 # ImageMagick
 $wgImageMagickConvertCommand = 'D:\texmf\imagick\convert.exe'; 
 $wgImageMagickIdentifyCommand = 'D:\texmf\imagick\identify.exe';
 # Tex
 $wgLaTexCommand = 'D:\texmf\miktex\miktex\bin\latex.exe'; 
 $wgDvipsCommand = 'D:\texmf\miktex\miktex\bin\dvips.exe';
 $wgSVGConverter = 'ImageMagick';
 $wgSVGConverters = array(
  'ImageMagick' => '"D:\texmf\imagick\convert.exe" -background white $input PNG:$output', 
 );
 require_once "$IP/extensions/Math/Math.php";
 $wgMathDisableTexFilter = true; // in Math.hooks.php

Alternative Installationsmethode gemäß Mediawiki[Bearbeiten]

  1. install the complete MikTeX (not the basic one, use the network installer) in D:\texfm\miktex - No: Since installing the complete version failed, we installed the basic one with administrator rights at last after installing GhostScript and installing ImageMagick.
  2. install the static (to be sure dependencies are embed) binary of für Windows in D:\texmf\imagick (ensure there are no spaces in the path you choose) - No: We installed the dynamic version wih administrator rights.
  3. install AFPL GhostScript bzw. GhostScript 8.54 bzw. [1] in D:\texmf\ghostscript
  4. oder GPL GhostScript 9.10 (gs910w32.exe) bzw. GhostScript in D:\texmf\ghostscript
  5. copy D:\texfm\ghostscript\gs8.70\bin\gswin32c.exe to D:\texmf\ghostscript\gs8.70\bin\gs.exe (8.70 can be different depending on version you install)
  6. add to the windows PATH environnement variable this path: D:\texmf\ghostscript\gs8.70\bin (again, 8.70 can be different depending on version you install)
  7. If you installed MiKTeX for all users and are running IIS, you may also need to create MiKTeX folders under "C:\Documents and Settings\Default User\Application Data" and "C:\Documents and Settings\Default User\Local Settings\Application Data". Make sure the IIS working process account running PHP (IUSR_[whoever]) has both read and write permissions to these directories!
  8. open a command line (start -> execute -> cmd.exe)
  9. verify that the following commands are working:
    latex
    dvips
    convert (not the microsoft convert)
    gs
  10. [edit] Settings
  • your wiki directory = $

replace the file $/includes/Math.php with code from http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Windows/math.php

  • uncomment or insert in $/LocalSettings.php:
$wgUseTeX= true;
  • insert in $/LocalSettings.php:

- ImageMagick

$wgImageMagickConvertCommand    = 'D:\texmf\imagick\convert.exe';
$wgImageMagickIdentifyCommand   = 'D:\texmf\imagick\identify.exe'; 

- Tex

$wgLaTexCommand                 = 'D:\texmf\miktex\miktex\bin\latex.exe';
$wgDvipsCommand                 = 'D:\texmf\miktex\miktex\bin\dvips.exe';
  • reboot if needed so that paths variables are updated for your services too

Ausblenden der History[Bearbeiten]

Diese Möglichkeit wurde nicht aktiviert.

Wenn nur Admins sowie Mitglieder der Gruppen "autor" und "Redakteur"/"Editor" die Versionsgeschichte einer Seite (History) sehen sollen, ist Folgendes in der Datei "LocalSettings.php" zu ergänzen:

## Bei der angegebenen User-Gruppe wird der Versionen-Button angezeigt. Der Admin sieht diesen immer!
$groupToShowHistory = 'autor';
## Code um die Histroy zu verstecken - sreher 20101105
$wgHooks['SkinTemplateContentActions'][] = 'removeHistory';
function removeHistory( $content_actions ) {
global $wgUser, $groupToShowHistory;
# print_r ($wgUser);
if ( ! (in_array( $groupToShowHistory, $wgUser->mGroups ) or in_array( 'sysop', $wgUser-
>mGroups) ) ) {
#print "drin!";
unset( $content_actions['history'] ); // only this to remove an action
}
return true;
}

Hilfeseiten[Bearbeiten]

Die Dateien, Abbildungen und Vorlagen entsprechend den Anweisungen in "http://www.mediawiki.org/wiki/Project:PD_help/Copying" in ein Verzeichnis exportieren und von dort in das entsprechende Wiki importieren. Die Import- und Export-Funktionen stehen unter "Spezialseiten->Seitenwerkzeuge" bzw. "Special pages->Page tools" zur Verfügung. Aktuelle Dateien vom 16.3.2011 sind unter D:\Dokumente\Hilfe-Dateien auf dem SalzWiki-Server gespeichert.

Bisher werden aus Mediawiki die deutschen Hilfeseiten nicht automatisch mit aufgelistet, weshalb neben den englischen Dateien (MediaWiki-help-en.xml) eine zweite Exportdatei (MediaWiki-Hilfe-de.xml) für die deutschen Dateien erstellt werden muss. Als Dateien wählt man dazu alle aus dem Namensraum "help/de" aus.

Die Abbildungen werden - in Abwandlung der Hinweise - direkt aus Mediawiki im Verzeichnis D:\Dokumente\Hilfe-Dateien gespeichert und von dort im Repositorium über "Spezialseiten->Medien" oder den Menüpunkt "Werkzeuge: Hochladen" hochgeladen. Auf die z. T. unterschiedlichen Lizenzen ist beim Hochladen bei der Eingabe der Metadaten zu achten.

  • Deutsche Version: Soll zuerst auf die deutsche Version verwiesen werden, ist der Hyperlink im Menü links (Sidebar) auf "help:contents/de" zu setzen.
  • Englische Version: Soll zuerst auf die englische Version verwiesen werden, ist der Hyperlink im Menü links (Sidebar) auf "help:Contents" zu setzen.

Die Extension "ParserFunctions" wird benötigt.