Opt-in Post Hero WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

A small WordPress plugin that adds two per-post controls and stable post URLs:

• use the featured image as the post hero background;
• compact the post header on mobile;
• publish posts at /blog/<post-slug>/ and permanently redirect their existing dated URLs.

Both visual options are disabled by default. The URL behavior applies to posts automatically. The plugin does not replace templates, modify post content, change the stored permalink structure, or flush rewrite rules.

Compatibility

• WordPress 6.5 or newer
• PHP 8.0 or newer
• Themes that use UiCore's .uicore-page-title post-header structure
• A dated post permalink structure such as /%year%/%monthnum%/%day%/%postname%/

The URL handling uses WordPress hooks and is independent of the active theme. The CSS is narrowly scoped to opted-in single posts. If a future theme update changes the expected selectors, the custom styling stops matching without altering stored content or templates.

Installation

1. Download the release ZIP.
2. In WordPress, open Plugins → Add New Plugin → Upload Plugin.
3. Upload the ZIP and activate the plugin.

Usage

Edit a post and open the Post hero panel. Enable either visual option independently, then save the post. WordPress-generated links for all posts use /blog/<post-slug>/; requests to their dated URLs receive an HTTP 301 redirect.

Local testing

The included Docker-backed WordPress environment reproduces the relevant UiCore post-header structure.

npm install
npm run env:start
scripts/run-integration-tests.sh
npm run env:stop

Releases

Releases are built from tags in the form vX.Y.Z. Before tagging, update the version in opt-in-post-hero.php and the stable tag in readme.txt.

git tag v1.1.0
git push origin v1.1.0

The release workflow verifies the versions, runs the Docker-backed integration tests, and publishes an installable ZIP with its SHA-256 checksum.

License

Copyright (C) 2026 David Leimroth. Licensed under GPL-2.0-or-later. See LICENSE.