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.m4aFEED:/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 | themearialverdanatimescourierlucidapalatinogill | Change the Title font family |
| font_family_2 | themearialverdanatimescourierlucidapalatinogill | Change the playlist font family |
| titleAlign | leftcentreright | |
| titleTop | eg: 20px | |
| titleCol | eg: blue#fff | Title colour |
| titleOffset | eg: 20px | Title left margin |
| titleOffsetR | eg: 20px | Title right margin |
| titleBold | truefalse | |
| titleItalic | truefalse | |
| captionBold | truefalse | |
| captionItalic | truefalse | |
| listBold | truefalse | |
| listItalic | truefalse | |
| images | A comma seperated list of image urls, or true/false | |
| imageSize | autoWautoHthumbnailmediumlargefull | |
| imageAlign | leftcentreright | |
| imgOverflow | visiblehidden | |
| 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 |