Joomla Plugin

These instructions were written using Joomla version 2.5.9.

Install the Joomla Plugin

  1. Download the plugin from: https://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 Content > Media Manager in the Administration area.
  2. Create a new folder or use an existing.
  3. Upload the GGPGK.
    Upload-joomla.png
  4. Add a new article: Content > Article Manager > Add 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 Extensions > Plug-in Manager > GGPKG Import. These settings affect all instances of GGPKG. Changes can be done on an individual basis using the attributes..

Player Properties

Joomla-player-props.png

  • Width and Height: Change the default player size.
    ◊ NOTE: Units are customizable. If no units are added, pixels (px) are assumed.
    ◊ TIP: If you, for example, set the width to 100%, the panorama player will always fit within the column’s width.
  • 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 customize layout of the user data.
    Userdata joomla.png

Pano2VR

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

Pano-map.png

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

CMS Plugins
Download the Plugins
Extenstion installation in Joomla
HTML5 Output (Pano2VR)
HTML5 Output (Object2VR)
User Data (Pano2VR)
User Data (Object2VR)