Konfigurace

Wire funguje po instalaci hned. Konfigurační soubory publikujte jen když potřebujete změnit výchozí hodnoty pro notifikace, formáty data, uploady, chování tabulky, chování sortable nebo audit logging.

Publikování konfiguračních souborů

php artisan vendor:publish --tag=wire-core::config
php artisan vendor:publish --tag=wire-forms::config
php artisan vendor:publish --tag=wire-table::config
php artisan vendor:publish --tag=wire-sortable::config
php artisan vendor:publish --tag=wire-panels::config
php artisan vendor:publish --tag=wire-admin::config
php artisan vendor:publish --tag=wire-boost::config
 
# Jeden na každý nainstalovaný modul
php artisan vendor:publish --tag=wire-module-users::config
php artisan vendor:publish --tag=wire-module-auth::config
php artisan vendor:publish --tag=wire-module-settings::config
php artisan vendor:publish --tag=wire-module-notifications::config
php artisan vendor:publish --tag=wire-module-audit::config
php artisan vendor:publish --tag=wire-module-media::config
php artisan vendor:publish --tag=wire-module-tenants::config

Potřebujete jen tagy balíčků, které jste nainstalovali.

Proměnné prostředí

JavaScriptové assety

Není co konfigurovat ani co publikovat: každý balíček si své předsestavené bundly zkopíruje do public/vendor/<balíček> a servíruje je jako statické soubory, s cache-bustingem podle času poslední změny souboru. Jediné, o čem rozhoduje vaše aplikace, je kde se vypíšou — dejte

@wireStackScripts

jednou do <head> layoutu a Alpine controllery všech nainstalovaných balíčků jsou v úvodním dokumentu, což je přesně to, co je udrží funkční napříč wire:navigate (včetně cesty cachovaného Zpět/Vpřed). Předáním jména balíčku — @wireStackScripts('wire-table') — vypíšete jen bundly jednoho balíčku.

php artisan vendor:publish --tag=laravel-assets --force udělá tutéž kopii dopředu, čímž ji sundá z prvního requestu po nasazení — užitečné, nikdy povinné. Konfigurační klíč k tomu tak jako tak žádný není.

Podrobné vysvětlení v Začínáme → JavaScriptové assety.

Core

Konfigurace wire-core řídí sdílené chování UI.

return [
    'navigate' => env('WIRE_NAVIGATE', true),
 
    'notifications' => [
        'default' => env('WIRE_NOTIFICATIONS_DRIVER', 'session'),
    ],
 
    'icons' => [
        'default_set' => 'default',
        'sets' => [
            'default' => \NyonCode\WireCore\Foundation\Icons\DefaultIconSet::class,
            // 'lucide' => App\Wire\Icons\LucideIconSet::class,   // => "lucide:home"
        ],
        'paths' => [
            // resource_path('icons'),                 // logo.svg => "logo"
            // 'brand' => resource_path('icons/brand'), // mark.svg => "brand-mark"
        ],
        'warn_missing' => env('WIRE_ICONS_WARN_MISSING', false),
    ],
 
    'colors' => [
        // Role, ne barvy: každá plocha následuje to, na co ukazují. // 
        'success' => 'emerald',
        'danger' => 'red',
        'warning' => 'amber',
        'info' => 'cyan',
    ],
 
    // 'normal' nebo 'compact' — viz Vzhled → Hustota.
    'density' => env('WIRE_DENSITY', 'normal'),
 
    // 'rounded' nebo 'sharp' — viz Vzhled → Tvar.
    'shape' => env('WIRE_SHAPE', 'rounded'), 
 
    'plugins' => [
        // App\Wire\Plugins\ExamplePlugin::class,
    ],
 
    'modals' => [
        'default_width' => 'md',
        'slide_over_width' => 'md',
        'close_on_click_away' => true,
        'close_on_escape' => true,
    ],
];

Navigace

navigate rozhoduje, jestli se odkaz z jedné stránky aplikace na jinou otevře přes Livewire wire:navigate — tělo další stránky se stáhne a vymění, takže layout, scroll sidebaru i už načtené assety zůstanou — nebo obyčejným načtením celé stránky. Ve výchozím stavu je zapnutý.

Je to jeden přepínač pro všechny odkazy, které framework vykresluje: sidebar a horní navigaci, drobečkovou navigaci, sub-navigaci záznamu, akce s url() (tlačítka, položky menu, akce v hlavičce, akce v infolistu), recordUrl() tabulky, sloupce s URL a odkazy ButtonColumn, list widget, zvonek notifikací, karty boardu, uživatelské menu a redirect po uložení, smazání, výběru výsledku hledání nebo kroku průvodce.

Každý odkaz se rozhoduje v tomto pořadí:

1. Je to stránka této aplikace? Cesta, nebo absolutní URL se stejným schématem, hostem a portem jako aplikace. Jiný web, odkaz mailto: nebo tel: a samotný #fragment se nenavigují nikdy, ať přepínač říká cokoli — Livewire nedokáže vyměnit stránku z jiného originu.
2. Otevírá se v nové záložce? Pak není co navigovat.
3. Má odkaz vlastní volbu? ->navigate(false) nechá jeden odkaz načíst celou stránku i v aplikaci, která naviguje — stažení souboru nebo stránku s vlastním skriptem, který musí proběhnout při načtení. ->navigate() naopak nechá jeden odkaz navigovat v aplikaci, která přepínač vypnula.
4. Jinak přepínač.

// config/wire-core.php
'navigate' => env('WIRE_NAVIGATE', true),

Action::make('export')
    ->url(fn (Order $record) => route('orders.export', $record))
    ->navigate(false), 
 
TextColumn::make('customer.name')
    ->actionUrl(fn (Order $record) => route('customers.show', $record->customer))
    ->navigate(false), 
 
$table->recordUrl(fn (Order $record) => route('orders.show', $record), navigate: false); 

Vlastní Blade se ptá stejně, direktivou @wireNavigate:

<a href="{{ $url }}" @wireNavigate($url)>Objednávky</a>
<a href="{{ $url }}" @wireNavigate($url, false)>Stáhnout</a>

Vypíše wire:navigate, nebo nic. <x-wire::menu-item> má pro tutéž volbu prop :navigate.

Dvě místa schválně načítají celou stránku: přepínač tenantů a přepínač týmů, protože celý layout patří tenantovi nebo týmu, ze kterého se odchází.

Notifikace

Vestavěné notifikační drivery jsou:

WIRE_NOTIFICATIONS_DRIVER=livewire

Příklady použití viz Core Notifikace.

Ikony

'icons' => [
    'default_set' => 'default',
    'sets' => [
        'default' => DefaultIconSet::class,   // "pencil"      (Heroicons, 20×20 fill)
        'lucide'  => LucideIconSet::class,    // "lucide:home" (24×24 stroke)
    ],
    'paths' => [
        'brand' => resource_path('icons/brand'),
    ],
    'warn_missing' => env('WIRE_ICONS_WARN_MISSING', false),
],

Sady se používají společně s deterministickým, kolizím-odolným vyhodnocením. Kompletní API, model prefix:name, vlastní sady a přístupnost viz Core → Foundation → Ikony.

Pluginy

Zaregistrujte aplikační nebo balíčkové pluginy v poli plugins:

'plugins' => [
    App\Wire\Plugins\TenantPlugin::class,
],

Pluginy implementující HasConfiguration mohou také číst sloučené volby z wire-core.plugins.config.{pluginId}:

'plugins' => [
    App\Wire\Plugins\ExportPlugin::class,
 
    'config' => [
        'export' => [
            'format' => 'xlsx',
        ],
    ],
],

Třídy pluginů, životní cyklus, závislosti, makra, hooky, type registry, query pipes a konfiguraci pluginů viz Core Pluginy.

Modaly

Hodnoty šířky modalu jsou size tokeny ve stylu Tailwindu jako sm, md, lg, xl, 2xl nebo full.

'modals' => [
    'default_width' => 'lg',
    'slide_over_width' => 'xl',
    'close_on_click_away' => false,
    'close_on_escape' => true,
],

Modální akce a slide-overy viz Core Modaly.

Mobil

Plovoucí panely (rozbalovací nabídky, menu skupin akcí, select/date/tag pickery, panely filtrů a přepínání sloupců tabulky) a mobilní varianty modalů se pod breakpointem zobrazí jako bottom sheet. Toto jsou globální výchozí hodnoty — každá komponenta je přepisuje u své instance.

'mobile' => [
    // Zobrazit plovoucí panely jako bottom sheet na mobilu. false = klasický
    // plovoucí panel ukotvený k triggeru všude.
    'sheet' => env('WIRE_MOBILE_SHEET', true),
 
    // Breakpoint, pod kterým se panely stanou sheetem:
    //   'sm' (< 640px, telefony — výchozí)
    //   'md' (< 768px, včetně malých tabletů)
    //   'lg' (< 1024px, včetně tabletu na výšku)
    'breakpoint' => env('WIRE_MOBILE_BREAKPOINT', 'sm'),
 
    // Pod breakpointem vykreslit vlastní <select> / vstup data / času
    // prohlížeče místo vlastního prvku, všude, kde nějaký existuje.
    'native' => env('WIRE_MOBILE_NATIVE', false), 
 
    // Pod breakpointem vykreslit prvek dělaný pro palec: kolečko pro datum a
    // čas, seznam přes celou výšku pro selecty. Vyhrává nad 'native'.
    'touch' => env('WIRE_MOBILE_TOUCH', false), 
],

Přepisy u jednotlivých komponent (vyhrávají nad globálními výchozími):

// Sheet zap/vyp
Select::make('role')->options([...])->sheetOnMobile(false);   // vynutit plovoucí
Select::make('country')->searchable()->sheetOnMobile();       // vynutit sheet i když searchable
$table->sheetOnMobile(false);                                 // panely filtrů + přepínání sloupců
 
// Breakpoint (sm | md | lg)
Select::make('role')->mobileBreakpoint('lg');                 // sheet až do 1024px
$table->mobileBreakpoint('md');
ActionGroup::make([...])->mobileBreakpoint('md');
Action::make('edit')->form([...])->slideOverOnMobile()->mobileBreakpoint('md');
 
// Nativní prvek prohlížeče pod breakpointem, vlastní nad ním
DateTimePicker::make('starts_at')->nativeOnMobile();          // vlastní kolečko data telefonu 
SelectFilter::make('status')->nativeOnMobile(false);          // ponechat combobox i při 'native' => true
Select::make('customer_id')->touchOnMobile();                 // dotykový seznam přes celou výšku, i s hledáním 

<x-wire::dropdown :sheet-on-mobile="false" :breakpoint="'md'">…</x-wire::dropdown>

Priorita: jednotlivá komponenta (->sheetOnMobile() / ->mobileBreakpoint()) > searchable-auto-floating > globální konfigurace. Searchable selecty jsou defaultně plovoucí, aby vyhledávací pole zůstalo použitelné. Sheety automaticky přidávají safe-area padding, úchyt pro zavření tažením a focus trap.

touch i native mění prvek samotný, ne jeho panel, a pro všechny prvky platí jedno pořadí přednosti: ->native() (prvek prohlížeče všude) > ->touchOnMobile() / touch > ->nativeOnMobile() / native. touch vykreslí prvek dělaný pro palec — kolečko pro datum nebo čas, seznam v bottom sheetu s 48px řádky, 16px písmem a hledáním nahoře pro select — a na rozdíl od prvku prohlížeče si ponechá všechno, co pole umí: vzdálené hledání, vytvoření možnosti, zakázané dny. Viz dotykový seznam na telefonu a dotykové kolečko na telefonu.

native nemění panel prvku, ale prvek samotný. Každý select a picker, který má protějšek v prohlížeči — Select, BelongsToSelect, DateTimePicker, TimePicker, SelectFilter, TernaryFilter — vykreslí oba a CSS na stejném breakpointu ukáže pod ním prvek prohlížeče a nad ním vlastní prvek, takže se pro takové pole žádný sheet nekreslí. Prvek, který by přechodem o něco přišel, zůstává vlastní na každé obrazovce — select se vzdáleným hledáním nebo s vytvářením či úpravou možnosti; vše ostatní je nativní. Krok hodin se stane nativním <select> slotů (u data a času vedle nativního data), protože iOS step časového vstupu ignoruje, a meze pickerů hlídá server, protože kolečko telefonu je ignoruje. Explicitní ->native(false) pole z globálního přepínače také vyřadí; ->nativeOnMobile() ho vrátí zpět.

Průvodci

Kde si průvodce pamatuje, co o kom ví: které průvodce dokončil nebo přeskočil, ke kterému kroku došel v tom, který opustil v půlce, a které si odložil. Je to úložiště preferencí s vlastním výchozím driverem, session místo null, protože průvodce nad úložištěm, které zapomíná, by stejného člověka přerušoval při každém načtení stránky.

'tours' => [
    'postpone' => env('WIRE_TOURS_POSTPONE', 3),                 // „Odložit“, než se průvodce přestane ptát // 
 
    'preferences' => [
        'default' => env('WIRE_TOURS_DRIVER', 'session'),        // přihlášení uživatelé
        'guest' => env('WIRE_TOURS_GUEST_DRIVER', 'session'),    // hosté
        'drivers' => [
            'null' => NullPreferenceDriver::class,
            'session' => SessionPreferenceDriver::class,
            'database' => DatabasePreferenceDriver::class,       // „jednou provždy" — potřebuje migraci
        ],
    ],
],

postpone je počet, kolikrát smí být welcome blok průvodce odbyt tlačítkem „Odložit“, než se průvodce zaznamená jako viděný a přestane se ptát. Každé „Odložit“ ho položí na dobu dané session; nula tlačítko odstraní a průvodce může číslo přepsat přes ->postpone(int $times).

Panel průvodce se pod mobile.breakpoint výše přichytí ke spodnímu okraji obrazovky. Viz Tour → Zapamatování.

Forms

Konfigurace wire-forms řídí výchozí hodnoty data a času, zápis částek a telefonních čísel, uploady a toolbar rich editoru.

return [
    'date_format' => 'd.m.Y',
    'time_format' => 'H:i',
    'datetime_format' => 'd.m.Y H:i',
    'first_day_of_week' => 1,
 
    'money' => [                                            
        'currency' => 'CZK',
        'decimal_separator' => ',',
        'thousands_separator' => ' ',
    ],
 
    'phone' => [
        'countries' => [],
        'default_country' => null,
    ],                                                      
 
    'file_upload' => [
        'disk' => env('WIRE_FORMS_UPLOAD_DISK', 'public'),
        'directory' => 'uploads',
    ],
 
    'rich_editor' => [
        'toolbar' => [
            'bold', 'italic', 'underline', 'strike',
            'h2', 'h3',
            'bulletList', 'orderedList',
            'link', 'blockquote', 'codeBlock',
            'undo', 'redo',
        ],
    ],
];

money říká, jak MoneyInput zapíše částku, pokud pole neurčí jinak, a phone je nabídka PhoneInputu — prázdný seznam countries nabídne celou tabulku předvoleb a seznam je zároveň validací.

Pro přesun uploadů na jiný filesystem disk použijte WIRE_FORMS_UPLOAD_DISK:

WIRE_FORMS_UPLOAD_DISK=s3

Volby specifické pro pole viz Reference polí.

Table

Konfigurace wire-table řídí výchozí chování tabulky a chování inline text inputu.

return [
    'defaults' => [
        'per_page' => 10,
        'per_page_options' => [10, 25, 50, 100],
        'searchable' => true,
        'sortable' => true,
        'hoverable' => true,
        'striped' => false,
    ],
 
    'text_input' => [
        'save_on_blur' => true,
        'save_on_enter' => true,
        'live_validation' => false,
        'live_debounce' => 500,
    ],
 
    'notification_driver' => null,
];

notification_driver může zůstat jako null; tabulka pak použije driver, který určuje wire-core.notifications.default. Nastavte ho na třídu driveru jen když tabulky potřebují jiný.

Viz Přehled tabulek, Sloupce a Exporty.

Sortable

Konfigurace wire-sortable řídí řazení řádků.

return [
    'order_column' => 'sort_order',
    'sortablejs_cdn' => null,
    'animation' => 150,
    'user_model' => 'App\\Models\\User',
    'user_key_type' => 'id', // 'uuid' / 'ulid' pro neceločíselné klíče uživatele
];

sortablejs_cdn je ve výchozím stavu null, protože SortableJS je zkompilovaný přímo do bundlu balíčku — řazení nepotřebuje žádný CDN request, takže funguje offline i pod přísnou CSP. Nastavte ho jen tehdy, když váš vlastní kód potřebuje globální window.Sortable: tag se pak načte navíc k bundlu, nikdy místo něj, a drag controller používá zabundlovanou kopii tak jako tak.

Nastavte user_key_type na uuid nebo ulid (před spuštěním migrace pořadí sloupců), když váš model uživatele používá neceločíselný primární klíč.

Viz Instalace Sortable.

Routy a panely

Routy každého balíčku jsou skupina — panel (stránky resource), zones, tenant-entry a to, co přinesou nainstalované moduly (tenants, auth-codes) — a žádný provider žádnou neregistruje. Každou umisťuje aplikace: voláním Route::wire('panel') v routes/web.php uvnitř vlastní skupiny, nebo záznamem ve wire-core.routes, který zaregistruje jediný route soubor frameworku.

// config/wire-core.php
'routes' => [
    'defaults' => [],                  // pod každým záznamem
    'groups' => [                      
        'admin' => ['uses' => 'panel', 'prefix' => 'admin', 'middleware' => ['web', 'auth', 'can:admin']],
        'business' => ['uses' => 'panel', 'prefix' => 'business', 'only' => ['orders']],
    ],                                 
],

Záznam bere atributy skupiny Laravelu (prefix, domain, middleware, without_middleware, as, where, namespace, scope_bindings), can, vlastní volby skupiny a routes pro jednotlivé routy. Záznam pojmenovaný jinak než jeho skupina je zóna té skupiny. Ve výchozím stavu se neregistruje nic, panel začíná od ['web', 'auth'], takže záznam bez middlewaru je hlídaný, a skupiny z configu se matchují před routes/web.php.

wire-panels si nechává jen to, kam vedou dvě adresy — routes.zone_entry.primary a .view pro adresu nad zónami, routes.tenant_entry.view pro holou adresu tenantové zóny:

// config/wire-panels.php
'routes' => [
    'zone_entry' => ['primary' => null, 'view' => null],
    'tenant_entry' => ['view' => null],
],

Celou tabulku viz Routování § Popis skupin v configu, zóny Zóny.

Boost

Konfigurace wire-boost řídí MCP server AI nástrojů. Dva nástroje spouštějící kód jsou ve výchozím stavu vypnuté.

return [
    'server' => [
        'name' => 'WireStack Boost',
        'version' => '1.0.0',
    ],
    'tools' => [
        'database_query' => env('WIRE_BOOST_DATABASE_QUERY', false),
        'tinker' => env('WIRE_BOOST_TINKER', false),
        'browser_logs' => env('WIRE_BOOST_BROWSER_LOGS', true),
    ],
    'scan' => [
        'paths' => [app_path()], // kde list-wire-components hledá
    ],
    'docs' => [
        'paths' => [], // extra Markdown adresáře pro search-wire-docs
    ],
    'browser_logs' => [
        'path' => storage_path('wire-boost/browser.log'),
        'max_entries' => 50,
    ],
];

Zapněte database-query a tinker jen když důvěřujete agentovi připojujícímu se k serveru. Viz MCP Server a nástroje.

Audit

Nastavení audit logu žije v config/wire-core.php:

'audit' => [
    'enabled' => env('WIRE_AUDIT_ENABLED', true),
    'model' => \NyonCode\WireCore\Audit\AuditEntry::class,
    'user_model' => env('WIRE_AUDIT_USER_MODEL', 'App\\Models\\User'),
    'events' => null,
    'exclude_columns' => [
        'password',
        'remember_token',
    ],
    'retention_days' => null,
],

Nastavte events na pole, když chcete logovat jen vybrané typy událostí:

'events' => ['created', 'updated', 'deleted'],

Nastavení, použití modelu a prořezávání viz Audit Log.

Admin

Shell publikuje jediný blok a je to brand — všechno ostatní kolem něj je markup, který si napíšete (viz Admin shell):

// config/wire-admin.php
'brand' => [
    'name' => null,        // fallback je config('app.name')
    'logo' => null,        // široké menu — cesta pod public/, nebo URL
    'logo_dark' => null,   // tmavá varianta téhož
    'mark' => null,        // 64pixelová lišta — fallback je iniciála aplikace
    'height' => 28,        // vykreslená výška loga v pixelech
    'url' => null,         // kam brand odkazuje — výchozí je kořen panelu
],

Proč jsou podoby loga dvě a proč se volí dřív, než se stránka vykreslí: Branding a motiv.

Menu má jeden vlastní přepínač, filtr nad sebou — co dělá a proč to není druhé hledání: Sidebar.

// config/wire-admin.php
'layout' => [
    'navigation' => 'sidebar', // 'sidebar' | 'top' — viz Layout § Menu jako pruh
],
'navigation' => [
    'filter' => 'auto',        // 'auto' | 'always' | 'never'
    'filter_threshold' => 12,  // 'auto' ho ukáže od tolika řádků výš
],

Moduly

Každý hotový modul publikuje vlastní config a jeho klíče jsou popsané na stránce modulu, ne tady — modul je celá oblast a jeho volby dávají smysl vedle obrazovek, které mění:

Zbytek wire-core

Čtyři klíče v config/wire-core.php jsou deklarace, ne nastavení, a každý je popsaný tam, kde se vysvětluje věc, kterou deklaruje:

config/wire-table.php má ještě jeden: preferences volí driver, do kterého se ukládá pořadí sloupců pro každého uživatele, jejich viditelnost a velikost stránky (null, session nebo database, přičemž guest pojmenovává driver pro nepřihlášeného návštěvníka). Viz Pokročilé funkce.