{"id":104606,"date":"2019-06-26T13:04:43","date_gmt":"2019-06-26T13:04:43","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/garden-gnome-package\/"},"modified":"2025-12-11T14:33:17","modified_gmt":"2025-12-11T14:33:17","slug":"garden-gnome-package","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/garden-gnome-package\/","author":12529510,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.4.1","stable_tag":"trunk","tested":"6.9.0","requires":"5.0","requires_php":"7.2","requires_plugins":null,"header_name":"Garden Gnome Package","header_author":"<a href=\"https:\/\/ggnome.com\">Garden Gnome Software<\/a>","header_description":"Import Pano2VR & Object2VR Content into Wordpress.","assets_banners_color":"cccccc","last_updated":"2025-12-11 14:33:17","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/ggnome.com\/ggpkg","header_author_uri":"","rating":4.2,"author_block_rating":0,"active_installs":4000,"downloads":51593,"num_ratings":5,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"2.0.0":{"tag":"2.0.0","author":"Ggnomes","date":"2019-06-26 13:02:00"},"2.0.1":{"tag":"2.0.1","author":"Ggnomes","date":"2019-09-05 07:39:27"},"2.1.0":{"tag":"2.1.0","author":"Ggnomes","date":"2019-11-08 14:44:02"},"2.1.1":{"tag":"2.1.1","author":"Ggnomes","date":"2019-12-03 16:18:41"},"2.1.2":{"tag":"2.1.2","author":"Ggnomes","date":"2020-03-03 12:50:16"},"2.1.3":{"tag":"2.1.3","author":"Ggnomes","date":"2020-03-24 15:00:44"},"2.2.0":{"tag":"2.2.0","author":"Ggnomes","date":"2020-05-19 09:00:08"},"2.2.1":{"tag":"2.2.1","author":"Ggnomes","date":"2020-05-19 09:55:37"},"2.2.2":{"tag":"2.2.2","author":"Ggnomes","date":"2020-08-06 13:54:53"},"2.2.3":{"tag":"2.2.3","author":"Ggnomes","date":"2020-11-25 15:48:57"},"2.2.4":{"tag":"2.2.4","author":"Ggnomes","date":"2021-04-13 15:43:07"},"2.2.5":{"tag":"2.2.5","author":"Ggnomes","date":"2022-02-03 11:25:56"},"2.2.6":{"tag":"2.2.6","author":"Ggnomes","date":"2023-10-31 16:30:47"},"2.2.7":{"tag":"2.2.7","author":"Ggnomes","date":"2023-11-02 10:47:15"},"2.2.8":{"tag":"2.2.8","author":"Ggnomes","date":"2023-11-02 15:34:32"},"2.2.9":{"tag":"2.2.9","author":"Ggnomes","date":"2023-11-04 15:03:54"},"2.3.0":{"tag":"2.3.0","author":"Ggnomes","date":"2024-09-19 13:17:06"},"2.4.0":{"tag":"2.4.0","author":"Ggnomes","date":"2025-01-02 12:30:02"},"2.4.1":{"tag":"2.4.1","author":"Ggnomes","date":"2025-12-11 14:34:07"}},"upgrade_notice":{"1.x":"<p>Please deactivate the old GGPKG-Import plugin to avoid conflicts<\/p>"},"ratings":{"1":1,"2":0,"3":0,"4":0,"5":4},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2307787,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2307787,"resolution":"256x256","location":"assets","locale":""},"icon.svg":{"filename":"icon.svg","revision":2307787,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":2307787,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":2307787,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":{"ggpkg\/ggpkg-block":{"name":"ggpkg\/ggpkg-block","title":"GGPKG"}},"tagged_versions":["2.0.0","2.0.1","2.1.0","2.1.1","2.1.2","2.1.3","2.2.0","2.2.1","2.2.2","2.2.3","2.2.4","2.2.5","2.2.6","2.2.7","2.2.8","2.2.9","2.3.0","2.4.0","2.4.1"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":2112812,"resolution":"1","location":"assets","locale":""},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":2307787,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":2112812,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":2112812,"resolution":"4","location":"assets","locale":""}},"screenshots":{"1":"Embedded virtual tour","2":"Gutenberg block","3":"Settings page","4":"Shortcode in classic editor"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[745,762,8430,132878,217444],"plugin_category":[],"plugin_contributors":[173207],"plugin_business_model":[],"class_list":["post-104606","plugin","type-plugin","status-publish","hentry","plugin_tags-745","plugin_tags-panorama","plugin_tags-virtual-tour","plugin_tags-webvr","plugin_tags-webxr","plugin_contributors-ggnomes","plugin_committers-ggnomes"],"banners":{"banner":"https:\/\/ps.w.org\/garden-gnome-package\/assets\/banner-772x250.png?rev=2307787","banner_2x":"https:\/\/ps.w.org\/garden-gnome-package\/assets\/banner-1544x500.png?rev=2307787","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/garden-gnome-package\/assets\/icon.svg?rev=2307787","icon":"https:\/\/ps.w.org\/garden-gnome-package\/assets\/icon.svg?rev=2307787","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/garden-gnome-package\/assets\/screenshot-1.jpg?rev=2112812","caption":"Embedded virtual tour"},{"src":"https:\/\/ps.w.org\/garden-gnome-package\/assets\/screenshot-2.jpg?rev=2307787","caption":"Gutenberg block"},{"src":"https:\/\/ps.w.org\/garden-gnome-package\/assets\/screenshot-3.png?rev=2112812","caption":"Settings page"},{"src":"https:\/\/ps.w.org\/garden-gnome-package\/assets\/screenshot-4.png?rev=2112812","caption":"Shortcode in classic editor"}],"raw_content":"<!--section=description-->\n<p>This plugin provides an easy way to publish panoramas and object movies created with Garden Gnome Software's Pano2VR and Object2VR.<\/p>\n\n<p>You can embed a package via a shortcode like <code>[ggpkg id=12]<\/code> or a block in the Gutenberg editor.<\/p>\n\n<p>Sample packages can be downloaded from our <a href=\"https:\/\/forum.ggnome.com\/viewtopic.php?f=21&amp;t=9025\">forum<\/a>.<\/p>\n\n<h3>Shortcode<\/h3>\n\n<p>When you are using a shortcode to embed a package, you can provide additional parameters in the shortcode:<\/p>\n\n<ul>\n<li><p>width: the width of the player in the page<\/p><\/li>\n<li><p>height: the height of the player in the page<\/p><\/li>\n<li><p>start_preview: when set to 'true', the player will initially show as a preview image with a play button.<\/p><\/li>\n<li><p>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.<\/p><\/li>\n<li><p>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.<\/p><\/li>\n<li><p>url: can be used instead of ID, to embed a package from a specific URL. Like <code>[ggpkg url='....']<\/code>. This field needs to be enabled in the settings.<\/p><\/li>\n<\/ul>\n\n<p>Example: <code>[ggpkg id=12 width='100%' height='500px' start_preview='true']<\/code><\/p>\n\n<p>If you are using the Gutenberg Editor and want to embed a package via a shortcode, use a <em>Classic Block<\/em> from the 'Formatting' section, and use the <em>Add Media<\/em> button to add a package from the media library.<\/p>\n\n<h3>Gutenberg Block<\/h3>\n\n<p>You can find the GGPKG Gutenberg Block in the Widgets section.<\/p>\n\n<p>In the GGPKG Block, you can pick a package from the media library.<\/p>\n\n<p>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.<\/p>\n\n<h3>Elementor Widget<\/h3>\n\n<p>You can find the Garden Gnome Package Widget in the General section.<\/p>\n\n<p>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.<\/p>\n\n<!--section=installation-->\n<h3>Requirements:<\/h3>\n\n<p>The <a href=\"https:\/\/www.php.net\/manual\/en\/book.zip.php\">zip<\/a> and <a href=\"https:\/\/www.php.net\/manual\/en\/book.libxml.php\">libxml<\/a> PHP module must be installed on your server.<\/p>\n\n<h3>Installation:<\/h3>\n\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/garden-gnome-package<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='what%20is%20a%20garden%20gnome%20package%3F'><h3>What is a Garden Gnome Package?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id='how%20can%20i%20create%20a%20package%3F'><h3>How can I create a package?<\/h3><\/dt>\n<dd><p>Please see the <a href=\"https:\/\/ggnome.com\/doc\/pano2vr\/guide\/export\/output-web\/ggpkg\/\">Pano2VR documentation<\/a> or <a href=\"https:\/\/ggnome.com\/doc\/object2vr\/guide\/export\/output-web\/ggpkg\/\">Object2VR documentation<\/a>.<\/p><\/dd>\n<dt id='how%20can%20i%20upload%20a%20tour%20with%20a%20large%20file%20size%3F'><h3>How can I upload a tour with a large file size?<\/h3><\/dt>\n<dd><p>The easiest solution is to install the excellent <a href=\"https:\/\/wordpress.org\/plugins\/tuxedo-big-file-uploads\/\">Big File Uploads<\/a> plugin.<\/p>\n\n<p>There are two strategies without an additional plugin:<\/p>\n\n<ul>\n<li><p>Upload the tour to a folder on a web server and use the shortcode <code>[ggpkg url=\"https:\/\/example.com\/my_tour_folder\/\"]<\/code> to point to the tour.<\/p><\/li>\n<li><p>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.<\/p><\/li>\n<\/ul><\/dd>\n<dt id='how%20can%20contribute%3F'><h3>How can contribute?<\/h3><\/dt>\n<dd><p>Please submit a pull request on <a href=\"https:\/\/github.com\/ggnomes\/garden-gnome-package\">GitHub<\/a>.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h3>2.4.1<\/h3>\n\n<ul>\n<li>Added 3d file extensions to the allowed file types for Pano2VR 8 packages.<\/li>\n<\/ul>\n\n<h3>2.4.0<\/h3>\n\n<ul>\n<li>Added a list of valid file extensions within a package file for security reasons (CVE-2024-12854).<\/li>\n<\/ul>\n\n<h3>2.3.0<\/h3>\n\n<ul>\n<li><em>Breaking Change:<\/em> Added and option for the url field in the settings, that is off by default for security reasons.<\/li>\n<li>Shortcode: Better \u201curl\u201d parameter sanitization<\/li>\n<\/ul>\n\n<h3>2.2.9<\/h3>\n\n<ul>\n<li>Fixes for \u201cstart_node\u201d parameter sanitization<\/li>\n<\/ul>\n\n<h3>2.2.8<\/h3>\n\n<ul>\n<li>Fixes for the plugin settings dialog<\/li>\n<\/ul>\n\n<h3>2.2.7<\/h3>\n\n<ul>\n<li>Less strict sanitization to allow complex CSS attributes in short code<\/li>\n<\/ul>\n\n<h3>2.2.6<\/h3>\n\n<ul>\n<li>Better input sanitization for the short code attributes<\/li>\n<\/ul>\n\n<h3>2.2.5<\/h3>\n\n<ul>\n<li>Fix for Elementor icon and version bump<\/li>\n<\/ul>\n\n<h3>2.2.4<\/h3>\n\n<ul>\n<li>Fix for centered preview button<\/li>\n<\/ul>\n\n<h3>2.2.3<\/h3>\n\n<ul>\n<li>Fix warnings in JSON parser<\/li>\n<\/ul>\n\n<h3>2.2.2<\/h3>\n\n<ul>\n<li>Forces CSS line-height to 1.0 in skins<\/li>\n<\/ul>\n\n<h3>2.2.2<\/h3>\n\n<ul>\n<li>Forces CSS line-height to 1.0 in skins<\/li>\n<\/ul>\n\n<h3>2.2.1<\/h3>\n\n<ul>\n<li>Fix for uninstall hook and deprecation warning<\/li>\n<\/ul>\n\n<h3>2.2.0<\/h3>\n\n<ul>\n<li>New icon<\/li>\n<li>Added WebXR support<\/li>\n<\/ul>\n\n<h3>2.1.3<\/h3>\n\n<ul>\n<li>Fix for copy current package player<\/li>\n<li>Fix for multiple different skins on a page<\/li>\n<li>Fix in Gutenberg editor for WordPress 5.4<\/li>\n<\/ul>\n\n<h3>2.1.2<\/h3>\n\n<ul>\n<li>Elementor widget is now responsive<\/li>\n<li>Fix for fullscreen, if the fullscreen API is missing<\/li>\n<\/ul>\n\n<h3>2.1.1<\/h3>\n\n<ul>\n<li>Disable 'sslverify' for gginfo download, as this causes issues with PHP 7.4<\/li>\n<\/ul>\n\n<h3>2.1.0<\/h3>\n\n<ul>\n<li>Added and Elementor widget<\/li>\n<li>Added a filter for packages in the media library<\/li>\n<li>Changed div container ids<\/li>\n<\/ul>\n\n<h3>2.0.1<\/h3>\n\n<ul>\n<li>Improved CSS reset for images<\/li>\n<\/ul>\n\n<h3>2.0<\/h3>\n\n<ul>\n<li>Complete rewrite of the ggpkg-import plugin.<\/li>\n<\/ul>","raw_excerpt":"Display panoramas, virtual tours or object movies created with Pano2VR and Object2VR.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/104606","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=104606"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ggnomes"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=104606"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=104606"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=104606"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=104606"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=104606"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=104606"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}