WvdS.DokuWiki.Cond Plugin

Plugin: wvdscond
Version: 1.0.0
Namespace: lib/plugins/wvdscond/
Autor: Wolfgang van der Stille zeljko.petrusic@outlook.de
Lizenz: GPL 2

Das wvdscond Plugin vereint bedingte Inhaltsanzeige und Server-seitige Redirects in einem Plugin. Es bietet:

• Bedingte Tags - <ifgroup>, <ifnotgroup>, <iflang>
• Redirects - redirect_target mit Variablen-Unterstuetzung
• Negation - <ifgroup !guest> oder <ifnotgroup guest>

• Berechtigungsbasierte Inhalte - Verschiedene Inhalte fuer Gaeste, Benutzer, Admins
• Mehrsprachige Startseiten - Sprachspezifische Begruessungen und Inhalte
• Automatische Sprachweiterleitung - Redirect basierend auf Browser-Sprache
• Login-Redirects - Weiterleitung nach Anmeldung
• Bedingte Weiterleitungen - Redirects nur fuer bestimmte Gruppen

<ifgroup gruppenname>Inhalt fuer diese Gruppe</ifgroup>
<ifgroup gruppe1,gruppe2>Inhalt fuer mehrere Gruppen</ifgroup>
<ifgroup !guest>Inhalt fuer NICHT-Gaeste</ifgroup>

<ifnotgroup guest>Inhalt fuer angemeldete Benutzer</ifnotgroup>
<ifnotgroup admin>Inhalt fuer Nicht-Admins</ifnotgroup>

<iflang sprachcode>Inhalt fuer diese Sprache</iflang>
<iflang code1,code2>Inhalt fuer mehrere Sprachen</iflang>
<iflang *>Fallback-Inhalt (immer angezeigt)</iflang>

{{wvds:redirect target="de:start"}}
{{wvds:redirect target="{lang}:start"}}
{{wvds:redirect target="int:home" ifgroup="user"}}
{{wvds:redirect target="{lang}:pub:start" ifnotgroup="user"}}

Anforderung: Startseite leitet automatisch zur Browser-Sprache weiter.

{{wvds:redirect target="{lang}:start"}}

Ergebnis:

• Browser auf Deutsch: Redirect zu de:start
• Browser auf Englisch: Redirect zu en:start
• Browser auf Slowenisch: Redirect zu sl:start

Anforderung: Gaeste werden zu einer oeffentlichen Seite geleitet, angemeldete Benutzer bleiben.

{{wvds:redirect target="pub:start" ifnotgroup="user"}}

Ergebnis:

• Gast: Redirect zu pub:start
• Angemeldet: Kein Redirect

Anforderung: Nicht-VIPs werden zur Info-Seite weitergeleitet.

{{wvds:redirect target="info:upgrade" ifnotgroup="vip,premium"}}

<ifgroup vip,premium>
===== VIP Bereich =====
Willkommen im exklusiven Bereich!
</ifgroup>

Anforderung: Begruessungen in verschiedenen Sprachen.

~~NOCACHE~~
<iflang de>
===== Willkommen =====
Dies ist unsere Wissensdatenbank auf Deutsch.
</iflang>

<iflang en>
===== Welcome =====
This is our knowledge base in English.
</iflang>

<iflang *>
===== Welcome =====
Please select your language.
</iflang>

Anforderung: Admin-Links nur fuer Admins sichtbar.

~~NOCACHE~~
===== Navigation =====
  * [[.:start|Startseite]]
  * [[.:docs:index|Dokumentation]]

<ifnotgroup guest>
  * [[.:intern:index|Interner Bereich]]
</ifnotgroup>

<ifgroup admin>
  * [[.:admin:index|Administration]]
</ifgroup>

1. Pattern-Erkennung
   └── Findet {{wvds:redirect ...}}

2. Bedingungspruefung (falls vorhanden)
   ├── ifgroup: Prueft Gruppenzugehoerigkeit
   └── ifnotgroup: Prueft NICHT-Zugehoerigkeit

3. Variablen-Ersetzung
   ├── {lang} → Browser-Sprache
   ├── {user} → Benutzername
   ├── {group} → Erste Gruppe
   └── {ns} → Aktueller Namespace

4. Redirect-Ausfuehrung
   ├── HTTP 301/302 Header (bevorzugt)
   ├── Meta-Refresh (Fallback)
   └── JavaScript (Fallback)

• Redirects verwenden wl() fuer interne URLs (Open Redirect Prevention)
• Keine externen URLs erlaubt (CWE-601 Schutz)
• Alle Ausgaben werden mit hsc() escaped (XSS-Schutz)

Das Plugin benoetigt keine spezielle Konfiguration. Die Gruppenerkennung nutzt die Standard-DokuWiki-ACL-Gruppen.

• WvdS.DokuWiki.i18n Plugin - Uebersetzungs-Plugin (Nachfolger von wvdslang)
• WvdS.DokuWiki.Snippet Plugin - Wiederverwendbare HTML-Bausteine
• WvdS.DokuWiki.Flat Template - Template mit Sprachwechsler

Datei: lib/plugins/wvdscond/syntax.php

Datei: lib/plugins/wvdscond/helper.php