WvdS.DokuWiki.Cond Plugin

Vtičnik: wvdscond
Verzija: 1.0.0
Imenski prostor: lib/plugins/wvdscond/
Avtor: Wolfgang van der Stille zeljko.petrusic@outlook.de
Licenca: GPL 2

Vtičnik wvdscond združuje pogojno prikazovanje vsebine in strežniške preusmeritve v enem vtičniku. Ponuja:

• Pogojne oznake - <ifgroup>, <ifnotgroup>, <iflang>
• Preusmeritve - redirect_target s podporo spremenljivk
• Negacija - <ifgroup !guest> ali <ifnotgroup guest>

• Vsebina na podlagi pravic - Različna vsebina za goste, uporabnike, administratorje
• Večjezične začetne strani - Jezikovno specifična pozdravna sporočila in vsebina
• Samodejna jezikovna preusmeritev - Preusmeritev na podlagi jezika brskalnika
• Preusmeritve po prijavi - Preusmeritev po uspešni prijavi
• Pogojne preusmeritve - Preusmeritve samo za določene skupine

<ifgroup imeskupine>Vsebina za to skupino</ifgroup>
<ifgroup skupina1,skupina2>Vsebina za več skupin</ifgroup>
<ifgroup !guest>Vsebina za NE-goste</ifgroup>

<ifnotgroup guest>Vsebina za prijavljene uporabnike</ifnotgroup>
<ifnotgroup admin>Vsebina za ne-administratorje</ifnotgroup>

<iflang jezikovna_koda>Vsebina za ta jezik</iflang>
<iflang koda1,koda2>Vsebina za več jezikov</iflang>
<iflang *>Privzeta vsebina (vedno prikazana)</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"}}

Zahteva: Začetna stran samodejno preusmeri na jezik brskalnika.

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

Rezultat:

• Brskalnik v nemščini: Preusmeritev na de:start
• Brskalnik v angleščini: Preusmeritev na en:start
• Brskalnik v slovenščini: Preusmeritev na sl:start

Zahteva: Gostje so preusmerjeni na javno stran, prijavljeni uporabniki ostanejo.

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

Rezultat:

• Gost: Preusmeritev na pub:start
• Prijavljen: Brez preusmeritve

Zahteva: Ne-VIP uporabniki so preusmerjeni na informacijsko stran.

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

<ifgroup vip,premium>
===== VIP Območje =====
Dobrodošli v ekskluzivnem območju!
</ifgroup>

Zahteva: Pozdravna sporočila v različnih jezikih.

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

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

<iflang sl>
===== Dobrodošli =====
To je naša baza znanja v slovenščini.
</iflang>

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

Zahteva: Admin povezave so vidne samo administratorjem.

~~NOCACHE~~
===== Navigacija =====
  * [[.:start|Začetna stran]]
  * [[.:docs:index|Dokumentacija]]

<ifnotgroup guest>
  * [[.:intern:index|Interno območje]]
</ifnotgroup>

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

1. Prepoznava vzorca
   └── Najde {{wvds:redirect ...}}

2. Preverjanje pogojev (če obstajajo)
   ├── ifgroup: Preveri članstvo v skupini
   └── ifnotgroup: Preveri NE-članstvo

3. Nadomeščanje spremenljivk
   ├── {lang} → Jezik brskalnika
   ├── {user} → Uporabniško ime
   ├── {group} → Prva skupina
   └── {ns} → Trenutni imenski prostor

4. Izvedba preusmeritve
   ├── HTTP 301/302 glava (prednostno)
   ├── Meta-Refresh (rezerva)
   └── JavaScript (rezerva)

• Preusmeritve uporabljajo wl() za notranje URL-je (preprečevanje odprtih preusmeritev)
• Zunanje URL-je niso dovoljene (zaščita CWE-601)
• Vsi izpisi so escaped z hsc() (zaščita pred XSS)

Vtičnik ne potrebuje posebne konfiguracije. Prepoznavanje skupin uporablja standardne DokuWiki-ACL skupine.

• WvdS.DokuWiki.i18n Plugin - Vtičnik za prevode (naslednik wvdslang)
• WvdS.DokuWiki.Snippet Vticnik - Ponovno uporabni HTML gradniki
• WvdS.DokuWiki.Flat Predloga - Predloga s preklopnikom jezika

Datoteka: lib/plugins/wvdscond/syntax.php

Datoteka: lib/plugins/wvdscond/helper.php