Allgemeines zu den Restrictions

Abb.: der Restrictions-Button

Die sogenannten JPETo™-Restrictions erlauben es, die "Sichtbarkeit" eines Objektes über eine boolsche Gleichung zu steuern.

Damit können einfache Workflows (State-Machine) über das AdminInterface implementiert werden.

Diese Gleichung ist PHP Code, der zur Laufzeit interpretiert wird. Wenn ein Objekt geholt wird, bei dem Restrictions gesetzt wird, wird vor einer weiteren Verarbeitung (und Weiterverfolgung) dieses Objekts geprüft, ob die angegebenen Restrictions dieses erlauben.

Die Farbe des Buttons mit den beiden Paragraphen Zeichen gibt innerhalb des AdminInterfaces über den Zustand Auskunft:

§§ (siehe Abb.): keine Restrictions gesetzt.
§§: Restrictions wurden gesetzt
§§: Restrictions wurden gesetzt und greifen beim aktuellen Zustand des Objekts / beim aktuellen User

Der Restrictions Dialog

Abb.: Restrictions Dialog

Innerhalb des Restrictions-Dialogs kann die oben genannte boolsche Gleichung eingegeben oder über vorbelegte Buttons "zusammengebaut" werden.

Die Dialog-Buttons

• STORE: übergibt die aktuell angegebenen Restrictions an das übergeordnete Admin-Fenster
• CL: löscht die aktuell angegebenen Restrictions
  
  
• USR: setzt die Restriction ($user->j_UserID != ""), d.h. ein angemeldeter User wird vorausgesetzt.
• USR: setzt die Restriction ($user->j_UserID == ""), d.h. das Objekt darf nur von "Gästen" gesehen werden.
  
  
• GRP: setzt die Restriction ($user->isMemberOf("GROUP_NAME")), d.h. ein angemeldeter User, der Mitglied der Gruppe "GROUP_NAME" ist, wird vorausgesetzt.
• GRP: setzt die Restriction (!$user->isMemberOf("GROUP_NAME")), d.h. das Objekt darf nur von Usern, die nicht Mitglied der Gruppe "GROUP_NAME" sind, gesehen werden.
  
  
• AND: macht eine UND-Verknüpfung mehrerer Buttons
• OR: macht eine ODER-Verknüpfung mehrerer Buttons
  
  
• CANCEL: schließt den Dialog, ohne Änderungen durchzuführen

zur Laufzeit hat man innerhalb der Restrictions auf folgende Objekte & Variablen Zugriff:

• $user: der aktuelle User
• $this: das betroffene Objekt
• $_SERVER, $_REQUEST, $_POST, $_GET, $GLOBALS,... alle globalen PHP Variablen

^^ nach oben

Warnung

Mit dem Setzen von Restrictions kann man sich als Admin sehr leicht "selbst aussperren". Diese Sperre kann nur vom Superuser (Level 10) aufgehoben werden, für ihn gelten keinerlei Restrictions.

Ein Syntax-Fehler innerhalb der Restrictions Gleichung bewirkt im einfachsten Fall, dass die Restriction ignoriert wird. Im schlimmsten Fall kann es passieren, dass die Seite, auf der das Objekt liegt, nicht verarbeitet werden kann und sich das Objekt nicht mehr administrieren lässt. Hier hilft nur mehr der Superuser (Object Picker) bzw. ein gezielter "Eingriff" in die Datenbank.

Keine Angst, um Restrictions setzen zu dürfen, ist ein vorgegebener Mindest-Admin Level und dadurch einiges an Erfahrung nötig.

Ungeübten Admins empfehlen wir, sich der vorbelegten Buttons innerhalb der Restrictions-Dialogs zu bedienen.

^^ nach oben

Beispiele

A)
$user->isMemberOf("BLABLABLA")
Dieses Objekt wird nur Mitgliedern der Gruppe BLABLABLA gezeigt

B)
!$user->isMemberOf("BLABLABLA")
Dieses Objekt wird all jenen gezeigt, die nicht Mitglied der Gruppe BLABLABLA sind (also auch Gästen)

C)
$user->j_UserID != ""
Dieses Objekt wird nur eingeloggten Usern gezeigt

D)
$user->j_UserID != "" && !$user->isMemberOf("BLABLABLA")
Dieses Objekt wird nur eingeloggten Usern gezeigt, die nicht Mitglied der Gruppe BLABLABLA sind. Eine und-Verknüpfung von C) und B)

E)
$user->isMemberOf("MIAU") || $user->isMemberOf("WUFF")
Dieses Objekt wird nur Mitgliedern der Gruppe MIAU und/oder Mitgliedern der Gruppe WUFF gezeigt

F)
$user->isMemberOf("MIAU") && $user->isMemberOf("WUFF")
Dieses Objekt wird nur Mitgliedern der Gruppe MIAU und WUFF gezeigt (Mitgliedschaft in beiden Gruppen erforderlich)

G)
strftime("%d%m") == "2902"
Dieses Objekt wird nur an Schalttagen gezeigt...

H)
strftime("%u") > 5
Dieses Objekt wird nur an Wochenenden gezeigt

I)
strftime("%u") <= 5
Dieses Objekt wird nur von Mo-Fr gezeigt

^^ nach oben