WP Manifestindependent plugin directory
manifest / editor / ran-enhanced-cover

RAN Enhanced Cover

An enhanced Cover-style block with background video, a poster fallback, and motion-sensitive pause/play controls.

by RAN · github.com/rocketsarenostalgic/ran-enhanced-cover · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/rocketsarenostalgic/ran-enhanced-cover/archive/refs/heads/main.zip
Readme github.com/rocketsarenostalgic/ran-enhanced-cover ↗

Ran Enhanced Cover is a standalone Cover-style WordPress block for background video, a poster fallback, and a visitor-controlled motion preference. Its canonical block name is ran/enhanced-cover.

Features

  • Provides background video or poster-image media with focal point controls.
  • Supports content placement, minimum height, a transparent-media surface colour, an independent colour wash, and nested content.
  • Starts without autoplay and starts playback only when JavaScript confirms that the visitor has not requested reduced motion.
  • A visitor can pause all Video Cover blocks on a site. That non-identifying pause preference is stored in local storage when available; no cookie is set.

Requirements

  • WordPress 6.5 or newer.
  • PHP 8.0 or newer.

Installation

  1. Install the plugin in wp-content/plugins/ran-enhanced-cover.
  2. Activate Ran Enhanced Cover in WordPress administration.
  3. Deploy the committed build/blocks/ runtime assets with the plugin.

The source blocks/ directory is for development. WordPress loads the compiled build/blocks/ assets in production.

Usage

Insert Ran Enhanced Cover from the standard Media category. Choose a background video or poster image, then configure focal point, minimum height, content placement, Background colour, and Colour wash. The selected background colour sits beneath the media, so it is visible through transparent video or poster pixels; the wash remains a separate layer. Add headings, body copy, and buttons as nested content.

Development

Run commands from this plugin directory:

pnpm install --frozen-lockfile
pnpm start
pnpm build
pnpm format:check
pnpm check

Source files live in blocks/. Rebuild build/blocks/ after block changes and commit the generated runtime assets with their source.

Agent workflow

See AGENTS.md for the local Dex workflow, WordPress skills, generated-asset rules, quality checks, and release guidance.

Extensibility and compatibility

The block is not a migration adapter for arbitrary core/cover serialized content. It owns its registration, assets, editor UI, rendering, and styles; it depends only on WordPress APIs and standard theme.json presets.

Rendered markup uses .ran-video-cover* classes and --ran-video-cover-* presentation variables. The frontend player is enqueued only when a block has a selected video; poster-only and empty blocks keep their shared presentation CSS without player JavaScript or controls. The frontend stores an optional non-identifying pause preference under ranVideoCoverPaused in local storage. It does not set or read cookies.

Accessibility and security

Provide a useful poster image or first visible frame so content remains understandable when video cannot play or JavaScript is unavailable. The block honours reduced-motion preferences, exposes a native pause/play control, and keeps the background video out of the accessibility tree. Use only media URLs suitable for public delivery and preserve WordPress media-library permissions.

Releases

The plugin directory contains a WordPress.org-compatible readme.txt, POT template, clean archive allowlist, and SVN hand-off notes. Before a release:

pnpm install --frozen-lockfile
pnpm check
pnpm build
pnpm check:build
composer install
composer lint:syntax
composer standards
pnpm pot
pnpm release
pnpm release:verify
pnpm release:plugin-check

composer test:integration runs WordPress integration tests when WP_TESTS_DIR points to an installed WordPress test library. See tests/README.md for setup details. pnpm release:plugin-check runs the official WordPress Plugin Check command against the generated ZIP after Plugin Check has been installed in the target WordPress environment. The archive builder writes files in a stable order with fixed ZIP metadata, checks every Release Please-managed version source, and rejects any archive whose contents differ from the explicit runtime allowlist. Use php scripts/build-release.php --check for a non-persistent archive gate.

License

RAN Enhanced Cover is licensed under the GNU General Public License v2.0 or later (GPL-2.0-or-later).

Support and contributing

Report reproducible issues at RocketsAreNostalgic/ran-enhanced-cover. Include the relevant lint and build output with changes.