Kompletný sprievodca: Branike KB (príručka)

1. Čo to je a na čo slúži

Branike KB je vyhľadateľná príručka na vašom webe — databáza návodov a odpovedí, v ktorej zákazník nájde riešenie skôr, než vám napíše. Odborne sa tomu hovorí vedomostná základňa (knowledge base). Presne na tomto plugine beží aj príručka na branike.com, ktorú práve čítate.

Pri každom článku si zvolíte, kto ho uvidí: všetci, len prihlásení, alebo len členovia s určitou úrovňou členstva. Príručka má vlastnú úvodnú stránku s vyhľadávaním, stránky kategórií s bočným stromom a stránku článku so súvisiacimi článkami.

2. Pre koho a kedy

• Kto predáva produkt alebo službu — a odpovedá na tie isté otázky dokola.
• Členská zóna — časť návodov len pre prihlásených.
• Interná dokumentácia — postupy pre tím, viditeľné len po prihlásení.
• Podpora — namiesto dlhého e-mailu pošlete odkaz.

3. Čo očakávať — a čím sa líši od kurzov

Príručka je referenčná: človek príde s otázkou, nájde odpoveď a odíde. Kurz v Branike LMS je štruktúrované vzdelávanie s postupom a sledovaním pokroku. Dopĺňajú sa — kurz učí od začiatku, príručka odpovedá na to, čo sa vynorí neskôr.

Čo príručka zámerne nerobí: nezaznamenáva, čo návštevníci hľadali, a zamknutý článok neskrýva pred zoznamom — len pred čítaním. Nie je to ani šifrovanie obsahu: zamknutý text nevidí návštevník bez prístupu, ale administrátori a redaktori webu ho vidia vždy.

4. Inštalácia a licencia

1. Nainštalujte plugin na Branike HUB → Dashboard tlačidlom Inštalovať a aktivujte ho.
2. V ľavom menu pribudne Branike KB.
3. Príručka je hneď dostupná na adrese vášho webu s koncovkou /prirucka/. Adresu, názov aj šírku zmeníte v Nastaveniach.

Licenciu rieši HUB — na stránke Branike KB → Licencia uvidíte jej stav a tlačidlo Spravovať cez HUB. Príručka funguje aj bez aktívnej licencie: články sa zobrazujú ďalej, licencia odomyká aktualizácie a podporu.

5. Rýchly štart (3 kroky)

1. Vytvorte kategórie podľa tém, na ktoré sa ľudia pýtajú (Začíname, Platby, Riešenie problémov…). Každej môžete dať ikonu.
2. Napíšte prvých päť článkov — tie, ktoré posielate e-mailom najčastejšie. Píšete v bežnom blokovom editore; doplňte aj zhrnutie (výňatok), ukáže sa na kartách a vo vyhľadávaní.
3. Nastavte, kto článok uvidí — v paneli Prístup v pravom bočnom paneli editora.

Adresu príručky potom pridajte do menu webu. Vyhľadávanie na nej už je — netreba ho vkladať.

Ak nechcete začínať naprázdno, v Branike KB → Návod kliknite Importovať štartovacie články. Pribudne desať článkov o Branike ekosystéme v štyroch kategóriách, ktoré upravíte alebo zmažete. Import nič neprepíše — článok alebo kategóriu, ktoré už existujú, preskočí.

6. Kde čo nájdete

• Branike KB → Všetky články — obsah príručky. Stĺpec Prístup ukazuje pri každom článku farebnú značku: Verejné, Prihlásený, Členovia.
• Branike KB → Kategórie príručky — štruktúra príručky. Pri kategórii zvolíte ikonu (výber z jednoduchých čiarových ikon alebo emoji) a číslo poradia.
• Branike KB → Poradie kategórií — poradie kategórií presuniete myšou. Presúva sa v rámci toho istého nadradeného priečinka.
• Branike KB → Nastavenia — Názov príručky (zobrazí sa v úvodnom páse a v menu), URL adresa (slug) (koncovka za doménou, predvolene prirucka) a Šírka rozloženia (Ohraničená (na stred, odporúčané) alebo Celá šírka).
• Branike KB → Návod — kroky, skratky na vloženie, import štartovacích článkov a tlačidlo Obnoviť URL adresy.
• Branike KB → Licencia — stav licencie.

7. Ako na to — konkrétne úlohy

Nastaviť, kto článok uvidí

V paneli Prístup v editore článku v poli Kto môže čítať tento článok? zvoľte:

• Verejné — každý. Dobré pre vyhľadávače.
• Len prihlásení používatelia.
• Členský tier — a pod ňou v poli Minimálny členský tier úroveň Basic, Pro alebo Agency.

Pri zamknutom článku vyplňte pole Ukážka zamknutého (teaser) — krátky text, ktorý uvidí návštevník bez prístupu. Ak ho necháte prázdny, použije sa zhrnutie článku. Neprihlásený návštevník dostane tlačidlo na prihlásenie; prihlásený bez oprávnenia tlačidlo na získanie prístupu.

Zamknuté články ostávajú viditeľné vo výpisoch aj vo vyhľadávaní so zámkom — návštevník vidí, že odpoveď existuje a čo pre ňu treba spraviť. Vyhľadávanie pri nich neukáže výňatok textu a vyhľadávačom sa zamknutý článok neponúka (dostane značku, aby ho neindexovali).

Dôležité: voľba Členský tier berie úroveň členstva z interného systému branike.com, ktorý na vašom webe nie je, a nenapája sa ani na skupiny Branike Club. Článok s touto voľbou preto na vašom webe neprečíta nikto okrem administrátorov a redaktorov. Pre vlastnú členskú zónu použite voľbu Len prihlásení používatelia.

Zvýrazniť článok

V paneli Prístup je aj prepínač Odporúčaný článok (zvýrazní článok vo výpisoch). Odporúčané články viete vypísať samostatne skratkou [kb_articles featured="1"].

Odkázať priamo do nastavení

Skratka [kb_admin_link page="branike-hub" label="Otvoriť HUB"] vloží do článku tlačidlo, ktoré človeka prenesie rovno na danú stránku administrácie. Hodí sa do interných návodov pre tím.

Tlačidlo sa zobrazí len používateľom s právom administrátora na tom istom webe — bežný návštevník ho neuvidí vôbec, takže v príručke nevzniká mŕtvy odkaz. Ak ho chcete ukázať aj iným rolám, pridajte do skratky oprávnenie (napríklad cap="edit_posts").

Vložiť vyhľadávanie kamkoľvek

Príručka má vyhľadávanie na úvodnej stránke. Ak ho chcete aj inde — na kontaktnej stránke, v pätičke —, máte dve cesty:

• Bloky KB — Vyhľadávanie a KB — Kategórie v blokovom editore.
• Skratky: [kb_search hero="1"] (vyhľadávacie pole), [kb_categories] (mriežka kategórií), [kb_articles category="zaciname" limit="6"] (karty článkov z kategórie).

Ako funguje vyhľadávanie

Výsledky sa ukazujú už počas písania, od druhého znaku. Najprv sa ponúknu kategórie (najviac štyri), potom články (najviac osem). Vďaka tomu sa návštevník dostane k celej téme aj vtedy, keď netrafí presný názov článku.

Vyhľadávanie funguje aj bez JavaScriptu — vtedy sa po odoslaní načíta stránka s výsledkami. Články chránené heslom WordPressu sa vo vyhľadávaní nezobrazujú vôbec.

Čo je na konci článku

Pod každým článkom je výzva Nenašli ste odpoveď? s tlačidlom Napíšte nám, ktoré vedie na stránku vášho webu s adresou /kontakt/. Pod ňou sú súvisiace články — tri ďalšie z rovnakej kategórie. V úvodnom páse článku je navigácia (kde v príručke ste) a dátum poslednej úpravy (Aktualizované …).

Prispôsobiť vzhľad

Farby príručka preberá z palety vašej témy a funguje s klasickou aj blokovou témou, vrátane Branike témy. Šablóny úvodnej stránky, kategórie aj článku sa dajú prepísať vo vašej (detskej) téme — do priečinka branike-kb v nej skopírujete súbor home.php, category.php alebo single.php. Aktualizácia pluginu ich neprepíše, takže úpravy prežijú. Je to úloha pre vývojára.

8. Tipy a dobrá prax

• Píšte v jazyku zákazníka. Názov článku má byť otázka, ktorú položí on — nie odborný termín.
• Verejného obsahu čím viac, tým lepšie. Sú to presne tie odpovede, ktoré ľudia hľadajú vo vyhľadávači.
• Zbierajte, na čo sa ľudia pýtajú. Príručka hľadané výrazy nezaznamenáva, preto si otázky z e-mailov a telefonátov píšte bokom — každá opakovaná otázka je kandidát na článok.
• Jeden článok = jedna otázka. Dlhý článok o všetkom nenájde nikto.
• Vždy vyplňte zhrnutie. Z neho vzniká text na karte, vo vyhľadávaní aj ukážka zamknutého článku.

9. Riešenie problémov

• Článok alebo kategória hlási „Nenájdené“ — v Branike KB → Návod kliknite Obnoviť URL adresy. Po zmene adresy príručky v Nastaveniach sa to deje samo.
• Zamknutý článok vidí každý — skontrolujte panel Prístup v editore. Pamätajte, že vy ako administrátor vidíte zamknuté články vždy; skúšajte to v súkromnom okne prehliadača.
• Článok s voľbou Členský tier nevidí nikto z členov — pozrite sa do upozornenia v kapitole 7: táto voľba na vašom webe nefunguje; použite Len prihlásení používatelia.
• Vyhľadávanie nenachádza nový článok — musí byť publikovaný, nie koncept, a nesmie byť chránený heslom.
• Tlačidlo z [kb_admin_link] nevidno — zobrazuje sa len administrátorom (alebo roli podľa cap).
• Vzhľad nesedí s webom — šablóny sa dajú prepísať v téme.

10. Súvisiace pluginy a integrácie

• Branike FAQ Chat — konverzačná vstupná brána pre zákazníkov.
• Branike LMS — pre štruktúrované kurzy namiesto referencie.
• LingoPress Pro — príručka vo viacerých jazykoch. Nepreložený článok nezmizne, zobrazí sa v pôvodnom jazyku; kategórie sa správajú rovnako.
• Branike SEO — verejné články sú silný zdroj návštev z vyhľadávania.
• Branike HUB — licencia a aktualizácie.

11. Časté otázky

Uvidia príručku vyhľadávače?

Verejné články áno a je to žiaduce. Zamknuté sa vo výpisoch aj vo vyhľadávaní na webe zobrazia so zámkom, ale vyhľadávačom sa neponúkajú.

Môže byť časť len pre klientov?

Áno, prístup sa nastavuje pri každom článku zvlášť.

Prestane príručka fungovať, keď skončí licencia?

Nie. Články sa zobrazujú ďalej; bez licencie neprichádzajú aktualizácie a podpora.

Dá sa vzhľad prispôsobiť?

Áno, cez šablóny v téme — aktualizácia ich neprepíše.

Ako začať, keď nemám čas písať?

Importujte štartovacie články a prepíšte ich. Kostra býva ťažšia než samotné písanie.

12. Potrebujete pomoc?

Pozrite si stránku Branike KB alebo nám napíšte cez Branike HUB → Nahlásiť problém.

Súvisiace návody

• Čo je Vedomostná základňa?
• Kompletný sprievodca: Branike FAQ Chat
• Kompletný sprievodca: Branike LMS (kurzy)
• Kompletný sprievodca: LingoPress Pro (viacjazyčný web)
• Kompletný sprievodca: Branike HUB