A child theme preserves site-specific presentation across parent updates. It must extend supported WordPress/theme surfaces rather than replace Aurelia’s runtime bootstrap or copy Core/Pro business logic.
Use the actual parent identity
The parent template/stylesheet identity is aurelia-theme. Keep the child separate, retain its own stylesheet and use WordPress templates/template parts and documented hooks for custom presentation. Parent runtime includes and its asset manifest stay bound to the parent directory.
Do not shadow parent inc classes, duplicate constants or load a second shared license client. Child code loads in its normal WordPress lifecycle; it cannot make missing Pro available or change payment/availability authorization.
Override catalogued booking surfaces
Use kimorapro_hb_template_override_catalog() to identify allowed logical templates and exact versions. Core uses the hotel-booking/ theme directory; Pro uses its documented hotel-booking/pro/ subpath. These are template package paths, not a request to rename the canonical Free plugin folder.
Each override needs the logical identity, package, exact Template Version and compatible Theme Contract metadata. Resolution is child → parent → plugin, skipping unsafe/stale candidates. An outdated child file can therefore fall through instead of rendering an incompatible payload.
Prefer a small prepared-HTML wrapper or supported hook to copying an internal partial. Keep owner-provided nonces, machine fields, access markers, action URLs and prepared financial/status meanings intact.
Verify parent updates
Compare current catalog/override diagnostics after an update. Test both your override and native fallback, missing/disabled optional features and current receipt/Book Now contracts. Do not use CSS hiding to mask duplicated policy content or a broken authorization handoff.
Keep an independent backup of child files. Parent rollback does not restore erased data, undo a gateway refund or rebind a theme license. A compatible version declaration is necessary but does not prove full browser or licensed runtime behavior.
See template metadata/example and Aurelia updates.
