Konfigurácia
Technické nastavenia blogu. Prispôsobte URL adresy, farby, ukladanie obrázkov a ďalšie pokročilé možnosti podľa vašich potrieb.
Nastavenie URL adresy blogu
Určuje, na akej webovej adrese bude váš blog dostupný. Napríklad ak nastavíte "aktuality", váš blog bude na www.vasastranka.sk/aktuality. Základné nastavenie je "blog".
BLOG_ROUTE_PREFIX
Príklady nastavenia:
blog
www.vasastranka.sk/blog
aktuality
www.vasastranka.sk/aktuality
clanky
www.vasastranka.sk/clanky
Viacjazyčné URL adresy
Ak máte web v viacerých jazykoch (napríklad slovenčina, angličtina, nemčina), môžete zapnúť podporu pre jazykové URL adresy. Blog sa potom zobrazí v príslušnej jazykovej verzii podľa adresy.
BLOG_LOCALE_BASED
Príklady nastavenia:
true
Zapnuté - blog bude na /sk/blog, /en/blog, /de/blog
false
Vypnuté - blog bude len na /blog
Viacjazyčný obsah článkov
Nová funkcia, ktorá vám umožňuje napísať každý článok vo viacerých jazykoch. Namiesto vytvárania samostatných článkov pre každý jazyk, môžete mať všetky jazykové verzie v jednom článku. Systém automaticky zobrazí správnu jazykovú verziu podľa toho, akú stránku návštevník vidí.
BLOG_TRANSLATABLE
Príklady nastavenia:
Zapnutie
Nastavte BLOG_TRANSLATABLE=true a spustite migráciu databázy
V administrácii
Pri úprave článku uvidíte záložky SK, EN, DE - vyplňte každú samostatne
Pre návštevníkov
Na /sk/blog uvidia slovenské články, na /en/blog anglické
Fallback správanie
Ak článok nemá DE preklad, na /de/blog sa zobrazí SK verzia
Hlavné funkcie:
- Jeden článok vo viacerých jazykoch (slovenčina, angličtina, nemčina)
- Prekladateľné polia: názov, URL, popis, Google popis, obsah článku
- V administračnom paneli sa zobrazia záložky pre každý jazyk
- Automatické prepínanie jazyka podľa URL adresy návštevníka
- Každý jazyk môže mať vlastnú URL (napr. /sk/zahrada vs /en/garden)
- Obrázky a galérie sú zdieľané naprieč všetkými jazykmi
- Inteligentný fallback - ak preklad chýba, zobrazí sa záložný jazyk
- Žiadne 404 chyby - články sú vždy dostupné vo všetkých jazykoch
- Nulový dopad na existujúce články - funkcia je voliteľná
Podporované jazyky
Určuje, ktoré jazyky sú dostupné pre viacjazyčný obsah. Môžete podporovať ľubovoľnú kombináciu jazykov. Štandardne sú nastavené slovenčina (sk), angličtina (en) a nemčina (de).
BLOG_SUPPORTED_LOCALES
Príklady nastavenia:
sk|en|de
Slovenčina, angličtina, nemčina (štandardné nastavenie)
sk|en
Len slovenčina a angličtina
sk|cs|pl
Slovenčina, čeština, poľština
en|es|fr
Angličtina, španielčina, francúzština
Záložný jazyk (Fallback)
Dôležité nastavenie pre viacjazyčné stránky. Ak článok nemá preklad v aktuálnom jazyku (napríklad nemčine), systém automaticky zobrazí obsah v záložnom jazyku (napríklad slovenčine). Návštevník tak nikdy neuvidí prázdnu stránku alebo chybu 404.
BLOG_FALLBACK_LOCALE
Príklady nastavenia:
BLOG_FALLBACK_LOCALE=sk
Slovenčina ako záložný jazyk (štandardné)
BLOG_FALLBACK_LOCALE=en
Angličtina ako záložný jazyk
Príklad použitia
Článok existuje len v SK. Návštevník na /de/blog vidí SK obsah.
Hlavné funkcie:
- Automatické zobrazenie obsahu v záložnom jazyku, ak preklad chýba
- Funguje pre všetky prekladateľné polia (názov, popis, obsah, URL)
- Návštevník na /de/blog stále vidí články, aj keď sú len v slovenčine
- URL adresy sa automaticky prepoja na existujúci preklad
- Žiadne 404 chyby pre články bez prekladu
- Obrázky a galérie sa zobrazujú vždy (nie sú jazykovo závislé)
Zapnutie/Vypnutie záložného jazyka
Môžete si vybrať, či chcete používať záložný jazyk alebo nie. Ak je vypnutý, články bez prekladu v aktuálnom jazyku sa jednoducho nezobrazia. Toto je užitočné, ak chcete mať prísne oddelený obsah pre každý jazyk.
BLOG_USE_FALLBACK
Príklady nastavenia:
true
Zapnuté - články bez prekladu sa zobrazia v záložnom jazyku
false
Vypnuté - články bez prekladu sa nezobrazia (prísne oddelenie)
Ako funguje záložný jazyk
Detailné vysvetlenie správania systému pri chýbajúcich prekladoch. Systém používa inteligentnú logiku na nájdenie najlepšieho dostupného obsahu pre návštevníka.
Príklady nastavenia:
Scenár 1
Článok má SK a EN preklad. Návštevník na /de/blog vidí SK verziu.
Scenár 2
Článok má len EN preklad. Návštevník na /sk/blog vidí EN verziu.
Scenár 3
Článok má všetky preklady. Každý návštevník vidí svoju jazykovú verziu.
URL správanie
Odkaz /de/blog/slovensky-clanok funguje aj keď nemecký preklad neexistuje.
Hlavné funkcie:
- 1. Systém najprv hľadá obsah v aktuálnom jazyku návštevníka
- 2. Ak obsah neexistuje, použije sa nastavený záložný jazyk (fallback_locale)
- 3. Ak ani ten neexistuje, použije sa prvý dostupný preklad
- URL adresy fungujú rovnako - ak nemecká URL neexistuje, použije sa slovenská
- SEO tagy sa automaticky prispôsobia zobrazenému jazyku
- V zozname článkov sa zobrazia všetky články (s fallback obsahom)
Názov stránky blogu (SEO title)
Názov stránky blogu, ktorý sa zobrazuje v záložke prehliadača a vo výsledkoch Google pre hlavnú stránku blogu (/blog). Tento názov môžete prispôsobiť pre každý jazyk samostatne úpravou prekladových súborov.
lang/vendor/blog/{locale}/blog.php
Príklady nastavenia:
SK: title => Aktuality
Pre slovenčinu sa zobrazí "Aktuality" v záložke prehliadača
EN: title => News
Pre angličtinu sa zobrazí "News"
DE: title => Aktuelles
Pre nemčinu sa zobrazí "Aktuelles"
Hlavné funkcie:
- Automatický preklad názvu stránky podľa aktuálneho jazyka
- Súbory sa nachádzajú v lang/vendor/blog/{sk,en,de}/blog.php
- Kľúč "title" určuje SEO názov v záložke prehliadača
- Kľúč "description" určuje SEO popis stránky
- Po úprave spustite: php artisan optimize:clear
Vzhľad blogu
Môžete si vybrať, či chcete zobraziť články v mriežke (s veľkými obrázkami) alebo v zozname (kompaktnejšie zobrazenie). Takisto môžete prispôsobiť farby blogu tak, aby ladili s farbami vašej stránky.
BLOG_INDEX_STYLE
Príklady nastavenia:
grid
Mriežka - články vedľa seba s veľkými obrázkami (moderný vzhľad)
list
Zoznam - články pod sebou, kompaktnejšie (viac článkov na obrazovke)
Prispôsobenie farieb
Prispôsobte farby blogu tak, aby ladili s farbami vašej značky. Môžete nastaviť farbu pozadia stránky a farbu kariet (boxov) s článkami, samostatne pre svetlý a tmavý režim.
BLOG_BG_COLOR, BLOG_CARD_BG_COLOR
Príklady nastavenia:
white, white
Čisto biele pozadie s bielymi kartami
gray-50, white
Svetlo šedé pozadie s bielymi kartami (odporúčané)
slate-50, slate-100
Tmavšie šedé tóny
Ukladanie obrázkov
Určuje, kde sa budú ukladať obrázky z vašich článkov. Môžete ich ukladať na vlastnom serveri alebo použiť cloudové úložisko (napríklad DigitalOcean Spaces, Amazon S3) pre rýchlejšie načítanie a profesionálnejší prístup.
BLOG_STORAGE_DISK
Príklady nastavenia:
local
Miestne úložisko - obrázky sa ukladajú na vašom serveri
digitalocean
DigitalOcean Spaces - cloudové úložisko s CDN (rýchlejšie)
s3
Amazon S3 - cloudové úložisko od Amazonu
CDN (Content Delivery Network)
CDN je služba, ktorá urýchľuje načítavanie obrázkov pre vašich návštevníkov po celom svete. Obrázky sa automaticky poskytujú z najbližšieho servera. Toto nastavenie je voliteľné – funguje aj bez CDN.
CDN_URL
Príklady nastavenia:
https://cdn.vasastranka.sk
Vlastné CDN - obrázky sa načítajú cez vašu CDN adresu
prázdne
Bez CDN - obrázky sa načítajú priamo zo servera
SEO nastavenia
SEO (Search Engine Optimization) pomáha, aby vaše články lepšie nachádzali ľudia na Google a iných vyhľadávačoch. Nastavte základné informácie o vašom webe, ktoré sa automaticky použijú pri zdieľaní článkov na sociálnych sieťach.
BLOG_SITE_NAME, BLOG_SITE_URL
Hlavné funkcie:
- Automatické SEO názvy a popisy pre každý článok
- OpenGraph tagy pre pekné náhľady na Facebooku a LinkedIn
- Twitter Card tagy pre Twitter/X
- Automatické kanonické URL (pomáha Google pochopiť správnu verziu stránky)
- Štruktúrované dáta pre lepšie zobrazenie vo vyhľadávačoch
Automatické kľúčové slová
Systém dokáže automaticky extrahovať dôležité kľúčové slová z vášho článku. Tieto slová pomáhajú s SEO a čitateľom lepšie pochopiť, o čom článok je. Nie je potrebné ich manuálne písať.
BLOG_KEYWORDS_ENABLED
Príklady nastavenia:
true
Zapnuté - kľúčové slová sa automaticky vytvoria pri uložení článku
false
Vypnuté - kľúčové slová sa nevytvárajú
Nastavenia obrázkov
Každý článok môže mať hlavný obrázok (zobrazuje sa v náhľade článku) a špeciálny obrázok pre sociálne siete (zobrazuje sa pri zdieľaní na Facebooku, LinkedIn, atď.). Systém automaticky upraví obrázky na správnu veľkosť.
Hlavné funkcie:
- Hlavný obrázok - pomer strán 16:9 (širokoúhlý formát, ideálny pre moderný web)
- Sociálny obrázok - rozmer 1200x630 pixelov (optimálne pre Facebook, LinkedIn, Twitter)
- Automatické vytvorenie menších verzií (náhľady) pre rýchle načítanie
- Podpora formátov: JPEG, PNG, WebP, GIF
- Maximálna veľkosť súboru: 5 MB
- Automatická optimalizácia pre web (kompresia)
Fotogalérie
Ku každému článku môžete pridať fotogalériu s až 50 obrázkami. Návštevníci si môžu fotky prezerať v plnej veľkosti s pekným efektom (lightbox), prechádzať medzi nimi pomocou šípok na klávesnici a čítať popisy obrázkov.
BLOG_GALLERY_MAX_IMAGES
Hlavné funkcie:
- Až 50 obrázkov v jednej galérii
- Automatické vytvorenie náhľadov (300x300, 800x800, 1600x1600 pixelov)
- Voliteľné popisy k jednotlivým obrázkom
- Plynulé animácie a moderný vzhľad
- Prezeranie na celú obrazovku s klávesovou navigáciou (← →)
- Optimalizované pre mobilné zariadenia
Vyhľadávanie v článkoch
Systém umožňuje vyhľadávanie v obsahu vašich článkov. Návštevníci môžu zadať kľúčové slovo a nájsť všetky relevantné články. Vyhľadávanie funguje aj s chybami v písaní a hľadá aj v podobných slovách.
BLOG_SEARCH_ENABLED
Príklady nastavenia:
true
Zapnuté - návštevníci môžu vyhľadávať v článkoch
false
Vypnuté - vyhľadávanie nie je dostupné
Multi-inštančný blog (Instances)
Pokročilá funkcia, ktorá vám umožňuje mať viacero nezávislých blogových sekcií na jednej stránke. Každá inštancia môže mať vlastnú URL adresu, štýl zobrazenia a filtrovanie podľa štítku. Ideálne pre stránky, ktoré potrebujú napríklad sekciu "Novinky" a "Fotogaléria" oddelene.
config/blog.php → instances
Príklady nastavenia:
/oznamy
Inštancia pre novinky - štýl "list", filtrovaná štítkom "news"
/fotogaleria
Inštancia pre galérie - štýl "grid", filtrovaná štítkom "gallery"
/blog
Predvolená inštancia pre články bez štítkov
Hlavné funkcie:
- Neobmedzený počet blogových sekcií na jednej stránke
- Každá inštancia má vlastnú URL adresu (napr. /oznamy, /fotogaleria)
- Rôzne štýly zobrazenia pre každú inštanciu (mriežka alebo zoznam)
- Filtrovanie článkov podľa štítku
- Voliteľný počet článkov na stránku pre každú inštanciu
- Predvolená /blog stránka pre články bez štítkov (voliteľné)
- Plná podpora SEO pre každú inštanciu
- Zdieľaná administrácia - všetky články na jednom mieste
Konfigurácia inštancií
Inštancie sa konfigurujú v súbore config/blog.php. Každá inštancia má svoj kľúč (identifikátor) a nastavenia ako prefix URL, štítok pre filtrovanie, štýl zobrazenia a počet článkov na stránku.
config/blog.php
Príklady nastavenia:
Príklad konfigurácie
'instances' => ['oznamy' => ['prefix' => 'oznamy', 'tag' => 'news', 'style' => 'list', 'per_page' => 10, 'label' => 'Novinky']]
Dve inštancie
Novinky na /oznamy (list) + Galéria na /fotogaleria (grid)
Label v breadcrumbs
Ak nastavíte label, v navigácii sa zobrazí "Domov > Novinky > Článok" namiesto "Domov > Blog > Článok"
Registrácia v Filament
Pridajte TagResource do AdminPanelProvider
Hlavné funkcie:
- prefix - URL adresa inštancie (napr. "oznamy" → /oznamy)
- tag - slug štítku pre filtrovanie článkov (napr. "news")
- style - štýl zobrazenia: "grid" (mriežka) alebo "list" (zoznam)
- per_page - počet článkov na stránku (predvolene 12)
- label - názov sekcie v breadcrumbs (napr. "Novinky", "Fotogaléria")
- layout - voliteľný vlastný layout pre inštanciu
Predvolená inštancia (/blog)
Keď máte nakonfigurované inštancie, môžete si vybrať, či chcete zachovať aj predvolenú /blog stránku. Ak áno, zobrazí sa na nej články bez akýchkoľvek štítkov. Môžete ju aj úplne vypnúť.
config/blog.php → default_instance
Príklady nastavenia:
enabled => true
Predvolená /blog stránka je zapnutá
enabled => false
Predvolená /blog stránka je vypnutá (len inštancie)
show_untagged_only => true
Na /blog sa zobrazujú len články BEZ štítkov
show_untagged_only => false
Na /blog sa zobrazujú všetky články