Skip to main content

WordPress Plugin

We provide a package format (GGPKG) to make it easy for you to embed your panoramas on your CMS site or blog. Below are the instructions for WordPress.

✭ The plugin works only with the self-hosted WordPress publishing platform (wordpress.org). The plugin will not work on wordpress.com sites.

Install the WordPress Plugin

  1. Log in to your WordPress site.

  2. In the Dashboard’s left sidebar, hover over Plugins to bring up a menu. Click, Add New.

  3. Search for our plugin, Garden Gnome Package.

  4. Click, Install Now.

  5. Select, Activate Plugin.

The plugin will now be in the Plugins list.

To delete the plugin

  1. Under the plugin name, select Deactivate.

  2. Select, Delete.

  3. Choose, Yes.

Add the Image or Tour to a Post

Before you can add the GGPKG to a post, you must first install the plugin.

First, export your image or tour using the Generate GGPKG button in the HTML5 output settings. The package format is like a ZIP. Once the package is uploaded to WordPress, your project will be unpacked/unzipped and you will see your image/tour in the Media Library.

Using the Widget

  1. Add a new post.

  2. Add a block.
    Add Block

  3. Find the Widgets tab and the GGPGK widget.
    Add Wiget

  4. Add the image or tour to the page. Select, Select Package and then choose your image or tour or drag your package to upload it, if you haven’t done so already.

Using the Classic Editor

The Classic Editor will give you the package ID in a Shortcode. Once you have the ID, you can just use the Shortcode widget.

  1. Add a new post.

  2. Add a block.

  3. Find the Formatting tab and choose, Classic.
    Classic Editor

  4. Click the Add Media button and then drag the GGPKG to the media library (to upload it) or select the tour or image from the library. Click, Insert into post.
    Add Media

  5. Once the image or tour has been inserted in the post, you’ll see something like this:
    Package added

    This is the shortcode for the image or tour. In the example above, the number is the media’s unique ID assigned by WordPress.
    Each package can be customized using attributes.

  6. Preview and/or publish your post.

Garden Gnome Package Settings

The Plugin settings are found in the WordPress Settings in the Dashboard.

General Settings

These settings affect all instances of GGPKG; both from Pano2VR and Object2VR. Changes can be done on an individual basis using the attributes or in the post’s sidebar.

Player size – Defines the default size of the player.

Start player as preview image – The player will load and start playing when the user clicks the preview image. This is handy for when there are multiple projects on one page and some or all, for example, have background sound. This prevents them from playing all at once.

Pano2VR

Player Version – Choose a version from an already uploaded package. Once you upload packages, you will see a list of all the the player versions that are available. This is useful for when the embedded project doesn’t work as expected suddenly, but it’s known that a previous version worked. You can then choose that previous version.

Object2VR

Player Version – Choose a version from an already uploaded package. Once you upload packages, you will see a list of all the the player versions that are available. This is useful for when the embedded project doesn’t work as expected suddenly, but it’s known that a previous version worked. You can then choose that previous version.

Uploading Large Files

If you need to upload projects to Wordpress but are limited by the upload file restrictions, then you can convert a normal HTML5 output to a light-weight package to get past the file size restrictions.

Another option would be to host the project files elsewhere and use the shortcode, ggpkg url=e'xample.com/mytour.index'.


See also

2019-08-19 12:48:21