# Changelog
All notable changes to Kayce Custom Archive Sections are documented here.
Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
---
## [2.3.0] — 2026-10-31
### Changed
- Display name is now **Kayce Sections – Add Content to Category & Archive Pages**. The slug and text domain are unchanged.
- Publishing a section needs `edit_others_posts`, so Authors can no longer publish content that shows site-wide.
- Front-end CSS and JS load only once a section is published; block themes skip `frontend.js`.
### Security
- Reorder and duplicate check `edit_post` for each section instead of the general `edit_posts`.
- The activation notice is limited to users who can create sections.
### Fixed
- Bulk activate and deactivate now clear the cache, so a deactivated section stops showing straight away.
- Changing a section's location clears the old location's cache.
- Duplicate copies `_kcas_taxonomy` and `_kcas_terms`.
- Uninstall removes `kcas_cache_expiry_hours`, cached transients and trashed sections.
### Added
- Documentation and Support links on the Plugins screen and Settings page.
## [2.2.1] — 2026-10-24
### Fixed
- **CPT singles** location never matched. `resolve_locations()` tested `is_single()` before the CPT-singles branch, and `is_single()` is true for every post type except pages and attachments, so custom post type singles always resolved to `single_post`. The check is now `is_singular('post')`, so CPT singles reach `cpt_singles` and `single_post` covers blog posts only. Applies to both the classic and block-theme pipelines, which share `resolve_locations()`.
## [2.2.0] — 2026-10-13
### Added
- **Specific terms** location. Targets individual terms within any public custom taxonomy, completing the pair started in 2.1.0 — `taxonomy_archives` covers a whole taxonomy, `specific_terms` covers chosen terms inside it. Mirrors how `specific_categories` relates to `category_archives`.
- Searchable term picker in the meta box. All term lists render up front and are switched client-side, so changing taxonomy costs no request.
- `kcas_terms_picker_limit` filter for sites whose taxonomies exceed the default 500-term cap.
### Changed
- `resolve_locations()` now returns both `taxonomy_archives` and `specific_terms` on `is_tax()` pages, with the term ID as the cache suffix for the latter.
- Submitted term IDs are validated against the section's saved taxonomy on save, and the taxonomy is re-checked on display, so switching taxonomy cannot leave a section matching terms from the previous one.
## [2.1.0] — 2026-10-13
### Added
- **Custom taxonomy archives** location. Targets every term archive of any public custom taxonomy, including WooCommerce product categories and tags. Until now only the built-in Category and Tag archives could be targeted — `is_tax()` was not handled anywhere, so custom taxonomy archives fell through the archive guard entirely.
- **Archive Section block** (`kayce/archive-section`). Embeds a section from the block inserter, including inside Full Site Editing templates where a shortcode cannot be used. Server-rendered from a stored section ID, so an embedded section always reflects its current content.
### Changed
- `KCAS_Frontend::resolve_locations()` now returns a `taxonomy_archives` location on `is_tax()` pages, with the taxonomy slug as the cache-key suffix so two taxonomies never share cached output.
- The block renders through `KCAS_Frontend::render_shortcode()` rather than duplicating it, so block and shortcode embeds cannot diverge in how they apply the active flag, login-state visibility, scheduling, device targeting and role checks.
## [2.0.0] — 2026-05-23
### Added
**New locations**
- **Front page** — targets the static front page (`is_front_page() && !is_home()`). Distinct from the blog index so each can have independent sections.
- **All pages** — targets every static WordPress page (`is_page()`).
- **Specific pages** — targets individual pages selected from a searchable page picker in the meta box. Saved as `_kcas_pages` (array of page IDs).
- **CPT archives** — targets the archive listing page of a specific custom post type. A post-type dropdown appears in the meta box when this location is chosen. Saved as `_kcas_cpt` (CPT slug string).
- **CPT singles** — targets individual posts of a specific custom post type. Uses the same post-type dropdown as CPT archives.
**Display scheduling**
- New **Schedule** fields in the meta box: optional **From** and **To** date pickers (YYYY-MM-DD, HTML5 ``).
- Sections outside their date range are silently skipped on the frontend — no code changes needed in themes.
- Dates are compared against the site's configured WordPress timezone (`current_time('Y-m-d')`), so the admin's notion of "today" always matches the site.
- Both fields are optional; set only one for open-ended scheduling (e.g. "starts on date X, never expires").
- Stored as `_kcas_date_from` / `_kcas_date_to` post meta. Validated server-side with `date_create_from_format('Y-m-d')` before saving.
**Device visibility**
- New **Devices** section in the meta box: three toggle-style checkboxes — **Desktop** (≥ 1025 px), **Tablet** (768–1024 px), **Mobile** (≤ 767 px). All three checked by default (no restriction).
- Implemented entirely in CSS — deselected devices add `kcas-hide-desktop`, `kcas-hide-tablet`, or `kcas-hide-mobile` classes to the `` element; `frontend.css` hides them via `@media` queries.
- No server-side user-agent detection — works with page caching, CDNs, and Vary-free setups.
- Stored as `_kcas_devices` (array of active device slugs).
**User role targeting**
- New **User roles** section in the meta box: scrollable checklist of all registered WordPress roles, sorted alphabetically.
- Leave all unchecked for no restriction (existing behaviour preserved). Tick one or more roles to restrict visibility to those roles only.
- Combines with the existing Visibility setting — a section set to "Logged in" + "Administrator" only shows to logged-in administrators.
- The roles row is automatically hidden in the meta box when Visibility is set to "Logged-out visitors only" (role checks are irrelevant for logged-out users).
- Stored as `_kcas_roles` (array of role slugs). Validated against `wp_roles()->roles` before saving.
**Shortcode — `[kcas_section id="X"]`**
- Render any published, active section anywhere in WordPress content: posts, pages, widgets, Classic Editor, Gutenberg custom HTML blocks, or any plugin that executes shortcodes.
- Accepts a single required attribute: `id` — the post ID of the section to render.
- All display controls are respected: login-state visibility, date scheduling, user role targeting, and device CSS classes are applied exactly as in automatic archive injection.
- Block context is set correctly: on singular pages, dynamic blocks (`core/post-title`, `core/post-featured-image`, etc.) resolve against the viewed post; on archive/other pages, post-specific blocks return empty rather than leaking section metadata.
- Output is never cached — the shortcode already runs inside the page's own cached HTML; caching section output separately would cause stale double-caching.
- The `kcas_section_html` filter fires on shortcode output (position = `'shortcode'`), so developer customisations apply consistently everywhere.
**Drag-drop reordering**
- A drag-handle column (☰) appears as the first column in the Archive Sections list table.
- Handles are revealed only once jQuery UI Sortable is initialised — invisible on screens where sorting is not active (e.g. when a column header sort is applied).
- Drag-drop is automatically disabled when the list is sorted by a column header (`?orderby=…`); reorder by dragging is only meaningful in the default `menu_order` view.
- Dropping a row saves the new order instantly via AJAX (`wp_ajax_kcas_reorder_sections`) — no page reload required. Each section's `menu_order` is updated to its 0-based visual position.
- Default list table sort order changed to `menu_order ASC, title ASC` (was WordPress default). This makes the drag-drop order immediately visible without any URL parameter.
- AJAX handler validates a dedicated nonce (`kcas_reorder`) and `edit_posts` capability; non-KCAS post IDs in the payload are silently skipped.
**Admin UI**
- Location grid reorganised into four labelled groups: **General** (Disabled, Blog index, Front page), **Archives** (All categories, Specific categories, Tags, Authors, Search, Date), **Singular** (Single posts, All pages, Specific pages), **Custom Post Types** (CPT archives, CPT singles — only shown when public non-built-in CPTs are registered).
- **Specific Pages picker** — scrollable, searchable checklist (`kcas_pages[]`); shown/hidden via JS when "Specific pages" is selected; mirrors the existing category picker UI.
- **Post type dropdown** (`kcas_cpt`) — shown/hidden via JS when "CPT archives" or "CPT singles" is selected; lists all public non-built-in CPTs with their singular label and slug.
- Scheduling, Devices, and User roles sections appear below Visibility in the meta box, separated by dividers, with hint text explaining default/no-restriction behaviour.
- Duplicate action copies all new meta keys (`_kcas_pages`, `_kcas_cpt`, `_kcas_date_from`, `_kcas_date_to`, `_kcas_devices`, `_kcas_roles`) to the cloned post.
- List table Location column shows hints (page titles, CPT name) for all picker-based locations.
- Preview button resolves a relevant URL for every new location type.
**Cache / uninstall**
- Five new location slugs added to `KCAS_Cache::LOCATIONS`, version-option busting, and `uninstall.php` cleanup.
---
## [1.1.1] — 2026-05-22
### Fixed
- **FSE / block themes — single post sections not appearing**: sections with the `single_post` location were silently skipped on FSE themes because the `render_block` filter only targeted `core/query` (archive templates). Extended to also target `core/post-content` so sections inject correctly on single post and page templates.
- **FSE / block themes — "After Header" on singular pages**: position was injecting before `core/post-content`, which landed the section between the featured image and the post body. Fixed by targeting the header `core/template-part` block instead — section now appears between the site header and the post title/featured image.
- **FSE / block themes — "Before Posts" on singular pages**: now also injects at the header template part level (same as After Header), so it appears before the title and featured image rather than mid-post.
- **All themes — section design breaking on every other page load**: WordPress generates dynamic layout class names (e.g. `wp-container-*-is-layout-N`) whose counter increments globally across blocks on the page. Caching the rendered HTML meant the class names in cache never matched the CSS output to `wp_footer` on the next request. Fixed by caching only the raw section data (post IDs + block markup) and always rendering blocks fresh per request, so class names and CSS are always in sync.
- **All themes — post content disappearing after sections rendered**: missing `wp_reset_postdata()` after the section rendering loop left `$GLOBALS['post']` pointing at the last `kcas_section` post; the theme then read the wrong post for its own output. Reset call restored.
- **Theme switch — stale section output**: switching the active theme left transient-cached section HTML rendered under the old theme's block styles. Cache is now busted automatically on `switch_theme`.
- **Classic themes with sidebar (e.g. ColorMag) — "After Header" inside column**: the JS repositioner ran a single pass, moving the section from inside the posts loop to `#cm-primary` but stopping there — still inside the column layout. Repositioner now loops until the section stops moving, correctly lifting it outside the columns row to full-width.
---
## [1.1.0] — 2026-05-22
### Added
**Positions**
- New **After Header** (`before_content`) position — injects section between the site header and page content area, outside the posts grid
- Theme-hook cascade for classic themes: Astra (`astra_header_after`), Genesis (`genesis_after_header`), OceanWP (`ocean_after_header`), Kadence (`kadence_after_header`), Neve (`neve_after_header_wrapper`), Storefront (`storefront_after_header`), Hestia (`hestia_after_header`), ColorMag (`colormag_before_primary_content`), Blocksy (`blocksy:header:after`), Hello Elementor (`hello_elementor_after_header`), Divi (`divi_after_header`), Enfold (`enfold_after_header`)
- `assets/js/frontend.js` — JavaScript safety net that auto-repositions `before_content` sections on unknown classic themes by detecting `article` siblings and moving the section before the posts container
**Admin features**
- Quick Edit — update Active, Position, and Visibility directly from the list table
- Bulk actions — Activate / Deactivate multiple sections at once
- Sortable columns — Active, Location, Position, Visibility column headers are all sortable
- Settings page (Archive Sections → Settings) — configure cache expiry 0–168 hours; 0 disables caching
- Activation welcome notice with a direct link to create the first section
- Friendly empty-state card in the list table when no sections exist yet
**Locations**
- Single post support — sections can target individual post pages (`is_single()`)
**i18n / developer**
- `languages/kayce-custom-archive-sections.pot` — POT translation template
- Full CPT label set: `archives`, `attributes`, `items_list`, `items_list_navigation`, `filter_items_list`, etc.
- `includes/class-kcas-settings.php` — new Settings class with `KCAS_Settings::get_cache_expiry_seconds()` helper
- `assets/css/frontend.css` — minimal, non-opinionated frontend spacing styles
### Changed
**Admin UI (meta box redesign)**
- Active field: flat checkbox → CSS toggle switch with on/off label and hint text
- Location field: radio list → two-column Dashicon card grid (9 options including Disabled)
- Position field: two inline radios → vertical segmented button group; now includes After Header as third option
- Visibility field: inline radios → vertical segmented button group (one option per row)
- Category picker: added live search input with leading search icon; list items now show post-count badges; checked items highlighted
- Preview button: full-width styled button with external-link Dashicon
- Position section hidden entirely when Location is set to Disabled
**Caching**
- `KCAS_Cache::set()` now reads expiry from `KCAS_Settings::get_cache_expiry_seconds()` if available, falling back to the hardcoded 12-hour constant
- Cache key for `single_post` location now includes the queried post ID — each post gets its own cached copy
**List table**
- Position column now shows "After header" label for `before_content` value
- Quick Edit position `