jplayer January 17, 2012 / Updated: July 25, 2023

Note: The example macros in this text contain a space after the first and before the last bracket. This is to avoid them being executed. On real usages there should be none.

Support for the jPlayer jQuery/Flash 2.0.0 multimedia player (jplayer.org). It will play natively via HTML5 in capable browser if the appropiate multimedia formats are provided.

Audio: .mp3, .m4a, .fla - Counterpart formats .oga and .webma supported (see note below!)
Video: .m4v/.mp4, .flv - Counterpart formats .ogv and .webmv supported (see note below!)

IMPORTANT NOTE ON OGG AND WEBM COUNTERPART FORMATS:

The counterpart formats are not valid formats for Zenphoto itself as that would confuse the management. Therefore these formats can be uploaded via ftp only. The files needed to have the same file name (beware the character case!). In single player usage the player will check via file system if a counterpart file exists and if counterpart support is enabled. NOTE: Counterpart format does not work correctly on playlists yet. Detailed reason: Priority solution setting must be "flash" as otherwise flv and fla will not work on some browsers like Safari. This in return disables counterpart support for ogg and webm files for some reason on Firefox). Since the flash fallback covers all essential formats ths is not much of an issue for visitors though.

Otherwise it will not work. It is all or none. See the developer guide for info on that.

NOTE on POPCORN Support (http://popcornjs.org):
jPlayer has support for this interactive libary and its plugin is included but currently not loaded or implemented. You need to customize the plugin or your theme to use it. Please refer to http://jplayer.org/latest/developer-guide/ and http://popcornjs.org to learn about this extra functionality.

NOTE ON PLAYER SKINS:
The look of the player is determined by a pure HTML/CSS based skin (theme). There may occur display issues with themes. Only the Zenphoto's own default skins zenphotolight and zenphotodark have been tested with the standard themes (and it does not work perfectly for all). These two themes also have a responsive width. So you might need to adjust the skin yourself to work with your theme. It is recommended that you place your custom skins within the root /plugins folder like:

plugins/jplayer/skin/skin name1
plugins/jplayer/skin/skin name2 ...

You can select the skin then via the plugin options. NOTE: A skin may have only one CSS file.

USING PLAYLISTS:
You can use printjPlayerPlaylist() on your theme's album.php directly to display a video/audio playlist (default) or an audio only playlist. Alternativly you can show a playlist of a specific album anywhere. In any case you need to modify your theme. See the documentation for the parameter options.

Alternativly you can show a playlist of a specific album anywhere. In any case you need to modify your theme. See the documentation for the parameter options.

CONTENT MACRO:
jPlayer attaches to the content_macro MEDIAPLAYER you can use within normal text of Zenpage pages or articles for example.

Usage: [ MEDIAPLAYER <fullpath to your multimedia file> <number> ]

Example: [ MEDIAPLAYER http://yourdomain.com/albums/video/video.mp4 ]

If you are using more than one player on a page you need to pass a 2nd parameter with a unique number:
[ MEDIAPLAYER http://yourdomain.com/albums/video/video1.mp4 1 ]
[ MEDIAPLAYER http://yourdomain.com/albums/video/video2.mp4 2 ]

NOTE: This player does not support external albums!

This extension is included in the ZenphotoCMS release.

For questions and comments please use the forum or discuss on the social networks.