Embed interactive wide/panoramic images on your site. Optimised for responsive layouts, it works great with devices equipped with motion sensors.
Easy Panorama plugin for WordPress websites allows you to display wide/panoramic images in a more accessible way: enjoy your panoramic photos scrolling them on the x-axis or moving your mobile device.
You can start embedding your panoramic images using the handy shortcode (TinyMCE editor) or the new Block.
Easy Panorama uses the packed Paver.
Include your favourite panoramic images in posts and pages using the built-in shortcode functionality.
If you are using the classic WordPress editor (TinyMCE), you will find the Add Panorama button above the editor: click on the button and select the image you want to include.
The shortcode will be inserted in the editor and replaced by the panoramic viewer when you visit the website.
You can customize the appearance and behaviour of the panoramic viewer through the Easy Panorama settings page or adding specific attributes to each shortcode: these will override the general settings.
id
: attachment/image WordPress id (number) – Requiredurl
: image url (string)meta
: determines whether a metadata overlay should be displayed (boolean)title
: image title, showed on overlay in case “Show image meta” (“meta” attribute) is set to true (string)alt
: image alternative text, showed on overlay in case “Show image meta” (“meta” attribute) is set to true (string)graceful_failure
: allows the display of failure message (boolean)failure_message
: this message will appear in mobile devices with no gyroscopic data or no physical orientation support (string)failure_message_insert
: the location where the failure message will be inserted (before | after)minimum_overflow
: the excess width the picture must have before panoramic viewer kicks in (number)start_position
: the start position of the panorama (number from 0 to 1)Include your favourite panoramic images in posts and pages using the built-in block functionality.
If you are using the Gutenberg editor (WordPress >= 5.0), you find the Panorama block ready to be embedded in your post.
Search for “Panorama” within the blocks list, select it and choose the image you want to include.
You can customize the appearance and behaviour of each panoramic viewer thanks to the Inspector Control.
[easy_panorama]
shortcodes into “Panorama” blocks with one click.Easy Panorama requires:
WordPress >= 4.5 (Required for TinyMCE shortcode)
WordPress >= 5.0 (Required for the new custom Panorama Block feature)
PHP >= 5.6
Node >= 8.9.X (Required for Block development)
Yarn (Required for Block development)
There are many ways to contribute to this plugin:
Need help? Read the FAQ or visit the WordPress.org support page / Github Issue Tracker.
/plugins/
.Done! Now you can embed panoramic pictures into WordPress editor clicking on the “Add panorama” button. Choose the image and insert into the post/page: this will be rendered as panorama image.
If you are using the Gutenberg editor (WordPress >= 5.0), you will find the Panorama Block within the blocks list.
Visit the new admin page (Settings > Easy Panorama) to customize Paver scripts behaviour.
No FAQs ready yet.
<MediaUploadCheck>
+ allowedType
controlwithAPIData
with withSelect
wp.blocks
to wp.editor
ImagePlaceholder
to MediaPlaceholder
[easy_panorama]
accepts attributes for appearance and behaviour customization. See “Shortcode” section<span>
to <button>
. Thanks to icehouzestartPosition
value is sanitized correctly: from absint
to float