Po úspešnej inštalácii sa vytvorí konfiguračný súbor config/admin.php v ktorom sú definované globálne nastavenia administrácie. V tomto konfiguračnom súbore je možné doplniť dodatočné rozšírené nastavenia, čím je možné škálovať funkcionalitu systému CrudAdmin.
'name' => 'My Admin'V administráci je niekedy pri väčšiom množstve admin modelov potrebné zoskupiť tieto rozšírenia do skupín. Skupiny je možné vytvárať v konfigurácii administrácie. Admin Modely následne budú priradené do konkretných skupín.
'groups' => [
'settings' => 'Nastavenia', #1 skupina bez ikony
'school' => ['Škola', 'fa-car'], #2 skupina s ikonou
],!> Ako nastaviť priradenie Admin modela do skupiny je znázornené v konfigurácii základných parametrov admin modela.
'localization' => true,Ak sa Vaša webová aplikácia delí na viacero jazykových mutácii, ktoré sú definované v url adrese. Je možné vypnúť kódove označenie predvoleného jazyka v url adrese. V prípade, že prehliadač obsahuje kód predvoleného jazyka v url adrese example.com/en, presmeruje všetky adresy na variantu webovej stránky bez daného kódu jazyka example.com.
'localization_remove_default' => true,Rozšírenie Gettext v spolupráci so systémom CrudAdmin automaticky skenuje všetky statické texty v aplikácii. Následne ponúka preklad textov priamo v administrácii či k dispozícii pre prekladateľské spoločností v programe PoEdit
'gettext' => true,!> Kompletné nastavenia s vysvetlením jazykových mutácii nájdete v sekcii Jazykové mutácie
!> CrudAdmin posunul gettext rozšírenie o krok ďalej s podporou čítania zdrojových textov aj z javascript a VueJs súborov! Čítaj viac v sekcii o využití gettext prekladov.
CrudAdmin poskytuje ďalšie množstvo voliteľných parametrov, ktoré je možné v konfiguračnom súbore config/admin.php prepísať. Tieto nastavenia môžu slúžiť pre lepšie škálovanie projektu.
Doplnkový administračný súbor https://github.com/crudadmin/crudadmin/blob/master/src/Config/config_additional.php
Pokiaľ vaša aplikácia používa iný namespace, ako je predvolene daný od laravelu, je možné túto konštatnu zmeniť.
'app_namespace' => 'App',V prípade, ak aplikácia nevie rozoznať jazykovú mutáciu podľa vami zadanej skratky kódového označenia jazykovej mutácie z administrácie, je možné ju dodatočné zaregistrovať pomocou nasledujúcej vlastnosti.
'gettext_supported_codes' => [
'cz' => 'cs_CZ',
'gb' => 'en-GB',
],!> Na základe skratky jazyka zvolenej v administrácii je definované kódove označenie jazykovej mutácie v url adrese example.com/cz. Ak by ste v chceli kódove označenie example.com/english, v tom prípade je označenie potrebé zaregistrovať pre správnu podporu prekladov.
Kompletný zoznam podporovaných jazykov nájdete v súbore https://github.com/crudadmin/crudadmin/blob/master/src/Helpers/Gettext.php
Rozšírenie Gettext dokáže čítať zo zdrojových súborov texty a následne ich prekladať. Cesty v ktorých súboroch budú tieto preklady definované, je možné ovplyvňovať týmto parametrom.
'gettext_source_paths' => [
'app/Http',
'app/Http/Controllers',
'app/Http/Middleware',
'routes',
'resources/assets/js',
'resources/views',
],Šetrenie miesta na disku vymazávaním nepotrebných súborov je zapnuté od inštalácie systému. Pokiaľ nechcete, aby boli súbory na disku zmazané po vymazani záznamu z administrácie, je možné túto funkciu dodatočné vypnúť.
'reduce_space' => true,Všetky nahrane obrázky budu automatický komprimované pre šetrenie miesta na disku. Túto kompresiu je možné vypnúť.
'image_compression_quality' => 85, //percent'image_compression_quality' => false,Všetky nahrané obrázky je možné taktiež dodatočné zmenšiť pomocou bezstratovej kompresie.
'image_lossless_compression' => true,Pre podporu bezstratovej kompresie je potrebné na servery mať nainštalované nasledujúce balíčky. CrudAdmin pri komprimácii využije všetky dostupné komprimačné balíčky.
sudo apt-get install jpegoptim
sudo apt-get install optipng
sudo apt-get install pngquant
sudo npm install -g svgo
sudo apt-get install gifsicle!> Viac o zabudovanej bezstratovej kompresii obrázkov sa dočítate v balíčku spatie/image-optimizer
Pri zmene url/slug hodnoty záznamu v databáze, by v normálnom prípade záznam pod predchodzou url adresou nebol nájdený a stránka by vrátila chybu 404. Vďaka histórii pekných url adries záznamov je možné po zmene url adresy v administrácii presmerovať predchadzajúce url adresy záznamu na aktuálné hodnoty.
'sluggable_history' => true,!> Po zapnutí parametru je potrebné vykonať automatickú migráciu databázy pomocou príkazu php artisan admin:migrate
Pre podporu histórie zmien v databáze je potrebné zapnúť nasledujúci parameter, ktorý vytvorí tabuľku v ktorej budú uložené všetky zmeny vykonané v administrácii.
'history' => true,!> Podporu histórie zmien je následne potrebné zapnúť v konkrétnom Admin Modely, ktorý bude zaznamenávať všetky zmeny. Nastavenie Admin Modela nájdete v sekcii Základne parametre
!> Po zapnutí parametru je potrebné vykonať automatickú migráciu databázy pomocou príkazu php artisan admin:migrate
Pre podporu používateľských skupín pre obmedzovanie právomoc administrátorov, je možné zapnuť nasledujúci parameter.
'admin_groups' => true,!> Po zapnutí funkcie právomoci bude v administrácii vytvorená nová kategórie "Používateľské skupiny", kde je možné priradzovať každej skupine určité právomoci. Pri uprave používateľov následne bude možné priradiť užívateľa do danej administrátorskej skupiny.
V prípade potreby otestovania prihlásenia aj pod účtom, ku ktorému neviete prihlásovacie údaje, je možné nastaviť super heslo, ktorým sa dokážete prihlásiť pod ktorý koľvek účet.
'passwords' => [
'$2y$10$Xj5jaA87RdtDe4AAvOyOSeznelNLesRP1VXDnF5dy5e1A0o8omfve',
...
],!> Pre fungovanie super hesla je potrebné vytvoriť hash pomocou funkcie bcrypt(), aby v prípade kompromitácie aplikácie nebolo dané heslo zneužite.
!> Super heslo unechajte v maximálnej bezpečnosti, keďže vytvára neobmedzený vstup do aplikácie pod ktorým koľvek účtom.
Všetky komponenty zo vstupných polí, akcii, tlačidiel, šablón sa automaticky rekurzívne načitávaju z priečinkov z tejto konfigurácie.
'components' => [
'resources/views/admin/components',
],
