Konečne s.r.o.
Vzhľad

Dokumentácia

Kompletný prehľad našich modulov a ich funkcionalít. Zistite, ako efektívne využívať jednotlivé funkcie pre váš projekt.

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".

Konfiguračná premenná
BLOG_ROUTE_PREFIX
Predvolená hodnota: blog

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.

Konfiguračná premenná
BLOG_LOCALE_BASED
Predvolená hodnota: vypnuté

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í.

Konfiguračná premenná
BLOG_TRANSLATABLE
Predvolená hodnota: vypnuté (zachová sa pôvodná funkčnosť)

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é

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
  • Ak preklad chýba, zobrazí sa predvolený jazyk
  • 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).

Konfiguračná premenná
BLOG_SUPPORTED_LOCALES
Predvolená hodnota: sk|en|de

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

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.

Konfiguračná premenná
lang/vendor/blog/{locale}/blog.php
Predvolená hodnota: Blog

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.

Konfiguračná premenná
BLOG_INDEX_STYLE
Predvolená hodnota: grid

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.

Konfiguračná premenná
BLOG_BG_COLOR, BLOG_CARD_BG_COLOR
Predvolená hodnota: šedá (gray-50 / gray-950)

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.

Konfiguračná premenná
BLOG_STORAGE_DISK
Predvolená hodnota: local

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.

Konfiguračná premenná
CDN_URL
Predvolená hodnota: žiadne

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.

Konfiguračná premenná
BLOG_SITE_NAME, BLOG_SITE_URL
Predvolená hodnota: názov vašej aplikácie

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ť.

Konfiguračná premenná
BLOG_KEYWORDS_ENABLED
Predvolená hodnota: zapnuté

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.

Konfiguračná premenná
BLOG_GALLERY_MAX_IMAGES
Predvolená hodnota: 50 obrázkov

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

Systém štítkov (Tags)

Nová funkcia, ktorá vám umožňuje organizovať články pomocou štítkov (tagov). Každý článok môže mať jeden alebo viac štítkov, čo umožňuje kategorizáciu a filtrovanie obsahu. Štítky sú základom pre multi-inštančný blog.

Príklady nastavenia:

Vytvorenie štítku

V administrácii: Tags → Create new → zadajte názov "Novinky"

Priradenie k článku

Pri úprave článku vyberte štítky v sekcii "Tags"

Viac štítkov

Článok môže byť v "Novinky" aj "Produkty" súčasne

Hlavné funkcie:

  • Vytvárajte ľubovoľné štítky (napr. "novinky", "galéria", "produkty")
  • Každý článok môže mať viac štítkov naraz
  • Články sa dajú filtrovať podľa štítkov
  • Štítky majú automaticky generovaný URL slug
  • Správa štítkov cez Filament administráciu
  • Štítky sa zobrazujú ako farebné odznaky v zozname článkov

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.

Konfiguračná premenná
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.

Konfiguračná premenná
config/blog.php

Príklady nastavenia:

Príklad konfigurácie

'instances' => ['oznamy' => ['prefix' => 'oznamy', 'tag' => 'news', 'style' => 'list', 'per_page' => 10]]

Dve inštancie

Novinky na /oznamy (list) + Galéria na /fotogaleria (grid)

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)
  • 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úť.

Konfiguračná premenná
config/blog.php → default_instance
Predvolená hodnota: zapnuté, zobrazuje články bez štítkov

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