====== Plugins ======
Diese Erweiterungen für DokuWiki ergänzen dessen allgemeine Funktionalitäten, z. T. sind sie Bestandteil der aktuellen Wiki-Version ''Hogfather'' (Release 51.3 2020-07-29, wir starteten mit ''Greebo'' 50.3 2018-0422c). Die Plugins werden wie auch Templates administrativ installiert und upgedatet => ''Erweiterungen verwalten''. Sie haben alle unter dokuwiki.org eine Quelle, die für weitere informationen genutzt werden kann. Wir beschreiben hier ggf. nur die Eigenschaften, welche für iX-Wiki relevant sind.
Plugins werden in der Regel über die Anmeldung und dann über Admin => Erweiterungen verwalten installliert/aktualisiert. In Einzelfällen, wenn das Plugin zu groß ist wie bei DW2PDF, muss das Plugin manuell heruntergeladen entpackt und in das jeweilige Pluginverzeichnis kopiert werden (A plugin could be manually installed by putting it into its own folder under lib/plugins/. See the detailed plugin installation instructions.). In regelmäßigen Abständen kann in der Verwaltung der Erweiterungen geprüft werden, ob ein installiertes Plugin ein Update anbietet. Features der Plugins können ggf. unter Admin => Konfiguration im Konfigurationsmanager angepasst werden.
Ein Teil dieser Plugins ist DokuWiki-Standard, weitere wurden aus organisatorischen Gründen hinzugefügt. Bei einem geplanten Update (''Igor'', Releasedatum noch offen, Abkündigung von PHP < 7.2, Support von SVG-Grafiken, ...) sollte vorab geprüft werden, ob diese Plugins weiterhin kompatibel mit der neuen Version sind. Zudem können einzelne Plugins gegebenenfalls on the fly upgedatet werden (beachte nachfolgenden Hinweis). Versionsinfos hierzu findet man im admin-Bereich. Mittlerweile wird ''Igor'' im Editmodus beworben, ist aber (Stand 27.06.2022) noch nicht offiziell und weist bis auf den Support von SVG-Grafiken bislang keine für uns relevanten Verbesserungen auf. iX-Wiki Version 20.22.0 wird weiterhin unter angepasster DokuWiki-Version ''Hogfather'' (DokuWiki Release 51.3) betrieben.
Falls Sie ein Plugin manuell installieren (durch Kopieren des Verzeichnisses in das plugin-Verzeichnis) sollten Sie den Cache von DokuWiki bereinigen, damit das neue Plugin korrekt arbeitet. Ohne dies wird es nicht korrekt funktionieren. Zum Löschen des Cache müssen Sie in die Datei /conf/local.php öffnen → irgendein Zeichen ändern → die Änderung zurückstellen (undo) → speichern → und die Datei wieder schließen. Dies zwingt DokuWiki, seinen Cache neu aufzubauen. Diese Vorgehensweise ist wahrscheinlich für die meisten Plugins zutreffend und somit eine generell wichtige Information.
====Plugins im Updateprozess====
Rücksprache mit SMV > notwendige Dateien müssen manuell aktualisiert werden
++++Übersicht aktiver Plugins im iX-Wiki lt. Reihenfolge in Administration|
^Plugin Name und Link zur Anbieterseite\\ aktuelle Plugin-Dokumentation ^DokuWiki bundled^Konfiguration im Admin-Bereich^50.3 Greebo^51.3 Hogfather ^ Info ^
| [[https://dokuwiki.org/plugin:acl|ACL Manager|ja|ja|ja|ja|Management der Zugangskontrollen (access control lists) für einzelne Seite und/oder Namepages.|
| [[https://www.dokuwiki.org/plugin:authpdo|Authpdo]]|ja|ja|ja|ja|This plugin allows to configure your wiki to authenticate against an existing database using PHP's PDO extension. Typical use cases are integrating DokuWiki with a web forum, blog or bug tracker. (Derzeit aktiviert aber nicht in Konfiguration integriert)|
| [[https://www.dokuwiki.org/plugin:authplain|Plain Auth Plugin]]|ja|ja|ja|ja|Provides user authentication against DokuWiki's local password storage. This plugin uses a plain text file ''conf/users.auth.php'' to store user information and passwords. Passwords are stored using one way encryption (aka. hashing). This is the default backend. Solange kein anderes Tool zum Einsatz kommt, dient dieses Plugin per Default der Benutzerverwaltung. |
| [[https://www.dokuwiki.org/plugin:bookcreator|Bookcreator]]|nein|ja|ja|ja| Allow to select some pages and create a book (PDF, ODT or text) nodisp-Plugin wird hiervon nicht unterstützt - dem Autor gemeldet - akzeptable Beeinträchtigung.|
| [[https://www.dokuwiki.org/plugin:config|config]]|ja|ja|ja|ja| Der Konfigurationsmanager selbst... The Config Manager allows wiki administrators to easily alter the wiki configuration settings online from the comfort of their favorite web browser. This plugin manages basic DokuWiki configurations as well as other settings for installed plugins and currently used template. |
| [[https://www.dokuwiki.org/plugin:dw2pdf|Dw2pdf]] |nein|ja|ja|ja| Export DokuWiki content to PDF Eine neuere Version des Plugins ist verfügbar, benötigt jedoch eine neuere PHP-Variante als die von uns eingesetzte!In der verwendeten Version dieses PlugIns werden die nodsip-tags übergangen. D. h., die im Viewer nicht sichtbaren Inhalte von nodisp-Klammern werden ausgedruckt unabhängig von benutzerlaccountlevel! |
| [[https://www.dokuwiki.org/plugin:extension|extension]]|ja|ja|ja|ja|The Extension Manager plugin allows superusers to administer installed plugins and templates and install new ones. |
| [[https://www.dokuwiki.org/plugin:folded|Folded]]|nein|ja|ja|ja| Foldable page sections, Steuerung über Klammern mit mehrfachen Pluszeichen (einmal mit, einmal ohne Pipe-Zeichen. Vierfache Pluszeichen => abschnittsweise, zweifache Pluszeichen => inline). Mit Hilfe von wrap-Klammern oder Includes können auch Abschnitte innerhalb von eingeklappten Abschnitten zusätzlich eingeklappt dargestellt werden (nested). \\ Beim Öffnen eines Abschnitts erhält man im edit-Modus eine leere Seite, wenn nested WRAP-Klammern auf includeten Seiten stehen und man von der übergeordneten Startseite ausgehend einen betroffenen Abschnitt editieren will. Hier muss man zum Bearbeiten auf der includeten Seite selbst stehen (vgl. nachfolgenden Tipp zum Wrap-Plugin). |
| [[https://www.dokuwiki.org/plugin:include|Include]]|nein|ja|ja|ja| Include another wiki page into the current one. Leistungsstarkes Plugin, mit dem wir Seiten oder Seitenabschnitte an anderer Stelle einbinden können. (Singelesource-Quelldatenbearbeitung wird so möglich) In den meisten Fällen ist eine Bearbeitung der Inhalte von eingebundenen Abschnitten auch über die Startseite selbst möglich. Bei mehrfach verschachtelten WRAP-Klammern ist die Bearbeitung nur auf der originalen Seite möglich. |
| [[https://www.dokuwiki.org/plugin:indexmenu|Indexmenu]]|nein|ja|ja|nein \\ :!:\\ ja| Dieses flexible Plugin liefert einen sortierbaren Menübaum mit Einklappungen und ohne Umbruch (stattdessen kann horizontal gescrollt werden). Es kann auf Namespace-Ebene durch Positionierung in der Sidebar versionsspezifische Menüs liefern, da pro Programmversion ein eigener Namespace gepflegt werden muss. Das Layout ist anpassbar (JavaScript). Durch interne Nummerierung ist eine Reihenfolge von Seiten unabhängig des Seitennamens (i. d. R. die erste Überschrift) möglich.\\ :!: If you use the Indexmenu's option 'js' in the Hogfather release (June 2020), you have to disable the defer_js feature flag. The indexmenu plugin does not support deferred javascript loading at the moment. Help with rewriting the javascript code is very welcome! Wir nutzen Indexmenu aufgrund der optimalen Integration und Umsetzung unseres CI für die Sidebar- trotz der js-Einschränkung klappt es in Release 51.3. Problematik für skip_index und skip-file gelöst. Ggf. muss Parameter komplett gelöscht, gespeichert und dann erst wieder konfiguriert werden. |
| [[https://www.dokuwiki.org/plugin:info|info]]|ja|ja|ja|ja| The plugin serves as simple sample syntax plugin and is included in the DokuWiki distribution. It is able to display some information about DokuWiki's internals, for example a list of installed and enabled plugins. |
| [[https://www.dokuwiki.org/plugin:move|Move]]|nein|ja|ja|nein| Das Move-Plugin unterstützt den Redakteur beim Umbenennen und Verschieben von Seiten unter Beibehaltung vorhandener Hyperlinks. Auch Namespaces können hiermit umbenannt werden. Was das Plugin nicht leistet: Sind Namespaces in Parameteranweisungen anderer Plugins enthalten, werden diese (entgegen der Links) NICHT aktualisiert. Solche Parameter müssen anderweitig angepasst werden, z. B. Definitionen für Namespaces in indexmenu oder navi (controlpage). Teilweise in Useroberfläche, teilweise im Adminbereich. Im Adminbereich spielt es seine besonderen Stärken aus. |
| [[https://www.dokuwiki.org/plugin:navi|Navigation Plugin]]|ja|ja|ja|ja|Von Namespaces unabhängige Navigation auf Basis einer unsortierten Linkliste. Kein Link in Liste – keine Nennung im Navigationsmenü. Alles andere auf der sogenannten Controlpage bleibt somit verborgen und kann als Kommentartext oder als Vorbereitung für zukünftige Menüstrukturen genutzt werden. Vom DokuWiki Autor selbst. Kann im Zweifelsfall oder Einzelfall das Plugin indexmenu ersetzen - leider ohne die dort integrierte CI-Unterstützung. Look & feel entspricht eher einer einfachen Linkliste und kann nur zwei Ebenen! (Für Not- oder Sonderfälle)|
| [[https://www.dokuwiki.org/plugin:nodisp|nodisp]]|nein|nein|ja|ja| Dieses Plugin erlaubt, entsprechend getagten Text für bestimmte Benutzer anhand ihrer Rechte (ACL) auszublenden. Der Textabschnitt wird für diese Benutzer dann gar nicht generiert. \\ Beispiel: FIXME => FIXME ist nur für Benutzer mit Schreibrechten sichtbar/auffindbar. In Tabellen muss zur korrekten Ausführung von nodisp die Anweisung innerhalb eines -Tags stehen! Wir nutzen derzeitzum Einschränken 2 als ACL-Level. Eine neue Funktionalität ist eine Inlinevariante, die tags werden dann mit geschweiften Klammern statt mit spitzen Klammern geschrieben. s. Doku zum Plugin.|
| [[https://www.dokuwiki.org/plugin:orphanswanted|Orphanswanted]]|nein|ja|ja|ja|Find Orphan pages, Wanted pages with reference counts. Also shows reference counts for linked pages (previous authors: Doug Edmunds)|
| [[https://www.dokuwiki.org/plugin:popularity|popularity]]|ja|ja|ja|ja| Send anonymous data about your wiki to the DokuWiki developers (bundled with DokuWiki) |
| [[https://www.dokuwiki.org/plugin:revert|revert]]|ja|ja|ja|ja| Allows you to mass revert recent edits (bundled with DokuWiki) |
| [[https://www.dokuwiki.org/plugin:safefnrecode|safefnrecode]]|ja|nein|ja|ja| Upgrade utility for safe filename encoding |
| [[https://www.dokuwiki.org/plugin:searchindex |Searchindex manager]]|ja|ja|ja|ja| This admin plugin allows you to rebuild the index used by the fulltext search. This isn’t needed generally as the index builds and updates itself while users browse your wiki. However if you just upgraded, added or removed a lot of files it may be a good idea to cleanup the index. (komplette Neuindexierung von 800 Seiten dauert im iX-Wiki ca. 30 Minuten)|
| [[https://www.dokuwiki.org/plugin:styling|styling]] |ja|ja|ja|ja| Preview and change the appearance of any template (which supports the style.ini functionality) via the admin interface |
| [[https://www.dokuwiki.org/plugin:upgrade|DokuWiki Upgrade Plugin]] |ja|ja|:?:|ja| Update your DokuWiki with a few clicks from the admin interface. |
| [[https://www.dokuwiki.org/plugin:usermanager|usermanager]]|ja|ja|ja|ja| Manage registered users (bundled with DokuWiki) |
| [[https://www.dokuwiki.org/plugin:wrap|Wrap]]|ja|ja|:!:|ja|
Universal plugin which combines the functionality of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction. Auch gut für [[#sprungmarkentechnik]]! \\ Für die Meldungen mit ''important'' und ''tip'' haben wir abweichend vom Standard des Plugins eigene Farben für bestimmte Hintergründe definiert. Diese werden in der Datei ''style.less'' im Pfad ''\lib\plugins\wrap'' definiert. Hier wird u. a. die background-color definiert, welche wir für unsere CI angepasst haben: **important** und **tip** (diese haben bei uns ''background-color: #ffffe0'') sowie **info** mit ''background-color: #ffffff'' (wrap info werden wir aber praktisch nicht einsetzen). \\ Wird der wrap-Tag in Kapitälchen geschrieben, erhält man einen Absatz mit einer großen Marginalie. Wird der wrap-Tag klein geschrieben, wird die Info inline innerhalb eines Absatzes eingebunden. Meist verwenden wir die inline-Variante. Durch die ergänzende Formatanweisung ''center'' wird auch in der inline-Variante das Symbol vor dem Text als Marginalie positioniert. Es wird also eine neue Zeile genutzt und diese komplett eingefärbt. Beispiel wrap tip inline ohne center. Dies ist besonders für kurze Infos gegeignet. Bei einem Zeilenumbruch sind diese typografisch nicht so prägnant, da der Infotext im Textfluss der Marginalie dann nicht mehr eindeutig zugeordnet zu sein scheint (die Marginalie wird nur der ersten Zeile vorangestellt, es findet keine Einrückung statt). Im Gegegensatz hierzu ein Beispiel mit center-Anweisung: Eine Definition mit ''wrap center ...'' ergibt ebenfalls eine inline-Darstellung, diese aber mit Marginalie zentriert vor dem farblich hervorgehobenen Inhalt. Dies ist insbesondere bei mehrzeiligen Hinweisen typografisch die bessere Lösung, da das Symbol und der Infotext eine optische Einheit bilden. Der Infotext inkl. Marginalie werden nach einem automatischen Zeilenumbruch positioniert, stehen aber weiterhin innerhalb ihres Absatzes. Die zusätzliche Formatanweisung ''round'' oder eine Prozentangabe machen nur in den großen WRAP-Tags Sinn. Die Anweisung ''round'' für runde Ecken wird zudem nur browserspezifisch ausgewertet. Wenn der Browser das schafft (hier: center round tip 80%), bekommt der Anwender eine Box mit abgerundeten Ecken und prozentual in der Breite begrenzt. Innerhalb von Tabellen muss die Zelle, in welcher derartige Absatz-WRAP-Tags verwendet werden, mit einem zusätzlichen WRAP-Tag begonnen und entsprechend mit /WRAP-Tag geschlossen werden (übergeordnete WRAP-Klammer). Dann sind dort neben WRAP-Tags aber auch Zeilenumbrüche mit Enter und Listen möglich. Vergisst man die übergeordnete WRAP-Klammer zu setzen, bricht dann das Layout der Tabelle an dieser Zelle ab! Ein vielleicht ungewollter Nebeneffekt in Form eines größeren Abstands zum unteren Rahmen der Zelle ist beim Einsatz einer großen WRAP-Klammer in Tabellen dann in Kauf zu nehmen.\\ Seiten, die über include zusammengesetzt sind und mit verschachtelten WRAP-Klammern arbeiten (z. B. für verschachtelte folded-Einklappungen) können nicht von der start-Seite im Browsereditor bearbeitet werden. Beim Öffnen eines Abschnitts erhält man im edit-Modus dann eine leere Seite. Hier muss man zum Bearbeiten auf der includeten Seite stehen, also meist im gleichen Namespace z. B. auf der Seite parameter statt der Seite start. Das erkennt man oft erst beim Versuch des Editierens. In dem Fall mit dem Schalter ''Abbrechen'' zurückgehen -> Die Adresszeile im Browser zeigt dann schon den korrekten Aufruf für den Abschnitt, jedoch die Seite ''start''. Hier dann einfach die erforderliche Seite, also z. B. anstelle ''start'' die Unterseite ''parameter'' angeben und bestätigen. Dann wieder in den edit-Modus wechseln -> voilà :-D. |
:!: möglicherweise kompatibel
:?: Kompatibilität unbekannt
Weitere Plugins
^ Plugin ^ DokuWiki bundled ^ Einsatz im Konfigurations-Manager-Bereich ^ 50.3 Greebo ^ 51.3 Hogfather ^ Info ^
| [[https://www.dokuwiki.org/plugin:authad |Active Directory Auth Plugin]]|ja|ja|ja|ja|Provides authentication against a Microsoft Active Directory. Status: inaktiv.|
| [[https://www.dokuwiki.org/plugin:authldap |LDAP Auth Plugin]]|ja|ja|ja|ja|This plugin allows authentication against an LDAP directory using the ACL feature.Status: inaktiv|
| [[https://www.dokuwiki.org/plugin:authmysql |MySQL Authentication Plugin]]|ja|ja|ja|ja| :!: The authMySQL plugin is deprecated. Please use its replacement: the authPDO plugin. Status: inaktiv|
| [[https://www.dokuwiki.org/plugin:authpgsql|PostgreSQL Authentication Plugin]] |ja|ja|ja|ja|This backend uses a PostgreSQL Database to store user data and passwords. bundled with Dokuwiki. Status inaktiv.|
| [[https://www.dokuwiki.org/plugin:sectiontoggle|Sectiontoggle]] |nein|ja|ja|ja|Toggle sections open and closed by clicking on section headers; change templates where needed for phones and tablets. This plugin converts DokuWiki headers into toggles which open and close the sections immediately below them. Optische Umsetzung fanden wir bislang nicht so gut wie die alternative Lösung mittels folded-Plugin. Letzteres bietet auch inline-wrapping und ist optisch attraktiver umgesetzt. Status: nicht aktiv.|
++++
++++Installierbare Plugins|
Potentiell für unser iX-Wiki interessante Plugins
* ''catlist'' [[https://www.dokuwiki.org/plugin:catlist]] listet Seiten und Namensräume rekursiv als mehrstufige Liste auf. Sie können Seiten, Namensräume und deren Elemente mit regex ausschließen. Es gibt mehrere Möglichkeiten, Überschriften und Links zu personalisieren. Elemente können sortiert und in Spalten abgelegt werden. Neue Seiten können schnell in einem bestimmten Namensraum mit den Schaltflächen Seite hinzufügen... erstellt werden. Stark ist die steuerbare Spaltenfunktion. Zu prüfen ist, ob diese Funktionalität von Kunden benötigt wird, ggf. ist catlist auch nur als Interimstool für die redaktionelle Erstellung sinnvoll zur Kontrolle und Ergänzung von fehlenden Seiten. Die Demoseite http://wiki.xif.fr/ hinterlässt jedoch einen schalen Beigeschmack. Ich hoffe wir können es besser :-/)
* ''Color'' [[https://www.dokuwiki.org/plugin:color]] obsoletes? Plugin zum Setzen von erweiterten Textfarben. Z. B. %%text%% oder %%text%% oder %%text%% oder %%text%%. Unterstützt X11 color names. Ggf. Überschneidung mit Funktionalität aus wrap-Plugin!
* ''hidden header'' [[https://www.dokuwiki.org/plugin:hiddenheader]] weitere Sprungmarken ggf. für kontextsensitive Ansteuerung interessant, Interaktion mit ''sectiontoggle'' möglich - sollte aber auch mit Wrap schon gehen [[#Querverweise]]
* ''save and edit'' [[https://www.dokuwiki.org/plugin:saveandedit]] Speichern und weitereditieren - ein smartes Feature für längere Bearbeitungen. Die aktuelle Erinnerung reicht m. E. aber auch... so derart lange wollen wir Seiten gar nicht ohne zu Speichern bearbeiten, als dass das Feature zeitrelevant wäre.
* ''Section Toggle'': [[playground:sectiontoggle|spezielle Section Test- und Infoseite]] \\ Ich hatte hier das PlugIn ''Section Toggle'' aktiviert und zwar für den Namespace **playground**. Damit waren im Playground alle Überschriften bis h4 für diese interaktive Einklappung aktiv. Das Ergebnis war typografisch wie auch organisatorisch nicht überzeugend. Daher habe ich das Plugin wieder deaktiviert.
++++