Jump to: navigation, search

Panotour - Notions - Deep Linking

Logo-Panotour-Pro-2010.png Panotour Pro only    This feature is available only in the pro version of Panotour.


Deep linking allows you to go directly to the panorama view and zoom of your choice, among other things. You can achieve this by adding some variables to the URL. This page will explain those different variables.

How does Deep Linking Work

  • Deep-linking starts with ? at the end of your URL, then your variable (see example below).
  • To use several variables in the same link, use the & between variables (see example below).

What variables can I use

  • startscene or s with the panorama id.
    Panorama Information - PanoID
  • h is the horizontal looking direction (-180 to +180).
  • v is the vertical looking direction (-90 to +90).
  • f is the current field of view in degrees (0.0 to 179.0). Depending on its value, this variable may have no effect if Limit to image resolution checkbox is checked.
  • skipintro is an option to skip the little planet effect and/or the splash screen introduction.
  • norotation is an option to stop autorotation. Useful if your tour is build with autorotation on startup.
  • tour_soundson=false is an option to start out the tour with the sounds turned off.
  • tour_displaythumbnails=false is an option to start out the tour with the tour thumbnails hidden.
  • tour_language=en is an option to start out the tour with as specific language. The value can be any language added into the Languages field of the Build screen.
  • vr to start the tour directly on the VR Mode start screen (can be combined with startscene variable).
  • starttime=NB to start a video scene (if it's the first scene) at NB seconds (not available into VR mode).

For example your final deep linked URL could look like:

- http://www.yoururl.com/?html5=only&s=pano425&h=-104&v=-9&f=67
- http://www.yoururl.com/mytour.html?s=pano425&h=-104&v=-9&f=67&skipintro=true&norotation=true
- http://www.yoururl.com/mytour.html?vr&s=pano425

How to force the display of the tour using the Flash or HTML5 player ?

Add ?html5=VALUE at the end of URL where VALUE is:

  • auto for automatic selection of the viewer
    • For example http://www.yoururl.com/?html5=auto or http://www.yoururl.com/mytour.html?html5=auto
  • never for the Flash viewer to be used.
    • For example http://www.yoururl.com/?html5=never or http://www.yoururl.com/mytour.html?html5=never
  • prefer for the HTML5 viewer when possible.
    • For example http://www.yoururl.com/?html5=prefer or http://www.yoururl.com/mytour.html?html5=prefer
    • This is the default mode of all tours using Panotour 2.5+
  • only to enforce the HTML5 viewer.
    • For example http://www.yoururl.com/?html5=only or http://www.yoururl.com/mytour.html?html5=only
  • The same values can be used with ?flash=VALUE at the end of your URL instead.

VALUE prefer and only also support the add of +css3d for the CSS3D player or +webgl for the WebGL player.
See KrPano's documentation

Is it possible to add my own variables?

Of course, but this requires that you edit the xml of the built tour or add a piece of code using the include an XML plugin.

Here are some custom variables have been posted by users on the forum:

BACK TO: Documentation / Panotour Documentation