About Flash MP3 Player

Creates a Field to store MP3-Audiofiles and generates a Frontend-Player which is extensively configurable in the Module settings.

Category 1Markup Generation
Markup modules that are called upon to generate or parse markup (like HTML). Markup modules are most often used on the front-end of a site (rather than admin).
Category 2Photo/Video/Audio
Modules that perform some function related to media such as photos and audio/video.
Category 3SEO/Accessibility
Modules designed to help site accessibility, standards compliance and SEO.
Release StateStable
Should be safe for use in production environments. *
Authorkixe
Module Version1.2.0
Class NameAudio_MP3
Compatibility2.3, 2.4, 2.5, 2.6, 2.7, 3.0
Date AddedJune 12, 2013
Last UpdatedMarch 19, 2016
Recommended ByNew recommendations may take up to 1 day to appear.

Instructions

This module's files should be placed in /site/modules/Audio_MP3/
How to install or uninstall modules

README

Audio_MP3

This module integrates a highly configurable Flash MP3 player in your pages.

Third party Code

This modules uses two versions of the free flash-mp3-player

download

or

more information

http://flash-mp3-player.net/players/

code

https://github.com/neolao/mp3-player/

licenses

http://creativecommons.org/licenses/by-sa/3.0/deed.en
http://www.mozilla.org/MPL/

author

neolao https://github.com/neolao

How to install

  • Download from github the module and the two swf Files, unzip, copy all files in a folder /Audio_MP3/ and add the folder to your /site/modules/ directory.
  • Click check for new modules in ProcessWire Admin Modules screen. Click install for the module labeled: "Audio_MP3".
  • Now you will be on the module config screen. Please make note of the config options and set as you want.
  • Done!

How to use

  • Add the field 'Audio' created by the module to your Template in Setup > Templates.
  • Add the following code to the template file
  • to get the title list: $page->player['title'];
  • to get the player: $page->player['code'];
  • create a page using the Template
  • drag and drop mp3 or mp3.zip files in the audio field in the Page-Edit-Area.
  • If you like put an alternative title in the description-field after the file upload. Default title is the name of the file.

How it works

If you store just one File in the Page-Edit-Area the Maxi-Player will be loaded. For 2 or more files the Module will switch to Multi-Player. If you want an alternative title, you can put it in the Description-field of the Audio Field, which is visible after the file upload.

Module Configuration

  • width: Forces the video width.
  • height: Forces the video height. //only Maxi-Player only one file stored
  • volume: The initial volume, between 0 and 200. By default set to 50
  • showstop: 1 to show the STOP button.
  • showinfo: 1 to show the INFO button.
  • showvolume: 1 to show the VOLUME button.
  • showloading: 'alway','never','autohide') to show the LOADING bar// By default set to 'alway'
  • buttonwidth: The buttons width. By default set to 30.
  • volumewidth: The width of the VOLUME button. By default set to 30.
  • volumeheight: The height of the VOLUME button. By default set to 10
  • loadingcolor: The color of loading bar
  • sliderovercolor: Hover color of the bar
  • buttonovercolor: Hover color of buttons

added in 1.0.2

  • buttoncolor: Color of Controls
  • slidercolor1: Start Color (start-color)
  • slidercolor2: End Color (gradient)
  • playlistcolor: Backgroundcolor of the playlist visible in Multiplayer only (2 and more files)
  • currentmp3color: visible in Multiplayer only (2 and more files)

more informations about configuration options here:

changelog

  • 14.06.13 add error messages to the install routine
  • 15.06.13 hook added to $page
  • 20.06.13 message added to the uninstall routine
  • 25.09.13 some configuration-options added (multiplayer)
  • 09.10.13 multisite support (path to swf-player/ site-folder)
  • 14.10.13 all phrases translatable
  • 14.10.13 translation for german available
  • 21.10.13 simplified color setting, allowed input now: with/without leading '#', 3 or 6 digit hex-code, Colornames allowed
  • 21.10.13 for better accessibility: alternative links directly to the mp3-files included
  • 25.10.13 accesibility: headline added to titlelist in alternative content
  • 13.11.13 bug fixed: Validation Error w3c: place before flow content(h2,ul etc.) in
  • 19.03.16 tested in PW 3.0.9, small debugging, better uninstall process preventing ugly error messages

Copyright 2013 by Christoph Thelen

Comments

No comments yet. Be the first to post!

Post a Comment

Your e-mail is kept confidential and not included with your comment. Website is optional.