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

Vtičnik wvdsif omogoča pogojno prikazovanje vsebine glede na uporabniške skupine ali jezik brskalnika. Zagotavlja dva tipa oznak: <ifgroup> za prikaz glede na skupino in <iflang> za prikaz glede na jezik.

• Vsebina glede na dovoljenja - Različna vsebina za goste, uporabnike, administratorje
• Večjezične vstopne strani - Jezikovno specifični pozdravi in vsebina
• Skrbniški razdelki - Skrite povezave vidne samo administratorjem
• Nadomestna vsebina - Privzeta vsebina ko se noben jezik ne ujema
• VIP območja - Ekskluzivna vsebina za določene skupine

<ifgroup imeskupine>Vsebina za to skupino</ifgroup>
<ifgroup skupina1,skupina2>Vsebina za več skupin</ifgroup>

<iflang jezikovnakoda>Vsebina za ta jezik</iflang>
<iflang koda1,koda2>Vsebina za več jezikov</iflang>
<iflang *>Nadomestna vsebina (vedno prikazana)</iflang>

Zahteva: Različen pozdrav za goste in prijavljene uporabnike.

<ifgroup guest>
===== Dobrodošli! =====
Prosimo [[?do=login|prijavite se]] za popoln dostop.
</ifgroup>

<ifgroup user>
===== Dobrodošli nazaj! =====
Imate dostop do vse dokumentacije.
</ifgroup>

Rezultat:

• Neprijavljen: Prikaže poziv k prijavi
• Prijavljen: Prikaže sporočilo dobrodošlice

Zahteva: Skrbniške povezave vidne samo administratorjem.

<ifgroup admin>
===== Administracija =====
  * [[admin:dashboard|Nadzorna plošča]]
  * [[admin:users|Upravljanje uporabnikov]]
  * [[admin:plugins|Upravljanje vtičnikov]]
  * [[admin:config|Konfiguracija]]
</ifgroup>

Rezultat:

• Administrator: Vidi vse skrbniške povezave
• Drugi uporabniki: Blok je neviden

Zahteva: Pozdrav v jeziku brskalnika obiskovalca.

<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 above.
</iflang>

Rezultat:

• Brskalnik nastavljen na nemščino: Prikaže nemški blok
• Brskalnik nastavljen na angleščino: Prikaže angleški blok
• Brskalnik nastavljen na slovenščino: Prikaže slovenski blok
• Drugi jeziki: Prikaže nadomestni blok

Zahteva: Stran 404 v jeziku obiskovalca.

<iflang de>
===== Seite nicht gefunden =====
Die angeforderte Seite existiert nicht.
[[start|Zurück zur Startseite]]
</iflang>

<iflang en>
===== Page Not Found =====
The requested page does not exist.
[[start|Back to homepage]]
</iflang>

<iflang sl>
===== Stran ni najdena =====
Zahtevana stran ne obstaja.
[[start|Nazaj na domačo stran]]
</iflang>

<iflang *>
===== Napaka 404 =====
Stran ni najdena.
[[start|Domov]]
</iflang>

Zahteva: Premium vsebina samo za VIP člane.

<ifgroup vip,premium>
===== Ekskluzivno območje =====
Tukaj najdete premium dokumentacijo in napredne vodiče.
  * [[premium:advanced|Napredne funkcije]]
  * [[premium:tutorials|Ekskluzivni vodiči]]
</ifgroup>

<ifgroup guest,user>
===== Premium območje =====
To območje je rezervirano za VIP člane.
[[kontakt|Zahtevaj nadgradnjo]]
</ifgroup>

Zahteva: Več skupin v stranski vrstici.

~~NOCACHE~~
===== Navigacija =====
  * [[start|Domov]]
  * [[docs:index|Dokumentacija]]

<ifgroup user,admin>
  * [[interno:index|Interno območje]]
</ifgroup>

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

<ifgroup guest>
  * [[?do=login|Prijava]]
</ifgroup>

1. Zaznava oznak
   └── Najde vse <ifgroup>...</ifgroup> in <iflang>...</iflang> oznake

2. Preverjanje pogojev
   ├── ifgroup: Preveri $_SERVER['REMOTE_USER'] in članstvo v skupini
   └── iflang: Preveri glavo Accept-Language

3. Filtriranje vsebine
   ├── Pogoj izpolnjen: Vsebina se prikaže
   └── Pogoj ni izpolnjen: Vsebina se odstrani

4. Obdelava nadomestnega znaka
   └── <iflang *> se preveri zadnji (samo če se noben drug jezik ne ujema)

Jezik se zazna iz HTTP glave Accept-Language:

Accept-Language: de-DE,de;q=0.9,en;q=0.8
                 ^^
                 Primarni jezik: "de"

Vtičnik ne zahteva posebne konfiguracije. Zaznava skupin uporablja standardne DokuWiki ACL skupine.

• vedno uporabljajte ko uporabljate ifgroup/iflang
• Nadomestna možnost z * zagotovite za iflang
• Jasno definirajte skupine v DokuWiki ACL
• Ne gnezdite - oznake ne smejo biti gnezdene ena v drugi

<ifgroup admin>Skrbniška vsebina</ifgroup>
<ifgroup user>Uporabniška vsebina</ifgroup>

<ifgroup admin>
  <ifgroup user>Gnezdena vsebina</ifgroup>
</ifgroup>

• WvdS.DokuWiki.Lang Vticnik - Večjezični prevodi
• Preusmeritev - Večkrat uporabne HTML komponente
• WvdS.DokuWiki.Flat Predloga - Predloga s preklopnikom jezika

Datoteka: lib/plugins/wvdsif/syntax.php