February 8, 2012, Wednesday, 38

Menuestruktur

Help:

Aus Webcoachwiki

Wechseln zu: Navigation, Suche
Technische Dokumentation
Administrator - Handbuch

Inhaltsverzeichnis

Sidebar

  • MediaWiki:Sidebar hier ist das Standardmenue abgelegt.
  • MediaWiki:NavTree hier können zusätzliche Menues, beispielsweise der Kategorie oder auch Boxen mit den letzten Änderungen in die Navigation eingebunden werden.

KategorieTree

Der KategorieTree zeigt alle Seiten zu einer Kategorie in einer Treedarstellung an. Jede Unterkategorie wird als Zweig im Tree ausgebildet und kann für sich wieder auf- und zugeklappt werden.

Der Aufruf erfolg nach folgendem Schema:

{{#categorytree:"Kategorie"|mode=all}}

Wobei "Kategorie" jene Kategorie ist, die den Ausgangspunkt des Trees bilden soll. Parameter:

  • mode=all bedeutet, dass alle Seiten gezeigt werden (ohne diesen Parameter werden nur die Kategorien gezeigt)
  • hideroot bedeutet, dass die Wurzel nicht gezeigt wird. Hilfreich für die Verwendung in der Navigation

Dieser Kategorietree ist sehr hilfreich für dynamsiche Menues, da zur Aufnahme einer Seite in das Menue die Zuordnung zur Kategorie ausreicht. Um auf der Seite selbst auch gleich alle Seiten der selben Kategorie darstellen zu können haben wir eine entsprechende Vorlage eingerichtet die entweder direkt als Kopiervorlage verwendet werden kann. Siehe nächster Abschnitt.

Webcoach-Best Practice

Zugriff auf Administrationsseiten

Um schnell auf die Administrationsseiten zugreifen zu können und eine Vorlage für Submenues zu haben, haben wir die Vorlage:Administration eingerichtet die mit dem KategorieTree arbeitet und der eine Kategorie als Parameter übergeben werden kann.

{{Administration|Bereich="Kategorie"}}

Der Parameter bewirkt einerseits, dass die Kategorie der Seite, in die die Vorlage eingebunden wird zugeordnet wird, ohne dass die Vorlage selbst der Kategorie zugeordnet ist und dass die Vorlage jenen Teil des KategorieTrees anzeigt, die mit der übergebenen Kategorie beginnt.

Die Vorlage Administration hat in der Überschrift einen Link auf "Webcoachwiki:Administration" und muß daher, wenn Sie für andere Zwecke verwendet werden soll kopiert werden.

Die Vorlage verwendet außerdem eine spezielle Formatierung, die in MediaWiki:Gumax.css "treebox" definiert ist. Damit die Vorlage richtig angezeigt wird, muß es diese Definition geben. Das Design, insbesondere die Farben können an dieser Stelle verändert werden.

Der KategorieTree wird üblicherweise in einer rechts ausgerichtet Box angezeigt, die vom Text umflossen wird. Wenn dies auf einzelnen Seiten nicht gewünscht wird, sollte der Aufruf in eine Tabelle eingebunden werden.

{|width=100%
|-
|{{Administration|Bereich="Kategorie"}}
|}

Dies kann man auch in der Vorlage selbst oder in einer Subvorlage machen. Mann kann die Tabelle auch zweispaltig ausbilden, wenn doch ein Teil des Textes rechts oder links neben der Box angezeigt werden soll. Die Angabe "width=100%" ist nur notwendig, wenn die Box rechts gestellt sein soll.

Letzte Änderungen auf der Hauptseite

Es hat sich bei unseren Wikis bewährt, eine Auswahl der letzten Änderungen gleich in die Hauptseite einzubinden. Dazu haben wir eine eigene Vorlage:News eingerichtet, mit der sich das einfach bewerkstelligen läßt.

Der Vorlage kann eine Parameter "Width" zur Definition der Breite mitgegeben werden. Die Box ist rechtsstehend definiert. Ein Aufruf kann daher folgendermaßen aussehen:

{{News|width=250px}}

Die Vorlage selbst hat den folgenden Inhalt:

<div>
{| id="webcoach-box" align="right" width = {{{width}}}px 
|- 
|<rss number=10 namespace=,Objekt:,Job:,Event:,Hilfe:,desc=off>http://www.coachit.at/webcoachwiki/index.php?title=Spezial:Recentchanges&feed=rss</rss>
|}
</div>

[[Kategorie:Menue]]

Es kann also im Style-Sheet, hier MediaWiki:Gumax.css eine Definition "webcoach-box" geben, mit der das Design der Tabelle generell gesteuert werden kann.

Der RSS-Reader ist über ein AddOn bewerkstelligt und hat die folgenden Parameter (Trennung durch Space):

  • number=10 (Anzahl der Einträge, die maximal angezeigt werden sollen)
  • namespace = (Namespaces, die angezeigt werden sollen. Die Angabe erfolgt durch den Namen gefolgt von ":". Dies ist eine individuelle Ergänzung im Add-On
  • desc = off bewirkt, dass die Beschreibung unterhalb der Überschrift ausgebelendet wird.
  • Aufruf des rss selbst, so wie er auch in einen Newsreader eingebunden würde.
  • list=tree bewirkt, dass nur die Überschriften als Tree ausgeben werden, damit ist eine Einbindung ins Menue möglich.

Die Zuordnung zur Kategorie:Menu ist aus Administrationsgründen getroffen. Siehe weiter oben.

Folgender Eintrag in MediaWiki:NavTree würde eine Ausgabe direkt unter dem Navigationsmenue bewirken:

<div class='gumax-portlet' id='p-Releases'>
<h5>Letzte Änderungen</h5>
<div id="gumax-p-navigation"><ul>
<rss number=10 namespace=,Job:,Event:,Projekt: desc=off list=tree>http://www.coachit.at/webcoach-wiki/index.php?title=Spezial:Recentchanges&feed=rss</rss>
</ul></div></div>