linked-components.php
Resolves theme-linked component instances, properties, source revisions, and fallback markup while preserving instance ownership.
Responsibility#
Resolves theme-linked component instances, properties, source revisions, and fallback markup while preserving instance ownership.
This is an implementation reference for the released 0.9.13 module. Internal PHP helpers are not a compatibility promise for third-party callers. Prefer the documented REST, Abilities, theme, and filter contracts.
Related modules#
WordPress hooks#
| Operation | Hook |
|---|---|
add_filter |
cantata_edit_components |
add_action and add_filter subscribe to a hook; do_action and apply_filters expose a hook. A subscription is not itself a new extension API. Dynamic hook names are not included in this literal inventory.
Function and method reference#
cantata_edit_linked_parse#
function cantata_edit_linked_parse( string $html ): ?DOMElement
Internal implementation helper in this module. Its name and signature identify the operation and accepted PHP values; it is not a standalone authenticated endpoint.
Source location: includes/linked-components.php:10.
cantata_edit_linked_inner#
function cantata_edit_linked_inner( DOMNode $node ): string
Internal implementation helper in this module. Its name and signature identify the operation and accepted PHP values; it is not a standalone authenticated endpoint.
Source location: includes/linked-components.php:20.
cantata_edit_linked_unbound#
function cantata_edit_linked_unbound( DOMElement $scope ): string
Editable content added outside declared slots must never be silently discarded during a rebase.
Source location: includes/linked-components.php:27.
cantata_edit_linked_slots#
function cantata_edit_linked_slots( DOMElement $scope, string $attribute ): ?array
Marked descendants belonging to this scope, excluding descendants of another field or repeat.
Source location: includes/linked-components.php:43.
cantata_edit_linked_overrides#
function cantata_edit_linked_overrides( DOMElement $source, DOMElement $target ): void
Preserve saved editor overrides while template classes continue to own structure.
Implementation connections: cantata_edit_visual_attributes.
Source location: includes/linked-components.php:60.
cantata_edit_linked_merge#
function cantata_edit_linked_merge( DOMElement $source, DOMElement $target ): bool
Use template nodes/classes, preserving authored HTML, styling and safe content attributes.
Implementation connections: cantata_edit_linked_overrides, cantata_edit_linked_slots, cantata_edit_linked_unbound.
Source location: includes/linked-components.php:79.
cantata_edit_linked_render#
function cantata_edit_linked_render( string $html, ?array $components = null ): string
Resolve explicitly linked sections; unlinked/custom sections and unknown schemas retain their exact HTML.
Implementation connections: cantata_edit_components, cantata_edit_linked_inner, cantata_edit_linked_merge, cantata_edit_linked_parse.
Source location: includes/linked-components.php:137.