{"id":409581,"date":"2026-11-22T00:57:21","date_gmt":"2026-11-22T00:57:21","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/softicon-virtual-tour\/"},"modified":"2026-11-22T00:56:59","modified_gmt":"2026-11-22T00:56:59","slug":"softicon-virtual-tour","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/softicon-virtual-tour\/","author":23588681,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.5","requires":"6.5","requires_php":"7.4","requires_plugins":null,"header_name":"SoftIcon Virtual Tour \u2013 360\u00b0 Panorama Viewer Block","header_author":"softiconai","header_description":"A 360\u00b0 panorama and virtual tour block. Add scenes and hotspots right in the block editor. No external services.","last_updated":"2026-11-22 00:56:59","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/profiles.wordpress.org\/softiconai\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":21,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"softiconai","date":"2026-11-22 00:56:59","revision":3815995}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3815995,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3815995,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3815995,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3815995,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"softicon\/virtual-tour":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"softicon\/virtual-tour","version":"1.0.0","title":"Virtual Tour","category":"media","description":"A 360\u00b0 panorama or a virtual tour of several scenes, with hotspots. Built right in the block editor.","keywords":["virtual tour","360","panorama","vr","360 photo","equirectangular","real estate"],"textdomain":"softicon-virtual-tour","attributes":{"scenes":{"type":"array","default":[]},"height":{"type":"string","default":"480px"},"heightMobile":{"type":"string","default":""}},"supports":{"html":false,"align":["wide","full"]},"editorScript":"file:.\/index.js","editorStyle":"file:.\/index.css","style":"file:.\/style-index.css","viewScript":"file:.\/view.js","render":"file:.\/render.php"}},"tagged_versions":["1.0.0"],"block_files":["\/tags\/1.0.0\/build\/index.js","\/tags\/1.0.0\/build\/index.css","\/tags\/1.0.0\/build\/style-index.css","\/tags\/1.0.0\/src\/index.js","\/tags\/1.0.0\/src\/index.css","\/tags\/1.0.0\/src\/style-index.css"],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3815995,"resolution":"1","location":"assets","locale":"","width":1240,"height":819},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3815995,"resolution":"2","location":"assets","locale":"","width":1440,"height":900},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3815995,"resolution":"3","location":"assets","locale":"","width":1440,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3815995,"resolution":"4","location":"assets","locale":"","width":1440,"height":900},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3815995,"resolution":"5","location":"assets","locale":"","width":1180,"height":568},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3815995,"resolution":"6","location":"assets","locale":"","width":1180,"height":568},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3815995,"resolution":"7","location":"assets","locale":"","width":780,"height":972}},"screenshots":{"1":"A tour on a page. Drag to look around, click an arrow to go to the next room, or pick a room under the panorama.","2":"Build the tour in the block editor. The block shows the real 360\u00b0 view, and the sidebar lists the scenes.","3":"An open scene: its name, hotspots and image. While it is open, click the panorama to add a hotspot there.","4":"Editing an info hotspot: a title, text and an image if you like.","5":"An info hotspot opens a small box on the page.","6":"A link hotspot shows its title when you point at it.","7":"On a phone: drag with a finger and pinch to zoom."}},"plugin_section":[172757],"plugin_tags":[745,764,1220,74914,8430],"plugin_category":[],"plugin_contributors":[287127],"plugin_business_model":[],"class_list":["post-409581","plugin","type-plugin","status-publish","hentry","plugin_section-block","plugin_tags-745","plugin_tags-360-panorama","plugin_tags-block","plugin_tags-panorama-viewer","plugin_tags-virtual-tour","plugin_contributors-softiconai","plugin_committers-softiconai"],"banners":{"banner":"https:\/\/ps.w.org\/softicon-virtual-tour\/assets\/banner-772x250.png?rev=3815995","banner_2x":"https:\/\/ps.w.org\/softicon-virtual-tour\/assets\/banner-1544x500.png?rev=3815995","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/softicon-virtual-tour\/assets\/icon-128x128.png?rev=3815995","icon_2x":"https:\/\/ps.w.org\/softicon-virtual-tour\/assets\/icon-256x256.png?rev=3815995","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/softicon-virtual-tour\/assets\/screenshot-1.png?rev=3815995","caption":"A tour on a page. Drag to look around, click an arrow to go to the next room, or pick a room under the panorama."},{"src":"https:\/\/ps.w.org\/softicon-virtual-tour\/assets\/screenshot-2.png?rev=3815995","caption":"Build the tour in the block editor. The block shows the real 360\u00b0 view, and the sidebar lists the scenes."},{"src":"https:\/\/ps.w.org\/softicon-virtual-tour\/assets\/screenshot-3.png?rev=3815995","caption":"An open scene: its name, hotspots and image. While it is open, click the panorama to add a hotspot there."},{"src":"https:\/\/ps.w.org\/softicon-virtual-tour\/assets\/screenshot-4.png?rev=3815995","caption":"Editing an info hotspot: a title, text and an image if you like."},{"src":"https:\/\/ps.w.org\/softicon-virtual-tour\/assets\/screenshot-5.png?rev=3815995","caption":"An info hotspot opens a small box on the page."},{"src":"https:\/\/ps.w.org\/softicon-virtual-tour\/assets\/screenshot-6.png?rev=3815995","caption":"A link hotspot shows its title when you point at it."},{"src":"https:\/\/ps.w.org\/softicon-virtual-tour\/assets\/screenshot-7.png?rev=3815995","caption":"On a phone: drag with a finger and pinch to zoom."}],"raw_content":"<!--section=description-->\n<p><strong>SoftIcon Virtual Tour<\/strong> adds a <strong>Virtual Tour<\/strong> block to the block editor. Choose your 360\u00b0 photos from the Media Library and each one becomes a scene. Click the panorama to add hotspots that take visitors from room to room, show a note or open a link.<\/p>\n\n<p>Made for real estate listings, hotels, restaurants, shops and showrooms, campuses, museums and galleries.<\/p>\n\n<ul>\n<li><strong>Build the tour in the block editor<\/strong> \u2013 the block shows the real 360\u00b0 view while you edit. Open a scene in the sidebar, click the panorama to add a hotspot there, and drag it to move it. No separate admin page, no shortcode.<\/li>\n<li><strong>Up to 50 scenes per tour<\/strong> \u2013 and up to 50 hotspots in each scene.<\/li>\n<li><strong>Three kinds of hotspots<\/strong> \u2013 go to another scene, show information (title, text and an image in a small box), or open a link.<\/li>\n<li><strong>Your starting view<\/strong> \u2013 turn and zoom the panorama, then press <strong>Use the current view<\/strong>. Visitors start each scene there.<\/li>\n<li><strong>Scene list<\/strong> \u2013 the scene names under the panorama let visitors jump to any room.<\/li>\n<li><strong>Full image quality<\/strong> \u2013 the block uses your original upload, not the smaller copy WordPress makes of big images.<\/li>\n<li><strong>Works on phones<\/strong> \u2013 drag with a finger, pinch to zoom, fullscreen, and look around by moving the phone where the device allows it. If a phone cannot show a very large image, the block uses WordPress's smaller copy for that phone only.<\/li>\n<li><strong>Fast<\/strong> \u2013 the viewer loads only when the tour comes near the screen, and each scene's image only when the scene is opened. The viewer is about 25 KB (gzip).<\/li>\n<li><strong>Accessible<\/strong> \u2013 alternative text for each scene, keyboard control (arrow keys to look around, + and - to zoom), and hotspots you can reach with the Tab key.<\/li>\n<li><strong>Works without JavaScript<\/strong> \u2013 the first scene is a real image with its alternative text, followed by the scene names, so search engines and every visitor can see it.<\/li>\n<li><strong>No external services<\/strong> \u2013 every file is on your site. No API key, no CDN, no cookies, no tracking.<\/li>\n<li><strong>Your height<\/strong> \u2013 in pixels or as a share of the screen height, with its own height on phones; wide and full width.<\/li>\n<\/ul>\n\n<h4>Privacy<\/h4>\n\n<p>The plugin sets no cookies, stores nothing about visitors and connects to no outside service. Your scenes and hotspots are saved in the block, inside your post.<\/p>\n\n<h4>Third-party libraries<\/h4>\n\n<ul>\n<li>Pannellum 2.5.7 (npm package pannellum) by Matthew Petroff \u2013 <a href=\"https:\/\/pannellum.org\/\">pannellum.org<\/a> \/ <a href=\"https:\/\/github.com\/mpetroff\/pannellum\">github.com\/mpetroff\/pannellum<\/a> \u2013 MIT License. Bundled in build\/pannellum.js and build\/style-index.css; license in build\/pannellum-LICENSE.txt. The build keeps it to the block, so it never changes another plugin's copy of Pannellum (loaders\/pannellum.js).<\/li>\n<\/ul>\n\n<h4>Source code<\/h4>\n\n<p>The plugin's source is in the src folder of the plugin, and builds with <code>npm install<\/code> and <code>npm run build<\/code>. It is also on GitHub: <a href=\"https:\/\/github.com\/softiconai\/SoftIcon-Virtual-Tour\">github.com\/softiconai\/SoftIcon-Virtual-Tour<\/a>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install the plugin from <strong>Plugins \u2192 Add New<\/strong>, or upload the zip, and activate it.<\/li>\n<li>In the block editor, add the <strong>Virtual Tour<\/strong> block.<\/li>\n<li>Choose or upload your 360\u00b0 panorama images. Each image becomes a scene.<\/li>\n<li>Open a scene in the block's sidebar to name it, add its alternative text and set its starting view. While it is open, click the panorama in the block to add a hotspot there.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"what%20images%20can%20i%20use%3F\"><h3>What images can I use?<\/h3><\/dt>\n<dd><p>Equirectangular 360\u00b0 panoramas: the image is twice as wide as it is high (2:1), for example 6000 \u00d7 3000 pixels. Most 360\u00b0 cameras (Insta360, Ricoh Theta, GoPro Max) and phone panorama apps save this format. The block warns you when an image is not 2:1.<\/p><\/dd>\n<dt id=\"how%20big%20should%20the%20images%20be%3F\"><h3>How big should the images be?<\/h3><\/dt>\n<dd><p>6000 \u00d7 3000 pixels is sharp on most screens. Larger images look a little sharper up close but take longer to load. Save them as JPEG at about 80% quality; a 6000 \u00d7 3000 image is then usually 2\u20135 MB.<\/p><\/dd>\n<dt id=\"why%20does%20wordpress%20make%20a%20%22-scaled%22%20copy%20of%20my%20image%3F\"><h3>Why does WordPress make a \"-scaled\" copy of my image?<\/h3><\/dt>\n<dd><p>WordPress makes a smaller copy (2560 pixels wide) of every image larger than that. The block shows your original upload, so the tour stays sharp. Phones that cannot show the original get the smaller copy instead.<\/p><\/dd>\n<dt id=\"the%20tour%20does%20not%20show%20on%20a%20phone.\"><h3>The tour does not show on a phone.<\/h3><\/dt>\n<dd><p>Some older phones can only show images up to 4096 or 8192 pixels wide. The block checks this and uses WordPress's smaller copy on those phones. If you uploaded the image somewhere other than the Media Library, there is no smaller copy: keep such images at 8000 pixels wide or less.<\/p><\/dd>\n<dt id=\"my%20images%20are%20on%20a%20cdn%20or%20another%20domain%20and%20the%20tour%20stays%20empty.\"><h3>My images are on a CDN or another domain and the tour stays empty.<\/h3><\/dt>\n<dd><p>The 360\u00b0 view is drawn with WebGL, which can only use images from another domain when that domain allows it (CORS). Ask your CDN or offload plugin to send the header <code>Access-Control-Allow-Origin<\/code> for images, or keep the panoramas in your own Media Library.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20caching%20and%20optimization%20plugins%3F\"><h3>Does it work with caching and optimization plugins?<\/h3><\/dt>\n<dd><p>Yes. The block finds its own files even when an optimization plugin combines or moves the scripts. If the tour does not start after you turn on JavaScript combining or delaying, exclude <code>softicon-virtual-tour<\/code> from it and clear the cache.<\/p><\/dd>\n<dt id=\"can%20i%20use%20it%20with%20elementor%20or%20another%20page%20builder%3F\"><h3>Can I use it with Elementor or another page builder?<\/h3><\/dt>\n<dd><p>The plugin is a block for the block editor. You can build the tour in a reusable block (synced pattern) and show that pattern where your page builder allows block content.<\/p><\/dd>\n<dt id=\"can%20visitors%20use%20the%20keyboard%3F\"><h3>Can visitors use the keyboard?<\/h3><\/dt>\n<dd><p>Yes. Press Tab to reach the panorama, use the arrow keys to look around and + or - to zoom. Hotspots and the scene names are buttons you can reach with Tab and press with Enter.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"A 360\u00b0 panorama and virtual tour block. Add scenes and hotspots right in the block editor. Up to 50 scenes, no external services.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/409581","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=409581"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/softiconai"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=409581"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=409581"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=409581"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=409581"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=409581"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=409581"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}