=== FWD Easy Virtual Tour Builder ===
Contributors: futurewebdesign
Donate link: https://fwdapps.net/p/evtb/
Tags: virtual tour, 360 panorama, panorama viewer, real-estate
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.0
Stable tag: 1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build immersive 360 virtual tours with multi-scene navigation, hotspots, camera presets, floor-map navigation, and realistic rendering.

== Video tutorial ==
https://www.youtube.com/watch?v=_OQun-eA1wY

== Demo ==
<a href="https://fwdapps.net/p/evtb/" target="_blank">Demo page</a>

== Description ==
FWD Easy Virtual Tour Builder helps you create responsive virtual tours from equirectangular panoramas (JPG/PNG/KTX2). Add interactive markers with tooltips and rich HTML/CSS info windows, switch smoothly between scenes, save camera positions, and use floor-map navigation for a complete cross-device experience.

== Highlights ==
**Immersive 360 Virtual Tours** - Create responsive tours with smooth scene transitions, configurable camera start views, interactive markers, and floor-map navigation.

**Hotspots/Markers** - Add interactive markers anywhere in the virtual tour. Markers can display tooltips and info windows, open links, switch scenes, and tween the camera to specific positions. <a href="https://fwdapps.net/p/evtb/markers.html" target="_blank">See markers examples</a>.

**Easy To Configure And Install** - Includes documentation, video tutorials, demo pages, updates and support from the developer - <strong><a href="mailto:tibi@fwdapps.net">Tibi @ FWD</a></strong>.

### Main Features
- **Responsive Layout** – Fully responsive and adaptable to any device.  
- **Desktop & Mobile Optimized** – iPhone, Android, and desktop browsers supported.  
- **Panorama Assets (JPG/PNG/KTX2)** - Build tours from high-quality equirectangular panoramas optimized for desktop and mobile.
- **Multi-Scene Virtual Tours** - Create tours with smooth scene switching for a guided walkthrough experience.
- **Camera Presets & Start View** - Save and use camera positions, set an initial view, and guide visitors to key points of interest.
- **Floor-Map Navigator Window** - Add a floor-plan style navigator with customizable markers, icon animation, and expand/collapse support.
- **Table Of Content Navigation** - Let users jump instantly to any scene using a customizable table of content panel.
- **Markers/Hotspots** - Add interactive markers to show tooltips and info windows, open links, switch scenes, and guide attention.
- **Camera Positions Menu** - Let visitors select saved viewpoints from a customizable camera positions menu.
- **Lightbox Support** – FWD Easy Virtual Tour Builder can be opened in a lightbox when the page is ready or triggered by an external action, such as clicking a button. The lightbox layout is fully responsive, and the instance size can be customized as needed, <a href="https://fwdapps.net/p/evtb/lightbox.html" target="_blank">example here</a>.
- **Customizable Size** – Set any width, height, and aspect ratio.  
- **Vector Skin** – Responsive or *after parent* mode.  
- **Preloader** – Vector based preloader that stays sharp on mobile and desktop.
- **Customizable Color Theme** – The color theme of all viewer elements can be easily customized to suit your preferences.
- **Lazy Scrolling/Loading** – Option to initialize FWD Easy Virtual Tour Builder on scroll when the instance is visible in the page. If the instance is in a section that is not visible, it will initialize only when the user scrolls to that section.
- **Customizable Preloader** – Shows loading progress and can display a poster, with configurable size and position.
- **Buttons Controller** – Customizable controller featuring play, zoom in, zoom out, info, help, and fullscreen buttons. The controller automatically hides itself after a designated period of user inactivity.
- **Hide Controller Delay** - Configure how quickly the controller hides after inactivity for a cleaner, more immersive view.
- **Scene Transition Control** - Control how tours start and how transitions feel between scenes for a polished presentation.
- **Info Window With HTML/CSS Content** - Display rich content such as text, images, media, and links directly inside the tour.
- **Share Panel** - Enable social sharing (Facebook, Twitter, LinkedIn, Pinterest, Reddit, and more) with customizable styling.
- **Help Screen** - Add a customizable on-screen help guide for mouse, touch, and keyboard navigation.
- **Orbital Controls** – Customizable 3D orbital controls that allow zooming and camera movement.
- **Orbital Controls Ranges** - The camera rotation can be selectively constrained both horizontally and vertically, alongside customizable minimum and/or maximum zoom settings, adjusting parameters such as zoom factor, damping factor, zoom speed, pan speed, and more, <a href="https://fwdapps.net/p/evtb/rotation-ranges.html" target="_blank">example here</a>.
- **Auto-Rotation** - The 3D virtual tour can be configured for automatic rotation, with the option to customize the rotation speed and direction to suit individual preferences, <a href="https://fwdapps.net/p/evtb/autorotate.html" target="_blank">example here</a>.
- **Keyboard Navigation** - Navigate the virtual tour with keyboard shortcuts, including W A S D controls with adjustable pan speed.


== Configuration ==
After activation, open the plugin settings in the WordPress admin area and create a new viewer preset. Then use this shortcode in any post/page: [fwdevtb id="my-virtual-tour"].


### Use Cases
- Publishing 360 virtual tours for real estate listings and property walkthroughs.
- Creating guided venue tours (hotels, restaurants, museums, campuses, showrooms).
- Building interactive scene-to-scene experiences with markers, tooltips, and info windows.
- Adding floor-map navigation for large spaces with multiple rooms or zones.
- Embedding responsive virtual tours in WordPress posts, pages, and landing pages.

### Links
- [Homepage & Docs](https://fwdapps.net/p/evtb/)
- [Demo](https://fwdapps.net/p/evtb/demos.html)
- [Support](https://fwdapps.net/contact)

== Installation ==
1. Upload the plugin folder to the `/wp-content/plugins/` directory.  
2. Activate the plugin through the ‘Plugins’ menu in WordPress.  
3. Use the provided shortcode in your posts or pages.

== Shortcode ==
Basic example:

[fwdevtb id="1"]

== Development ==
This plugin’s full source code is publicly available for transparency and verification.  
Developed and maintained by [FutureWebDesign](https://fwdapps.net).

- [Source code & build tools](https://fwdapps.net/d/js/evtb.zip) — includes original uncompiled files and Vite build configuration.
- Distributed plugin uses a compiled build generated by Vite for optimal performance.

== Frequently Asked Questions ==
= Does it work with Gutenberg? =  
Yes. You can use the shortcode in any block or the Classic block.

= Is it mobile-friendly? =  
Yes. FWD Easy Virtual Tour Builder is fully responsive and optimized for touch.

== Markers markup ==
Use the editor `Code/Text` tab to add custom HTML inside marker tooltip or marker info window fields.