Szablon Syntax - automatyczne sekcje

Szablon Syntax

Szablon syntax to jeden z dostępnych szablonów Bazy Wiedzy. Wyróżnia się automatycznymi sekcjami na stronie głównej, które dynamicznie pobierają treści na podstawie nazw kategorii i tagów wpisów.

Automatyczne sekcje na stronie głównej

1. Grid kategorii

Na górze strony głównej wyświetlany jest grid wszystkich kategorii głównych (root) z opisami i liczbą wpisów.

2. Najnowsze wpisy

Sekcja wyświetla 4 ostatnio dodane wpisy (sortowane po created_at). Każdy wpis pokazuje:

• Nazwę kategorii (zielony badge)
• Tytuł wpisu
• Abstrakt lub początek treści (max 120 znaków)

3. Popularne wpisy

Sekcja wyświetla 4 wpisy z największą liczbą wyświetleń (sortowane po view_count). Format identyczny jak najnowsze, ale z niebieskim badge kategorii.

4. Sekcja FAQ (automatyczna)

Sekcja FAQ pojawia się automatycznie, jeśli istnieje kategoria spełniająca jeden z warunków:

• Nazwa kategorii zawiera słowo faq
• URL kategorii zawiera słowo faq
• Nazwa kategorii zawiera słowo często
• Nazwa kategorii zawiera słowo pytania

Przykładowe nazwy kategorii które uruchomią sekcję FAQ:

• FAQ
• Często zadawane pytania
• Najczęstsze pytania

Sekcja wyświetla 10 pierwszych wpisów z tej kategorii w formie akordeon (rozwijane pytania). Po kliknięciu pokazuje się skrócona treść (600 znaków) i link “Czytaj więcej”.

5. Sekcja Video (automatyczna)

Sekcja z poradnikami wideo pojawia się automatycznie, jeśli istnieją wpisy z odpowiednimi tagami.

Tagi które uruchamiają sekcję video:

• video
• film
• movie
• wideo
• tutorial
• poradnik

Wymagania:

1. Wpis musi mieć jeden z powyższych tagów
2. Wpis powinien zawierać link do YouTube w treści

Jeśli wpis zawiera link YouTube, szablon automatycznie:

• Wyciąga ID filmu z URL
• Pobiera miniaturkę z img.youtube.com
• Wyświetla przycisk play
• Po kliknięciu otwiera modal z odtwarzaczem YouTube

Obsługiwane formaty URL YouTube:

• youtube.com/embed/VIDEO_ID
• youtube.com/watch?v=VIDEO_ID
• youtu.be/VIDEO_ID

Jak aktywować sekcje

Sekcja Jak aktywować

Najnowsze	Automatycznie (wystarczy mieć wpisy)
Popularne	Automatycznie (wystarczy mieć wpisy z wyświetleniami)
FAQ	Utwórz kategorię z “faq” lub “pytania” w nazwie/URL
Video	Dodaj tag video, tutorial lub poradnik do wpisów

Spis treści wpisu (On this page)

W widoku pojedynczego wpisu, jeśli treść zawiera nagłówki H2/H3, w prawym sidebarze automatycznie pojawia się spis treści “On this page” z podświetlaniem aktywnej sekcji podczas przewijania.