add('news', 'Neuigkeiten', '/neuigkeiten', active: 'news.*', sort: 20); * * Dynamische Einträge (z. B. Seiten aus dem Seitenbaum) liefert ein Provider: * * app(Navigation::class)->provider('pages', fn (Request $request, ?User $user) => [ * ['key' => 'page-3', 'label' => 'MAV', 'href' => '/seiten/mav', 'active' => true, 'sort' => 40], * ]); * * Hat die Administration unter „Menü“ ein eigenes Menü gespeichert, gilt dieses: * Bereiche (die Einträge oben), Links, Gruppen und Arten aus Plugins (z. B. „Seite“, * registriert mit source()), jeweils mit Unterpunkten. */ class Navigation { /** @var array, sort: int, ability: string|null, visible: Closure|null}> */ private array $items = []; /** @var array */ private array $providers = []; public const MENU_SETTING = 'navigation.menu'; /** @var array */ private array $sources = []; /** @var list|null Rollen der aktuellen Person (für „Sichtbar für“) */ private ?array $roleIds = null; public function __construct() { $this->add('home', 'Startseite', '/', active: 'dashboard', sort: 0); $this->add('people', 'Personen', '/personen', active: 'people.*', sort: 90); } /** * @param string|list $active Routennamen (mit *), bei denen der Eintrag aktiv ist * @param (Closure(User): bool)|null $visible zusätzliche Bedingung je Person */ public function add(string $key, string $label, string $href, string|array $active = [], int $sort = 50, ?string $ability = null, ?Closure $visible = null): void { $this->items[$key] = ['label' => $label, 'href' => $href, 'active' => (array) $active, 'sort' => $sort, 'ability' => $ability, 'visible' => $visible]; } public function remove(string $key): void { unset($this->items[$key], $this->providers[$key]); } /** * @param Closure(Request, User|null): list $items */ public function provider(string $key, Closure $items): void { $this->providers[$key] = $items; } /** * Weitere Art von Menüpunkten für den Menü-Editor, z. B. „Seite“. * * @param Closure(): array $options Auswahl im Editor * @param Closure(string, array, Request, User|null): (array{label: string, href: string, active: bool, children?: list}|null) $resolve * null = nicht (mehr) vorhanden oder nicht sichtbar */ public function source(string $type, string $label, Closure $options, Closure $resolve): void { $this->sources[$type] = compact('label', 'options', 'resolve'); } /** * @return array Art => Bezeichnung */ public function sourceTypes(): array { return array_map(fn (array $source) => $source['label'], $this->sources); } /** * @return array */ public function sourceOptions(string $type): array { return isset($this->sources[$type]) ? ($this->sources[$type]['options'])() : []; } /** * Bereiche für den Menü-Editor. * * @return array Schlüssel => Bezeichnung */ public function modules(): array { return collect($this->items)->sortBy('sort')->map(fn (array $item) => $item['label'])->all(); } /** * Menü für die Kopfzeile. Einträge können Unterpunkte (children) haben. * * @return list>}> */ public function items(Request $request, ?User $user = null): array { $this->roleIds = null; // je Aufruf neu – die Registry lebt über Requests hinweg $menu = app(Settings::class)->get(self::MENU_SETTING); $items = is_array($menu) && $menu !== [] ? $this->fromMenu($menu, $request, $user) : $this->automatic($request, $user); return Hooks::apply('navigation.items', $items, $request, $user); } /** * Das automatische Menü aus Kern, Plugins und Seiten „in der Hauptnavigation“. * * @return list> */ public function automatic(Request $request, ?User $user = null): array { $items = collect($this->items) ->filter(fn (array $item) => $item['ability'] === null || ($user?->can($item['ability']) ?? false)) ->filter(fn (array $item) => $item['visible'] === null || ($user !== null && ($item['visible'])($user))) ->filter(fn (array $item, string $key) => app(PluginAccess::class)->allows($key, $user)) ->map(fn (array $item, string $key) => [ 'key' => $key, 'label' => $item['label'], 'href' => $item['href'], 'active' => $item['active'] !== [] && $request->routeIs(...$item['active']), 'sort' => $item['sort'], ]); foreach ($this->providers as $key => $provider) { if (! app(PluginAccess::class)->allows($key, $user)) { continue; } $items = $items->merge($provider($request, $user)); } return $items->sortBy('sort') ->map(fn (array $item) => ['key' => $item['key'], 'label' => $item['label'], 'href' => $item['href'], 'active' => (bool) $item['active'], 'icon' => null, 'new_tab' => false, 'children' => []]) ->values() ->all(); } /** * @param list> $menu * @return list> */ private function fromMenu(array $menu, Request $request, ?User $user): array { return array_values(array_filter(array_map(fn ($item) => is_array($item) ? $this->resolve($item, $request, $user, true) : null, $menu))); } /** * Einen gespeicherten Menüpunkt auflösen – null, wenn er für diese Person nicht * sichtbar ist (Rolle, Recht, Plugin deaktiviert, Seite gelöscht, Gruppe leer). * * @param array $item * @return array|null */ private function resolve(array $item, Request $request, ?User $user, bool $topLevel): ?array { $roles = array_map('intval', (array) ($item['roles'] ?? [])); if ($roles !== [] && array_intersect($roles, $this->roleIds($user)) === []) { return null; } $type = (string) ($item['type'] ?? ''); $base = match ($type) { 'module' => $this->module((string) ($item['module'] ?? ''), $request, $user), 'link' => $this->link((string) ($item['url'] ?? ''), $request), 'group' => ['label' => '', 'href' => null, 'active' => false], default => isset($this->sources[$type]) && filled($item['target'] ?? null) ? ($this->sources[$type]['resolve'])((string) $item['target'], $item, $request, $user) : null, }; if ($base === null) { return null; } $children = []; if ($topLevel) { foreach ((array) ($item['children'] ?? []) as $child) { if (is_array($child) && ($resolved = $this->resolve($child, $request, $user, false))) { $children[] = $resolved; } } foreach ((array) ($base['children'] ?? []) as $child) { $children[] = ['key' => ($item['id'] ?? $type).'-'.md5($child['href']), 'label' => $child['label'], 'href' => $child['href'], 'active' => (bool) $child['active'], 'icon' => null, 'new_tab' => false, 'children' => []]; } } $label = trim((string) ($item['label'] ?? '')) ?: $base['label']; if ($label === '' || ($type === 'group' && $children === [])) { return null; } return [ 'key' => (string) ($item['id'] ?? md5(json_encode($item))), 'label' => $label, 'href' => $base['href'], 'active' => $base['active'] || collect($children)->contains('active', true), 'icon' => Icons::has($item['icon'] ?? null) ? $item['icon'] : null, 'new_tab' => $type === 'link' && ! empty($item['new_tab']), 'children' => $children, ]; } /** * @return array{label: string, href: string, active: bool}|null */ private function module(string $key, Request $request, ?User $user): ?array { $item = $this->items[$key] ?? null; if (! $item || ! app(PluginAccess::class)->allows($key, $user) || ($item['ability'] !== null && ! ($user?->can($item['ability']) ?? false)) || ($item['visible'] !== null && ($user === null || ! ($item['visible'])($user)))) { return null; } return ['label' => $item['label'], 'href' => $item['href'], 'active' => $item['active'] !== [] && $request->routeIs(...$item['active'])]; } /** * @return array{label: string, href: string, active: bool}|null */ private function link(string $url, Request $request): ?array { if (! preg_match('#^(/|https?://|mailto:|tel:)#i', $url)) { return null; } $path = str_starts_with($url, '/') ? (parse_url($url, PHP_URL_PATH) ?: '/') : null; return ['label' => '', 'href' => $url, 'active' => $path !== null && $path !== '/' && '/'.ltrim($request->path(), '/') === rtrim($path, '/')]; } /** * @return list */ private function roleIds(?User $user): array { return $this->roleIds ??= $user ? $user->roles()->pluck('roles.id')->map(fn ($id) => (int) $id)->all() : []; } }