MV 360 Tour

MV 360 Tour / plugin documentation version 1.1.0


Introduction


First of all, Thank you so much for purchasing this plugin and for being my loyal customer. You are awesome!

Getting Started #back to top

Plugin installation

First thing you need to do is go to your WordPress admin area and click on Plugins » Add New.
After that, click on the Upload Plugin button on top of the page.
This will bring you to the plugin upload page. Here you need to click on the choose file button and select the plugin file mv360tour.zip
After you have selected the file, you need to click on the install now button.
WordPress will now upload the plugin file from your computer and install it for you. You will see a success message like this after the installation is finished.
Once installed, you need to click on the Activate Plugin link to start using the plugin.

Manually Install a WordPress Plugin using FTP

In some cases, your WordPress hosting provider may have file restrictions that could limit your ability to install a plugin from the admin area.
In this situation, your best bet is to install the plugin manually using FTP.
The FTP manager method is the least friendly for beginners.
First you need to extract the zip file (mv360tour.zip) on your computer.
Extracting the plugin zip file will create a new folder with the same name. This is the folder that you need to manually upload to your website using a FTP client.
You would need to access your host through the FTP manager. If you do not have your FTP username and password, then contact your WordPress hosting provider and ask them.
Open the FTP client on your computer and connect to your website using the login credentials provided by your web host.
Once connected, you need to access the path /wp-content/plugins/
Next, upload the folder you extracted from the zip file to the /wp-content/plugins/ folder on your web server.
After uploading the files, you need to visit the WordPress admin area and click on the Plugins link in the admin menu.
You will see your plugin successfully installed on the plugins page.
You need to click on the Activate link below the plugin.

Virtual tour #back to top

To create a new tour

- Click on the menu item “Tour 360” and then on “Add new”
- Insert the title of the tour

To create a scene

- Click on the item "Add panorama"
- Type a title and click on "Add"
- Choose or upload a 360 picture (equirectangular 2:1) and click on the item "Insert into post" bottom - right

To edit a scene

- Open a scene by clicking on the icon of the pencil above it
- Under the image there are four icons: "Change image", "Set scene position", "Add Hotspot", "Set as first scene"

Change image

- This allows to change the image of the scene

Set scene position

- This allows to set the initial display of a specific scene

Add Hotspot

This allows to insert a hotspot in your scene.
There are four types of Hotspot, each one with its features:
- Text -> by clicking on the Hotspot a text is shown
- Image -> by clicking on the Hotspot an image is shown
- Video -> by clicking on the Hotspot a video is shown (using a Youtube or Vimeo embed)
- Change Scene -> by clicking on the Hotspot another scene of the tour is opened
When you insert a Hotspot, it is placed at the center of the picture. To move it you have to select it (by clicking on the Hotspot) and later double click on the spot you want.
When a Hotspot is selected, a box named “Hotspot” will appear in the right sidebar, with fields to fill in (different according to the type of Hotspot).

Types of Hotspot and related fields

There are fields in common for every Hotspot, which are:
- Hotspot title: it is the title of the Hotspot, shown in a popup when you click on the Hotspot
- Hotspot icon: it is the icon of the Hotspot
- Hotspot popup width (px): it is the width of the popup that opens by clicking on the Hotspot
- Hotspot popup title color: it is the color of the title of the popup
- Hotspot popup background color: it is the color of the background of the popup

Text
Hotspot that, at the click, opens a popup and shows a text.
Field to fill in:
- Hotspot popup text: text shown in the popup

Image
Hotspot that, at the click, opens a popup and shows a text.
Field to fill in:
- Hotspot popup text: text shown in the popup

Video
Hotspot that, at the click, opens a popup and shows a video from YouTube or Vimeo.
Field to fill in:
- Hotspot video url: link to the video (YouTube o Vimeo) shown in the popup

Change Scene
Hotspot that, at the click, opens a popup and shows an image.
Field to fill in:
- Hotspot scene: drop-down menu where you can select the destination scene. By clicking on “Set Position” you can also choose the position where the scene will open

Set as first scene

- This allows to choose the first scene displayed when you open the tour

Delete a scene

- Click on the basket icon above it

Options

- on the right sidebar you find the following options:
Primary color: this allows to choose the color of the directional icons, the zoom, the title of the scene and the menu
Secondary color: this allows to choose the background color of the directional icons, the zoom, the title of the scene and the menu
Autostart: when selected, the image will automatically rotate
Zoom controls: when selected, the icons to control the zoom are shown
Move controls: when selected, the icons to rotate the image are shown
Thumbnails menù: when selected, a new image field is opened; this field, named “thumbnail” is shown inside every scene where you can insert a thumbnail of the scene; this thumbnail will be shown in the menu
Hide menu: when selected, the menu will not be created
Disable zoom on scroll: when selected, disable zooming by scrolling the mouse
Embed height: height of the tour proportional to the width (only when used as embed; in the single viewing it will be displayed on full screen)
Embed height tablet (from 480px to 960px): height of the tour proportional to the width (only when used as embed; in the single viewing it will be displayed on full screen) – tablet view
Embed height mobile (from 0 to 480px): height of the tour proportional to the width (only when used as embed; in the single viewing it will be displayed on full screen) – mobile view

Custom CSS

At the bottom of the page there is an editor with which you can insert the CSS code, that will be added only on the pages where the tour is displayed.

Version History (Changelog) #back to top

Changelog

                                  -----------------------------------------------------------------------------------------
                                  Version 1.1.0 - October 8th, 2019
                                  -----------------------------------------------------------------------------------------

                                  - new hotspot type
                                  - improved code quality

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.12 - June 21th, 2019
                                  -----------------------------------------------------------------------------------------

                                  - bug fix
                                  - added Dutch

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.11 - June 17th, 2019
                                  -----------------------------------------------------------------------------------------

                                  - bug fix

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.10 - June 12th, 2019
                                  -----------------------------------------------------------------------------------------

                                  - added new function to embed
                                  - bug fix

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.9 - May 13th, 2019
                                  -----------------------------------------------------------------------------------------

                                  - bug fix

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.8 - March 28th, 2019
                                  -----------------------------------------------------------------------------------------

                                  - added fullscreen support and gyroscope

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.7 - March 9th, 2019
                                  -----------------------------------------------------------------------------------------

                                  - change encoding of content

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.6 - February 27th, 2019
                                  -----------------------------------------------------------------------------------------

                                  - bug fix

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.5 - February 26th, 2019
                                  -----------------------------------------------------------------------------------------

                                  - add support on full size images

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.4 - October 25th, 2018
                                  -----------------------------------------------------------------------------------------

                                  - add support on 360 video

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.3 - September 10th, 2018
                                  -----------------------------------------------------------------------------------------

                                  - when they are uploaded, the images are automatically resized

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.2 - August 29th, 2018
                                  -----------------------------------------------------------------------------------------

                                  - when you choose the scene position, the zoom is also set

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.1 - August 22th, 2018
                                  -----------------------------------------------------------------------------------------

                                  - added RTL support

                                  -----------------------------------------------------------------------------------------
                                  Version 1.0.0 - August 1th, 2018
                                  -----------------------------------------------------------------------------------------

                                  - first version