Kindly EditDocumentationTry the editor

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.

About this page

Documents Kindly Edit 0.9.16. Source: docs/DEVELOPER.md, assets/editor.js. Theme choices and account permissions can change which controls appear.

Type a word or phrase to search the full documentation.