FrontEnd MP3 Player¶

What does it do?¶

This Flash MP3 Player includes various playmodes, streaming playback, playhead scrubbing, and an equalizer. The playlists are created visually in the Typo3 backend. All settings can be done through flexforms on each instance of the plugin.

About the player / Licensing¶

This extension is an integration of an existing standalone MP3 player, developed by Jeroen Wijering – www.jeroenwijering.com . Thanx a lot to him for his great work.

The original files (including the Flash source file) can be downloaded on the following URL:

http://www.jeroenwijering.com/?item=Flash+Mp3+Player

Note that a creative commons license (exact terms: `http://creativecommons.org/licenses/by-nc-sa/2.5/ <http://creativecommons.org/licenses/by-nc-sa/2.5/>`_ ) is applied to this software. Please contact his author before using it for commercial purposes.

Screenshots¶

Here's what you'll get with this plugin (at left the default skin, and at right the new G-Skin):

If the Flash plugin is not found on the browser, the plugin will display an HTML list of the available MP3 files:

PodCasts¶

This plugin can play MP3 files directly from an external podcast. If you're interested to create/publish your own podcast, then you should try the «Typo3 Podcast Extension» (nbo_podcast) ( http://typo3.org/documentation/document-library/extension- manuals/nbo_podcast/current/ ), which is actually based on this extension, and which includes the same player. In its latest version, the Frontend MP3 Player extension has a direct support for selecting podcasts from nbo_podcast, which will soon use its player rather than providing its own. Thanx a lot to Noël Bossart for this work, and for the coordination.

Installation¶

The installation of this extension is very simple. Just connect to the Typo3 Extension Repository and download «FrontEnd MP3 Player» (fe_mp3player), located in the frontend plugin section. Note that you will also need to download version 2.3 of the «Developer API» extension (api_macmade), as it will be needed by the plugin.

When you install the extension, you'll notice a field called TypeNum.

This is the typeNum of the XML page which will be passed to the Flash file. You only have to care about this if you already have an extension which uses the same typeNum. Otherwise, just leave the default one.

Playlists¶

The next step is to create a playlist with your MP3 files. On a sysfolder, just create a new element and choose «Playlist» from the list:

You'll then be able to edit your playlist, and add MP3 files in it. You got three ways to do this.

Add MP3 files separately

Read MP3 files from a directory

Read MP3 files from a remote PodCast

Choose the way you want to create your playlist, and click on the corresponding item in the «Type» select menu.

Add MP3 files separately¶

With this option, you'll be able to add as many MP3 files as you want. Either choose «NEW MP3» to upload a file or «NEW PATH» to give the path to a MP3 file already present on the server (note that you must manually save to add a new section). Just repeat this step as many time as needed to create and complete your playlist.

Read MP3 files from a directory¶

With this option, you'll need to give the path of a directory (on the server) which contains your MP3 files. The playlist will then reload and display all the MP3 files present in that directory. Simply click on a file name to add it to the playlist. You can also give specific titles for each selected MP3. If no title is set, the MP3 file name will be used.

Read MP3 files from a remote PodCast¶

With this method, you just need to provide a PodCast URL. The MP3 files will then be read directly from this URL in the Flash player.

Read MP3 files from the Typo3 PodCast extension¶

With this method, if you have installed the Typo3 PodCast extension (nbo_podcast), you'll be able to directly select the PodCasts created by this extension.

Placing the plugin on a page¶

On a page, create a new content element anc choose «MP3 Player» from the list.

You'll now be able to configure the instance of the plugin through Typo3 flexforms. On the first tab, just add the playlist you want to be available in the player.

The second tab contains some options relative to the player. Please refer to the configuration section of this manual for more informations about those options.

Finally, on the third tab, you can configure settings related to the Flash plugin. Here again, refer to the configuration section of this manual for more informations about those settings.

Reference¶

Here's the complete reference of the TypoScript options for the plugin. Remember that you can set each one through the constant editor, or through each instance of the plugin.

((generated))¶