WaBis

walter.bislins.ch

Aufbau der Config-Datei

In der Config-Datei werden die Hierarchie und Einstellungen der Wikis einer Site gespeichert. Die Config-Datei sollte in einem von aussen nicht zugreifbaren Verzeichnis abgelegt werden.

Die Config-Datei wird über Erweiterte Wiki-Funktionen verwaltet. Ein User braucht dazu Administrator-Rechte. Die Konfiguration kann über folgenden Link aufgerufen werden:

 Configuration

Die Zugriffsrechte von Usern werden in der User-Datenbank gespeichert.

Genereller Aufbau

Die Config-Datei ist eine reine Text-Datei in einem Format das an XML angelehnt ist. Die Reihenfolge der benannter Tags ist beliebig. Leerzeilen werden ignoriert, ebenso Zeilen mit einem HTML-Kommentar.

Wiki-Daten

<WikiData>
  <Wiki>
    <ID>WikiID</>
    <Name>WikiName</>
    <URL>WikiPath</>               ohne abschliessendem /
    <AspFileName>WikiInstance</>
    <DefaultPage>PageName</>
    <Folder>PageFolder</>          ohne abschliessendem /
    <CacheFolder>CacheFolder</>    ohne abschliessendem /
    <MediaHome>MediaHomePath</>    ohne abschliessendem /
    <MediaIsProteced>bool</>
    <DoList>bool</>
    <ExtendSearch>int</>
    <DefaultPublicRight>AccessLevel</>
    <DefaultRegisteredRight>AccessLevel</>
    <DefaultOwnerRight>AccessLevel</>
    <ScriptExeRight>ScriptRight</>
  </Wiki>
  <Wiki>
    <!-- Weitere Wiki-Daten -->
  </Wiki>
  <Group>
    <!-- Weitere Wiki-Gruppen -->
  </Group>
</WikiData>

<Wiki>
Kennzeichner für einen Wiki-Datenblock
ID
Eindeutige ID für die Wiki-Instanz. Dies muss ein Wort ohne Spezialzeichen und ohne Leerzeichen sein! Dieser Parameter muss zuerst stehen und muss mit der WIKI_ID in der entsprechenden ASP-Datei übereinstimmen!
Name
Name des Wikis, wie er zum Beispiel im Header jeder Seite angezeigt wird. Dies kann ein beliebiger Text sein.
URL
Pfad relativ zum Root-Verzeichnis der Installation (WIKI_ROOT). Muss nicht mit / abgeschlossen werden.
AspFileName
ASP-Dateiname der Wiki-Instanz, z.B. index.asp. Über diese ASP-Datei werden weitere Wiki-Seiten aufgerufen (z.B. index.asp?page=Seitenname).
DefaultPage
Name der Startseite des Wikis.
Folder
Ordner, in welchem die originalen Wiki-Seiten abgelegt werden, relativ zu URL.
CacheFolder (optional)
Ordnername für den Cache dieses Wikis. Default ist ID. Der Ordner wird unterhalb von CACHE_ROOT angelegt.
MediaHome (optional)
Ordnername für das Medien-Verzeichnis des Wikis, relativ zu WIKI_ROOT. Default ist Folder. Es kann auch COMMON_MEDIA_FOLDER angegeben werden, wenn mehrere Wikis dasselbe Medien-Verzeichnis teilen sollen. COMMON_MENDIA_FOLDER muss dann in wiki_app/wikidefaults.inc entsprechend definiert werden.
MediaIsProteced (optional)
Wenn das Medien-Verzeichnis in einem geschützen Verzeichnis liegt, welches von ausserhalb der Website nicht erreichbar ist, muss diese Option true gesetzt werden (Default ist false). Dadurch übernimmt das Wiki unter Passwort-Kontrolle die Übertragung der Medien (Bilder usw.) zum Browser des Users. Unbefugte Zugriffe darauf sind dadurch ausgeschlossen.
DoList (optional)
Steuert, ob das Wiki bei der Suchfunktion unter Suche erweitern auf... oder beim Editieren unter Id's zu anderen Wikis aufgelistet werden soll oder nicht (Standard ist true).
ExtendSearch (optional)
Die Suchfunktion des Wikis sucht standardmässig nur im aktuellen Wiki. Mit ExtendSearch=1 kann das Wiki angewiesen werden, in allen Wikis der übergeordneten Gruppe zu suchen. Der Wert n gibt an, wie weit in der Hierarchie nach oben gegangen werden soll. Je weiter oben, desto mehr Wikis werden in die Suche eingeschlossen.
DefaultPublicRight, DefaultRegisteredRight, DefaultOwnerRight (optional)
Definiert die Zugriffsrechte für die verschiedenen User-Typen auf das Wiki. Diese Rechte gelten für nicht registrierte User (DefaultPublicRight) oder für registrierte User, bei denen in ihrem User-Daten-Block keine expliziten Rechte für dieses Wiki angegeben worden sind. Wenn diese Werte nicht angegeben werden, erbt sie das Wiki von einer übergeordneten Gruppe oder verwendet die globalen Standardeinstellungen DEFAULT_PUBLIC_RIGHT, DEFAULT_REGISTERED_RIGHT, DEFAULT_OWNER_RIGHT.
AccessLevel
eines der folgenden Worte: none, read, disc, new, edit, manage, admin
ScriptExeRight (optional)
Gibt an, ob auf Wiki-Seiten Wiki-Scripts ausgeführt werden dürfen oder nicht. Standard ist none (kein Scripts werden ausgeführt). Wird ScriptExeRight nicht angegeben, wird der Wert einer übergeordneten Gruppe geerbt.
ScriptRight
Einer der folgenden Werte: none, some, all. Bei some wird in der Seite «Spezial:ScriptPages» nachgesehen, in welchen Seiten Scripts ausgeführt werden dürfen.

Group-Daten

<WikiData>
  <Group>
    <ID>GroupID</>
    <Name>GroupName</>
    <DoList>bool</>
    <ShowIDs>IdList</>
    <DefaultPublicRight>AccessLevel</>
    <DefaultRegisteredRight>AccessLevel</>
    <DefaultOwnerRight>AccessLevel</>
    <ScriptExeRight>ScriptRight</>
    <Nodes>
      <!-- Liste von Group- oder Wiki-Daten -->
    </Nodes>
  </Group>
</WikiData>

<Group>
Kennzeichner für einen Group-Datenblock
ID
Eindeutige ID für die Wiki-Gruppe. Dies ist ein Wort ohne Leerzeichen. Dieser Parameter muss zuerst stehen!
Name
Bezeichnung für die Wiki-Gruppe. Dies kann ein beliebiger Text sein.
DoList (optional)
Steuert, ob diese Wiki-Gruppe bei der Suchfunktion unter Suche erweitern auf... oder beim Editieren unter Id's zu anderen Wikis aufgelistet werden soll oder nicht (Standard ist true).
ShowIDs (optional)
Mit dieser Option kann gesteuert werden, welche Wikis beim Editieren unter Id's zu anderen Wikis aufgeführt werden sollen. Es kann eine durch , getrennte Liste von Wiki- oder Gruppen-IDs angegeben werden. In der Regel wird einfach bei der obersten Wiki-Gruppe einer Hierarchie die ID dieser Gruppen selbst eingetragen, um alle IDs der darunter verwalteten Wikis aufzulisten.
DefaultPublicRight, DefaultRegisteredRight, DefaultOwnerRight (optional)
Definiert die Zugriffsrechte für die verschiedenen User-Typen auf die Wikis unterhalb dieser Gruppe. Diese Rechte gelten für nicht registrierte User (DefaultPublicRight) oder für registrierte User, bei denen weder in einem Wiki, noch in ihrem User-Daten-Block explizite Rechte angegeben worden sind. In der Regel gibt man diese Rechte nur in der obersten Wiki-Gruppe einer Hierarchie an, da sie an alle untergeordneten Gruppen und Wikis vererbt werden. Wenn diese Werte nicht angegeben werden, erbt sie die Gruppe von einer übergeordneten Gruppe oder verwendet die globalen Standardeinstellungen DEFAULT_PUBLIC_RIGHT, DEFAULT_REGISTERED_RIGHT, DEFAULT_OWNER_RIGHT.
AccessLevel
eines der folgenden Worte: none, read, disc, new, edit, manage, admin
Wiki- und Gruppen-Daten
Wiki-Daten- oder Group-Daten-Blöcke, die zu dieser Gruppe zusammen geschlossen werden sollen. Gruppen können verschachtelt werden.
<Nodes>
Liste von Unterelementen. Dies können weitere Group-Daten oder Wiki-Daten sein.
Weitere Infos zur Seite
Erzeugt Freitag, 1. Juni 2007
von wabis
Zum Seitenanfang
Geändert Samstag, 18. Juli 2015
von wabis