Skip to main content

Joomla Plugin

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

These instructions were written using Joomla version 2.5.9.

Install the Joomla Plugin

  1. Download the plugin from: http://ggnome.com/ggpkg.

  2. Log in to the administration area of your Joomla site.

  3. Go to the Extenstion Manager. Make sure Install, is selected.

  4. Upload and install the Joomla package file (ggpkg_joomla_1_0_0.zip).

  5. Go to Manage, in the extension manager.

  6. Find the plugin and check that it is enabled. If it is not enabled, select the plugin and choose, Enable.

Add Package to an Article

  1. Go to ContentMedia Manager in the Administration area.

  2. Create a new folder or use an existing.

  3. Upload the GGPGK.

    img

  4. Add a new article: ContentArticle ManagerAdd new article. (Or add to an existing article.)

  5. Add the GGPKG package to the body text of the article.

    This requires a bit of stringing attributes together.

    Below is a list of a few examples. The string starts and ends with curly brackets { } and the attribute descriptors are encased in quotes: ggpkg file="put_filename_here".

    • To show only the panorama or object:

      {ggpkg file="Package_ID" display_userdata="false" display_map="false"}

    • To show a preview image with a play button, a map and custom
      window size:

      {ggpkg file="Package_ID" start_preview="true" display_map="true" width="320" height="240"}

    • To show a map without a panorama:

      {ggpkg file="Package_ID" map_only="1"}

      Using the number, 1, turns the map_only function to, on.

Plug-in Manager – GGPKG Import

The GGPKG Import settings are found under ExtensionsPlug-in ManagerGGPKG Import. These settings affect all instances of the GGPKG. Changes can be done on an individual basis using the attributes..

Player Properties

Joomla Properties

Width and Height – Change the default player size.

If, for example, you set the width to 100%, the panorama player will always fit within the column’s width.

✭ Units are customizable. If no units are added, pixels (px) are assumed.

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 all from playing at once.

User Data

Display User Data – Select to show the User data when published.

User Data – Use this text field to add a customized layout of the user data.

Joomla User Data

Pano2VR

Display Map – If a panorama is geotagged, you can include a map with the panorama. It will be visible when published.

The next three options work in conjunction with each other. They can be used to globally update the player and skin using one GGPKG. This avoids having to update every panorama when the player or skin changes.

Master Panorama – Upload a GGPKG to function as the master panorama.

Use Player from Master Panorama – Select to use the uploaded Master’s player. For every instance of GGPKG, the player will be updated to the one used in the Master.

Use Skin from Master Panorama – Select to use the Master’s skin. For every instance of GGPKG, the skin will be updated to the one used in the Master.

Object2VR

The following three options work in conjunction with each other. They can be used to globally update the player and skin using one GGPKG. This avoids having to update every panorama when the player or skin changes.

Master Objectmovie – Upload a GGPKG to function as the master object movie.

Use Player from Master Objectmovie – Select to use the uploaded Master’s player. For every instance of GGPKG, the player will be updated to the one used in the Master.

Use Skin from Master Objectmovie – Select to use the Master’s skin. For every instance of GGPKG, the skin will be updated to the one used in the Master.


See also

2017-08-10 08:38:23