Server module reference
Every PHP subsystem, its responsibility, named helpers, WordPress hooks, and implementation connections.
Modules#
abilities.php#
Registers the WordPress Abilities interface, checks whether AI access is enabled, applies per-user rate limits, and records a compact operation audit. Each ability delegates to the same page or design functions used elsewhere. 6 named functions or methods.
admin.php#
Adds WordPress administration entry points and row actions. It routes an existing or new page into the appropriate editing experience and communicates whether a page already has a Kindly layout. 1 named functions or methods.
advanced-code-api.php#
Exposes authorized element-code reads and draft writes. It requires a Kindly-built owner and delegates persistence to the normal atomic save path rather than turning an unrelated WordPress page into a built page. 4 named functions or methods.
advanced-php-api.php#
Connects stronger PHP authoring permissions to automation. It resolves an explicit code owner, reads private source only for an authorized caller, and stages validated immutable code resources. 3 named functions or methods.
ai-checks.php#
Validates automation edits and publication, checks stale revisions, and reports structural and content problems before committing a draft or publishing it. 10 named functions or methods.
blocks-mode.php#
Coordinates WordPress block-editor pages with Kindly editing. It preserves the chosen page mode rather than assuming every page is native HTML. 6 named functions or methods.
blocks.php#
Loads the built-in block catalog, parses metadata, substitutes theme-aware placeholders, and exposes appropriate insertion choices. 10 named functions or methods.
branding.php#
Resolves the public product identity and optional license-issued branding while retaining the plugin’s stable internal identifiers. 3 named functions or methods.
build-contract.php#
Describes the accepted native page build structure, inspects code ownership and contract compliance, and exposes the contract to tooling. 14 named functions or methods.
cli.php#
Provides the wp kindly command family and legacy wp cantata alias. Commands share the AI access checks and content functions and emit JSON results. 14 named functions or methods.
conditions.php#
Validates serialized visibility rules, evaluates them in the visitor context, omits nonmatching HTML, and marks visitor-dependent output as unsuitable for ordinary shared caching. 7 named functions or methods.
context-help.php#
Builds bounded editor help context and forwards authorized help requests. Context describes the selected element and available controls rather than granting the help service unrestricted editing access. 4 named functions or methods.
design-system.php#
Stores shared design variables and classes, validates style values, tracks their uses, checks revision conflicts, and emits public CSS. 9 named functions or methods.
dynamic.php#
Resolves dynamic fields and repeated WordPress queries in the current render context. It handles formatting, fallbacks, pagination, alternates, and empty states. 15 named functions or methods.
editor-mode.php#
Resolves Simple or Developer mode and persists authorized user preferences. Mode availability remains distinct from resource permissions. 3 named functions or methods.
editor.php#
Decides when the editing interface loads, prepares its configuration, enqueues editor assets, and supplies the editable page context. 6 named functions or methods.
element-css.php#
Parses and validates element-owned CSS, scopes selectors to the owner, generates output, and keeps visual settings and authored exceptions consistent. 41 named functions or methods.
element-js.php#
Validates element-owned JavaScript envelopes, signs trusted ownership, handles code authoring and migration helpers, and prints only authorized execution payloads. 38 named functions or methods.
element-php.php#
Stores immutable PHP source resources privately, checks native code permissions and signatures, validates and stages code, and renders authorized owners with explicit execution guards. 37 named functions or methods.
entry.php#
Adds the small front-end entry affordance for eligible signed-in editors without loading the entire editor on every visitor page. 2 named functions or methods.
feedback.php#
Retains the optional legacy review queue only for installations that previously configured it. This is separate from native visitor forms and is not universally enabled. 1 named functions or methods.
forms.php#
Validates public submissions against the published form schema, stores private action settings and submission records, and coordinates email, redirects, webhooks, popups, and private files. 15 named functions or methods.
globals.php#
Registers linked global source records, validates instance properties, resolves nested content within limits, and preserves fallback copies when a source is unavailable. 6 named functions or methods.
help.php#
Provides product help entry points and support context. It is separate from the context-aware Ask Kindly panel and from content-editing APIs. 4 named functions or methods.
i18n.php#
Loads translation support and makes the plugin text domain available to the WordPress localization system. 0 named functions or methods.
icon-library.php#
Provides the registered icon library and its safe SVG data for native element choices. 1 named functions or methods.
intro.php#
Tracks whether an authorized user has seen the editor introduction and provides the corresponding initial guidance. 4 named functions or methods.
kindly-menu.php#
Organizes the WordPress administration navigation and management screens for Kindly-owned content and settings. 33 named functions or methods.
kindly-theme.php#
The Kindly Edit > Theme screen, its draft preview and its theme-settings REST routes (0.9.15). 7 named functions.
labels.php#
Provides site-facing labels and terminology without changing stable storage identifiers. 3 named functions or methods.
license.php#
Maintains license state and server communication. The gate controls editor entry while leaving public rendering intact, with bounded grace after the last valid response. 14 named functions or methods.
linked-components.php#
Resolves theme-linked component instances, properties, source revisions, and fallback markup while preserving instance ownership. 7 named functions or methods.
loop-templates.php#
Registers reusable single-item loop templates, validates their root structure, and resolves published layouts before per-item dynamic rendering. 7 named functions or methods.
media-categories.php#
Registers and queries media categorization used by the editor’s media library filters. 7 named functions or methods.
native-allowed-html.php#
Defines the native HTML attribute and element contract accepted by the sanitizer, including supported controls and serialized settings. 1 named functions or methods.
page-model.php#
Parses page HTML into an automation outline with revision-scoped section, item, and field paths. It applies structured edits through the same tree and saves drafts using shared validation. 23 named functions or methods.
page-sources.php#
Reports the sources that contribute to the visible page, including templates and shared records, without mutating them. 1 named functions or methods.
parts.php#
Manages editable copies of theme parts, including separate drafts, revisions, and publication of shared header or footer content. 11 named functions or methods.
popups.php#
Registers popup records, validates settings and display rules, resolves public payloads, records bounded event statistics, and manages library operations. 34 named functions or methods.
providers.php#
Registers WordPress-native live sources such as posts, menus, search, login, site identity, author data, and widget areas with explicit accepted fields. 14 named functions or methods.
render.php#
Owns the public rendering path for Kindly-built HTML and integrates dynamic sources, responsive styles, native interactions, and approved code output. 16 named functions or methods.
responsive.php#
Validates screen definitions and per-element responsive declarations, emits state and breakpoint CSS, and handles visibility ranges. 13 named functions or methods.
rest.php#
Registers the core editor REST endpoints and coordinates content validation, atomic save operations, revisions, conflict detection, publication, discard, and restore. 29 named functions or methods.
sanitize.php#
Cleans submitted HTML, preserves allowed native structures, removes editor-only output, and applies feature-specific validation before storage. 11 named functions or methods.
scoped-style-capture.php#
Captures style ownership for imported markup and translates eligible rules into portable scoped settings while avoiding unrelated document rules. 5 named functions or methods.
seo.php#
Stores portable search and sharing metadata with draft and revision support, resolves public fallbacks, and integrates recognized SEO plugins through their filters. 14 named functions or methods.
settings.php#
Renders administrator settings and handles nonce-protected license activation, release channel, update checks, and AI access preferences. 3 named functions or methods.
template-code.php#
Validates portable template markup and handles code ownership rules when content enters a reusable library. 12 named functions or methods.
templates.php#
Maintains saved layout templates and idempotent creation reservations. Inserted copies are independent of the library source. 10 named functions or methods.
text.php#
Provides the text-editing presentation and WordPress integration needed for editable words. 1 named functions or methods.
theme-design.php#
Reads, validates, drafts, publishes, and discards the active theme’s structured design document through the authorized integration interface. 6 named functions or methods.
theme-templates.php#
Chooses matching theme templates by rule specificity, handles draft and published rules, and renders against the requested post or archive context. 18 named functions or methods.
theme.php#
Loads the active theme’s configuration, components, design tokens, and editable-root contract, with parent/child theme resolution. 15 named functions or methods.
tones.php#
Resolves theme tone and color choices, validates their token roles, and emits the corresponding presentation rules. 8 named functions or methods.
updater.php#
Integrates the release server with WordPress plugin updates, respects the selected release channel, and supplies package information for authorized downloads. 4 named functions or methods.