Module documentation

Příspěvky

Modul `/post` je redakční systém pro tvorbu a publikaci článků. Slouží pro cokoliv, co má podobu psaného obsahu — firemní blog, aktuality, tiskové zprávy, nápovědu nebo klientskou zónu s chráněnými texty. Hlavní myšlenkou modulu je, že článek není jen kus textu, ale entita s životním cyklem: vzniká jako rozepsaná myšlenka, zraje v redakci, publikuje se v čase, žije mezi čtenáři (kteří ho komentují a sdílí) a nakonec se archivuje, aniž by se jeho odkazy rozbily. Modul je navíc od začátku koncipován jako vícejazyčný, takže jeden článek může existovat v několika jazykových verzích s vlastními...

Last updated 24 April 2026

Modul /post je redakční systém pro tvorbu a publikaci článků. Slouží pro cokoliv, co má podobu psaného obsahu — firemní blog, aktuality, tiskové zprávy, nápovědu nebo klientskou zónu s chráněnými texty. Hlavní myšlenkou modulu je, že článek není jen kus textu, ale entita s životním cyklem: vzniká jako rozepsaná myšlenka, zraje v redakci, publikuje se v čase, žije mezi čtenáři (kteří ho komentují a sdílí) a nakonec se archivuje, aniž by se jeho odkazy rozbily. Modul je navíc od začátku koncipován jako vícejazyčný, takže jeden článek může existovat v několika jazykových verzích s vlastními URL adresami a vlastním stavem překladu.

Stránka je rozdělena do tří záložek — Příspěvky, Kategorie a Komentáře — které spolu úzce souvisí a dohromady tvoří kompletní redakční pracoviště.

Přehled příspěvků

Hlavní záložka zobrazuje seznam všech článků organizace v podobě tabulky s náhledovými obrázky, která je navržená jako rychlý přehled redakčního dění. Na první pohled je vidět, co je hotové, co čeká na překlad a co přitahuje pozornost čtenářů. Každý řádek nese náhledový obrázek, název (u oblíbených označený hvězdičkou), hlavní kategorii, autora, úroveň viditelnosti, počet komentářů a relativně formátované datum publikace. U každého příspěvku se navíc zobrazují barevné tagy a jazykové vlaječky — zelená znamená, že překlad do daného jazyka existuje, šedá, že chybí.

Tabulka se automaticky obnovuje každých 20 sekund, aby redakční práce více lidí najednou byla v přehledu vidět takřka okamžitě. Řazení je pevně dané: oblíbené příspěvky (s hvězdičkou) jsou vždy na začátku, pod nimi pak zbytek sestupně podle data publikace. Smazané články zůstávají v seznamu označené červeným štítkem „Deleted" — díky tomu je lze obnovit, aniž by se museli hledat někde stranou.

Kontextové menu

Pravé tlačítko myši nad řádkem otevře kontextové menu se třemi akcemi, které pokrývají nejčastější redakční úkony bez nutnosti otevírat detail. Automatický překlad odešle článek AI a přeloží ho do všech jazyků, které v organizaci existují, ale pro daný článek ještě nemají překlad. Smazat přesune článek do archivu (soft-delete) a zobrazí potvrzovací dialog, aby nedošlo k náhodnému smazání. Obnovit vrátí archivovaný článek zpět do aktivního stavu.

Vytvoření nového příspěvku

Tlačítko Add v pravém horním rohu otevře formulář pro založení článku. Vyplňují se čtyři údaje: název, obsah (v markdown editoru), volitelně hlavní kategorie, jazyk a úroveň viditelnosti. Po uložení se uživatel automaticky ocitne v detailu nového článku, kde pokračuje v práci.

Vytvoření článku spustí několik automatik, které šetří čas. Pokud uživatel neurčil hlavní kategorii, systém se ji pokusí odhadnout AI analýzou obsahu — podrobněji viz sekci Automatická kategorizace. Pokud se odhad nezdaří (například když organizace nemá žádnou vhodnou kategorii s popisem), článek se zařadí do první dostupné aktivní kategorie, takže nikdy nezůstane „nezařazený". Viditelnost soukromý ponechá článek nepublikovaný (bez data publikace), kdežto u všech ostatních viditelností se datum publikace nastaví automaticky na okamžik vytvoření. Jako autor je implicitně nastaven aktuálně přihlášený uživatel. Pro zadaný jazyk vzniká canonická URL adresa odvozená od názvu.

ℹ️ Pokud název obsahuje zalomení řádků nebo nadbytečné mezery (například omylem zkopírované z Wordu), systém jej před uložením automaticky normalizuje na jeden řádek.

Životní cyklus a viditelnost

Článek se v průběhu své existence nachází v jednom ze tří stavů, které společně určují, zda je pro kohokoliv viditelný. Rozepsaný článek je soukromý — existuje jen pro autora a administrátory, není publikovaný, nemá datum publikace. V okamžiku, kdy přejde do jakékoliv jiné viditelnosti, systém automaticky doplní datum publikace (pokud uživatel výslovně nezadal jiné). Publikovaný článek je viditelný podle zvolené úrovně viditelnosti, která je nezávislá na stavu — definuje, kdo konkrétně článek uvidí. Smazaný článek je archivovaný pomocí soft-delete, takže zmizí ze všech veřejných zobrazení, ale zůstává v administraci a lze jej obnovit beze ztráty dat.

Úrovně viditelnosti jsou čtyři a každá odpovídá typické redakční situaci. Veřejný článek vidí kdokoliv — je zahrnut v seznamech, RSS kanálech i ve sdíleních. Soukromý zůstává u autora a administrátorů, takže se hodí pro rozpracované texty nebo interní poznámky. Neuvedený není v žádném veřejném výpisu, ale kdo dostane přímý odkaz, ten si článek přečte — typické pro dlouhodobé náhledy sdílené s klientem. Pro odběratele je viditelný jen přihlášeným členům klubu nebo členské sekce.

Detail příspěvku

Po kliknutí na příspěvek se otevře stránka s detailem rozdělená do čtyř záložek, každá zaměřená na jinou dimenzi článku.

Obsah

Záložka Obsah je hlavní pracovní plocha. Levý sloupec je vyhrazen samotnému textu — obsahuje pole pro název, perex (shrnutí pro náhled v listech a sociálních sítích), markdown editor s obsahem a hvězdičku pro označení oblíbenosti. Pravý postranní panel soustřeďuje metadata, která s článkem souvisí, ale nejsou jeho obsahem: interní ID (jen pro čtení), úroveň viditelnosti, hlavní kategorii s tlačítkem AI návrh, seznam autorů (příspěvek může mít více spoluautorů), datum publikace, datum vytvoření, tagy, stav překladu do jiných jazyků a tlačítko pro smazání článku.

Změny se ukládají tlačítkem Save. Systém přitom trvá na tom, aby měl článek alespoň jednoho autora — pokud uživatel všechny autory odstraní, uložení selže. Tato pojistka brání vzniku článků bez autorské odpovědnosti.

⚠️ Pokud byl článek do této chvíle soukromý a uživatel ho přepne na veřejný nebo jinou zveřejňující viditelnost, systém automaticky doplní aktuální datum publikace. Jde o pohodlí, aby publikační den nemusel administrátor zadávat ručně.

Galerie

Záložka Galerie spravuje obrazovou stránku článku. Obrázky lze nahrávat z lokálního počítače (přijímají se pouze obrázkové formáty), zobrazují se v mřížce náhledů a jejich pořadí lze měnit přetažením myší. Jeden z obrázků je vždy hlavní — slouží jako náhled v seznamech článků, Open Graph pro sociální sítě a hrdinský obrázek na veřejném webu. První nahraný obrázek se automaticky stává hlavním; pokud je hlavní obrázek deaktivován nebo smazán, jeho roli převezme první zbývající aktivní obrázek v pořadí.

Kromě pořadí a hlavního obrázku lze každý snímek aktivovat nebo deaktivovat (dočasné skrytí bez smazání, vhodné třeba při sezónní výměně fotek) a smazat (soft-delete, který snímek odstraní z výpisu, ale fyzicky zachová pro případný návrat). Kliknutí na náhled otevře lightbox — prohlížeč na celou obrazovku s navigací mezi snímky.

Alt text a SEO

U každého obrázku lze zadat popisek (alt text), který plní tři současné role: zpřístupňuje obsah čtečkám obrazovky a prohlížečům bez grafiky, pomáhá vyhledávačům indexovat obrázek v obrázkovém vyhledávání a lepí se ke sdíleným náhledům na sociálních sítích. Prázdný alt text je sice povolený, ale alespoň u hlavního obrázku je silně doporučeno ho vyplnit — jde o jednu z nejlevnějších SEO vylepšení.

💡 Alt text by měl popisovat, co je na obrázku vidět a jaký má vztah k článku, ne jen opakovat název souboru. Dobrý alt text pomůže jak čtenáři, tak robotu.

Tagy

Tagy jsou volnější forma kategorizace než hlavní kategorie — zatímco kategorie je jedna hierarchická rubrika, tagů může mít článek libovolný počet. Záložka Tagy zobrazuje přiřazené tagy jako barevné čipy s možností odebrání a pod nimi seznam dostupných tagů, které lze k článku přidat. Nový tag lze vytvořit přímo odtud (zadá se název, kód a barva), změny se promítnou po uložení.

Tagy jsou sdílené napříč celou organizací, takže jeden tag lze uplatnit u více článků a vytvořit tak tématické shluky. Barva tagu se propisuje do barevných čipů v přehledu příspěvků, což usnadňuje vizuální orientaci.

Routing

Záložka Routing slouží k nastavení URL adresy (slugu) článku. Při vytvoření je slug automaticky odvozen od názvu — převede diakritiku, odstraní speciální znaky a sloučí mezery do pomlček. Slug lze později ručně upravit, ale uživatel by měl vědět, že starý odkaz pak přestane fungovat.

⚠️ Pokud článek už existuje v produkci a je odkazován z externích zdrojů, je změna slugu rozbije. Pro trvalý překlep v URL existují lepší cesty — například přesměrování na úrovni routingu.

Automatický překlad

Automatický překlad je funkce, která za pomoci AI doplní chybějící jazykové verze článku, aniž by redakce musela ručně překládat. Systém začne tím, že si zjistí výchozí jazyk organizace a načte článek v tomto jazyce jako zdroj. Pak porovná dostupné jazyky organizace s existujícími překlady článku a pro každý chybějící jazyk vytvoří samostatný překlad (zvlášť název, zvlášť obsah), aby kvalita byla co nejvyšší. Pro každý přeložený jazyk navíc automaticky vytvoří canonickou URL adresu odvozenou z přeloženého názvu, pokud ještě neexistuje.

Funkce je dostupná jak z kontextového menu v seznamu (hromadně pro jeden článek), tak z detailu článku. Pokud už jsou všechny jazyky přeložené, nic se neděje — operace je tedy bezpečně opakovatelná.

ℹ️ Překlad nevznikne okamžitě; AI model nad textem chvíli pracuje, zvlášť u dlouhých článků. Během čekání je proto lepší stránku neopouštět.

Automatická kategorizace

Vedle překladu je AI asistence dostupná i pro zařazení do kategorie. Tlačítko AI návrh u pole „Hlavní kategorie" spustí analýzu, při níž systém předá AI název a obsah článku (až 3 000 znaků) spolu se seznamem všech aktivních kategorií organizace a jejich popisů. Model z nabídky vybere nejvhodnější kategorii, případně navrhne, že žádná nevyhovuje — v takovém případě současná volba zůstává beze změny.

Stejná logika se spustí automaticky i při vytváření nového článku, pokud uživatel kategorii sám nezvolil. Selhání AI (například výpadek služby) nebrání vzniku článku — jen se zařadí do výchozí kategorie a redaktor si ji může později upravit.

Vícejazyčnost v praxi

V prostředí s více nakonfigurovanými jazyky se vícejazyčnost prolíná celým modulem. V detailu článku lze přepínat jazyk editovaného obsahu a pro každý jazyk psát vlastní název, perex a obsah. Stav překladů je vizualizován vlaječkami v přehledu, takže redakce na první pohled vidí, které články potřebují dopřeložit. Automatický překlad pomáhá tuto práci zrychlit, ale konečná kontrola zůstává na redakci.

Každý jazyk má vlastní URL adresu (slug), která vzniká při prvním uložení obsahu v daném jazyce. Pokud návštěvník webu přijde v jazyce, který pro článek ještě nemá překlad, systém použije fallback a zobrazí obsah ve výchozím jazyce organizace, aby stránka nebyla prázdná.

Komentáře

Záložka Komentáře shromažďuje všechny komentáře napříč všemi články organizace do jednoho přehledu. Řádek obsahuje název článku (s odkazem na jeho detail), jméno autora komentáře, e-mail, text komentáře, stav (aktivní nebo smazaný) a datum. Redaktor tedy nemusí chodit po jednotlivých článcích a sleduje dění na diskuzi z jednoho místa.

Komentáře lze mazat přes kontextové menu s potvrzovacím dialogem. Stejně jako u článků jde o soft-delete — komentář zůstane v databázi, jen už není veřejně zobrazen. Díky tomu lze případné chybné smazání opravit a zároveň nejsou narušené odkazy ve vláknech.

Automatická filtrace spamu

Při odeslání komentáře z veřejného webu prochází text automatickou kontrolou spamu. Pokud je obsah vyhodnocen jako spam, komentář se vůbec neuloží a autorovi se vrátí chyba. Administrátor v seznamu komentářů tedy vidí jen ty, které prošly filtrem — spam mu nezahlcuje moderování.

Vlákna komentářů

Komentáře mohou být hierarchické: na komentář lze odpovědět a vytvořit tak vlákno. V administraci je výpis plochý (pro rychlé moderování), ale na veřejném webu se zachovává stromová struktura, aby si čtenáři mohli snadno dohledat kontext diskuze.

Kategorie

Záložka Kategorie je rychlý rozcestník na stránku se správou kategorií příspěvků, která je dostatečně bohatá na to, aby měla vlastní dokumentaci — viz Kategorie příspěvků.

Smazání a obnovení

Mazání článku je vždy soft-delete. Článek se pouze označí jako smazaný a ze všech veřejných zobrazení zmizí, ale v administraci zůstává s červeným štítkem „Deleted" a lze jej obnovit přes kontextové menu Obnovit. Tento princip je záměrný — díky němu nedochází ke ztrátě komentářů, obrázků z galerie ani odkazů z jiných modulů, které by při tvrdém mazání osiřely.

Obnovený článek se vrací v tom stavu, v jakém byl v okamžiku smazání, včetně viditelnosti a data publikace. Pokud byl tedy smazán veřejný článek, obnoví se rovnou jako veřejný — je to tedy rychlá cesta, jak vrátit omylem smazaný text.

⚠️ Pokud administrátor potřebuje článek trvale a nevratně odstranit, je třeba použít nástroje přímé správy dat, nikoliv toto rozhraní. Běžné mazání je úmyslně jen měkké.

Build with the API

Every module shipped here is also exposed via the REST API.