Navigation¶

Diese Seite fasst zusammen, was zur Navigation gehört: die Hauptnavigation im Kopfbereich, Zusatzfelder an Menüpunkten und die Brotkrumen.

Zwei Wege für die Hauptnavigation¶

Beide beziehen ihre Einträge aus den klassischen WordPress-Menüs, nicht aus dem Navigations-Block. Gepflegt wird also unter Darstellung → Menüs.

Megamenü¶

Einen Menüpunkt zum Megamenü machen¶

1. Darstellung → Menüs öffnen
2. Menüpunkt aufklappen
3. Im Bereich Mega Menu den Item-Typ wählen:

1. Spaltenbreiten je Breakpoint festlegen, von sm bis xxl
2. Bei Widget-Spalten den Sidebar Name eintragen

Bei Menüpunkten, die auf einen Inhaltstyp zeigen, kommen zwei Felder hinzu:

Der Block¶

Der Block TW Megamenü kommt in den Kopfbereich, bearbeitet unter Design → Editor. Einstellbar sind die Menü-Position, der Umbruchpunkt für die mobile Darstellung, das Icon des Menüschalters und die Beschriftung für Screenreader.

Auf kleinen Bildschirmen wird das Megamenü zu einem Offcanvas-Menü mit Akkordeon.

Bedienung mit der Tastatur¶

Das Megamenü ist ohne Maus vollständig bedienbar: Tab und Shift+Tab wandern durch die Einträge, Escape schließt ein geöffnetes Menü, ein Klick außerhalb ebenfalls. Der Fokus springt danach auf das auslösende Element zurück.

Klassisches Menü¶

Der Block Klassisches Menü gibt ein Menü aus Darstellung → Menüs aus. Auswählbar sind das Menü selbst — über Position oder direkt — und die Ausrichtung.

Das Modul ergänzt außerdem den Navigations-Block von WordPress um Links auf Inhaltstyp-Archive, die dort sonst fehlen.

Zusatzfelder an Menüpunkten¶

Eigene Felder an Menüpunkten laufen über den Filter twtheme_menu_fields. Sie erscheinen dann im Menü-Editor bei jedem Eintrag.

add_filter('twtheme_menu_fields', function (array $fields, $item_id, $item_type): array {
    $fields[] = [
        'id'    => 'twtheme_menu_badge',
        'label' => 'Badge-Text',
        'type'  => 'text',
    ];

    return $fields;
}, 10, 3);

Für die Ausgabe im Frontend greifen die Filter des Hyperlinks-Moduls, denn Menüs und Inhalte laufen durch denselben Link-Aufbau:

Früher gab es dafür eine eigene Optionsseite Menu fields. Sie ist entfallen — die Felder werden heute über den Filter definiert und im Megamenü verwaltet.

Brotkrumen¶

Einstellungen¶

Unter Theme → Einstellungen → Hilfsmittel → Breadcrumbs:

Die letzte Einstellung ist die interessanteste bei verschachtelten Kategorien: Sie bestimmt, ob der Pfad die ganze Kategorie-Hierarchie zeigt oder nur die unterste Ebene.

Diese Werte sind Standardwerte für Shortcode, twtheme_breadcrumb() und den Breadcrumbs-Block. Einzelne Aufrufe überschreiben sie per Attribut oder Argument.

Ausgeben¶

Drei Wege, je nach Kontext:

[breadcrumb]
[breadcrumb divider="/" show_homepage="false"]

echo twtheme_breadcrumb();

$items = [
    ['name' => 'Produkte', 'url' => '/produkte/'],
    ['name' => 'Kategorie', 'url' => '/produkte/kategorie/'],
    ['name' => 'Produktname', 'url' => ''],
];

echo twtheme_breadcrumb($items, [
    'divider'       => '/',
    'show_homepage' => false,
]);

Ohne eigene Einträge erzeugt das Theme den Pfad aus dem Kontext: Einzelansicht, Archiv, Taxonomie, Suche oder 404-Seite.

Schnellnavigation im Kopfbereich¶

Der Shortcode [twtheme_header_quick_nav] gibt eine Reihe von Schnelllinks aus, etwa für Telefon und Kontakt. Die Einträge kommen aus der Theme-Konfiguration.

Erweitern lässt sich die Topbar über zwei Filter und zwei Actions:

Weiter¶

• Blöcke — alle Navigationsblöcke
• Hooks und Filter
• Sichtbarkeit — Blöcke je Bildschirmgröße ein- und ausblenden