This is the homepage of the WP-PhotoNav plugin for WordPress. It is mainly thought as a more interactive platform than the plugin page at the WordPress plugin directory.

Project

I do not plan to significantly increase the functionality of the plugin. Of course I will provide necessary maintenance either in accordance to changes in WordPress itself or due to bugs in the produced output.

If you are interested in the technical details, want to report issues or even contribute, please use the public project on GitHub.

Download

Please download this plugin from the WordPress plugin directory.

Usage

You can use WP-PhotoNav either via WordPress shortcodes or via the media button on top of the editor, which will show a dialogue similar to the ones you know from inserting common images. The dialog does nothing more than automatically generating the shortcode for you. The following examples have the shortcode used to generate them below the image.

Basic

This is the easiest way to include a panorama in your post. You only have to specify the URL of the image.

[photonav url='/files/2010/08/panoramaLeMole.jpg']

Advanced

For more sophistication, WP-PhotoNav accepts a number of parameters, most of which are demonstrated in the following example:

[photonav url='/files/2009/05/panorama02_resized.jpg' container_height=300 mode=drag360 popup=colorbox animate=1]

The following parameters are used:

• container_height – Defines the height of the displayed frame (hence the container). If the image is higher than the given height, vertical scrolling (or dragging) is enabled. The unit is one pixel. There is also the parameter container_width in case you don’t want the frame to fill the horizontal space available in the post or page.
• mode – Specifies one of the following modes: move, drag or drag360 where move is the default mode and doesn’t have to be specified. The drag mode allows the user to navigate the panorama by dragging it inside the frame. The drag360 mode is similar, but generates the illusion of an vertically infinite image. This is useful for 360° panoramas where the user can turn around in each direction infinitely.
• popup – If specified, enables a popup for enlarged view. The only valid popup type at the moment is colorbox, which only works if the ColorBox plugin for jQuery is available. It is provided e.g. by the jQuery Colorbox plugin. You have to install this plugin separately to make use of the popup functionality.
• animate – If this option is enabled, the panorama will be rotated automatically until either the user interacts with it (by scrolling in move mode or dragging in drag mode) or the image is scrolled through entirely once. This allows to attract the users attention to the additional functionality of the panorama compared to a simple, still image. Please note that the animation (like everything else) is accomplished using JavaScript and might not be 100% fluid on all systems and browsers.