Handbuch:Erweiterung/MenuEditor: Unterschied zwischen den Versionen

Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
Keine Bearbeitungszusammenfassung
Zeile 3: Zeile 3:


==Einführung==
==Einführung==
Die Hauptnavigation ist in der Desktop-Ansicht des Wikis die linke Seitenleiste. Die Inhalte dieser Navigationsleiste gelten für das gesamte Wiki und können nicht für bestimmte [[Namensraum|Namensräume]] angelegt werden. <gallery widths="200" heights="350">
Die Hauptnavigation ist in der Desktop-Ansicht des Wikis die linke Seitenleiste. Die Inhalte dieser Navigationsleiste gelten für das gesamte Wiki und können nicht für bestimmte [[Namensraum|Namensräume]] angelegt werden. <gallery heights="350">
Datei:skin-discovery-hautpnavigation4-4.png|Hauptnavigation ab BlueSpice 4.4
Datei:skin-discovery-hautpnavigation4-4.png|Hauptnavigation ab BlueSpice 4.4
Datei:Handbuch:skin-discovery-hauptnavigation.png|Hauptnavigation BlueSpice -4.3
Datei:Handbuch:skin-discovery-hauptnavigation.png|Hauptnavigation BlueSpice -4.3

Version vom 6. Dezember 2023, 15:13 Uhr


Einführung[Bearbeiten | Quelltext bearbeiten]

Die Hauptnavigation ist in der Desktop-Ansicht des Wikis die linke Seitenleiste. Die Inhalte dieser Navigationsleiste gelten für das gesamte Wiki und können nicht für bestimmte Namensräume angelegt werden.

In einem neuen Wiki werden unter der Überschrift Einstieg einige Standardlinks angezeigt:

  • Hauptseite: Link zurück zur Haupseite, wie standardmäßig auch das Wiki-Logo.
  • Bücherregal: Hier werden alle Bücher, die im Wiki angelegt sind angezeigt. Wenn keine Bücher existieren, sollte dieser Link deaktiviert werden.
  • Alle Seiten: Link zur Spezialseite Alle Seiten. Über diese Seite werden alle Seiten nach Namensraum geordnet aufgelistet. Die Auflistung der Namensräume erfolgt nach Namensraum-ID. Namensräume, die von Administratoren manuell angelegt wurden, werden am Ende der Auswahl angezeigt (nach dem Namensraum "Gadget").
  • Blog: Link zur Spezialseite Blog. Wird im Wiki kein Blog geführt, sollte dieser Link deaktiviert werden.
  • Timeline: Link zur Spezialseite Timeline. Diese Seite listet alle "sozialen" Einheiten (Beiträge mit Kommentarfunktion) des Wikis auf (z.B. Blogeinträge, Diskussionsbeiträge oder neue Benutzerprofile)
  • Letzte Änderungen: Link zur Spezialseite Letzte Änderungen. Hier können die täglichen Seitenbearbeitungen und Seitenerstellungen nachverfolgt werden. Diese Seite ist hilfreich, um einen Überblick über die Inhalte und deren Pflege zu behalten. Es ist meistens sinnvoll, diesen Link anzubieten.

Zusätzlich können in dieser Leiste Links hinzugefügt werden. Damit die Hauptnavigation nicht zu umfangreich wird, ist es sinnvoll, hier Links zu den wichtigsten Themen sowie zu weiterführendenPortalseiten einzurichten.

Standardlinks deaktivieren[Bearbeiten | Quelltext bearbeiten]

Die Standardlinks können über die Konfigurationsverwaltung deaktiviert werden. Folgende Einstellungen sind hierbei unter dem Menüpunkt "Benutzeroberfläche" zu finden:

BlueSpiceDiscovery:

  • Einstiegspunkt "Hauptseite" anzeigen
  • Einstiegspunkt "Alle Seiten" anzeigen
  • Einstiegspunkt "Letzte Änderungen" anzeigen

BlueSpiceSocial:

  • Einstiegspunkt "Timeline" anzeigen

BlueSpiceSocialBlog:

  • Einstiegspunkt "Blog" anzeigen

Hauptnavigationstyp einstellen[Bearbeiten | Quelltext bearbeiten]

In der Konfigurationsverwaltung kann zwischen vier Menü-Einstellungen ausgewählt werden:

Formular mit Anzeige der vier Menütypen
Menüeinstellung in der Konfigurationsverwaltung
  1. Mediawiki Sidebar: Eine einfache Auflistung von Links zu Wiki-Seiten (oft zu Portalseiten). Eine hierarchische Navigationsstruktur wird nicht unterstützt.
  2. Namensraum Hauptseiten: Erzeugt automatisch zu allen Seiten im Wiki mit der Syntax Namensraum-Präfix:Hauptseite (z.B. QM:Hauptseite)
  3. Unterseitenbaum: Sinnvoll in einem Wiki, das die Seiten haupsächlich über Unterseiten strukturiert.
  4. Erweiterte MediaWiki Sidebar: Eine Auflistung von Links zu Wikiseiten. Eine hierarchische Navigationsstruktur wird unterstützt. Seiten können mit ihrer Unterseitenstruktur aufklappbar angezeigt werden.

Hauptnavigation bearbeiten[Bearbeiten | Quelltext bearbeiten]

So öffnen Sie den Menü-Editor:

  1. Klicken Sie Seitenleiste bearbeiten. Dieser Link wird sichtbar, wenn Sie über bestehende Links hovern. Falls die Seite noch nicht existiert, wird anschließend eine entsprechende Notiz angezeigt und die Seite kann angelegt werden.
    Seite MediaWiki:Sidebar anlegen
    Seite MediaWiki:Sidebar anlegen: (1) Meldung, (2) Bearbeiten-Schaltfläche

Mediawiki Sidebar[Bearbeiten | Quelltext bearbeiten]

Wenn Sie als Konfiguration "MediaWiki Sidebar" eingestellt haben, gehen Sie wie folgt vor.

So fügen Sie eine neue Überschrift hinzu:

  1. Klicken Sie auf Seitenleiste bearbeiten. Dieser Link wird sichtbar, wenn Sie mit der Maus über den letzten Navigationslink fahren. Wenn die Seite noch nicht existiert, wird eine Meldung angezeigt.
  2. Klicken Sie Neues Element hinzufügen.
    Menü-Überschrift hinzufügen
    Menü-Überschrift hinzufügen
  3. Geben Sie den Text für die Überschrift ein. Hinweis: In einem mehrsprachigen Wiki, geben Sie hier eine Systemnachricht ein.
    Text für Menü-Überschrift
    Text für Menü-Überschrift

Links hinzufügen:

  1. Klicken Sie auf das Dropdown-Menu neben der Überschrift. Wählen Sie Neuen Unterpunkt hinzufügen.
    Link als Unterpunkt hinzufügen
    Link als Unterpunkt hinzufügen
  2. Geben Sie das Linkziel (Seitenname) und die Link-Bezeichnung (Label) ein.
    Link erstellen
    Link erstellen
  3. Klicken Sie auf Fertig.
  4. Wiederholen Sie die Schritte 1-3.
  5. Klicken Sie Änderungen speichern.

Quelltextbearbeitung[Bearbeiten | Quelltext bearbeiten]

Alternativ können Sie die Seitenleiste auch in der Quelltextbearbeitung (Wikitext) anpassen.

So fügen Sie neue Links hinzu:

  1. Klicken Sie auf Seitenleiste bearbeiten. Dieser Link wird sichtbar, wenn Sie auf einen bereits existierenden Link mit der Maus fahren.
  2. Wechseln Sie in den Quelltext-Bearbeitungsmodus.
  3. Erstellen Sie einen oder mehrere Navigationslinks (mit oder ohne Überschrift). Im folgenden Beispiel erstellen wir einen Link zur Wikiseite "Firma" mit der Beschriftung "Unsere Firma" und einen externen link zur BlueSpice Website mit der Bezeichung "Website". Die Links sind unter der Überschrift "Wichtige Infos" gruppiert:
    *Wichtige Infos
    **Firma|Unsere Firma
    **https//www.bluespice.com/de|Website
    
  4. Speichern Sie die Seite. Die Links werden nun in der Hauptnavigation angezeigt.

Unter Umständen kann es zu Kollisionen von Linkbezeichnungen mit Systemnachrichten kommen. Ist dies der Fall, so hängen Sie der Bezeichnung einfach den HTML-Code für ein Leerzeichen an:

**Portal|Portal&#160;

Gruppenspezifische Navigation[Bearbeiten | Quelltext bearbeiten]

Mithilfe von UserFunctions ist es möglich, Navigationselemente nur für bestimmte Benutzergruppen anzuzeigen. Beachten Sie, dass innerhalb dieser Funktion der Trennstrich (|) zwischen Seitenname und Bezeichnung als {{!}} maskiert werden muss.

{{#ifingroup:sysop,widgeteditor |
*Test2                       
**somepage{{!}}Some page
|}}
Hinweis:Wenn Sie im Quelltext über die Parserfunktion {{#ifingroup:... Navigationselemente gruppenspezifisch anzeigen, dann müssen Sie die Hauptnavigation stets im Quelltext bearbeiten. Im visuellen Bearbeitungsmodus werden beim Speichern alle Parserfunktionen oder semantische Abfragen entfernt.


Erweiterte MediaWiki Sidebar[Bearbeiten | Quelltext bearbeiten]

Wenn Sie in der Konfigurationsverwaltung "Erweiterte MediaWiki Sidebar" eingestellt haben, können Sie ein hierarchisches Menü erstellen. Hier bearbeiten Sie die Seite MediaWiki:Sidebar.json. Es verfügt über die Grundfunktionalität der Standard-MediaWiki-Seitenleiste. Darüber hinaus unterscheidet es zwischen folgenden Unterelementen (=Knotentypen):

Interner Link[Bearbeiten | Quelltext bearbeiten]

Geben Sie einfach einen Link zu einer Wiki-Seite mit einem zusätzlichen Link-Label an. Sowohl der Seitenname als auch die Beschriftung können mithilfe einer Parser-Funktion erstellt werden.

Interner Link mit einer Variable.

Interner Link mit einer Variable.

Externer Link[Bearbeiten | Quelltext bearbeiten]

Identisch mit internem Link, Sie müssen jedoch eine vollständige URL zu einer externen Website angeben.

Unterseitenbaum[Bearbeiten | Quelltext bearbeiten]

Sie können den Namen einer Seite angeben, die über eine oder mehrere Unterseitenebenen verfügt. Sie können die Tiefe auf 6 Ebenen einstellen, wobei die übergeordnete Seite die erste Ebene ist. Das heißt, wenn Sie die erste Ebene der Unterseiten anzeigen möchten, würden Sie eine Tiefe von 2 wählen.

Screenshot des Bearbeitungsfensters für ein Unterseitenbaumelement.

Erstellen eines Unterseitenbaums mit dem Enhanced MenuEditor.

Es ist nicht möglich, den Knotentyp (=Elementtyp) nach der Erstellung zu ändern. Erstellen Sie stattdessen nach Bedarf ein neues Element und löschen Sie das unerwünschte Element.

Für Gruppen anzeigen[Bearbeiten | Quelltext bearbeiten]

Darüber hinaus kann die Sichtbarkeit eines Menüpunkts auf bestimmte Wiki-Gruppen eingeschränkt werden. Geben Sie im Feld „Für Gruppen anzeigen“ eine durch Kommas getrennte Liste von vorhandenen Wiki-Gruppen ein.

CSS-Klassen[Bearbeiten | Quelltext bearbeiten]

Sie können CSS-Klassen auch auf jedes Element anwenden, um benutzerdefinierte Stiloptionen zu erhalten. Die Stile müssen auf der Seite MediaWiki:Common.css definiert werden (CSS-Kenntnisse erforderlich).

Zusätzliche Anpassungen[Bearbeiten | Quelltext bearbeiten]

Weiterführende Links




Feedback zur Dokumentation ist im Community-Forum möglich.