Easy Panorama

Description

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.

Main features

  1. Enqueuing of Paver Javascript and CSS files.
  2. Customization of Paver appearance and behaviour from the Panorama Settings page.
  3. Other geek settings in the Advanced Settings page.
  4. [easy_panorama] shortcode to embed panoramic images with no hassle.
  5. Custom Panorama Block for a better editing experience.

Shortcode (Classic WordPress editor)

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.

Shortcode attributes cheat sheet:

  • id: attachment/image WordPress id (number)Required
  • url: 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)

Block (Gutenberg editor)

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.

Block features

  • Embed your panoramic/wide images in the new editor with no hassle.
  • Preview your panorama within the editor.
  • Customize the appearance and behaviour of each panoramic viewer thanks to the Inspector Control.
  • Transform “Image” blocks into “Panorama” blocks with one click.
  • Transform “Panorama” blocks into “Image” blocks with one click.
  • Transform previous inserted [easy_panorama] shortcodes into “Panorama” blocks with one click.

Requirements

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)

Contribution

There are many ways to contribute to this plugin:

  1. Report a bug, submit pull request or new feature proposal: visit the Github repo.
  2. Translate it in your language: visit the WordPress translation page.
  3. Rate it 5 stars on WordPress.org.
  4. Buy me a beer!

Support

Need help? Read the FAQ or visit the WordPress.org support page / Github Issue Tracker.

Screenshots

  • How to embed a Panorama using [easy_panorama] shortcode

  • How to embed a Panorama using Easy Panorama Block

  • How to transform [easy_panorama] shortcode into block

  • Easy Panorama settings page

Installation

  1. Download the plugin from WordPress repository.
  2. Upload the plugin folder in /plugins/.
  3. Activate the plugin.

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.

FAQ

No FAQs ready yet.

Reviews

August 9, 2018
Per il momento do un quattro stelle perché il plugin è ben fatto, ma la documentazione è un po' troppo da esperti. Inoltre qualche parametro configurabile direttamente dal plugin sarebbe auspicabile, come disabilitare il giroscopio. Una volta capito però fa il suo dovere egregiamente
February 20, 2017
Works fine on a desktop (Chrome). SCrolling by mouse, good view with bar on the bottom to indicate where you are in the panorama. On Android (recent version 6) the scrolling is done by device orientation, this means moving/tilting the tablet or phone. And all panorama's on the page respond to the tilting, not just the one you want. So no wipe/touch support for Android alas. Perhaps acceptable on a phone, unusable as is on a tablet. Such a pity, since it is a simple but adequate panorama viewer.
January 28, 2017
For me the best and only way to present panoramas, when you want to provide mobile support. With the fullwidth jquery workaround (see support) and the option to style any img inside a div by adding class easy-panorama (very useful with div shortcode) you are enabled to add panorama where ever you want.
November 5, 2016
Does exactly what it needs to do... a simple implementation of the excellent 'Paver' panorama script that provides a simple yet elegant way of showing big panoramas. Simple to implement and use and it just works!
Read all 4 reviews

Contributors & Developers

“Easy Panorama” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Easy Panorama” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.1.4 (15/12/2018)

  • Bug fix: Added <MediaUploadCheck> + allowedType control
  • Design: Moved tooltip help icon at bottom/right corner of the block

1.1.3 (05/08/2018)

  • Bug fix: Replaced withAPIData with withSelect

1.1.2 (03/08/2018)

  • Bug fix: Updated from Gutenberg wp.blocks to wp.editor
  • Bug fix: Updated from Gutenberg ImagePlaceholder to MediaPlaceholder

1.1.1 (02/05/2018)

  • Bug fix: Paver dependencies are now enqueued in the right order

1.1.0 MAJOR RELEASE (26/04/2018)

  • Updated Paver to 1.3.4
  • New feature: Gutenberg Block
  • New feature: [easy_panorama] accepts attributes for appearance and behaviour customization. See “Shortcode” section
  • Updated readme.txt
  • Updated plugin Overview page

1.0.2 (06/05/2017)

  • Bug fix: HTML error in “Add Panorama” button + changed HTML from <span> to <button>. Thanks to icehouze

1.0.1 (08/10/2016)

  • Updated Paver to 1.3.2
  • Bug fix: startPosition value is sanitized correctly: from absint to float
  • Updated readme.txt
  • Updated plugin Overview page

1.0.0 (09/09/2016)

  • First commit