Blog — site content#
The most open module — most reading is public.
Every resource offers the standard set of actions
get, get-by, get-all, save, update-columns, delete, delete-all —
unless stated otherwise. See the CRUD pattern.
Resources#
| Resource | Note |
|---|---|
article |
article — public, event |
news |
news item — public |
event |
dated event — public |
category |
category — tree, public |
tag |
tag — public |
gallery |
gallery |
carousel |
rotating content |
intro |
intro block |
flash-message |
site announcement |
guestbook |
guestbook — public |
guestbook-message |
guestbook entry |
contact-message |
contact form message |
article-discussion-message |
post in an article discussion |
Articles#
The most used resource of the whole API. Reading is public.
Without includes[]=translations you get no text
The title and body are in a subordinate entity, one per language.
Multiple languages#
Texts live in translations. The language is chosen by the address prefix
(/en/api/…) or by a filter over the translations.
An empty translation is not a missing translation
A stored empty text counts as valid and the fallback language is not used. The item then comes out with no name.
Events#
An event carries a date, a place and possibly admission.
Filter by date, not by an active flag
Past events stay in the data.
Guestbook#
Writing is open to visitors who are not signed in, but an entry usually waits for approval.
Do not publish personal details to the guestbook
It is public. A phone number or order number there is readable by anybody.