The krpano bundle for Contao 4 integrates the well-known and widely used panorama software of the same name into the Contao CMS.
The free version of the bundle installs the equally free demo version of the krpano viewer for HTML5.
Important notes!
The HTML5 viewer adds a “krpano demo version” watermark. For unrestricted use of krpano you need to buy a krpano license!
You have to create the panoramas yourself. The corresponding droplets are not included in the bundle. If you already use krpano, you can keep using your file structures.
The Flash component of krpano is not supported by this bundle.
You find an overview of the available krpano licenses here: krpano.com/buy.
Search for the bundle with the keyword krpano. The bundle is then offered for installation.
Click “Add” on the bundle.
Then click “Packages” and then “Apply changes”. The bundle is now installed.
2. Run a database update
After the installation has finished, run a database update.
Configuration
After the installation you will find a new menu item pdir Apps in the main menu of the back end.
It contains three entries: Panoramas, Hotspots and Configuration.
The three entries are largely self-explanatory.
under »Panoramas« you manage all panoramas registered in the system
under »Hotspots« you manage all hotspots. Hotspots are always assigned to one or more panoramas.
under »Configuration« you manage a krpano configuration.
The menu item »Panoramas«
List
This menu item gives access to the available panoramas. They are shown in a customized list.
Each record is shown with a heading and in two columns. The heading shows the ID of the panorama
and its name. The left column contains data about the hotspots and a preview image (krpano preview.jpg, if one
was generated). The right column (currently) contains the description text, as it can be very long.
Edit
As usual in Contao, click the yellow pencil to edit a record.
The detail view looks like this:
Each panorama record gives access to the following data:
Panorama name and alias
You can set a name and an alias for each panorama.
The field of view (also called »view«)
A view consists of three parameters: the horizontal viewing direction, the vertical viewing direction and the field of view angle (sometimes called the zoom value).
The view is initialized with start values when it loads. You enter them under Field of view and viewing direction:
the start viewing direction, horizontal (krpano pov = point of view) is a decimal number with two decimal places. The range is from -180.00° (left) to +180° (right).
This setting may differ from older krpano versions. Strictly speaking, -180° = +180°, i.e. a vector on the horizon plane pointing »backwards«.
If you want to know more about the structure and configuration of a view, we recommend the krpano documentation on the view.
the start viewing direction, vertical (krpano poh = point of heading) is also a decimal number with two decimal places. The range is from +90.00° (zenith) to -90° (nadir).
the start field of view angle (fov = field of view) is a decimal number with two decimal places. The range is (theoretically) 0.00°, (in practice) 27.54° to (theoretically) 180.00°, (in practice) 120.00°.
Preview
The preview window is below the view parameters and shows the current panorama.
It is initialized with the values of the view. The preview also shows all hotspots associated with the
panorama and several overlays. It looks like this:
Overlay »View«
At the top left there is an overlay with the three parameters (pov, poh and fov) of the view.
It shows the parameters of the current view.
If you click into the preview and »drag« the panorama with the mouse button held down,
you can move the view (pan and zoom). The parameters are updated continuously.
Once you have changed the view, you can save the parameters with one click. This makes working with a panorama
easier, because you don’t have to enter all three parameters separately every time.
Info
To set the view again, click into the preview and not on a hotspot! The view overlay cannot
be hidden.
Overlay »Debug mode«
This overlay can be shown and hidden. It shows important parameters of the panorama and helps with
troubleshooting.
Overlay »Hotspots«
On the right edge of the preview there is an overlay with all hotspots of the panorama.
Info
Unfortunately, not all hotspot types have the correct icons yet.
The following icons are available:
Icon
Meaning
Error This hotspot is faulty or cannot be jumped to (not a GoTo hotspot).
GoTo Click this hotspot to jump to it. There is a target panorama available at the marked position.
Image This is an image hotspot. A photo or hover information is shown at this position.
