… * * header ->

, footer ->

, anything else ->

. The CSS is the editor-generated `_zadex_css` * (plus the page-settings CSS), queued through \Zadex\Frontend\Styles (WordPress style queue, handle * `zadex-css-`); PHP never generates element CSS. The small structural rules for sticky and transparent headers * are queued too (handle `zadex-template-base`). */ final class TemplateRenderer { private Renderer $renderer; /** @var array templates being rendered (recursion guard) */ private array $stack = []; public function __construct(Renderer $renderer) { $this->renderer = $renderer; } /** * @param int|null $context_post post the template's dynamic tags render against (single templates: the * post in the loop; editor view: the preview post). null = Context::current(). */ public function render(int $id, ?int $context_post = null): string { if ($id <= 0 || isset($this->stack[$id])) { return ''; } $type = TemplatePost::type($id); $settings = TemplatePost::settings($id); $tag = $type === 'header' ? 'header' : ($type === 'footer' ? 'footer' : 'div'); $classes = ['zadex', 'zadex-' . $id, 'zadex-template', 'zadex-template--' . ($type !== '' ? $type : 'part')]; if ($type === 'header') { if (!empty($settings['sticky'])) { $classes[] = 'zadex-header--sticky'; } if (!empty($settings['transparent'])) { $classes[] = 'zadex-header--transparent'; } } $this->stack[$id] = true; $contextual = $context_post !== null && $context_post > 0 && method_exists($this->renderer, 'set_context'); if ($contextual) { $this->renderer->set_context(\Zadex\Dynamic\Context::for_post($context_post)); } try { $data = Document::get_data($id); $body = $this->renderer->render_document($data['elements'] ?? []); } finally { unset($this->stack[$id]); if ($contextual) { $this->renderer->set_context(null); } } $extra = ''; if (self::is_context_in_editor($id)) { // Inside the editor canvas of ANOTHER document (e.g. the site header while a page is edited) the // template is read-only context: drop the element markers so selection, overlays, DnD and element // queries never treat its nodes as part of the edited document. $body = (string) preg_replace('/\sdata-zx-(?:id|type)="[^"]*"/', '', $body); $extra = ' data-zx-ignore data-zx-context="template" title="' . esc_attr(sprintf( /* translators: %s: template title */ __('%s: edit it in Zadex → Theme Builder', 'zadex'), get_the_title($id) )) . '"'; } $this->styles($id, $type); return '<' . $tag . ' class="' . esc_attr(implode(' ', $classes)) . '" data-zx-doc="' . $id . '"' . $extra . '>' . $body . ''; } /** * True while rendering the editor preview (`?zadex=preview`) of a different post than $id, i.e. the * template is surrounding context in the canvas, not the document being edited. */ public static function is_context_in_editor(int $id): bool { if (!class_exists('\Zadex\Editor\EditorLoader') || !\Zadex\Editor\EditorLoader::is_preview()) { return false; } $edited = function_exists('get_queried_object_id') ? (int) get_queried_object_id() : 0; if ($edited <= 0) { $edited = \Zadex\Editor\EditorLoader::requested_post_id(); } return $edited !== $id; } /** Queues the template's CSS (and the header base rules) — each once per request. */ public function styles(int $id, string $type = ''): void { if (($type !== '' ? $type : TemplatePost::type($id)) === 'header') { Styles::add('zadex-template-base', self::base_css()); } Styles::document($id); } /** Sticky: stays under the admin bar. Transparent: lies over the content. Both: fixed over the content. */ public static function base_css(): string { return '.zadex-header--sticky{position:sticky;top:var(--wp-admin--admin-bar--height,0);z-index:99}' . '.zadex-header--transparent{position:absolute;left:0;right:0;z-index:99;background:transparent}' . '.zadex-header--sticky.zadex-header--transparent{position:fixed;top:var(--wp-admin--admin-bar--height,0)}'; } }