.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt =================== FrontEnd MP3 Player =================== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Jean-David Gadina :Changed: 2009-05-12T14:26:18 :Email: macmade@gadlab.net .. _FrontEnd-MP3-Player: FrontEnd MP3 Player =================== Extension Key: **fe\_mp3player** Copyright 2000-2002, macmade@gadlab.net, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.com .. _Table-of-Contents: Table of Contents ----------------- **FrontEnd MP3 Player 1** **Introduction 1** What does it do? 1 About the player / Licensing 1 Screenshots 2 PodCasts 2 **Users manual 3** Installation 3 Playlists 3 Add MP3 files separately 4 Read MP3 files from a directory 4 Read MP3 files from a remote PodCast 5 Read MP3 files from the Typo3 PodCast extension 5 Placing the plugin on a page 6 **Administration 7** **Configuration 8** Reference 8 **Known problems 9** **To-Do list 9** **Changelog 9** .. _Introduction: Introduction ------------ .. _What-does-it-do: 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: 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/ `_ ) is applied to this software. Please contact his author before using it for commercial purposes.** .. _Screenshots: Screenshots ^^^^^^^^^^^ Here's what you'll get with this plugin (at left the default skin, and at right the new G-Skin): |img-1| If the Flash plugin is not found on the browser, the plugin will display an HTML list of the available MP3 files: |img-2| .. _PodCasts: 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. .. _Users-manual: Users manual ------------ .. _Installation: 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. |img-3| 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: 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: |img-4| 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 |img-5| Choose the way you want to create your playlist, and click on the corresponding item in the «Type» select menu. .. _Add-MP3-files-separately: 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. |img-6| .. _Read-MP3-files-from-a-directory: 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. |img-7| .. _Read-MP3-files-from-a-remote-PodCast: 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. |img-8| .. _Read-MP3-files-from-the-Typo3-PodCast-extension: 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. |img-9| .. _Placing-the-plugin-on-a-page: Placing the plugin on a page ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ On a page, create a new content element anc choose «MP3 Player» from the list. |img-10| 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. |img-11| 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. |img-12| 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. |img-13| .. _Administration: Administration -------------- The whole configuration of the plugin is available through the constant editor. Please see the configuration section for more details about each option. |img-14| .. _Configuration: Configuration ------------- .. _Reference: 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. .. ### BEGIN~OF~TABLE ### .. _width: width """"" .. container:: table-row Property width Data type int+ Description Control the width of the player. Default 400 .. _height: height """""" .. container:: table-row Property height Data type int+ Description Control the height of the player. Default 400 .. _version: version """"""" .. container:: table-row Property version Data type int+ Description The version of the Flash plugin required to view the player. Default 6 .. _swfParams-loop: swfParams.loop """""""""""""" .. container:: table-row Property swfParams.loop Data type string Description Loop the Flash animation (Flash object parameter). Default false .. _swfParams-menu: swfParams.menu """""""""""""" .. container:: table-row Property swfParams.menu Data type string Description Allow the Flash menu to be displayed in the animation (Flash object parameter). Default false .. _swfParams-quality: swfParams.quality """"""""""""""""" .. container:: table-row Property swfParams.quality Data type string Description The quality of the Flash animation (Flash object parameter). Default best .. _swfParams-scale: swfParams.scale """"""""""""""" .. container:: table-row Property swfParams.scale Data type string Description The scale of the Flash animation (Flash object parameter). Default showall .. _swfParams-bgcolor: swfParams.bgcolor """"""""""""""""" .. container:: table-row Property swfParams.bgcolor Data type color Description The background color of the Flash animation. Default #FFFFFF .. _swfParams-swliveconnect: swfParams.swliveconnect """"""""""""""""""""""" .. container:: table-row Property swfParams.swliveconnect Data type string Description Enable the use of LiveConnect (Flash object parameter). Default false .. _swfParams-salign: swfParams.salign """""""""""""""" .. container:: table-row Property swfParams.salign Data type string Description Alignment of the Flash animation (Flash object parameter). Default l .. _swfParams-wmode: swfParams.wmode """"""""""""""" .. container:: table-row Property swfParams.wmode Data type string Description Window mode for the Flash animation (Flash object parameter). Default window .. _skins-default: skins.default """"""""""""" .. container:: table-row Property skins.default Data type string Description The SWF file with the default skin. Default EXT:fe\_mp3player/pi1/mp3player.swf .. _skins-gskin: skins.gskin """"""""""" .. container:: table-row Property skins.gskin Data type string Description The SWF file with the G-Skin. Default EXT:fe\_mp3player/pi1/mp3player\_gskin.swf .. _playerParams-useSkin: playerParams.useSkin """""""""""""""""""" .. container:: table-row Property playerParams.useSkin Data type string Description The skin to use. Default default .. _playerParams-gskinColor: playerParams.gskinColor """"""""""""""""""""""" .. container:: table-row Property playerParams.gskinColor Data type int+ Description The color to use for the G-Skin. Default 1 .. _playerParams-showDisplay: playerParams.showDisplay """""""""""""""""""""""" .. container:: table-row Property playerParams.showDisplay Data type boolean Description Show display drawer at start. Default 1 .. _playerParams-showPlaylist: playerParams.showPlaylist """"""""""""""""""""""""" .. container:: table-row Property playerParams.showPlaylist Data type boolean Description Show playlist drawer at start. Default 1 .. _playerParams-autostart: playerParams.autostart """""""""""""""""""""" .. container:: table-row Property playerParams.autostart Data type boolean Description Automatically start playing songs when the player is loaded. Default 1 .. ###### END~OF~TABLE ###### [tsref:plugin.tx\_femp3player\_pi1.] .. _Known-problems: Known problems -------------- None at the time. Just contact me if you find some. .. _To-Do-list: To-Do list ---------- - Make output XHTML compliant. - Better support for nbo\_podcast extension. - Change locallang files to XML. - Please contact me if you have any suggestion about this extension. .. _Changelog: Changelog --------- .. _generated: ((generated)) ^^^^^^^^^^^^^ .. _0-2-4-6-sup-th-public-release: 0.2.4: 6 :sup:`th` public release """"""""""""""""""""""""""""""""" Fixed security issue #2009030510000012: SQL Injection vulnerability .. _0-2-3-5-sup-th-public-release: 0.2.3: 5 :sup:`th` public release """"""""""""""""""""""""""""""""" Fixed a bug with flexforms on Typo3 4.0. .. _0-2-2-4-sup-th-public-release: 0.2.2: 4 :sup:`th` public release """"""""""""""""""""""""""""""""" Added direct support for Typo3 PodCast extension (nbo\_podcast). .. _0-2-1-3-sup-rd-public-release: 0.2.1: 3 :sup:`rd` public release """"""""""""""""""""""""""""""""" - Fixed a bug with the PodCast import function. - Fixed a bug with older versions of Typo3. .. _0-2-0-2-sup-nd-public-release: 0.2.0: 2 :sup:`nd` public release """"""""""""""""""""""""""""""""" - Added an option to read MP3 files from a directory instead of uploading them. - Added an option to get MP3 files from a remote PodCast. - Fixed a bug with the player when the Typo3 site is not in the www root. - Added new player skin (G-Skin) and options. - Added new options for the Flash plugin (wmode, salign, etc.). - Added context sensitive help for database table. - Increased upload limit for MP3 files to 10MB (was 2 MB). - Miscellaneous fixes. .. _0-1-0-1-sup-st-public-release: 0.1.0: 1 :sup:`st` public release """"""""""""""""""""""""""""""""" |img-15| FrontEnd MP3 Player - 9 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.jpeg .. :align: left .. :border: 0 .. :height: 376 .. :id: graphics2 .. :name: graphics2 .. :width: 602 .. |img-2| image:: img-2.jpeg .. :align: left .. :border: 0 .. :height: 203 .. :id: graphics13 .. :name: graphics13 .. :width: 548 .. |img-3| image:: img-3.jpeg .. :align: left .. :border: 0 .. :height: 131 .. :id: graphics3 .. :name: graphics3 .. :width: 669 .. |img-4| image:: img-4.jpeg .. :align: left .. :border: 0 .. :height: 77 .. :id: graphics4 .. :name: graphics4 .. :width: 207 .. |img-5| image:: img-5.jpeg .. :align: left .. :border: 0 .. :height: 223 .. :id: graphics9 .. :name: graphics9 .. :width: 434 .. |img-6| image:: img-6.jpeg .. :align: left .. :border: 0 .. :height: 228 .. :id: graphics12 .. :name: graphics12 .. :width: 588 .. |img-7| image:: img-7.jpeg .. :align: left .. :border: 0 .. :height: 336 .. :id: graphics11 .. :name: graphics11 .. :width: 413 .. |img-8| image:: img-8.jpeg .. :align: left .. :border: 0 .. :height: 68 .. :id: graphics10 .. :name: graphics10 .. :width: 434 .. |img-9| image:: img-9.jpeg .. :align: left .. :border: 0 .. :height: 70 .. :id: graphics14 .. :name: graphics14 .. :width: 434 .. |img-10| image:: img-10.jpeg .. :align: left .. :border: 0 .. :height: 107 .. :id: graphics5 .. :name: graphics5 .. :width: 285 .. |img-11| image:: img-11.jpeg .. :align: left .. :border: 0 .. :height: 143 .. :id: graphics6 .. :name: graphics6 .. :width: 582 .. |img-12| image:: img-12.jpeg .. :align: left .. :border: 0 .. :height: 213 .. :id: graphics7 .. :name: graphics7 .. :width: 582 .. |img-13| image:: img-13.jpeg .. :align: left .. :border: 0 .. :height: 24% .. :id: graphics8 .. :name: graphics8 .. :width: 60% .. |img-14| image:: img-14.jpeg .. :align: left .. :border: 0 .. :height: 700 .. :id: graphics1 .. :name: graphics1 .. :width: 334 .. |img-15| image:: img-15.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102