Menu in der Kopfleiste #65

Closed
opened 2026-11-04 09:40:35 +01:00 by miko · 1 comment
Owner

Ursprüngliche Anfrage: Es sollte ein optionales Menü in der oberen Leiste geben, welche administratoren mit links zu kategorien, seiten oder externen urls bestücken können.

Blocked by: #64, #66

Admins pflegen ein Menu in der Kopfleiste. Es ist flach und besteht aus Menu Items, die auf Categories, Guides, Pages oder externe URLs verlinken.

Menu Items

  • Es gibt vier Arten von Einträgen: Category, Guide, Page und URL.
  • Bei der Art URL sind nur absolute http://- und https://-URLs erlaubt.
  • Das Menü hat eine Ebene, ohne Untermenüs. Es gibt keine Obergrenze für die Zahl der Einträge.
  • Label: Es ist optional. Ohne Label wird der aktuelle Titel des Ziels angezeigt, eine Umbenennung des Ziels wandert also mit. Bei URLs ist das Label Pflicht.
  • Sichtbarkeit: Ein Eintrag wird nur angezeigt, wenn der Besucher das Ziel öffnen darf. Maßgeblich sind die Effective Visibility der Category, canViewGuide für Guides (Draft, internal, gelöscht) sowie Visibility und Status der Page. URLs sind immer sichtbar. Einträge haben keine eigene Sichtbarkeit.

Speicherung

  • Eine neue Tabelle MenuItem mit position, Art, optionalem Label, URL und optionalen Fremdschlüsseln auf Category, Guide und Page.
  • Wird eine Category oder Page gelöscht, verschwindet der Eintrag mit (onDelete: Cascade).
  • Guides werden nur soft gelöscht. Der Eintrag bleibt deshalb bestehen, wird ausgeblendet und erscheint wieder, wenn der Guide wiederhergestellt wird.

Verwaltung

  • Das Verwaltungsmenü (#66) bekommt den Eintrag Menü, der zu /admin/menu führt (requireAdmin).
  • Dort kann man Einträge hinzufügen, bearbeiten und entfernen und ihre Reihenfolge manuell sortieren, wie bei ArrangeChildren. Alles wird in einem Formular gespeichert.
  • Ein Eintrag, dessen Guide gelöscht ist, wird als „Ziel gelöscht“ markiert.

Darstellung

  • Ab md: Die Einträge stehen inline in der Kopfleiste, zwischen Logo und Suche.
    • Die Kopfleiste wird eine flex-wrap-Zeile, nur mit CSS und ohne Messen.
    • Die Suche ist mindestens etwa 16rem und höchstens 24rem breit und füllt den Platz zwischen Menü und Account.
    • Reicht der Platz nicht, rutscht die Suche in eine eigene Zeile über die volle Breite. Passt das Menü selbst nicht in eine Zeile, umbricht es ebenfalls.
    • Die exakte Zentrierung der Suche ab xl entfällt.
  • Unter md: Links vom Logo steht ein Hamburger-Button.
    • Er klappt die Einträge als Disclosure-Liste auf, im selben Stil wie UserMenu und das Verwaltungsmenü.
    • Die Liste schließt bei Escape, bei einem Klick außerhalb und bei einem Seitenwechsel.
  • Ohne sichtbare Einträge gibt es weder Menü noch Hamburger. Die Leiste sieht dann aus wie heute.
  • Externe Links öffnen in einem neuen Tab mit rel="noopener noreferrer", ohne Icon.
  • Aktiver Eintrag: Er wird in der Accent Colour hervorgehoben.
    • Eine Category gilt im ganzen Teilbaum als aktiv, also auch auf Unterkategorien und Guides darin.
    • Ein Guide gilt auf seiner Leseansicht und seinen Bearbeitungsseiten als aktiv.
    • Eine Page gilt auf ihrer Seite als aktiv.

Doku

  • Glossar-Einträge Menu und Menu Item, dazu User menu und Admin menu zur Abgrenzung.

Akzeptanzkriterien

  • Ein Admin kann unter /admin/menu Einträge aller vier Arten anlegen, bearbeiten, entfernen und sortieren. Andere Rollen haben keinen Zugriff.
  • Ungültige URLs (nicht http(s)) und URL-Einträge ohne Label werden abgewiesen.
  • Einträge mit Zielen ohne Leserecht sind für den jeweiligen Besucher ausgeblendet.
  • Löschen einer Category oder Page entfernt ihre Einträge. Ein gelöschter Guide blendet seinen Eintrag aus, die Wiederherstellung zeigt ihn wieder.
  • Ab md steht das Menü inline, die Suche rutscht bei Platzmangel in eine eigene Zeile. Unter md gibt es den Hamburger.
  • Der aktive Eintrag ist hervorgehoben, wie oben beschrieben.
  • Die Texte sind übersetzt (Lingui).
> Ursprüngliche Anfrage: Es sollte ein optionales Menü in der oberen Leiste geben, welche administratoren mit links zu kategorien, seiten oder externen urls bestücken können. Blocked by: #64, #66 Admins pflegen ein **Menu** in der Kopfleiste. Es ist flach und besteht aus **Menu Items**, die auf Categories, Guides, Pages oder externe URLs verlinken. ## Menu Items - Es gibt vier Arten von Einträgen: **Category**, **Guide**, **Page** und **URL**. - Bei der Art URL sind nur absolute `http://`- und `https://`-URLs erlaubt. - Das Menü hat eine Ebene, ohne Untermenüs. Es gibt keine Obergrenze für die Zahl der Einträge. - **Label:** Es ist optional. Ohne Label wird der aktuelle Titel des Ziels angezeigt, eine Umbenennung des Ziels wandert also mit. Bei URLs ist das Label Pflicht. - **Sichtbarkeit:** Ein Eintrag wird nur angezeigt, wenn der Besucher das Ziel öffnen darf. Maßgeblich sind die Effective Visibility der Category, `canViewGuide` für Guides (Draft, internal, gelöscht) sowie Visibility und Status der Page. URLs sind immer sichtbar. Einträge haben keine eigene Sichtbarkeit. ## Speicherung - Eine neue Tabelle `MenuItem` mit `position`, Art, optionalem Label, URL und optionalen Fremdschlüsseln auf Category, Guide und Page. - Wird eine Category oder Page gelöscht, verschwindet der Eintrag mit (`onDelete: Cascade`). - Guides werden nur soft gelöscht. Der Eintrag bleibt deshalb bestehen, wird ausgeblendet und erscheint wieder, wenn der Guide wiederhergestellt wird. ## Verwaltung - Das Verwaltungsmenü (#66) bekommt den Eintrag **Menü**, der zu `/admin/menu` führt (`requireAdmin`). - Dort kann man Einträge hinzufügen, bearbeiten und entfernen und ihre Reihenfolge manuell sortieren, wie bei `ArrangeChildren`. Alles wird in einem Formular gespeichert. - Ein Eintrag, dessen Guide gelöscht ist, wird als „Ziel gelöscht“ markiert. ## Darstellung - **Ab `md`:** Die Einträge stehen inline in der Kopfleiste, zwischen Logo und Suche. - Die Kopfleiste wird eine `flex-wrap`-Zeile, nur mit CSS und ohne Messen. - Die Suche ist mindestens etwa `16rem` und höchstens `24rem` breit und füllt den Platz zwischen Menü und Account. - Reicht der Platz nicht, rutscht die Suche in eine eigene Zeile über die volle Breite. Passt das Menü selbst nicht in eine Zeile, umbricht es ebenfalls. - Die exakte Zentrierung der Suche ab `xl` entfällt. - **Unter `md`:** Links vom Logo steht ein Hamburger-Button. - Er klappt die Einträge als Disclosure-Liste auf, im selben Stil wie `UserMenu` und das Verwaltungsmenü. - Die Liste schließt bei Escape, bei einem Klick außerhalb und bei einem Seitenwechsel. - Ohne sichtbare Einträge gibt es weder Menü noch Hamburger. Die Leiste sieht dann aus wie heute. - **Externe Links** öffnen in einem neuen Tab mit `rel="noopener noreferrer"`, ohne Icon. - **Aktiver Eintrag:** Er wird in der Accent Colour hervorgehoben. - Eine Category gilt im ganzen Teilbaum als aktiv, also auch auf Unterkategorien und Guides darin. - Ein Guide gilt auf seiner Leseansicht und seinen Bearbeitungsseiten als aktiv. - Eine Page gilt auf ihrer Seite als aktiv. ## Doku - Glossar-Einträge **Menu** und **Menu Item**, dazu **User menu** und **Admin menu** zur Abgrenzung. ## Akzeptanzkriterien - [ ] Ein Admin kann unter `/admin/menu` Einträge aller vier Arten anlegen, bearbeiten, entfernen und sortieren. Andere Rollen haben keinen Zugriff. - [ ] Ungültige URLs (nicht `http(s)`) und URL-Einträge ohne Label werden abgewiesen. - [ ] Einträge mit Zielen ohne Leserecht sind für den jeweiligen Besucher ausgeblendet. - [ ] Löschen einer Category oder Page entfernt ihre Einträge. Ein gelöschter Guide blendet seinen Eintrag aus, die Wiederherstellung zeigt ihn wieder. - [ ] Ab `md` steht das Menü inline, die Suche rutscht bei Platzmangel in eine eigene Zeile. Unter `md` gibt es den Hamburger. - [ ] Der aktive Eintrag ist hervorgehoben, wie oben beschrieben. - [ ] Die Texte sind übersetzt (Lingui).
miko changed title from Menü in oberer Leiste to Menu in der Kopfleiste 2026-11-04 10:01:36 +01:00
Author
Owner

Implemented in #71 (feature/65-menu → development). Agreed deviation on the titlebar layout: a menu wrapping over several rows leaves the search in the free space below the account rather than on a full-width row; see the PR description.

Implemented in #71 (feature/65-menu → development). Agreed deviation on the titlebar layout: a menu wrapping over several rows leaves the search in the free space below the account rather than on a full-width row; see the PR description.
miko closed this issue 2026-11-04 12:03:39 +01:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Depends on
Reference
MassiveDynamic/kataba#65
No description provided.