Title: Garden Gnome Package Author: Chief Gnome Published: June 26, 2019 Last modified: October 15, 2026 --- Search plugins ![](https://ps.w.org/garden-gnome-package/assets/banner-772x250.png?rev=2307787) ![](https://ps.w.org/garden-gnome-package/assets/icon.svg?rev=2307787) # Garden Gnome Package By [Chief Gnome](https://profiles.wordpress.org/ggnomes/) [Download](https://downloads.wordpress.org/plugin/garden-gnome-package.zip) * [Details](https://srd.wordpress.org/plugins/garden-gnome-package/#description) * [Reviews](https://srd.wordpress.org/plugins/garden-gnome-package/#reviews) * [Installation](https://srd.wordpress.org/plugins/garden-gnome-package/#installation) * [Development](https://srd.wordpress.org/plugins/garden-gnome-package/#developers) [Support](https://wordpress.org/support/plugin/garden-gnome-package/) ## Description This plugin provides an easy way to publish panoramas and object movies created with Garden Gnome Software’s Pano2VR and Object2VR. You can embed a package via a shortcode like `[ggpkg id=12]` or a block in the Gutenberg editor. In the plugin settings, you can restrict `.ggpkg` uploads to users with a specific WordPress capability. This check is enabled by default and uses `upload_ggpkg` unless you change it. Sample packages can be downloaded from our [forum](https://forum.ggnome.com/viewtopic.php?f=21&t=9025). ### Shortcode When you are using a shortcode to embed a package, you can provide additional parameters in the shortcode: * width: the width of the player in the page * height: the height of the player in the page * start_preview: when set to ‘true’, the player will initially show as a preview image with a play button. * start_node: if the package is a virtual tour, you can specify the start node. You can find the node ID of each node in the tooltip in the tour browser. * start_view: for panoramas and virtual tours, sets the initial view of the first node. The format is ‘pan/tilt/fov/projection’. The projection parameter is optional. * url: can be used instead of ID, to embed a package from a specific URL. Like `[ ggpkg url='....']`. This field needs to be enabled in the settings. * Remote URL security: when using `url`, you can enforce TLS certificate verification and optionally restrict allowed hostnames in the plugin settings. Example: `[ggpkg id=12 width='100%' height='500px' start_preview='true']` If you are using the Gutenberg Editor and want to embed a package via a shortcode, use a _Classic Block_ from the ‘Formatting’ section, and use the _Add Media_ button to add a package from the media library. ### Gutenberg Block You can find the GGPKG Gutenberg Block in the Widgets section. In the GGPKG Block, you can pick a package from the media library. In the Inspector panel on the right, you can specify if the package should start with a preview image and a play button, and set the width and height of the player in the page. ### Elementor Widget You can find the Garden Gnome Package Widget in the General section. In the Widget settings, you can pick a package from the media library, define the height, and select if it should start with a preview image. ## Screenshots [⌊Embedded virtual tour⌉⌊Embedded virtual tour⌉[ Embedded virtual tour [⌊Gutenberg block⌉⌊Gutenberg block⌉[ Gutenberg block [⌊Settings page⌉⌊Settings page⌉[ Settings page [⌊Shortcode in classic editor⌉⌊Shortcode in classic editor⌉[ Shortcode in classic editor ## Blocks This plugin provides 1 block. * GGPKG ## Installation ### Requirements: * WordPress 5.0 or higher * PHP 7.2 or higher * The [zip](https://www.php.net/manual/en/book.zip.php) and [libxml](https://www.php.net/manual/en/book.libxml.php) PHP module must be installed on your server. ### Installation: 1. Upload the plugin files to the `/wp-content/plugins/garden-gnome-package` directory, or install the plugin through the WordPress plugins screen directly. 2. Activate the plugin through the ‘Plugins’ screen in WordPress ## FAQ ### What is a Garden Gnome Package? A Garden Gnome Package is a simple ZIP file that contains everything necessary to display a single panorama, virtual tour, or object movie. After uploading the package, the plugin extracts the archive. ### How can I create a package? Please see the [Pano2VR documentation](https://ggnome.com/doc/pano2vr/guide/export/output-web/ggpkg/) or [Object2VR documentation](https://ggnome.com/doc/object2vr/guide/export/output-web/ggpkg/). ### How can I upload a tour with a large file size? The easiest solution is to install the excellent [Big File Uploads](https://wordpress.org/plugins/tuxedo-big-file-uploads/) plugin. There are two strategies without an additional plugin: * Upload the tour to a folder on a web server and use the shortcode `[ggpkg url ="https://example.com/my_tour_folder/"]` to point to the tour. * Upload a small version of the tour (i.e., just the start node) and then replace the files in the extracted folder in the upload directory. ### How can I retry unpacking a package? In the Media Library list view, use the `Re-extract GGPKG` row action on a package attachment. ### Where can I see unpack status and errors? * Admin notices are shown on Media Library screens after upload/re-extract. * Package attachment details include `GGPKG Unpack Status` and `GGPKG Unpack Errors`. ### How can I contribute? Please submit a pull request on [GitHub](https://github.com/ggnomes/garden-gnome-package). ## Reviews ![](https://secure.gravatar.com/avatar/22ad148abd04c7f8c448c810311a58de76c4f541a05791439e342ea20e0ae2c1? s=60&d=retro&r=g) ### 󠀁[Amazing Plugin!](https://wordpress.org/support/topic/amazing-plugin-2059/)󠁿 [crealys](https://profiles.wordpress.org/crealys/) November 29, 2021 I got my GGPKG running in no time. For those who use elementor, first create a blank page and edit with the classic editor > add media, upload your ggpkg, insert > you will get your ggpkg ID! Then on elementor page, just add a text widget and use this shortcode: [ggpkg id=XXXX width='100%' height='100vh' start_node=nodeXX ] You can set the width and height in any unit, which is great if you want to keep a footer( ex. height='85vh' & footer: 15vh) if your tour has several nodes, you can use start_node =nodeXX and set which node you want the tour to start from. Cheers! and great job! ![](https://secure.gravatar.com/avatar/2e46323e38e5d24f793bc91f02e48a9be2ff792e59315908bdda79a4033014fd? s=60&d=retro&r=g) ### 󠀁[Great and easy way to add 360 product photography that uses Object2vr](https://wordpress.org/support/topic/great-and-easy-way-to-add-360-product-photography-that-uses-object2vr/)󠁿 [photospherix](https://profiles.wordpress.org/photospherix/) October 15, 2021 This is a great and easy way to add 360 product photography that you have created in Object2VR to any page, post, portfolio page, or article inside of Wordpress. Keep in mind that you still need the files stored as a GGPKG from Object2vr. ![](https://secure.gravatar.com/avatar/99f75919d9267a90fa5c9301d37a45b23960d4f0f0d86b16c0b3a0faf84906de? s=60&d=retro&r=g) ### 󠀁[Nothing here!](https://wordpress.org/support/topic/nothing-here-2/)󠁿 [Ketil Ervik](https://profiles.wordpress.org/ketil/) November 6, 2020 Special for Garden Gnome files or? icone its here, but cant find package! nothing. ![](https://secure.gravatar.com/avatar/d3a77344796c76d3f66b47e87fdb44fb40305d4f026e0506e706794b7778e8cc? s=60&d=retro&r=g) ### 󠀁[An arbitrary area does not work in full screen mode (((](https://wordpress.org/support/topic/an-arbitrary-area-does-not-work-in-full-screen-mode/)󠁿 [alexapex](https://profiles.wordpress.org/alexapex/) October 7, 2020 1 reply Request to the developers! Fix the tour through an arbitrary area in full screen mode! WordPress 5.5.1 does not highlight an arbitrary area (to navigate the tour) when the mouse is hovering in full screen mode (( ———————————————————– Просьба к разработчикам ! Поправите переход по туру через произвольную область в полно экраном режиме! WordPress 5.5.1 не подсветки произвольной области (для перехода по туру) при наведении мыши именно в полно экранном режиме (( ![](https://secure.gravatar.com/avatar/df34b5cb3b65381036718c2f23173141fb190e5c0080f6e2d2941a691465447a? s=60&d=retro&r=g) ### 󠀁[Plugin for Pano2VR](https://wordpress.org/support/topic/plugin-for-pano2vr/)󠁿 [hopki](https://profiles.wordpress.org/hopki/) July 24, 2019 Making it easy to display Garden Gnome Softwares virtual tours and objects. [ Read all 5 reviews ](https://wordpress.org/support/plugin/garden-gnome-package/reviews/) ## Contributors & Developers “Garden Gnome Package” is open source software. The following people have contributed to this plugin. Contributors * [ Chief Gnome ](https://profiles.wordpress.org/ggnomes/) “Garden Gnome Package” has been translated into 1 locale. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/garden-gnome-package/contributors) for their contributions. [Translate “Garden Gnome Package” into your language.](https://translate.wordpress.org/projects/wp-plugins/garden-gnome-package) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/garden-gnome-package/), check out the [SVN repository](https://plugins.svn.wordpress.org/garden-gnome-package/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/garden-gnome-package/) by [RSS](https://plugins.trac.wordpress.org/log/garden-gnome-package/?limit=100&mode=stop_on_copy&format=rss). ## Changelog ### 2.5.4 * Sanitize uploaded package filenames, including dots and UTF-8 emoji, to keep player and skin JavaScript valid. * Repair player and skin variable names when re-extracting existing packages. * Allow `radc` and `map` files inside packages. ### 2.5.3 * Fix Gutenberg block registration in the editor. ### 2.5.2 * Capability check to for `.ggpkg` uploads is ignored for admins ### 2.5.1 * Capability check to for `.ggpkg` uploads is now on by default ### 2.5.0 * Added minimum version checks during activation (WordPress 5.0+, PHP 7.2+). * Added optional capability-based permission setting for `.ggpkg` uploads (off by default) to address CVE-2026-39683. * Updated Gutenberg block editor and Elementor widget registration APIs for improved forward compatibility. * Added unpack error reporting in Media Library notices and attachment details. * Added per-package unpack status metadata and `Re-extract GGPKG` media action. * Added secure remote URL settings for shortcode mode (strict TLS and allowed host list). ### 2.4.1 * Added 3d file extensions to the allowed file types for Pano2VR 8 packages. ### 2.4.0 * Added a list of valid file extensions within a package file for security reasons( CVE-2024-12854). ### 2.3.0 * _Breaking Change:_ Added an option for the url field in the settings, that is off by default for security reasons. * Shortcode: Better “url” parameter sanitization ### 2.2.9 * Fixes for “start_node” parameter sanitization ### 2.2.8 * Fixes for the plugin settings dialog ### 2.2.7 * Less strict sanitization to allow complex CSS attributes in short code ### 2.2.6 * Better input sanitization for the short code attributes ### 2.2.5 * Fix for Elementor icon and version bump ### 2.2.4 * Fix for centered preview button ### 2.2.3 * Fix warnings in JSON parser ### 2.2.2 * Forces CSS line-height to 1.0 in skins ### 2.2.2 * Forces CSS line-height to 1.0 in skins ### 2.2.1 * Fix for uninstall hook and deprecation warning ### 2.2.0 * New icon * Added WebXR support ### 2.1.3 * Fix for copy current package player * Fix for multiple different skins on a page * Fix in Gutenberg editor for WordPress 5.4 ### 2.1.2 * Elementor widget is now responsive * Fix for fullscreen, if the fullscreen API is missing ### 2.1.1 * Disable ‘sslverify’ for gginfo download, as this causes issues with PHP 7.4 ### 2.1.0 * Added and Elementor widget * Added a filter for packages in the media library * Changed div container ids ### 2.0.1 * Improved CSS reset for images ### 2.0 * Complete rewrite of the ggpkg-import plugin. ## Meta * Version **2.5.4** * Last updated **1 day ago** * Active installations **4,000+** * WordPress version ** 5.0 or higher ** * Tested up to **7.1.3** * PHP version ** 7.2 or higher ** * Languages * [Dutch](https://nl.wordpress.org/plugins/garden-gnome-package/) and [English (US)](https://wordpress.org/plugins/garden-gnome-package/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/garden-gnome-package) * Tags * [360](https://srd.wordpress.org/plugins/tags/360/)[panorama](https://srd.wordpress.org/plugins/tags/panorama/) [Virtual Tour](https://srd.wordpress.org/plugins/tags/virtual-tour/)[webvr](https://srd.wordpress.org/plugins/tags/webvr/) [webxr](https://srd.wordpress.org/plugins/tags/webxr/) * [Advanced View](https://srd.wordpress.org/plugins/garden-gnome-package/advanced/) ## Ratings 4.2 out of 5 stars. * [ 4 5-star reviews ](https://wordpress.org/support/plugin/garden-gnome-package/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/garden-gnome-package/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/garden-gnome-package/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/garden-gnome-package/reviews/?filter=2) * [ 1 1-star review ](https://wordpress.org/support/plugin/garden-gnome-package/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/garden-gnome-package/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/garden-gnome-package/reviews/) ## Contributors * [ Chief Gnome ](https://profiles.wordpress.org/ggnomes/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/garden-gnome-package/)