Každý Admin Model pozostáva z parametrov, ktoré definujú správanie generovania sa komponentov v administrácii. Admin Model po vytvorení obsahuje základné najpoužívanejšie parametre, ktoré môže programátor upraviť, vymazať alebo doplniť.
!> Pri všetkých konfiguráciach parametrov, ktoré sú reprezentované vytvorením stĺpca v databáze, či zmenu už existujúceho stĺpca alebo jeho vlastnosti, je potrebne vykonať
automatickú migráciu databázy pomocou príkazu v php artisan admin:migrate, ktorý automatický a inteligentne synchronizuje celú relačnú databázu.
Zoznam a nastavenie všetkých stĺpcov v databáze, vstupov vo formulároch, validácia, dáta vo vypíse záznamov sú reprezentované parametrom $fields.
protected $fields = [
'name' => 'name:Názov|placeholder:Zadajte názov článku|type:string|required|max:90',
'content' => 'name:Obsah článku|type:editor|required',
'image' => 'name:Obrazok autora|type:file|image',
'countries' => 'name:Zoznam krajín|type:select|options:Slovak,Czech,English',
];Pri dynamickom generovaní parametrov, je možné pozmeniť pravidla pre ukladanie záznamu, kde sa ako parameter funkcie vráti práve upravovaný záznam v databáze.
?> V nasledujúcom príklade je znázornené, že pri úprave existujúceho záznamu, chceme aplikovať výnimku validácie unikátnej emailovej adresy pre upravovaný záznam.
public function fields($row)
{
return [
'username' => 'name:Meno a priezvisko|type:string|required',
'email' => 'name:Email|email|required|unique:users,email,'.(isset($row) ? $row->getKey() : 'NULL'),
];
}!> Pri akej koľvek zmene v týchto nastaveniach, ktoré súvisia s nastavením databázy je potrebne vykonať automatickú migráciu
pomocou príkazu php artisan admin:migrate, ktorá inteligentne a automatický synchronizuje celú databázu.
?> Kompletné informácie o nastavení vstupných hodnôt nájdete v sekcii zoznam vstupných hodnôt.
Medzi základnú konfiguráciu Admin Modelu patria parametre ako názov, popis a ostatné bežné nastavenia.
Jeden z povinných parametrov je $migration_date v ktorom je zadefinovaný dátum a čas vytvorenia modelu. Pomocou tohto dátumu
bude administrácia zoradzovať rozšírenia a vyskládavať štruktúru administrácie v správnom poradí.
protected $migration_date = '2017-11-05 10:00:00';!> Povinný parameter, automaticky vygenerovaný.
!> Jeden rovnaký dátum môže obsahovať maximálne 1 Admin Model.
Názov sekcie v administrácii je definovaný pomocou parametru $name.
protected $name = 'Články';
!> Povinný parameter, automaticky vygenerovaný.
Popis sekcie v administrácii je definovaný pomocou nepovinného parametru $title.
protected $title = 'Upravte zoznam článkov v sekcii blog.';
Admin Model v administrácii je možné priradiť do podskupiny, ktorú je možné definovať pri konfigurácii systému.
protected $group = 'settings';
Povolenie unikatného prekladu obsahu pre každú jazykovú mutáciu na web stránke.
protected $localization = true;!> V administrácii budú ku každému rozšíreniu priradené unikátne záznamy každej jazykovej mutácie.
!> V tabuľke rozšírenia sa automatický vytvorí cudzí kľúč medzi tabuľkou languages, ktorá obsahuje zoznam dostupných jazykov.
?> Viac o preklade záznamov a textu nájdete v sekcii jazykové mutácie.
Pre vetvenie obsahu existuje parameter $belongsToModel, ktorý definuje vzťah medzi dvoma alebo viacerými Admin Modelmi.
protected $belongsToModel = Article::class;Pri kombinacii, ak je model dieťaťom viacerých Admin Modelov zároveň, je možné parameter zapísať vo forme poľa.
protected $belongsToModel = [Article::class, News::class, Blog::class];!> V databáze sa medzi tabuľkami automatický vytvoria cudzé kľúče.
?> Viac o reláciach a vetvení obsahu nájdete v sekcii databázové relácie.
Pre automatické generovanie url adries podľa hodnoty stĺpca je možné použiť parameter $sluggable.
Vhodné pre obsah, ktorý obsahuje v url adrese naformatovanú hodnotu zo stĺpca pomocou ktoréj je možné vyhľadať záznam z databázy.
protected $sluggable = 'field-name';!> V databáze sa v tabuľke vytvorí stĺpec slug, ktorý bude obsahovať hodnotu z požadovaného stĺpca bez diakritiky a v tvare nice url adresy.
?> Viac o generovaní url adries pre hodnoty v modely a ich následne vyhľadávanie nájdete v sekcii pekné url.
Pre ukládanie zmien v administrácii pri záznamoch je možné zapnúť históriu zmien, pomocou nasledujúceho parametru.
protected $history = true;
!> Pre fungovanie histórie zmien je potrebné v konfigurácii administrácie zapnúť históriu zmien.
Pri potrebe tabuľky v databáze, bez nutnosti generovania admininistračného rozhrania alebo jednoduchého skrytia rozšírenia v administrácii je možné ho deaktivovať
nastavením hodnoty na false.
protected $active = true;Ak je vaš Admin Model napojený na už existujúcu tabuľku v databáze, ktorá kolaboruje s iným projektom a obsahuje ďalšie stĺpce, ktoré nie sú definované v Admin modely, v tomto prípade vieme zadefinovať ignorovanie týchto sĺpcov pomocou nasledujúceho parametru.
protected $skipDropping = ['column_x', 'column_y'];Každá funkcionalita potrebuje vlastné nastavenia obsahu. Ako je maximálny alebo minimálny počet záznamov, povolenie zoradzovania záznamov (drag&drop), povolenie publikácie či mazania záznamov. Všetky tieto úkony je možné spravovať pomocou nasledujúcich parametrov.
Pre zakázanie pridavania nových záznamov v danej sekcii je potrebné nastaviť hodnotu na false.
protected $insertable = true;Pre zakázanie upravovania už existujúcich záznamov v danej sekcii je potrebné nastaviť hodnotu na false.
protected $editable = true;Pre zakázanie mazania existujúcich záznamov v danej sekcii je potrebné nastaviť hodnotu na false.
protected $deletable = true;Pre povolenie publikácie a skrývania záznamov v danej sekcii je potrebné nastaviť hodnotu na true.
protected $publishable = true;!> V databáze sa v tabuľke automatický vytvorí stĺpec published_at, ktorý definuje stav publikácie záznamu.
Pre zakázanie presúvania záznamov pomocou drag&drop je potrebné nastaviť hodnotu na false. Táto funkcionalita je automatický zapnutá
pri všetkých admin modeloch.
protected $sortable = true;!> V databáze sa v tabuľke automatický vytvorí stĺpec _order, ktorý definuje poradie záznamu.
!> Pri výbere záznamov z databázy pomocou Eloquent Modelu je poradie záznamov automaticky zoradené.
Po prekročeni alebo dosiahnuti minimálneho limitu počtu záznamov v databáze administrácia skryje možnosť mazania existujúcich záznamov.
protected $minimum = 0;!> Hodnota 0 reprezentuje pravidlo bez limitu.
Po prekročeni alebo dosiahnuti maximálneho počtu záznamov v databáze, administrácia skryje možnosť pridania nových záznamov.
protected $maximum = 0;!> Hodnota 0 reprezentuje pravidlo bez limitu.
Pre aktiváciu do jedno záznamového režimu rozhrania existuje parameter single, ktorý nastaví parameter $minimum a $maximum na hodnotu 1.
V tomto režime sa v administrácii skryje tabuľka s výpisom záznamov, a podstránka bude obsahovať len formulár pre úpravu jedneho záznamu.
protected $single = false;!> Pri aktivácii režimu, budu parametre $minimum a $maximum automatický nastavené na hodnotu 1.
Parameter $sortable a $publishable bude nastavený na false, s čim súvisi migrácia databázy.
?> Vhodné pre uloženie informácii do statických podstránok, ako je podstránka O nás, Kontakt, či úpravu konfiguráčných prvkov aplikácie, ktoré nepotrebujú viac záznamov v tabuľke...
Model taktiež obsahuje doplnkové parametre, ktoré sa zameriavajú na úpravy konkretných funkcionalít fungovania admin modela. Ide o nastavenia textov formulárov, nastavenia pravidiel tabuliek a ďalší zoznam podobných nastavení.
Tieto parametre sa definujú v parametri $settings, alebo metóde settings().
protected $settings = [
'columns.colum_name' => [
'name' => 'XYZ',
'hidden' => true,
],
'columns.other_column.name' => 'My column name'
...
];?> Nastavenia je možné defínovať rekurzívnym poľom, alebo kľúčmi odďelujucími zanorenie bodkou.
Pre úpravy textov pri vytvárani alebo úprave záznamov, je možné využiť nasledujúce nastavenia.
protected $settings = [
'title' => [
'create' => 'Nový záznam',
'update' => 'Upravujete záznam č. :id',
],
'buttons' => [
'insert' => 'Vytvoriť nový záznam',
'create' => 'Odoslať nový záznam',
'update' => 'Upraviť starý záznam',
],
];Pre úpravy nastavení vlastnosti stĺpcov, je možné použiť nasledujúce parametre pre ich skrývanie, zmenu limitu dĺžky textu, či zmeny ich predvoleného názvu.
protected $settings = [
'columns' => [
'field1' => [
'name' => 'Názov stĺpca pre pole x',
'limit' => 4,
],
'field2.name' => 'Názov stĺpca pre pole y',
'field2.after' => 'field1',
'field3' => [
'before' => 'field1'
],
],
];Pre pridanie nových stĺpcov, ktoré nenesú žiadnú hodnotu z existujúceho sĺpca z databázy, je možne vytvoriť nový stĺpec a priradiť mu ľubovoľnú hodnotu, poprípade ľubovoľný HTML kód, ktorý bude následne vykreslený.
protected $settings = [
'columns' => [
'price_vat' => [
'name' => 'My field',
'after' => 'field1',
],
'paid_status' => [
'name' => 'Status',
'encode' => false,
],
],
];public function setAdminAttributes($attributes = [])
{
$attributes['price_vat'] = ($this->price * 1.2) . ' €';
$attributes['paid_status'] = $this->paid_at ? '<i class="fa fa-check green"></i>' : '<i class="fa fa-times unpaid"></i>';
return $attributes;
}Tlačidla do postraného panela záznamov, kde sa nachádzaju tlačidla s vymazaním záznamu, publikácie, je možné dodatočné pridať pomocou vlastnosti $buttons.
protected $buttons = [
App\Admin\Buttons\MyButton::class
];!> Kompletny návod ako tieto tlačidla nastaviť, nájdete v sekcii Vlastné akcie a tlačidla.
Rozhranie administrácie je možné dpĺniať a ďalej kustomizovať, pomocou doplnkových snipetov, ktoré rozširujú funkcionalitu existujúcich admin komponent.
protected $layouts = [
App\Admin\Layouts\MyFormLayout::class
];!> Kompletny návod ako tieto šablóny nastaviť, nájdete v sekcii Snipety šablón.