Title: Easy Panorama
Author: Leonardo Giacone
Published: 2016 年 9 月 12 日
Last modified: 2023 年 1 月 25 日
---
搜尋外掛
這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個
外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。
# Easy Panorama
由 [Leonardo Giacone](https://profiles.wordpress.org/leopeo/) 開發
[下載](https://downloads.wordpress.org/plugin/easy-panorama.1.1.5.zip)
* [詳細資料](https://tw.wordpress.org/plugins/easy-panorama/#description)
* [使用者評論](https://tw.wordpress.org/plugins/easy-panorama/#reviews)
* [安裝方式](https://tw.wordpress.org/plugins/easy-panorama/#installation)
* [開發資訊](https://tw.wordpress.org/plugins/easy-panorama/#developers)
[技術支援](https://wordpress.org/support/plugin/easy-panorama/)
## 外掛說明
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](http://terrymun.github.io/paver/?source=easy-panorama-wp-plugin).
#### 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](https://wordpress.org/) >= 4.5 (Required for TinyMCE shortcode)
[WordPress](https://wordpress.org/)
>= 5.0 (Required for the new custom Panorama Block feature) [PHP](https://secure.php.net/manual/en/install.php)
>= 5.6 [Node](https://nodejs.org/en/) >= 8.9.X (Required for Block development)
[Yarn](https://yarnpkg.com/en/docs/install) (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](https://github.com/leopuleo/easy-panorama).
2. Translate it in your language: visit the [WordPress translation page](https://translate.wordpress.org/projects/wp-plugins/easy-panorama).
3. Rate it 5 stars on [WordPress.org](https://wordpress.org/support/view/plugin-reviews/easy-panorama?filter=5#postform).
4. Buy me a beer!
#### Support
Need help? Read the [FAQ](https://wordpress.org/plugins/easy-panorama/faq/) or visit
the [WordPress.org](https://wordpress.org/support/plugin/easy-panorama) support
page / [Github Issue Tracker](https://github.com/leopuleo/easy-panorama/issues).
## 螢幕擷圖
[⌊How to embed a Panorama using [easy_panorama] shortcode⌉⌊How to embed a Panorama
using [easy_panorama] shortcode⌉[
How to embed a Panorama using [easy_panorama] shortcode
[⌊How to embed a Panorama using Easy Panorama Block⌉⌊How to embed a Panorama using
Easy Panorama Block⌉[
How to embed a Panorama using Easy Panorama Block
[⌊How to transform [easy_panorama] shortcode into block⌉⌊How to transform [easy_panorama]
shortcode into block⌉[
How to transform [easy_panorama] shortcode into block
[⌊Easy Panorama settings page⌉⌊Easy Panorama settings page⌉[
Easy Panorama settings page
## 適用於區塊編輯器
這個外掛提供 1 個可供區塊編輯器使用的區塊。
* Panorama
## 安裝方式
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.
## 常見問題集
No FAQs ready yet.
## 使用者評論
### [Excellent solution on desktop, not so much on mobile.](https://wordpress.org/support/topic/excellent-solution-on-desktop-not-so-much-on-mobile/)
[Chise Hachiroku](https://profiles.wordpress.org/chise86/) 2025 年 4 月 6 日
To begin with, this is really one of the best solution on desktop, as it allows
easy viewing with mouse movement, does not affect scrolling, and still displays
the picture quite nicely when JS is not available. As a design choice, on mobile
platforms the movement is controlled by gyroscope, which is also quite intuitive
when user figured that out, but only when the phone is being viewed with screen
mostly parallel with the ground. It works dramatically worse, flashing from left
to right, when the phone is operated perpendicular to the ground, like when lying
down on one side, and it is rather annoying. I really hope to see this gets resolved,
such as on mobile the gyroscope position could be saved when the JS loads and movement
is based on the delta values from the initial position. I know this is quite unlikely
since it is an issue derived from the underlying solution, which has not been updated
for years. For the time being, I am converting panorama pictures to 360 sphere to
use other solutions out there.
### [Ottimo plugin](https://wordpress.org/support/topic/ottimo-plugin-114/)
[ViaggioControMano](https://profiles.wordpress.org/maxonline/) 2018 年 8 月 9 日
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
### [Not for Android?](https://wordpress.org/support/topic/not-for-android/)
[hansjcotten](https://profiles.wordpress.org/hansjcotten/) 2017 年 2 月 20 日 1
則留言
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.
### [Best Free Panorama Plugin](https://wordpress.org/support/topic/best-free-panorama-plugin/)
[thunfischdose](https://profiles.wordpress.org/thunfischdose/) 2017 年 1 月 28
日
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.
### [Great panorama plugin](https://wordpress.org/support/topic/great-panorama-plugin/)
[flintsonline](https://profiles.wordpress.org/flintsonline/) 2016 年 11 月 5 日
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!
[ 閱讀全部 5 則使用者評論 ](https://wordpress.org/support/plugin/easy-panorama/reviews/)
## 參與者及開發者
以下人員參與了開源軟體〈Easy Panorama〉的開發相關工作。
參與者
* [ Leonardo Giacone ](https://profiles.wordpress.org/leopeo/)
[將〈Easy Panorama〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/easy-panorama)
### 對開發相關資訊感興趣？
任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/easy-panorama/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/easy-panorama/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/easy-panorama/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/easy-panorama/)。
## 變更記錄
#### 1.1.5 (23/01/2023)
* Bug fix: Sanitize and escape admin input fields. Thanks to [riodrwn](https://twitter.com/riodrwn)
#### 1.1.4 (15/12/2018)
* Bug fix: Added `` + `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 `` to `