Tierra Innovation: Wordpress CMS Project
An open source project developed by Tierra Innovation and WNET.org
Audio Playlist Manager
v 2.2Tierra’s Audio Playlist Manager offers extensive flexibility when embedding mp3 audio into your posts or templates.
Features:
- Embed single/multiple audio file(s) on a post page or template
- Embed single/multiple audio playlist(s) on a post page or template
- Build your own XSPF compatible player and link our XML to it (we’ve tested against Tom Boutell’s Enhanced XSPF player
Short Code Examples
We have set up some easy to use short code that can be pasted into any post / page within WordPress.
Multi-Track Audio Playlist:
If you are looking to embed a playlist on to your page, you can use the following short code.
1 2 3 4 | // using the short code `[ti_audio]` by itself will attempt to play playlist #1, // which may or may not exist. It's always preferable to use a named Playlist // when calling the player or to set the id. [ti_audio] |
1 2 | // Plays playlist with name "Name of Playlist" (case sensitive) [ti_audio name="Name of Playlist"] |
1 2 | // Plays playlist #1 [ti_audio id="1"] |
1 2 3 4 5 | // Uses the swf located at this location, rather than the default. // Your root folder must contain a crossdomain.xml file allowing // another domain's swf access to XML data. Also passed is the // name of the player and the swf's width and height values. [ti_audio skin="/player/xspf_player_custom.swf" width="260" height="315"] |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | // In addition, you can also change the following attributes of the player (defaults shown): // Sets player to begin playing on load. Default is off, 0. autoplay="0" // Sets player to begin loading assets before the user clicks anything. Default is on, 1. autoload="1" // Sets player to repeat once it reaches the end of the playlist. Default is off, 0. repeat="0" // URL of the XSPF swf to use for display. Uses default player unless specified. skin="xspf_player.swf" // Set if the skin attribute points to a SWF of different dimensions. width="400" height="170" // Set default volume level (in percent) volume="50" // Set the playlist to play in random order randomize="1" |
Single Audio Track:
If you are looking to embed a single file, use the following short code.
1 2 | // Plays audio file with id of 1 [ti_audio media='201'] |
1 2 | // Plays single audio file, set to auto play, repeat and volume at 60% [ti_audio media='201' autoplay="1" repeat="1" volume="60"] |
Templates:
You can embed the audio player into any WordPress template. Much like the short code examples above, you can customize the values within your own templates. Here are all of the fields that you can specify should you choose. Omitting a field will set it to the plugin’s default values.
1 2 3 4 5 6 7 8 9 10 | <? if (function_exists ("ti_apm_print_player")) { print ti_apm_print_player (array( "name" => "Name of Playlist", "skin" => "/player/xspf_player_custom.swf", "autoplay" => "0", "repeat" => "0", "width" => "400", "height" => "170" )); } ?> |
To play a single audio file within your template, specify the following:
1 2 3 4 5 6 | // Set the media id to play a single audio track <? if (function_exists ("ti_apm_print_player")) { ti_apm_print_player (array( "media" => "3" )); } ?> |
Player API:
Want to use your own player? That’s no problem. We built our custom player to follow a default set of XML that is compatible with any skinned XSPF audio player. You can choose to use the core XSPF player by downloading it here or can skin your own.
Change Log:
v2.2
- Fixed widget randomize bug
- Fixed syntax error on certain browsers with output
v2.1
- Fixed RSS ‘array’ bug introduced with WP 3.0
v2.0
- Added widget support
- Added notice on plugin page about file upload limitations
- Added compatibility with WP 3.0.x
- Fixed loading bug upon activation in WP 3.0.1
- Fixed rendering bug on file upload size limit (see add notice)
v1.1.0
- Added ability to “randomize” audio tracks
- Added pre-loading indicator to default player
- Fixed bug in player causing multiple instances of track to play
- Changed preview to use text area for shortcode selection
v1.0.9
- Fixed bug in admin playlist display reported to affect IE users.
v1.0.8
- Fixed bug in player that could lead to simultaneous sound playing.
- Added logo to admin page.
v1.0.7
- Fixed glitches in Admin UI lightbox.
- Updated ti-player.swf to better accomodate long album, artist and track names.
- Removed visual glitch when ti-player.swf is launched without autoplay (Player would expand and shrink upon load).
- Fixed error thrown when selecting tracks from right-click menu while player was paused.
v1.0.6
- Changed Roles & Capabilities user level code to check against edit_others_posts per some users permissions issues.
v1.0.5
- Fixed the template embed code to render the player inside a theme.
v1.0.4
- Changed embed code to increase compatibility with older XSPF players. (Flash 7 v. 8 specifically)
v1.0.3
- Fixed issue where users who were not administators could not access the plugin page. You can now access if you are an Editor or Administrator. If you are an Editor, you will see the link to the plugin page under the “Tools” menu. If you are an “Administrator” you will see the link to the plugin page under both “Tools” and “Settings.” Also fixed an HTML bug on the edit asset screen.
I am having trouble with this plugin.
I’m trying to insert the audio player widget into the footer by dragging it into the footer copyright widget as directed. I also tried to insert the shortcode into the footer from the theme’s settings panel. I also tried to insert the Tierra’s Audio php code into the Novatorix template (footer.php) as documented from the Tierra’s Audio site. All without any desirable results.
The player is within the footer, copyright area. I see the title of the playlist but nothing else.
Please advise.
Report this comment
in header.php, place this < ?php wp_head(); ?> before the closing tag and in footer.php, place < ?php wp_footer(); ?> before the closing tag and see if that works for you.
Report this comment
Love the update! Exactly what I needed. Now, my site/podcast is complete. Much appreciated.
Report this comment
This is the best playlist manager I’ve found and thanks for that. I’m wondering if you know of any HTML 5 or non- flash players that would work with this? Since iPhones and iPads don’t support flash, it makes more sense to find alternatives.
Report this comment
@Seth – we’re talking about offering an HTML5 version, but haven’t yet decided on a release date for it. Keep checking back.
Report this comment
Hello,
I find your plugin very nice, especially due tot the autoresume option. However I have a problem in using: it seems that it does not recognize the mp3 files in media livrary. Even if I add one new mp3 file from the Tierra plugin page it does not recognize it (but the new file is loaded in Media library of the WP).
Can you help me, please?
Thank you,
Iustin
Report this comment
@Iustin – can you email a screen shot? Hop over to the Support page for our email and address it to Todd.
Report this comment
Does this player work on the iPad without Flash?
Report this comment
@Thomas at this time it does not support the iPad
Report this comment
Hi,
is it possible to get this player in an extra frame or what ever, so that the music can still play, when a site is change ?
thanks
Report this comment
@Klasser – it is possible – you’d either need to create a blank template and assign it to a page, and then use a popup window, or figure out how to use frames within WordPress. Good luck!
Report this comment
Another ‘issue’
Right now there are two entries in the wp-admin menu for Tierra – one in ‘settings’ and one in ‘tools’.
There is no difference, you are taken to the exact same page.
I suggest removing the ‘settings’ entry, because really, there are no settings, you can upload files and manipulate playlists, but setting? Can’t be done. Either that, or provide a regular settings page (which would be nice – path to an alternative xspf player, ability to pass along custom flashvars etc…)
I also suggest moving the other entry from ‘tools’ to ‘media’, because even though you could call Tiearra for a tool, it’s more intuitive to have it under ‘media’.
That’s all for today
Report this comment
@acebone – this is due to some users with legacy permissions not having access to the settings menu but wanting access to manage the plugin.
Report this comment
The current version generates invalid HTML:
……
The SCRIPT tag (or any block-level tag) is not permitted inside a element:
http://www.w3.org/TR/html401/struct/text.html#h-9.3.1
http://www.w3.org/TR/REC-html40/interact/scripts.html#h-18.3.1
Report this comment
The comment system deleted portions of my comment above, the essence of which is:
The SCRIPT tag is not permitted inside a P element.
Report this comment
I don’t see enough context here to be able to use this.
What is a playlist ID?
What is a playlist name?
I have playlists in xspf files. How do I upload/install them in order to be able to use the short codes?
Report this comment
Ah, now I see it buried under the changes list for v1.0.3.
Report this comment
Another bug:
Selecting ‘Create random order playlist’ in the widget does NOT randomize the playlist, the playlist is the same whether you select this option or not!
Report this comment
The reason is:
In the javascript that inserts the player you find:
‘flashvars’, ‘autoplay=1&player_title=Playlist+managed+by+Tierra+Audio+Playlist+Manager&volume=70&playlist_url=http>MY_URL>wp-content%2Fplugins%2Ftierra-audio-playlist-manager%2Fplaylist.php%3Fid%3D7%26media_id%3D0%26random%3D0′
The last param ‘%26random%3D0′ needs to be: ‘%26random%3D1′ !
Report this comment
@acebone – this fix just went up – check for v2.2
Report this comment
There is a problem with v. 2.0
The main RSS feed is ‘corrupted’
Instead of the actual feed-text of an item you get:
Warning: call_user_func_array() expects parameter 1 to be a valid callback, first array member is not a valid class name or object in /home/www/jenswinther.net/wp-includes/plugin.php on line 166
Disabling the Tierra plugin returns the feed back to it’s normal state.
Report this comment
@acebone – the rss fix is avail for v2.1.
Report this comment
It seems viewing in the editor for plugins the /tierra-audio-playlist-manager/js/AC_RunActiveContent.js is inactive Is that why its not showing on the pages?
http://sobehouse.net/shstore/?page_id=4&category=9&product_id=49 example
Report this comment
The player works in the preview mode but when I copy and paste the shortcode I view it on the page it just shows the code [ti_audio name="absinthe" autoplay="1"] and not the player.
Report this comment
Is there a way to have all of the tracks in a playlist display in the player at once, rather than simply one at a time?
Report this comment
Hi Todd;
Thanks for that great plugin. I managed to install it allright in my WP site and works beautifully on a normal page. But I need to get it in a popup window container (to Size 290px 32px) so that it doesn’t stop when changing page.
Thank you to gimme a solution for that issue.
Report this comment
I like the player a lot, but I need the ability to prevent the songs in the playlist from being downloaded. Can you please add this feature? Until then, I’m going to have to look for something else to use.
Report this comment
Hello,
Is there any documentation or a tutorial about getting Tierra to work with Tom Boutell’s Enhanced XSPF player? Or better yet, this player:
http://www.premiumbeat.com/flash_music_players/original/multiple_menu
I’m not sure how to link Tierra’s generated xml playlist to the other players.
I’m currently linking to the xml file that I get when I click the ‘Download XML File’ link on the Tierra Audio Playlist Manager page in WordPress.
Thanks,
Seth
Report this comment
Hi,
Bug Report.
This plugin is breaking the RSS feed of my site.
I found at line 236 the following code:
add_action(‘the_excerpt_rss’, array(&$this, ‘ti_apm_remove_shortcode_from_rss’));
passing $this and a method as a parameter when you are not inside a class. I just removed it and its ok now:
add_action(‘the_excerpt_rss’, ‘ti_apm_remove_shortcode_from_rss’);
cheers
Leo,,
Report this comment
Hi, I can’t get this plugin to active. It says “It looks like the plugin did not fully activate.” Any ideas/
Cheers,
Matt
Report this comment
Hi Guys,
I love the potential of this plug-in but I have about 200 tracks to import from my old site and I’m wondering if there’s any bulk process to add music and edit playlist info.
Thanks very much.
Pete
Report this comment
UPDATE: very excited as I just found out that I simply need to add files to the media gallery and hey presto all my media is automatically detected by this great plugin!
Nice work!
Report this comment
FYI – REALLY USEFUL!
adding lots of media files via FTP does not work as they are not recognised by the media library but there is a work around – see here for FTP instruction and Plugin details:
http://cyberinnovation.com/plugins/adding-large-files-to-wordpress-media-library-via-ftp-or-file-upload/
Report this comment
Nice plugin, I have one question:
Does the plugin add the audio file (mp3) from a folder say \audio (mp3 that is not loaded to the media library) ?
Report this comment
Hi there,
I was wondering if anyone can help me out as I was trying to add this code into my template but because I don’t have any real skills when it comes to coding I’m not too sure on what to do with the below code to make it work.
I have pasted it into my template under the css stylesheet but nothing comes up, I have noticed some of the pieces are highlighted in blue but wasn’t sure what to replace this text with?
I know what the media track is but the remaining parts I have no idea what to do with them.
Could anyone advise me?
// Set the media id to play a single audio track
“3″
));
} ?>
Thanking you in advance.
Justin
Report this comment
Hi Todd!
This plugin looks great i like it.
I think i have a poor theme though, as it is giving me trouble with ANY mp3 i’ve tried…
Any advice or suggestions?
Thanks
-008′
Report this comment
how about a function like “audio-player” for wordpress where only one player is allowed to play at a time this is the only thing holding me back from using this nice plugin
Report this comment
Hi!!
I’m trying to place the player on my single posts on http://www.nix-nix.com –> http://www.nix-nix.com/wp
But I’m always getting an error
Could you help me please?
Thanks in advance,
Nicole
Report this comment
@Nicole – I am seeing an error 500 message when trying to access the playlist. The first step would be to check the permissions of the plugin folder (folder: 755 / files: 644) and see if that helps. There is something perms based that is causing the plugin not to work as expected.
Report this comment
Hi Todd,
Regarding your last message to Karl, is there any chance you could provide a link to this documentation on how to re-skin the player.
I think it’s a great player, however if it’s not placed on a light background, there seems to be a white background around it.
Perhaps when you revist the player, you could ensure it’s built on a transparent background.
Cheers
Chris
Report this comment
I’m having a similar problem. I installed, set it up, seemed to do everything correct. All permissions were set fine as well. I am using new version of WP.
When I loaded the code in the page, the player is there, but just says ERROR and no tracks are there.
Help?? Thanks!
Report this comment
Hello,
I have installed your plugin and I think this is THE one I need. But as I’m not using the upload interface from the WordPress (because my mp3 files are too bigs for that) but a ftp connexion instead, my uploaded files are not appearing in the Media Library, wich is the location the plugin uses for choosing files.
I’ve tried to copy the uploaded files (via ftp) in the Uploads folder, but the plugin still doesn’t “see” them…
Do you see a solution ? Is it possible to define the location where the plugin should find the files ?
Thank you !
fkjh
Report this comment
Hello,
I think your plugin is THE thing I’m looking for. But I’m not using the uplaod manager from the WordPress interface, because my mp3 files are too big for the server. I’m using an ftp transfer and it does work well. But your plugin seems to look in the Media Library what are the files, but there is none. And even if I make a copy of my mp3 files in the Uploads folder, theplugin don’t “see” them. Do you have any idea for solving this problem ? Is there a listing of the files in the Media Library wich I could modify to make the plugin able to “see” my files ?
Thank you !
Report this comment
Hi,
The player works like a charm! I have a playlist going on and want to know if there is any way to configure it so the playlist does not start from the beginning as I navigate from one page to another on my website. I’d like for the song to continue playing.
Thanks!
Report this comment
oops, location tags won’t show here in the comments. My examples should be;
locationtag
http://path.to/music.mp3
/locationtag
instead of
locationtaghttp://path.to/music.mp3/locationtag
Report this comment
Trying to use Tierra generated playlists in other apps (XSPF Jukebox) but they doesn’t work.
Investigating a bit if find that there are linebreaks at in the generated playlists.;
http://path.to/music.mp3
instead of
http://path.to/music.mp3
Removing line breaks makes playlists work in XSPF Jukebox.
I’m doing this manually. Have tried changing playlist.php to get rid of linebreak but can’t see anything wrong with that code.
So, how do we get rid of linebreaks in Tierras playlists?
Report this comment
hi – im having these problems:
1) the plugin does not automatically find mp3 files that are already uploaded. the files are not in wp-content though, is there a place i should put them?
2) more importantly – when i embed the player, it appears on the page, but never actually finishes loading and doesnt play the songs – it just has the little ‘loading’ animated icon on the left and never stops loading.
can anyone help?
Report this comment
im having a couple of problems trying to use this plugin – first, it doesnt seem to automatically recognize mp3 files already uploaded (not in wp-content, but still on the site), is there a place to put these so the plugin will pick them up?
also, when i upload mp3s from the desktop instead, and create a playlist and embed it following the video tutorial, the playlist does not ever finish loading – the player just has the ‘loading’ animated icon on the left, and never stops loading.
can you help?
Report this comment
I am trying to use the [ti_audio media='201' autoplay="1" repeat="1" volume="60"] in a Widget on my WordPress blog. However it will not work. The exact code shows up just like that and not the player. Does this code work in a text box in the widget area? Thank you.
Report this comment