=== Papatto 360 Tour ===
Contributors: netscrander
Tags: virtual tour, 360, panorama, floor plan, real estate
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.0
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create unlimited virtual tours with unlimited WordPress Media Library panorama scenes and one floor-plan image.

== Description ==

Papatto 360 Tour creates interactive 360° virtual tours directly in the WordPress admin. It is suitable for real estate, accommodation, stores, schools, public facilities, and any place that benefits from a visual walk-through.

Create unlimited virtual tours with unlimited WordPress Media Library panorama scenes. Navigate from the public scene list or markers on one floor-plan image.

**Tour and viewer features**

* Add panorama scenes from the WordPress Media Library.
* Upload multiple JPEG, PNG, or WebP panorama files by drag and drop.
* Display a public scene list beside the 360° panorama viewer.
* Add one floor-plan image and position a marker for every scene.
* Navigate to a scene from either its list button or floor-plan marker.
* Set the opening scene, yaw, pitch, field of view, and autorotation.
* Add a description to each scene and an information area to the tour.
* Choose a per-tour folder under WordPress uploads.
* Embed a published tour with a shortcode.

`[papatto_360_tour id="123"]`

The separately distributed **Papatto 360 Tour Pro** product adds multi-floor tours, Google Maps, path arrows, information spots, video spots, and reuse of same-site legacy images. Pro is installed by replacing this plugin ZIP and preserves the common tour data.

This plugin bundles the [Pannellum](https://pannellum.org/) panorama viewer under the MIT License.

== External services ==

The WordPress.org edition does not contact external services. Pannellum is bundled with the plugin and loaded locally. Panorama and floor-plan images are selected from, uploaded to, and served by the site owner's WordPress installation.

== Installation ==

1. Install the plugin ZIP from Plugins → Add New Plugin → Upload Plugin, or copy the `papatto-360-tour` folder to `/wp-content/plugins/`.
2. Activate Papatto 360 Tour.
3. Open Panorama Tours → Add New Tour.
4. Add panorama scenes, optionally choose one floor-plan image, and place the scene markers.
5. Choose the opening scene and viewing direction, then publish the tour.
6. Paste the shortcode shown in the tour sidebar into a page or post.

== Screenshots ==

1. Add and organize panorama scenes in the WordPress tour editor.
2. View the published tour at its opening scene with the scene list and floor-plan markers.
3. Navigate the published tour to another scene from the scene list or floor-plan markers.

== Frequently Asked Questions ==

= What image format do the panoramas need? =

Use equirectangular panorama images, normally with a 2:1 aspect ratio, in JPEG, PNG, or WebP format.

= Do I need a floor plan? =

No. Without a floor-plan image, the panorama viewer and public scene list remain available.

= How many tours and panorama scenes can I create? =

You can create unlimited tours with unlimited panorama scenes backed by WordPress Media Library attachments.

= What does the separately distributed Pro product add? =

Papatto 360 Tour Pro adds multi-floor tours, Google Maps, path arrows, information spots, video spots, and same-site legacy-image reuse. The WordPress.org edition is complete and works independently.

= Are the original images resized? =

Images uploaded through the tour editor keep their original resolution. WordPress intermediate-size generation and the large-image scaling threshold are skipped only for authenticated panorama uploads from this editor.

== Changelog ==

= 1.2.0 =
* Added unlimited WordPress Media Library panorama scenes and unlimited tours.
* Added the public scene list and single-floor-plan marker navigation.
* Added schema-2 common data migration and replacement-compatible storage.
* Separated the WordPress.org implementation from all Pro implementation files.
* Bundled the Free editor, viewer, and Pannellum library; translations are delivered through WordPress.org language packs.
