Documentation | RS Cool MP3 Player Joomla Extension

July 29, 2010

Doc

img-58180

RS Cool Mp3 Player is a flash based minimalistic Mp3 player with a twist, perfect for your website. This is a Joomla extension specially developed for Joomla version 1.5.x. It supports the basic functions of an mp3 player- play, pause, draggable volume bar, sound visualizer. It includes a special sound visualizer that changes when you drag the volume bar. The features are:

  • Customizable width, height and background color of the module and player.
  • The player have Play button, Pause button, Draggable volume bar, Sound visualizer.
  • Single and multiple MP3 song support.
  • Text color, size, player color, button color, background color, visualizer color – Everything is editable from module parameter section.
  • Player can show “Artist Name”, “Song Name” and “Percentage of Volume”.

How To Configure and Use the Module (Steps):

  1. Install this Module.
  2. Now go to “Extensions” => “Module Manager”
  3. Edit/Add “RS Cool MP3 Player” Module and publish it after configuring the module.
  4. For detail configuration of module parameters either follow the steps mentioned in the next point (Point 5: Module Parameter Configuration) or please review these 2 screenshots:
  5. Module Parameter Configuration:
    • Module Class Suffix: A suffix to be applied to the CSS class of the Module. This allows for individual Module styling.
    • Module Width: Width of the module in pixel. Default value is “290″.
    • Margin between Player: If you are listing more than 1 songs, then please specify the gap between 2 songs. Default value is “10″.
    • Player Width: Please specify the Width of a single mp3 player button.  Default value is “281″.
    • Player Height: Please specify the Height of a single mp3 player button. Default value is “78″.
    • Background Color: Color of the background in hex-code. Do not add #. Default value is “FFFFFF”.
    • Autoplay: Start playing the song automatically when loaded. This setting will only work if there is only one mp3 song to play.  Default value is “NO”.
    • Margin: Margin of play button from the edge of the player, in pixel. Default value is “5″.
    • Stroke Color: Stroke Color in hex-code. Do not add #. Default value is “90C84B”.
    • Fill Color: Fill Color in hex-code. Do not add #. Default value is “414042″.
    • Button Back Color: Back Color of Play-Pause Button in hex-code. Do not add #. Default value is “FFFFFF”.
    • Button Back Over Color: Back Over Color of Play-Pause Button in hex-code. Do not add #. Default value is “DEECBD”.
    • Button Sign Stroke Color: Sign Stroke Color of Play-Pause Button in hex-code. Do not add #. Default value is “4B4B4B”.
    • Button Sign Fill Color: Sign Fill Color of Play-Pause Button in hex-code. Do not add #. Default value is “83B04D”.
    • Initial Volume Level: Initial Volume Level. Any value from 0 to 100. Enter 0 to mute, 100 to maximum volume. Default value is “50″.
    • Back Stroke Color: Back Stroke Color of volume control in hex-code. Do not add #. Default value is “4B4B4B”.
    • Back Fill Color: Back Fill Color of volume control in hex-code. Do not add #. Default value is “83B04D”.
    • Sign Color: Sign Color of volume control in hex-code. Do not add #. Default value is “E7E8E9″.
    • Sign Over Color: Sign Over Color of volume control in hex-code. Do not add #. Default value is “4B4B4B”.
    • Percent Text Color: Color of percentage text of the volume control in hex-code. Do not add #. Default value is “E7E8E9″.
    • Percent Horizontal Margin: Horizontal margin of percentage text of the volume control in pixel. Default value is “5″.
    • Percent Vertical Position: Vertical position of percentage text of the volume control, it can be ‘top’, ‘bottom’, ‘center’ or a number. Default value is “top”.
    • Back Color: Back Color of visualizer in hex-code. Do not add #. Default value is “4B4B4B”.
    • Wave Color: Wave Color of visualizer in hex-code. Do not add #. Default value is “FFFFFF”.
    • Artist Color: Color of the artist text in hex-code. Do not add #. Default value is “E7E8E9″.
    • Artist Font Size: Font Size of the artist text in pixel. Default value is “14″.
    • Song Color: Color of the song text in hex-code. Do not add #. Default value is “E7E8E9″.
    • Song Font Size: Font Size of the song text in pixel. Default value is “12″.
    • Name of Artist(s): Specify the name of artists within {}, seperated by comma. Example: “{Artist A}, {Artist B}”.
    • Name of MP3 Song(s): Specify the name of mp3 songs within {}, seperated by comma. Example: “{Song A}, {Song B}”.
    • Location/URL of Song(s): Specify the name of songs within {}, seperated by comma. Example: “{http://www.song.com/mp3/song1.mp3}, {http://www.song.com/mp3/song2.mp3}”.

Support: If you have any question/suggestion or if you wish to report any error please post it in our forum: SUPPORT FORUM LINK (Please do not forget to mention the extension name and the version)

, , , , , ,

About Souvik

Web Developer and SEO Specialist with 7+ years of experience in open source web development. He is also the moderator of this blog (www.rswebsols.com)

View all posts by Souvik

4 Responses to “Documentation | RS Cool MP3 Player Joomla Extension”

  1. Greennud Says:

    Thank you for good Extension !!!
    Could you please let me know how “RS Cool MA3 Player” can work with Thai Language in Name of Artist and Name of song?
    http://www.greennud.com/main/

    Thank you very much
    Best Regards,
    Greennud.

    Reply

    • Souvik Says:

      Although our module support thousands of special characters, but still it not support all. So it may not work for your language for now. We are trying to fix this. Will let you know once fixed.

      Reply

  2. John Says:

    The plugin works great on 1.5 but does not work at all on 1.6+ I really like the player and would like to use it on my 1.6+ sites. What plans, if any, are there to update the module?

    Reply

Leave a Reply