| @@ -1,12 +1,12 @@ | ||
| 1 | -=== WP VR - 360 Panorama and Virtual Tour Builder === | |
| 1 | +=== WPVR - 360 Panorama viewer and Virtual Tour Builder for WordPress === | |
| 2 | 2 | Contributors: rextheme, coderexltd, coderexco |
| 3 | -Tags: virtual tour, virtual reality, 360 panorama viewer, real estate, vr tour | |
| 3 | +Tags: 360 panorama, panorama viewer, virtual tour,real estate | |
| 4 | 4 | Donate link: https://rextheme.com/wp-vr-360-panorama-and-virtual-tour-creator-for-wordpress/ |
| 5 | 5 | Requires at least: 6.7 |
| 6 | -Tested up to: 7.0 | |
| 6 | +Tested up to: 7.1 | |
| 7 | 7 | Requires PHP: 7.0.0 |
| 8 | -Stable tag: 8.5.75 | |
| 8 | +Stable tag: 9.1.3 | |
| 9 | 9 | License: GPLv2 or later |
| 10 | 10 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 11 | 11 | |
| 12 | 12 | Create stunning 360 virtual tours to impress visitors and get more clients using WPVR - an easy virtual tour creator. |
| @@ -12,13 +12,13 @@ | ||
| 12 | 12 | Create stunning 360 virtual tours to impress visitors and get more clients using WPVR - an easy virtual tour creator. |
| 13 | 13 | |
| 14 | 14 | == Description == |
| 15 | 15 | |
| 16 | -<h4>🏆 Excellent Virtual Tour Creator and 360 Panorama Viewer.</h4> | |
| 16 | +<h4>#1 virtual tour creator & 360 Panorama viewer for WordPress</h4> | |
| 17 | 17 | |
| 18 | -WPVR is a free virtual tour creator that helps you build immersive 360 VR tours in minutes - no complexity at all. | |
| 18 | +WPVR is a free virtual tour creator that helps you build immersive 360 VR tours in minutes. | |
| 19 | 19 | |
| 20 | -With this WPVR plugin, you can use an effective 360 panorama viewer to showcase properties, shops, hotels, or exhibitions. Visitors can explore your space freely, interact with key areas, and gather the details they need to make a decision more quickly. | |
| 20 | +Create interactive 360° virtual tours and panorama viewers directly in WordPress. Build real estate property tours, hotel tours, showrooms and immersive 360 experiences using panoramic photos — no coding or external SaaS required. | |
| 21 | 21 | |
| 22 | 22 | |
| 23 | 23 | <h3>🌟 Why Use WPVR?</h3> |
| 24 | 24 | WPVR comes with all the necessary features to create a free virtual tour on your own — all you need is a 360 panoramic image to get started. |
| @@ -24,9 +24,9 @@ | ||
| 24 | 24 | WPVR comes with all the necessary features to create a free virtual tour on your own — all you need is a 360 panoramic image to get started. |
| 25 | 25 | |
| 26 | 26 | <a href="https://rextheme.com/wpvr/wpvr-pricing/">Upgrade to Pro — Get 20% Off!</a> |
| 27 | 27 | |
| 28 | -[Documentation](https://rextheme.com/docs/wp-vr/) | [Video Tutorials](https://www.youtube.com/watch?v=aNwB066MYko&list=PLelDqLncNWcUndi1NkXJh2BH62OYmIayt&ab_channel=RexTheme) | [Guides](https://rextheme.com/category/virtual-reality/) | [Get WPVR Pro 💎](https://rextheme.com/wpvr/wpvr-pricing/?utm_source=repo-CTA&utm_medium=VR-repo&utm_campaign=VR-repo-to-pricing) | |
| 28 | +[Documentation](https://rextheme.com/docs/wp-vr/) | [Video Tutorials](https://www.youtube.com/watch?v=aNwB066MYko&list=PLelDqLncNWcUndi1NkXJh2BH62OYmIayt&ab_channel=RexTheme) | [Guides](https://rextheme.com/category/virtual-reality/) | [Get WPVR Free](https://rextheme.com/free-virtual-tour-creator/?utm_source=WPVR-repo&utm_medium=cta&utm_campaign=WPVR-repo-to-wpvr-free-landing-page) | [Get WPVR Pro 💎](https://rextheme.com/wpvr/wpvr-pricing/?utm_source=repo-CTA&utm_medium=VR-repo&utm_campaign=VR-repo-to-pricing) | |
| 29 | 29 | |
| 30 | 30 | https://youtu.be/ukpHp8RzxUw?si=y_uQwNQUD2VT0vxh |
| 31 | 31 | |
| 32 | 32 | WPVR has a simple & easy virtual tour builder specially for real estate, designed for you to make virtual tours quickly, even without any expertise. |
| @@ -344,91 +344,93 @@ | ||
| 344 | 344 | |
| 345 | 345 | |
| 346 | 346 | == Frequently Asked Questions == |
| 347 | 347 | |
| 348 | -=1. Why Do I Need WP VR?= | |
| 348 | +=1. Is WPVR completely free? Is there any limitation?= | |
| 349 | 349 | |
| 350 | -You can easily create a free virtual tour with WP VR to showcase your business online. | |
| 350 | +WPVR offers a fully functional free version. The free plugin allows you to create unlimited virtual tours, with up to 5 scenes per tour and 5 hotspots per scene. This is plenty for a compact home or apartment. | |
| 351 | 351 | |
| 352 | -Just upload a 360° panoramic photo, and the plugin turns it into an easy-to-navigate virtual tour. | |
| 352 | +You can upgrade to Pro for unlimited scenes, unlimited hotspots, virtual floor plans, and advanced features. | |
| 353 | 353 | |
| 354 | -This lets visitors explore your space realistically before buying, helping you increase conversions. | |
| 354 | +=2. Do I need any coding or technical skills to build my first tour?= | |
| 355 | 355 | |
| 356 | -=2. How to Install and Activate WP VR?= | |
| 356 | +Not at all. You don't have to touch a single line of code. Just upload your 360 photos, connect your rooms, and drop in a few clickable hotspots from a simple dashboard. | |
| 357 | 357 | |
| 358 | -Once you have downloaded the file, go to your dashboard. Under Plugins, select Add New, and upload the file. Then Install and activate the plugin. | |
| 358 | +You'll likely have your very first live tour in under five minutes. | |
| 359 | 359 | |
| 360 | -Once activated, on the left side under your dashboard, you will find the option WP VR at the bottom. | |
| 360 | +=3. Why should I add a virtual tour to my property listing instead of just photos?= | |
| 361 | 361 | |
| 362 | -=3. What Kind of Images Should I Use To Create A Virtual Tour?= | |
| 362 | +Your photos only show a single snapshot, but a tour lets your buyers walk through your whole place at their own pace. | |
| 363 | 363 | |
| 364 | -To make a perfect equirectangular image, you need to use a 360 degree panoramic photo of the area you want to preview. | |
| 364 | +They can explore every room without booking a visit, so that when they contact you, they are already serious. | |
| 365 | 365 | |
| 366 | -However, you can also capture panorama images with your smartphone and use them to create a partial panorama tour. | |
| 366 | +You save time, and your listing stands out from everyone still posting flat photos. | |
| 367 | 367 | |
| 368 | -=5. Can I Customize The Hotspot Icons?= | |
| 368 | +=4. How do I create virtual tour? Upload photos using an app or record a video, what's the process? = | |
| 369 | 369 | |
| 370 | -Yes. You can create a custom class on your theme, stating whatever style you want. | |
| 370 | +You'll need to upload a 360 panoramic, and the plugin will turn it into a 360 virtual tour. | |
| 371 | 371 | |
| 372 | -Then you can input the class name on the Hotspot Custom Class section in a hotspot, and the content displayed will be customized according to the style you set. | |
| 372 | +For a house, you can capture 360 photos of every room using a smartphone or iPhone with specific apps. | |
| 373 | 373 | |
| 374 | -=6. Can I Create A 360 Degree Video Tour With WPVR?= | |
| 374 | +And if you want a cleaner, more professional look, use a 360 camera (e.g., Ricoh Theta, Insta360, GoPro MAX). | |
| 375 | 375 | |
| 376 | -Yes, with WP VR, you can create a 360 Degree video tour. | |
| 376 | +Try to keep your shots high-resolution (over 3000×1500 pixels, so every room looks sharp. | |
| 377 | 377 | |
| 378 | -You can either upload the video to create a tour or set a link to a Youtube/Vimeo 360 degree video. | |
| 378 | +Once you have the photos, you upload them into WPVR and connect them via hotspots to create an immersive virtual tour. | |
| 379 | 379 | |
| 380 | -=7. How To Embed A Virtual Tour Using Gutenberg Block Editor?= | |
| 380 | +=5. How do I connect multiple rooms so visitors can walk through my property?= | |
| 381 | 381 | |
| 382 | -Under common blocks, you will find a block called WPVR. Select the block and on the dynamic toolbar on the right, you will get the options to add ID, Height, and Width. | |
| 382 | +You can link scenes together using "Scene Type Hotspots". Simply place a hotspot near a door or entryway in Room A and set its target destination to Room B. | |
| 383 | 383 | |
| 384 | -Collect the ID from the virtual tour you created. Assign the height and width as you desire. | |
| 384 | +Visitors clicking the hotspot will navigate directly into the next room. | |
| 385 | 385 | |
| 386 | -=8. The Tour Is Not Loading On The Webpage.= | |
| 386 | +=6. Can buyers submit inquiries or book visits within my tour?= | |
| 387 | 387 | |
| 388 | -Go to your WordPress Dashboard > WPVR > Get Started > Settings. | |
| 388 | +Yes, you can attach booking forms, lead forms, or contact buttons directly on your virtual tour, letting prospects contact you instantly. | |
| 389 | 389 | |
| 390 | -Check the Enable Script Control option status. | |
| 390 | +=7. Can I add an interactive virtual floor plan to my real estate tours?= | |
| 391 | 391 | |
| 392 | -If the Enable Script Control option is turned On, turn it off and reload the tour page. | |
| 392 | +Yes, With WPVR Pro, you can upload a 2D floor plan image and place interactive pointers on it. | |
| 393 | 393 | |
| 394 | -If you wish to use this feature, you have to set the URLs of all the pages on your site with a virtual tour in the List of Allowed Pages To Load WPVR Scripts field. | |
| 394 | +Clicking a pointer on the floor plan immediately transports the viewer to that specific room in your 360 tour. | |
| 395 | 395 | |
| 396 | -=9. What To Do If I Get "THE FILE (image link) COULD NOT BE ACCESSED" Error?= | |
| 396 | +=8. Can I match the hotspot icons to my brand?= | |
| 397 | 397 | |
| 398 | -Sometimes when you add a tour to your site, you might face this issue, rather than loading the tour it will give the error "THE FILE (...) COULD NOT BE ACCESSED." | |
| 398 | +Yes, you can style your hotspots to fit your look, and even use custom CSS for full control. | |
| 399 | 399 | |
| 400 | -This error shows up when you are running a website under "HTTPS" (secured with SSL certificate) whereas your image link is under "HTTP" (unsecured). | |
| 400 | +Your free version gives you solid icon options, and Pro adds a library of 900+ premium icons plus custom colors. Either way, your markers stay clean and easy for visitors to spot. | |
| 401 | 401 | |
| 402 | -To solve this issue, go to your WordPress Dashboard > Settings > General. | |
| 402 | +=9. Can I embed a 360-degree video tour, not panoramic photos?= | |
| 403 | 403 | |
| 404 | -Here make sure you have "HTTP" added to both "WordPress Address (URL)" and "Site Address (URL)". | |
| 404 | +Yes, you can use WPVR as a 360 video player too, and it's included for free. You can host the video yourself or pull it from YouTube and Vimeo. | |
| 405 | 405 | |
| 406 | -And that's it. Your virtual tour should load with no issues. | |
| 406 | +If you have 360-degree videos recorded, then start using them ASAP. | |
| 407 | 407 | |
| 408 | -=10. Can I make The Virtual Tours Full-width?= | |
| 408 | +=10. Does WPVR work with page builders (Elementor, Gutenberg, Divi) and Real Estate themes?= | |
| 409 | 409 | |
| 410 | -Yes, you can publish the tours as the full width of your page/post. | |
| 410 | +Yes, WPVR includes dedicated widgets and blocks for Elementor, Gutenberg, Divi, Oxygen, and Visual Composer. | |
| 411 | 411 | |
| 412 | -For Gutenberg, Elementor, and Oxygen builder, set fullwidth on the Width field. For shortcodes, set width = "fullwidth". | |
| 412 | +You can also embed tours on any page, listing templates, or custom fields using standard shortcodes. | |
| 413 | 413 | |
| 414 | -=11. What If I Use An Optimization or Caching Plugin?= | |
| 414 | +=11. Can mobile visitors navigate using their phone's movement (Gyroscope)?= | |
| 415 | 415 | |
| 416 | -If you use any Optimization or Caching plugins, then you need to exclude WP VR from its optimization function. | |
| 416 | +Yes, On mobile devices, WPVR supports Gyroscope navigation. As users move their smartphones, the 360° view shifts in real-time for a realistic walkthrough experience. | |
| 417 | 417 | |
| 418 | -Simply add '/plugins/wpvr' to the exclusion field (or use the location where you store plugins). | |
| 418 | +=12. Will a caching or optimization plugin break my tour?= | |
| 419 | 419 | |
| 420 | -=12. Can I Allow The Users of My Site To Create Virtual Tours?= | |
| 420 | +It can, since aggressive caching or file optimization sometimes blocks the scripts your tour needs. | |
| 421 | 421 | |
| 422 | -You can only allow the backend users like Admins, Editors, and Authors of your site to create virtual tours. | |
| 422 | +If your tour acts up, just exclude WP VR's assets from your caching or minification settings. Once you clear the cache, it should load smoothly again. | |
| 423 | 423 | |
| 424 | -Admins & editors will have access to all virtual tours on the site to modify, update and delete them. | |
| 424 | +=13. Can I Allow Other Users On My Site To Create Virtual Tours?= | |
| 425 | 425 | |
| 426 | -Authors can access their own tours only and modify, update, or delete them. | |
| 426 | +You can only allow backend users like Admins, Editors, and Authors of your site to create virtual tours. | |
| 427 | 427 | |
| 428 | -Admins can remove access from Authors and Editors at any time. | |
| 428 | +- Admins & editors will have access to all virtual tours on the site to modify, update, and delete them. | |
| 429 | +- Authors can access their own tours only and modify, update, or delete them. | |
| 430 | +- Admins can remove access from Authors and Editors at any time. | |
| 429 | 431 | |
| 430 | -= 13. How can I report security bugs? = | |
| 432 | += 14. How can I report security bugs? = | |
| 431 | 433 | You can report security issues through the Patchstack Vulnerability Disclosure Program. |
| 432 | 434 | The Patchstack team will review & handle the issue. [Report a security vulnerability.](https://patchstack.com/database/vdp/wpvr) |
| 433 | 435 | |
| 434 | 436 | |
| @@ -439,14 +441,16 @@ | ||
| 439 | 441 | 3. Basic Settings of Virtual Tour |
| 440 | 442 | 4. Preview Image on Virtual Tour |
| 441 | 443 | 5. Preview Image Virtual Tour |
| 442 | 444 | 6. Advanced Controls of Virtual Tour |
| 443 | -7. Control Buttons of Virtual Tour | |
| 444 | -8. 360 Image Basic Settings | |
| 445 | -9. 360 Image Advanced Settings | |
| 446 | -10. Set Information on Hotspots | |
| 447 | -11. Connect 360 Degree Images on Hotspots | |
| 448 | -12. 360 Video Tour | |
| 445 | +7. Add Floor Plan in your Virtual Tour | |
| 446 | +8. Control Buttons of Virtual Tour | |
| 447 | +9. 360 Image Basic Settings | |
| 448 | +10. 360 Image Advanced Settings | |
| 449 | +11. Add Floor Plan Pointer in your Virtual Tour | |
| 450 | +12. Set Information on Hotspots | |
| 451 | +13. Connect 360 Degree Images on Hotspots | |
| 452 | +14. 360 Video Tour | |
| 449 | 453 | |
| 450 | 454 | |
| 451 | 455 | == Source Code == |
| 452 | 456 | |
| @@ -455,8 +459,84 @@ | ||
| 455 | 459 | == Changelog == |
| 456 | 460 | |
| 457 | 461 | = WPVR (Free) = |
| 458 | 462 | |
| 463 | += 9.1.3 (2026-09-17) = | |
| 464 | +* Security Fix: Resolved broken access control, authorization bypasses, and stored XSS vulnerabilities in the setup wizard, tour file import, and REST API endpoints. | |
| 465 | +* Fix: Restored Fluent Forms and WooCommerce product hotspot types in the modern tour editor. | |
| 466 | +* Enhancement: Added searchable dropdown with live search and request cancellation for selecting Fluent Forms and WooCommerce products in hotspot configuration. | |
| 467 | +* Fix: Improved Fluent Forms script handling, layout styling, and dynamic form re-initialization inside tour scenes. | |
| 468 | +* Fix: Resolved issue where scene numbering counter failed to reset after deleting scenes in the creation modal. | |
| 469 | +* Fix: Corrected typo in default scene name across translation strings. | |
| 470 | + | |
| 471 | += 9.1.2 (2026-09-15) = | |
| 472 | +* Fix: Restored embed and social share functionality for virtual tours in the new UI (feature parity with legacy UI). | |
| 473 | +* Fix: Resolved embedded tour rendering issue (black screen) when tour loaded via the embed iframe. | |
| 474 | +* Fix: Improved tour type detection, hotspot rendering, and data validation across legacy and API services. | |
| 475 | + | |
| 476 | += 9.1.1 (2026-09-08) = | |
| 477 | +* Fix: Resolved issue where tours created with the new UI failed to render when embedded. | |
| 478 | +* Fix: Improved tour type detection and state synchronization across legacy and REST API services. | |
| 479 | +* Fix: Prevented WordPress wptexturize and content filters from corrupting tour inline scripts. | |
| 480 | +* Fix: Resolved container ID conflicts and script errors when embedding multiple tour instances on the same page. | |
| 481 | +* Fix: Resolved hotspot click and modal popup display issues across different content formats. | |
| 482 | +* Fix: Added safe fallbacks to prevent PHP undefined key warnings in scene and hotspot data validation. | |
| 483 | + | |
| 484 | += 9.1.0 (2026-09-03) = | |
| 485 | +* New: Added Breakdance page builder integration with dedicated WPVR block support. | |
| 486 | +* New: Added 360-degree video tour support with Video.js and VideoJS-VR integration in the modern tour editor and frontend. | |
| 487 | +* Fix: Resolved self-hosted 360-degree video dragging and touch navigation issues with robust deferred initialization. | |
| 488 | +* Fix: Resolved Gutenberg block inline script corruption caused by wptexturize modifying operators in the content filter. | |
| 489 | +* Fix: Improved video tour metadata handling, state synchronization, and toggle logic between UI modes and editor. | |
| 490 | + | |
| 491 | += 9.0.3 (2026-09-01) = | |
| 492 | +* Security Fix: Enforced object-level authorization (BOLA) checks on tour REST API and AJAX endpoints so users can no longer read, edit, or delete tours they don't own. | |
| 493 | +* Security Fix: Restricted the UI mode toggle endpoint to administrators only. | |
| 494 | +* Security Fix: Sanitized hotspot content (including FluentForm hotspots) on both server and client sides to prevent stored XSS. | |
| 495 | + | |
| 496 | += 9.0.2 (2026-08-28) = | |
| 497 | +* Fix: Resolved `wpvrhotspot is not defined` error when caching and JavaScript deferral plugins (Autoptimize, WP Rocket, LiteSpeed Cache) are active. | |
| 498 | +* Fix: Ensured frontend scripts and styles are reliably enqueued across Gutenberg blocks and page builder widgets. | |
| 499 | +* Fix: Resolved fatal error on `update.php` during plugin updates. | |
| 500 | +* Fix: Resolved mobile touch dragging and swipe navigation dropping or getting interrupted on mobile browsers. | |
| 501 | +* Fix: Ensured tour navigation controls (mouse drag, zoom, and keyboard movement) remain properly enabled by default on the Free tier. | |
| 502 | +* Fix: Corrected keyboard movement control setting mapping in the tour editor. | |
| 503 | + | |
| 504 | += 9.0.1 (2026-08-20) = | |
| 505 | +* Fix: Fix mouse drag & drop issue. | |
| 506 | +* Fix: Unexpected variable warning. | |
| 507 | + | |
| 508 | + | |
| 509 | += 9.0.0 (2026-08-20) = | |
| 510 | +* New: Introducing the new WPVR user interface for a faster and more intuitive tour-building experience. | |
| 511 | +* New: Added keyboard accessibility to improve tour navigation and interaction. | |
| 512 | +* New: Added an imported tour indicator for easier identification of imported tours. | |
| 513 | +* New: Added smart warning diagnostics to help identify and resolve errors. | |
| 514 | +* Bug Fix: Prevented hotspots from overlapping panorama controls, keeping controls visible and accessible. | |
| 515 | +* Bug Fix: Fixed hotspot link types not opening their configured destinations correctly. | |
| 516 | +* Bug Fix: Improved image-switching performance in the preview section. | |
| 517 | +* Bug Fix: Fixed broken layout and alignment issues in the desktop tour builder. | |
| 518 | +* Bug Fix: Removed unexpected warnings from WordPress admin screens. | |
| 519 | +* Bug Fix: Fixed access and rendering issues for password-protected scenes. | |
| 520 | + | |
| 521 | + | |
| 522 | += 8.5.79 (2026-08-13) = | |
| 523 | +* Fix: Tours using `width="embed"` retain their fullscreen layout and control buttons. | |
| 524 | +* Enhancement: Improve tour loading speed on backend. | |
| 525 | + | |
| 526 | += 8.5.78 (2026-08-12) = | |
| 527 | +* Fix: Resolves FontAwesome icon rendering conflicts with active themes and adds dynamic script cache-busting for Pannellum. | |
| 528 | +* Enhancement: Added an "Imported" status badge in the admin tour list table (All Tours screen) for tours created via import. | |
| 529 | + | |
| 530 | += 8.5.77 (2026-07-30) = | |
| 531 | +* Fix: Vimeo video tour issue resolved for both preview and frontend. | |
| 532 | +* Fix: Prevent duplicate image entries in the onboarding media gallery. | |
| 533 | + | |
| 534 | += 8.5.76 (2026-07-06) = | |
| 535 | +* Fix: Panorama image now loads correctly when XHR is blocked by WAF or hotlink protection | |
| 536 | +* Fix: Removed unnecessary stripslashes() call from panodata JSON parsing | |
| 537 | +* Fix: Resolved stale panoImage reference in async XMP metadata reader | |
| 538 | + | |
| 459 | 539 | = 8.5.75 (2026-06-11) = |
| 460 | 540 | * Fix: Restored WPVR Pro tab compatibility for Floor Plan, Background Tour, and Street View when WPVR Pro v6.7.4 is active with a valid license. |
| 461 | 541 | |
| 462 | 542 | = 8.5.74 (2026-06-04) = |
| @@ -526,5 +606,5 @@ | ||
| 526 | 606 | |
| 527 | 607 | |
| 528 | 608 | == Upgrade Notice == |
| 529 | 609 | |
| 530 | -Keep WPVR updated to the latest version. It makes sure that you get the improvements, new features, and bug fixes instantly. | |
| 610 | +Keep WPVR updated to the latest version. It makes sure that you get the improvements, new features, and bug fixes instantly. | |
