Shortcode Reference
For examples of how to use shortcodes, please see the Demo Pages.
Single-File Players
These are the parameters for both [mp3t]
and [mp3j]
shortcodes:
Parameter | Possible Values | Description |
---|---|---|
track | eg:http://example.com/myfile.m4a | A filename, url, or number (from custom fields) |
caption | Your caption text | |
counterpart | url to an alternative file format | |
fontSize | eg: 20px | Change the title font size |
title | eg: My Track Title | Add a custom title |
flip | y n | Flip play/pause button to other side |
loop | y n | Repeat plays the file upon completion |
autoplay | y n | Auto-starts the player when you visit the page. Note that some mobiles and tablets prevent autoplay |
vol | eg: 75 | A number between 0 - 100 |
ind | y n | Show connecting indicator and time |
flow | y n | non line-breaking player |
volslider | y n | show volume control |
Additionally for [mp3t]
shortcodes:
Parameter | Possible Values | Description |
---|---|---|
play | eg: Play Me! | Text for the play button |
stop | eg: Stop It! | Text for the stop button |
Playlist & Popout Players
These are the shortcode parameters for [playlist]
(or [mp3-jplayer]
) and [popout]
(or [mp3-popout]
) shortcodes, the popout shortcode also has a few extra options listed at the bottom of the page:
Parameter | Possible Values | Description |
---|---|---|
tracks | eg:http://example.com/myfile.m4a FEED:/my/folder | A comma seperated list of filenames, urls, or FEED commands |
counterparts | A comma separated list of urls to alternative file formats | |
captions | eg: My Caption; Another Caption | A semicolon seperated list of captions |
loop | y n | Repeat plays the playlist upon completion |
autoplay | y n | Auto-starts the player when you visit the page. Note that some mobiles and tablets prevent autoplay |
vol | eg: 75 | A number between 0 - 100 |
dload | y n loggedin | Show the download button |
title | eg: My Title | Shown above player and as the popout window title |
list | y n | Start wih the playlist open (players must have more than 1 track to have a playlist) |
pn | y n | Show Prev and Next buttons |
width | eg: 40% or 300px | A numeric width including the units |
pos | left right rel-L rel-C rel-R | Float left, float right, or left/centre/right on it's own line |
stop | y n | Show Stop button |
shuffle | y n | Shuffles the playlist |
pick | eg: 3 | Picks the specified number of tracks randomly from the available playlist |
id | Any WordPress page ID, eg:35 | Playlists the tracks from the custom fields of the specified post |
height | eg. 130px | A numeric height including the units |
style | eg: fullbars nostop | A list of modifier names (separated by spaces). These change the look of the player, the following are provided by default:
nostop nopn nolistbutton noplayer fullbars notitle |
ids | eg 10,11,12 | A comma separated list of library item IDs |
fontsize | eg: 20px | Change the title font size |
font_family_1 | theme arial verdana times courier lucida palatino gill | Change the Title font family |
font_family_2 | theme arial verdana times courier lucida palatino gill | Change the playlist font family |
titleAlign | left centre right | |
titleTop | eg: 20px | |
titleCol | eg: blue #fff | Title colour |
titleOffset | eg: 20px | Title left margin |
titleOffsetR | eg: 20px | Title right margin |
titleBold | true false | |
titleItalic | true false | |
captionBold | true false | |
captionItalic | true false | |
listBold | true false | |
listItalic | true false | |
images | A comma seperated list of image urls, or true/false | |
imageSize | autoW autoH thumbnail medium large full | |
imageAlign | left centre right | |
imgOverflow | visible hidden | |
ppText | Popout button text (default to the text set on the options page) |
Additional parameters for the [popout]
(or [mp3-popout]
) shortcode:
Parameter | Possible Values | Description |
---|---|---|
text | eg: Pop me out! | Text for the popout button |
tag | eg: h2 | The html tag to wrap the text in |
image | An image url to use for the popout button |