# Bludit Pro 3.22.0 – Theme Architect Rulebook --- ## Flash Version: Dense Template Quick‑Reference ### $WHERE_AM_I Values & Content Mapping | $WHERE_AM_I | Content Available | Typical Action | |-------------|-------------------|----------------| | `'home'` | `$content` (list) + possibly `$page` (static homepage) | Loop `$content`; show `$page->content()` if `$page` exists. | | `'blog'` | `$content` (list) | Loop `$content` (sticky merged). | | `'page'` | `$page` (single page) | `$page->content()`, meta, comments area. | | `'tag'` | `$content` (pages with tag) | Loop with tag heading. | | `'category'` | `$content` (pages in category) | Loop with category heading. | | `'search'` | `$content` (search results) | Loop, no page object. | ### Essential Template Variables ```php // Globals always available $WHERE_AM_I // string $page // Page object or false $content // array of Page objects $staticContent // array of Page objects (static pages) $site // Site object $url // Url object $L // Language object $themePlugin // Companion plugin or false // Helpers Theme::metaTagTitle() Theme::metaTagDescription() Theme::plugins('hookName') Paginator::numberOfPages() Paginator::currentPage() Paginator::nextPageUrl() ``` ### If/Else Logic Boilerplate for Theme index.php ```php

title() ?>

content() ?>

title() ?>

contentBreak() ?>
readMore()): ?> Read more

get('No posts found') ?>

1): ?> notFound()): ?>

404 - Page Not Found

content() ?> ``` ### Minimal Hooks Map Insert these exactly where indicated: - `siteHead` → `` after charset/meta - `siteBodyBegin` → after `` - `siteBodyEnd` → before `` - `siteSidebar` → wherever sidebar should appear - `pageBegin` → just before `$page->content()` - `pageEnd` → just after `$page->content()` ### Pagination Quick‑copy ```php if (Paginator::numberOfPages() > 1) { echo ''; } ``` ### Theme Language Utility ```php // In en.json { "theme-data": {...}, "read-more": "Read more" } // In template get('read-more') ?> ``` Use `$L->get()` for all hard‑coded strings; this way the theme is translatable. ### Companion Plugin Read ```php getValue('primaryColor') : '#000' ?> ``` ### Page Template Override ```php template()) { include('page-'.$page->template().'.php'); } else { include('page-default.php'); } ?> ``` --- *This Rulebook is based on the Bludit Pro 3.22.0 patched codebase and does not replicate the full developer reference. For class methods and deeper internals, refer to the main Pro 3.22.0 Developer Reference.*