Kindly EditDocumentationTry the editor

Component identities and translation

Keep persistent component slugs unique and translate labels without changing stored identities.

Reference#

Number prefixes order components/*.html; removing that prefix produces the persistent component slug. Distinct files such as 10-hero.html and 20-hero.html therefore collide. The existing last-file lookup is retained for stored pages, and administrators receive a warning listing both filenames. Rename the portion after the number to make both components available. A child theme replacing an identical parent basename remains an intentional override.

cantata_edit_component_metadata filters parsed comment metadata before it becomes the picker catalog. It receives (array $metadata, string $slug, string $locale). Return an array with translated name, category, description, keywords, layouts and tones strings; layout/tone entries must keep their machine keys and translate only labels. The catalog cache separates locales. This seam changes picker labels, not authored example HTML, CSS classes or persistent component identities. Existing cantata_edit_components filters continue to work.

Live source numeric fields use only declared bounds: set min: 1 explicitly for positive counts. An undeclared minimum does not imply positivity; zero and negative values can be valid integration inputs. Record data-ce-edit-url handoffs must be HTTP(S) addresses on the current site's origin; cross-origin destinations are refused.

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.