# ACL Trace ACL Trace 3.1.0 is a terminal-inspired editorial block theme for WordPress with a flexible semantic palette, responsive typography, native templates, native Navigation, Query Loops, and production-ready patterns. Start with the included dark neon design or switch to Trace Light, then customize colors through Global Styles. ACL Trace includes its complete theme feature set with no paid tier, locked controls, or required premium upgrade. ACL Trace is free and open-source under the GPL. The theme is a presentation layer. Site metadata, schema, breadcrumbs, canonical and robots controls, discovery controls, and other site behavior belong to WordPress core or optional plugins. ## Version 3.1.0 Version 3.1.0 combines the native Front Page and posts-index showcase with maintenance compatibility corrections. This front-page update was validated on WordPress 6.8 and 7.1.1 with PHP 8.2.29. The Tested up to metadata is 7.1, reflecting validation on WordPress 7.1.1. The theme adds fallback values for the existing radius CSS variables and loads parent and child styles through `enqueue_block_assets`, so editor CSS no longer requires a server-side HTTP request. The Body Text palette now uses `body-text`. The old `text` slug generated `.has-text-color`, which WordPress also uses for custom text colors. That generated rule could override custom red, Canvas, and other earlier palette entries. Legacy blocks retain their saved `textColor: "text"` attribute and receive a narrowly targeted presentation class during rendering and in the editor. The legacy `--wp--preset--color--text` variable and Text background/border classes remain available. Saved Global Styles palettes are translated for presentation through public theme JSON and REST filters. An explicit Global Styles save retains the old palette key when that key already exists in storage. Normal WordPress validation, permissions, and save behavior continue to apply. No upgrade routine or automatic content/database migration runs, and existing blocks do not need resaving. The editor-only compatibility script does not add block attributes or change block serialization. Rolling back to 3.0.9 preserves the data but restores its original color collision. Child-theme authors can use `body-text` for new palette references. Existing Text CSS references and existing saved Text blocks remain supported. ## Requirements | Dependency | Supported version | | --- | --- | | Minimum supported WordPress version | 6.8 | | Tested up to WordPress | 7.1 | | PHP | 8.0 or later | ACL Trace has no build step, no runtime package dependencies, no remote fonts, and no frontend theme JavaScript. A small editor-only script preserves the presentation of legacy Text blocks. ## Features The native Front Page template displays the designed showcase at the root in both Reading modes. Selected static Page content renders between the cards and independent six-post Query Loop. A separate Posts page retains Blog Home and its inherited query. Saved template overrides retain WordPress precedence. - Block-theme architecture with twelve native templates and editable template parts. - `theme.json` v3 tokens for the flexible semantic palette, internal subtle border color, layout, spacing, shadows, motion, and responsive typography. - Curated semantic colors and custom color selection without enabling the WordPress default palette. - Trace Light style variation with a soft off-white canvas and complete light semantic mapping; the included dark neon design remains the default. - Native Navigation with a portable Page List fallback and WordPress's mobile overlay behavior. - Palette-neutral component behavior for Trace Cards, buttons, forms, Query Loops, comments, tables, quotes, code, Details, and media. - Visible keyboard focus, forced-colors support, reduced-motion behavior, readable overflow handling, and semantic template landmarks. - Eight original public patterns: Signal Hero, Signal CTA, Feature Grid, Two Column Content, Media and Text, Post Grid, Testimonials, and FAQ. - Insert ACL Trace Showcase from the Page Pattern inserter to add the full composition as editable Page content. This is separate from selecting the showcase template. - Select **ACL Trace Showcase** as any Page's template for the complete showcase, independent of Reading settings and Page content. Its separate Page Query pattern displays six recent posts. - Six additional posts-index showcase patterns provide hero, media, cards, query, closing CTA and navigation sections. - Parent and child stylesheets loaded separately with independent file modification versions. ## Installation 1. In WordPress, open **Appearance > Themes > Add New > Upload Theme**. 2. Select **acl-trace-3.1.0.zip** and choose **Install Now**. 3. Install and activate ACL Trace. 4. Open **Appearance > Editor** to customize Styles, templates, parts, and Navigation. The installed directory must be `wp-content/themes/acl-trace/`. ## Site Editor customization The default palette, typography, layout widths, spacing, and component styles are defined in `theme.json`. Use the Site Editor to customize supported settings. Custom color selection is enabled without enabling the WordPress default palette. Theme files remain the canonical defaults until a user saves a Global Styles, template, or template-part override. The user-editable Text color is independent from the theme's internal subtle border color. Media blocks and generic Groups are border-free by default; intentional Trace Cards and separators use the internal border token, and borders explicitly selected in the editor remain available. WordPress 6.8 retains its standard custom border-radius control. On WordPress 6.9 and later, ACL Trace also restores the Small, Control, Card, and Pill named radius presets supported by those releases. The header uses the native Navigation block with a Page List fallback. Replace or edit it in the Site Editor without custom JavaScript. ACL Trace follows the WordPress template hierarchy with a native `front-page.html` template. Both **Your latest posts** and a static front page display the designed showcase at the root. The selected static Page's content renders between the component cards and Query Loop. In latest-posts mode the Page-content slot stays empty, while the independent Query Loop displays six recent posts. A separate Posts page uses the unchanged `home.html` and its inherited query. Saved user templates retain normal WordPress precedence. ## Style variations Open Global Styles and browse styles to select **Trace Light**. Its palette retains every semantic color slug while remapping the values for a light presentation. Choose the theme default or reset the selected variation to return to the included dark presentation. ## Included patterns All patterns are available from the ACL Trace inserter category: 1. Signal Hero 2. Signal CTA 3. Feature Grid 4. Two Column Content 5. Media and Text 6. Post Grid 7. Testimonials 8. FAQ Pattern copy, links, images, queries, and citations are starter content and remain editable after insertion. ## Screenshot source `screenshot.png` is a 1200 x 900 capture of ACL Trace rendered with native theme blocks and the included dark default. Magenta and cyan are the default presentation, not a palette limitation. The screenshot contains no website URL, pricing claim, promotional banner, or call to action. ## Child themes Set `Template: acl-trace` in the child theme's `style.css`. ACL Trace loads the parent stylesheet once and then loads the child stylesheet once as a dependent asset. Each file uses its own modification time for cache invalidation. The editor receives the same parent-then-child order, and child `theme.json` settings inherit from the parent through WordPress core. ## Optional companion plugins No companion plugin is required. - ACL Site Style Kit can override palettes and typography. - ACL Site Essentials can provide optional metadata, schema, breadcrumbs, canonical/robots controls, discovery controls, and frontend emoji settings. - ACL Featured Image Plus can provide enhanced featured-image presentation. ## Known limitations - ACL Trace 3.1.0 includes no third-party commerce templates, styles, or support claims. - The Page List navigation fallback reflects published pages until a site owner creates or assigns a custom native Navigation menu. - Assistive-technology behavior can vary by browser and should be verified against the content and plugins used on the destination site. ## Development checkout upgrade note Development checkouts named `acl-trace-main` are separate themes from the production `acl-trace` package. Installing 3.1.0 does not automatically move theme mods, Global Styles, saved templates, saved template parts, Navigation references, Custom CSS, or widget assignments from the development slug. Back up the database, install the production package alongside the development checkout, migrate only verified slug-scoped records, activate `acl-trace`, verify the Site Editor and front end, and retain `acl-trace-main` until rollback testing is complete. ## File structure ```text acl-trace/ |-- CHANGELOG.md |-- licence.txt |-- license.txt |-- README.md |-- functions.php |-- readme.txt |-- screenshot.png |-- styles/ | `-- trace-light.json |-- style.css |-- theme.json |-- inc/ | |-- assets.php | |-- block-patterns.php | `-- color-compat.php |-- languages/ | `-- acl-trace.pot |-- parts/ (4 template parts) |-- patterns/ (16 patterns) `-- templates/ (12 templates) ``` ## License ACL Trace WordPress Theme, Copyright 2026 Ashes Creative Labs. ACL Trace is distributed under the terms of the GNU General Public License v2 or later. See `license.txt` for the complete GNU General Public License version 2 text. The `licence.txt` compatibility notice supports the legacy filename used by WordPress.org Theme Check 20231220.