Base — sdílené zdroje#
Komponenty používané napříč moduly. Komentář u produktu i u článku je tentýž zdroj.
Každý zdroj nabízí standardní sadu akcí
get, get-by, get-all, save, update-columns, delete, delete-all —
není-li u něj uvedeno jinak. Podrobně CRUD vzor.
Zdroje#
| Zdroj | Poznámka |
|---|---|
comment |
komentář — vlastník |
comment-thread |
vlákno komentářů |
rating |
hodnocení — vlastník, příjemce (akce save-reply), bez update-columns |
rating-thread |
vlákno hodnocení — veřejné čtení |
poll |
anketa — veřejné čtení |
poll-place |
umístění ankety |
advert |
reklamní sdělení — veřejné, událost |
advert-place |
reklamní plocha |
newsletter |
rozesílka |
newsletter-address |
odběratel |
message-thread, message, message-participant |
soukromé zprávy — CRUD jen administrátor |
Komentáře#
Vlákno vzniká samo při prvním komentáři. Komentář se váže na vlákno, ne přímo na obsah.
Nový komentář nemusí být hned viditelný
Podle nastavení webu čeká na schválení. Zápis projde, ale výpis ho ostatním nevrátí.
Kdy komentář neprojde (success: false, HTTP 200, důvod v data.errorCode):
| Případ | code |
errorCode |
|---|---|---|
| vlákno příspěvku diskuze, u kterého autor vypnul komentáře | 607 |
commentsClosed |
| host komentuje příspěvek diskuze a web dovoluje komentovat jen přihlášeným | 400 |
commentOnlyForLoggedIn |
| nový komentář s e-mailem nebo IP adresou na blacklistu | 615 |
blacklisted |
Hodnocení#
Vlákno hodnocení nese spočítané souhrny — počet, průměr a rozpad po hvězdičkách.
Souhrny jsou uložené hodnoty
Přepočítávají se při změně hodnocení. Krátký nesoulad s jednotlivými recenzemi je normální.
Odpověď na hodnocení#
Akce save-reply zapíše odpověď provozovatele k hodnocení. Smí ji majitel hodnoceného profilu
(role receiver). Autor hodnocení odpovídat nesmí a nepomůže ani role owner: ta u této
akce už nic nepovoluje. Autor hodnocení upravuje jen své hodnocení (save).
Soukromé zprávy#
Zdroje message-thread, message a message-participant jsou přes HTTP jen pro
administrátora. Akce nad jednou konverzací — číst zprávy, odpovědět, označit za přečtené,
skrýt, seznam účastníků — a výpisy „moje" jsou vnitřní: web je volá, ale nemají HTTP
obal, takže z externího klienta nejsou dostupné.
Kdo je v konverzaci vlastník a kdo příjemce
owner je ten, kdo v konverzaci napsal aspoň jednu nesmazanou zprávu, receiver ten,
komu nějaká zpráva přišla. Po první odpovědi je každá strana obojí.
Ankety#
Hlasování má vlastní vnitřní akci, která nemá HTTP obal.
Hlasovat se přes API nedá
Čtení ankety ano, odeslání hlasu ne.
Newsletter#
Adresa přidaná přes API musí projít potvrzením
Vložení adresy neznamená souhlas s odběrem. Adresa bez potvrzení se nerozesílá — a je to tak správně.
Adresa na blacklistu webu se nevloží: code: 615, data.errorCode: blacklisted.