About this plugin
A flat image can introduce a page. A panorama can pull people into it.
A360 Panorama Hero provides a dynamic Gutenberg block for building memorable Hero sections with an interactive equirectangular 360-degree image in the background. It is ideal for hotels, real estate, architecture, showrooms, tourism, events, creative portfolios, and any website where space and atmosphere help tell the story.
The foreground content uses native InnerBlocks. Headings, paragraphs, buttons, groups, columns, and other supported WordPress blocks remain editable with standard block editor controls. There is no separate page builder and no unfamiliar content workflow.
Build the Hero your way, invite visitors to look around, and make the most valuable part of the page impossible to ignore.
Lightweight by design
A360 Panorama Hero keeps its footprint focused. Panorama styles and scripts are loaded only on pages where the block or shortcode is used, so the plugin does not add an unnecessary site-wide script payload. It also uses no tracking and requires no external rendering service.
Features include:
- Native dynamic Gutenberg block with InnerBlocks content.
- Lightweight assets loaded only on pages that use a panorama.
- Equirectangular 2:1 panorama images from the Media Library.
- Multiple panoramas with a configurable automatic switching interval.
- Optional random starting panorama, followed by all panoramas in their saved order.
- Black 10×10 px WebP loading image by default, replaceable with a custom poster.
- Automatic rotation with configurable speed and restart delay.
- Default-enabled interaction lock for mouse and touch that preserves automatic rotation.
- Adjustable field of view, overlay opacity, and block height.
- Horizontal and vertical content alignment controls.
- Adjustable content padding.
- Optional, default-enabled localized credit link to the plugin’s WordPress.org page in the Hero’s lower-right corner.
- Optional mouse, keyboard, and touch navigation.
- A shortcode for displaying a standalone panorama.
No external service or user tracking is used by this plugin.
Shortcode
Use an attachment ID, an absolute image URL, or a filename placed in the plugin’s panoramas directory:
5" fov="75" resume="5"]
To start with a random panorama and then continue in saved order, add random="1". The starting point is chosen in the visitor’s browser, so page caching does not lock everyone to the same image.
The existing single-image syntax remains supported: [a360_panorama image="123"]
Supported attributes:
- image – a single attachment ID, image URL, or local filename (backward compatible).
- images – comma-separated attachment IDs, image URLs, or local filenames.
- interval – panorama change interval in seconds.
- random – 1 starts at a random panorama, then continues in saved order; 0 (default) starts with the first panorama.
- poster – optional poster image.
- height – viewer height in pixels.
- speed – automatic rotation speed.
- fov – initial field of view.
- resume – delay before rotation resumes after interaction.
- autoplay – always, respect, or off.
- label – accessible viewer label.