WvdS.DokuWiki.Cond Dodatak

Dodatak: wvdscond
Verzija: 1.0.0
Imenski prostor: lib/plugins/wvdscond/
Autor: Wolfgang van der Stille zeljko.petrusic@outlook.de
Licenca: GPL 2

Dodatak wvdscond kombinira uvjetno prikazivanje sadržaja i serverska preusmjeravanja u jednom dodatku. Pruža:

• Uvjetne oznake - <ifgroup>, <ifnotgroup>, <iflang>
• Preusmjeravanja - redirect_target s podrškom varijabli
• Negacija - <ifgroup !guest> ili <ifnotgroup guest>

• Sadržaj temeljen na dozvolama - Različit sadržaj za goste, korisnike, administratore
• Višejezične početne stranice - Jezično specifična pozdravljanja i sadržaj
• Automatsko jezično preusmjeravanje - Preusmjeravanje na temelju jezika preglednika
• Preusmjeravanja nakon prijave - Preusmjeravanje nakon uspješne prijave
• Uvjetna preusmjeravanja - Preusmjeravanja samo za određene grupe

<ifgroup imegrupe>Sadržaj za ovu grupu</ifgroup>
<ifgroup grupa1,grupa2>Sadržaj za više grupa</ifgroup>
<ifgroup !guest>Sadržaj za NE-goste</ifgroup>

<ifnotgroup guest>Sadržaj za prijavljene korisnike</ifnotgroup>
<ifnotgroup admin>Sadržaj za ne-administratore</ifnotgroup>

<iflang jezicni_kod>Sadržaj za ovaj jezik</iflang>
<iflang kod1,kod2>Sadržaj za više jezika</iflang>
<iflang *>Rezervni sadržaj (uvijek prikazan)</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"}}

Zahtjev: Početna stranica automatski preusmjerava na jezik preglednika.

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

Rezultat:

• Preglednik na njemačkom: Preusmjeravanje na de:start
• Preglednik na engleskom: Preusmjeravanje na en:start
• Preglednik na hrvatskom: Preusmjeravanje na hr:start

Zahtjev: Gosti se preusmjeravaju na javnu stranicu, prijavljeni korisnici ostaju.

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

Rezultat:

• Gost: Preusmjeravanje na pub:start
• Prijavljen: Bez preusmjeravanja

Zahtjev: Ne-VIP korisnici se preusmjeravaju na info stranicu.

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

<ifgroup vip,premium>
===== VIP Područje =====
Dobrodošli u ekskluzivno područje!
</ifgroup>

Zahtjev: Pozdravi na različitim jezicima.

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

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

<iflang hr>
===== Dobrodošli =====
Ovo je naša baza znanja na hrvatskom.
</iflang>

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

Zahtjev: Admin poveznice vidljive samo administratorima.

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

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

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

1. Prepoznavanje uzorka
   └── Pronalazi {{wvds:redirect ...}}

2. Provjera uvjeta (ako postoji)
   ├── ifgroup: Provjerava članstvo u grupi
   └── ifnotgroup: Provjerava NE-članstvo

3. Zamjena varijabli
   ├── {lang} → Jezik preglednika
   ├── {user} → Korisničko ime
   ├── {group} → Prva grupa
   └── {ns} → Trenutni imenski prostor

4. Izvršavanje preusmjeravanja
   ├── HTTP 301/302 zaglavlje (preferirano)
   ├── Meta-Refresh (rezerva)
   └── JavaScript (rezerva)

• Preusmjeravanja koriste wl() za interne URL-ove (sprječavanje otvorenih preusmjeravanja)
• Vanjske URL adrese nisu dozvoljene (zaštita CWE-601)
• Svi izlazi su escaped s hsc() (zaštita od XSS)

Dodatak ne zahtijeva posebnu konfiguraciju. Prepoznavanje grupa koristi standardne DokuWiki ACL grupe.

• WvdS.DokuWiki.i18n Dodatak - Dodatak za prijevode (nasljednik wvdslang)
• WvdS.DokuWiki.Snippet Dodatak - Višekratno upotrebljivi HTML blokovi
• WvdS.DokuWiki.Flat Predložak - Predložak s preklopnikom jezika

Datoteka: lib/plugins/wvdscond/syntax.php

Datoteka: lib/plugins/wvdscond/helper.php