Layout

Shell je Blade komponenta, ne konfigurační objekt. Váš layout ji jmenuje a plní její sloty — proto jsou brand, přihlašování i chrome markup, který napíšete, a ne třída, kterou nastavíte.

Sloty

Sloty místo konfigurace jsou záměr: třída, která drží brand, barvy a auth, je přesně to, co z shellu udělá panel builder — a všechno, co by nesla, je markup, který umíte napsat sami.

Menu jako pruh

Od lg výš je menu ve výchozím stavu sloupec vedle stránky. Může to být i pruh pod hlavičkou — pro aplikaci s malým počtem hlavních sekcí a širokými tabulkami, které tu šířku chtějí:

// config/wire-admin.php
'layout' => [
    'navigation' => 'top',   // 'sidebar' (výchozí) | 'top'
],

nebo jen pro jeden layout, <x-wire-admin::layout navigation="top">. Hodnota, která nejmenuje ani jedno, se odmítne výjimkou NavigationShapeException, místo aby se potichu vykreslil sloupec.

Pruh kreslí totéž menu jako sloupec — stejný Workspace, stejnou aktivní položku —, jen ve vlastním tvaru:

Pod lg je to šuplík, ať je tvar jakýkoli. Pruh je tvar pro širokou obrazovku; na telefonu je menu pořád sloupec otevíraný z hlavičky. Dokument tedy nese obojí a řádky pruhu mají vlastní jména (admin-topnav-*), oddělená od jmen šuplíku (admin-nav-*) — sdílená jména by každý test počítal dvakrát.

Pruh se nikdy nezalomí. Je oříznutý od prvního vykreslení, a jakmile ho prohlížeč změří, položky, které se nevejdou — první, která ne, a každá za ní, aby pořadí drželo —, se ukážou pod Další. V pruhu není co sbalovat, takže přepínač lišty ani jeho zkratka se nevykreslí.

Z klávesnice se po pruhu chodí ← a →, ↓ na skupině otevře její panel s fokusem na prvním odkazu, ↑ a ↓ se v něm pohybují a Escape nebo Tab ho zavře — Escape přitom vrátí fokus tlačítku.

Přihlašování

Shell má rám pro přihlášení a žádnou autentizaci: <x-wire-admin::auth-layout> je vycentrovaná karta se stejnou hlavou — rozhodnutí o motivu, assety, interakční vrstva — a bez menu, palety i zvonku, protože nic z toho před existencí uživatele nic neznamená.

{{-- resources/views/auth/login.blade.php, vykreslené Fortify nebo Breeze --}}
<x-wire-admin::auth-layout :title="__('Přihlášení')">
    <x-slot:brand>{{ config('app.name') }}</x-slot:brand>
    <x-slot:footer><a href="{{ route('password.request') }}">{{ __('Zapomenuté heslo?') }}</a></x-slot:footer>
 
    <form method="POST" action="{{ route('login') }}">@csrf
        {{-- vaše pole --}}
    </form>
</x-wire-admin::auth-layout>

Zbytek vlastní Laravel, a je to záměr: Fortify (headless) nebo Breeze (scaffolding) už nesou omezení počtu pokusů, tokeny pro reset hesla a jejich expiraci, ověření e-mailu, dvoufaktor i regeneraci session. Panel, který si tohle napíše znovu, vlastní bezpečnostní plochu a nezíská funkci — takže tenhle balíček dodává kartu a ani jednu přihlašovací cestu. Tam, kde obrazovku pro nastavení dvoufázového ověření v panelu chcete, ji dodá modul uživatelů a volá vlastní akce Fortify — obrazovka nad vlastníkem, ne druhý vlastník.

Spojuje je middleware, který stejně píšete:

Route::middleware(['web', 'auth'])->prefix('admin')->group(fn () => Route::wireResources());

Pro každou zónu, když jich aplikace má víc — can:admin na jedné skupině, can:business na druhé — a pro jednotlivé stránky přes RoutePage::make($page)->permission('users.manage'), což se stane Laravelím can: middlewarem. Všechno odpovídá Gate, takže role ze Spatie i wildcardy z nyoncode/laravel-permission-extended fungují, aniž by o nich tenhle balíček věděl.

Kdo je přihlášený

Shell ukazuje přihlášeného uživatele v rohu, i s menu. Nedodává žádnou stránku profilu ani odhlašovací route, protože nevlastní auth — ty přijdou slotem user-menu a <x-wire-admin::menu-item> existuje proto, aby to, co do něj dáte, vypadalo jako menu, ve kterém to sedí:

<x-slot:user-menu> 
    <x-wire-admin::menu-item :href="route('profile')" icon="outline:user-circle">
        Profil
    </x-wire-admin::menu-item>
 
    <form method="POST" action="{{ route('logout') }}">
        @csrf
        <x-wire-admin::menu-item type="submit" icon="outline:arrow-right-start-on-rectangle">
            Odhlásit se
        </x-wire-admin::menu-item>
    </form>
</x-slot:user-menu>

Modul uživatelů dodává stránku profilu pro přihlášeného uživatele, pokud ji nechcete psát sami.

Související

• Sidebar — menu, které tenhle layout staví vedle stránky
• Branding a motiv — logo a rozhodnutí o motivu v hlavičce
• Auth modul — hotové obrazovky pro rám výše
• Users modul — profilová stránka do rohového menu