====== DokuWiki ======


==== Update von Versionen älter 2015 ====

Auf SLES11 Systemen ist die aktuellste installierbare Version 2017-02-19e "Frusterick Manners" da ab 2018-04-22a "Greebo" mindestens PHP 5.6 benötigt wird.

  * Altes DokuWiki weg-sichern und umbenennen z.B. old_dokuwiki
  * Neues DokuWiki nach /srv/www/htdocs kopieren
  * Hier entpacken
  * Berechtigungen kontrollieren:


  chown -R wwwrun:www dokuwiki/


  * install.php aufrufen und Grundeinstellungen vornehmen.
  * als Admin anmelden LDAPAuth Plugin aktivieren und aktuelle Version des gewünschten Templates herunter laden.
  * In der Konfiguration das Template aktivieren.
  * Abmelden
  * ''/data'' Verzeichnis aus old_dokuwiki in das neue DokuWiki rüber kopieren
  * Für die Seiten und Namensraum Berechtigungen ''dokuwiki/conf/acl.auth.php'' rüber kopieren
  * Berechtigungen kontrollieren:

  chown -R wwwrun:www dokuwiki/

  * wieder Anmelden als Admin
  * Optional Debugging aktivieren in der grafischen Konfiguration
  * aus old_dokuwiki/conf/local.php Einstellungen übernehmen und in die grafischen Konfiguration eintragen
  * Den folgenden Abschnitt in die Konfiguration aufnehmen:

  $conf['superuser'] = 'thomas,ronni,flo';


  * Im Abschnitt Authentifizierung den Authentifizierungsmechanismus auf --> authldap umschalten.
  * Ab hier sollte nun der LDAP-Login funktionieren
  * Nun können noch weitere Plugins in aktueller Version nachinstalliert werden.


==== Neu indizieren ====

Ein PHP Skript zum neu-einlesen der Seiten:
  /srv/www/dokuwiki/bin/indexer.php



==== Debugging ====

Neben der Möglichkeit als Admin unter Konfiguration jeweils ein Häkchen bei Debug zu setzen gibt es noch weitere:

Hänge ein ''?do=check'' an der URL an um zu sehen in welcher Gruppe der eingeloggte Nutzer ist, dazu werden noch weiter Informationen angezeigt.


===== Templates und Plugins =====

Die Manuelle Installation eines neuen Templates oder Plugins  erfolgt durch das verschieben den entpackten Archiv Ordners nach ''/srv/www/dokuwiki/lib/tpl/'' bzw. ''/srv/www/dokuwiki/lib/plugins/''. Hier muss der Ordner entsprechend umbenannt werden. Der Name steht im Plugin Ornder in einer Datei welche den Namen "*"info trägt, z.B. ''/srv/www/dokuwiki/lib/plugins/indexmenu/plugin.info.txt''. Inhalt wäre dann hier: 

  base   indexmenu

Somit wird der Ordner umbenannt in //indexmenu.//

Abgeschlossen wird die Installation durch einen Wechsel auf das Admin WebInterface vom DokuWiki. Erweiterungen verwalten --> Installierte Templates, hier das entsprechende Template aktivieren.