Live content and native owners
Insert registered dynamic content and edit the source in its authoritative application.
Reference#
Live content is a shortcode described once by whoever owns it, through the cantata_edit_live_sources filter (label,
description, shortcode and fields). Editors pick it by name and fill in plain fields ("How many to show"). A
registered source runs only with the options it declares, with numbers clamped to their limits.
Any other shortcode goes in a Shortcode element: typed as in WordPress's editor and shown
with Apply. Only administrators and editors (the unfiltered_html capability) can add or change one; everyone else
can keep or delete the ones already on a page.
A source can also give:
manage: { url, label }: its card gets a link to where the contents are really changed, shown as "label ↗" ("Change what it shows ↗" without a label) and opening in a new tab (for example, events kept in Wild Apricot).note: the picker tile's own words, instead of the general "Fills itself in from the site."
A shortcode that renders separate WordPress records can put data-ce-edit-url="…" on each rendered record and,
optionally, data-ce-edit-label="Event" (or another singular name). In the on-page editor, clicking that record or
pressing Enter opens its real editing screen after the usual unsaved-changes check. These are runtime markers in the
shortcode output; they are not stored in the page's HTML.
Both pass through cantata_edit_live_sources() unchanged. A number field says "At most this many. Fewer show when there
are fewer."
In Developer mode, its settings also have Advanced → Shortcode, the raw shortcode name, for developers. Everyone else uses the fields.