[RC] Simple Audio Player Mod

[keith10456]

Modification Name: Simple Audio Player Mod
Author: keith10456

Modification Description: Adds a simple Audio Player to your phpBB website. Admins will be able to upload (via FTP) songs, podcasts, etc. that their members can then listen to. The mod utilizes the flash mp3 player from flashmp3player.org. Perfect for an Online Audio Bible.

• Special thanks to Pthelovod for the Simple Header tip and Muggins for the file edit/corrections tips.

Modification Version: 1.0.0

Features:

• Clean, easy to use user interface.
• Optional edit to make Audio Player for members only.
• Player opens in a new (small) window so members can listen to the audio while navigating around your site at the same time.
• Standard player controls.
• Forms playlist automatically (scans audio folder for mp3-files and uses ID3v1/ID3v2 tags for naming).
• Customizable design (you can change the player colors, etc. via xml file).
• Fully resizable.
• Autoplay option.
• Autoresume option (saves playing position when user moves from page to page).
• Uses the page background of the phpBB style you're using.
• No database changes.

Demo URL: Click here for the demo.

• To see the demo of the 2nd audio player in the contrib folder click here.

Modification Download: Click here to download the mod.


Online Audio Bible:
If you want an Online Audio Bible for your forum, simply use this mod with the audio files below. The files are in MP3 format and appropriately named. Once uploaded to the "audioplayer_files" folder (as stated in the install file), the mod will automatically group the files into their respective Bible books (and in the correct order).

• King James Version - Old English is used but more accurate Bible translation.
• New International Version - New English is used but less accurate Bible translation.

Online Bible:
If you would like a searchable Online Bible for your site, see my Simple Online Bible Mod.


Notice: As with any mod, before you install this mod be sure to make a back-up of your phpBB files and database (this mod does not make database changes).

[keith10456]

FREQUENTLY ASKED QUESTIONS

1 - Does this mod support subsilver?
There aren't any subsilver instructions in the download. However, applying the mod to a subsilver based style shouldn't be a problem.


2 - How do I restrict access to the Audio Player to logged in members only?
Open: root/styles/prosilver/template/overall_header.html

Find:

Code: Select all

				<!-- SIMPLE AUDIO PLAYER MOD BEGIN -->
				<li class="icon-sap"> <a href="{U_SIMPLE_AUDIO_PLAYER_MOD_LINK}" onclick="window.open('{U_SIMPLE_AUDIO_PLAYER_MOD_LINK}','','toolbar=no, location=no, directories=no, status=no, menubar=no, scrollbars=yes, resizable=yes, width=400, height=390, left=20, top=10'); return false;">{L_SIMPLE_AUDIO_PLAYER_MOD_LINK}</li>
				<!-- SIMPLE AUDIO PLAYER MOD END -->

Replace With:

Code: Select all

			<!-- SIMPLE AUDIO PLAYER MOD BEGIN -->
				<!-- IF S_USER_LOGGED_IN -->
				<li class="icon-sap"> <a href="{U_SIMPLE_AUDIO_PLAYER_MOD_LINK}" onclick="window.open('{U_SIMPLE_AUDIO_PLAYER_MOD_LINK}','','toolbar=no, location=no, directories=no, status=no, menubar=no, scrollbars=yes, resizable=yes, width=400, height=390, left=20, top=10'); return false;">{L_SIMPLE_AUDIO_PLAYER_MOD_LINK}</li>
				<!-- ENDIF -->
				<!-- SIMPLE AUDIO PLAYER MOD END -->

3 - Can I remove the links that are applied to the Audio Player page?
No. Removing the links will violate the scripts terms of use and copyright.


4 - How do I add this mod to a style other than prosilver?

• Copy the "prosilver" folder in the download and rename it to the exact name of the style you're using.
• Upload the copied folder to the following directory: yoursite.com/yourphpbb/styles/
• In the install instructions, apply the edits for "overall_header.html" to the overall_header.html file of the style you're using.
• In the install instructions, apply the edits for "bidi.css", "buttons.css", "colours.css", and "stylesheet.css" to the files of the style you're using.
• Upload the edited files. Go to the ACP, select the "Styles" tab. Refresh your "Templates", "Themes" and "Imagesets".

5 - How do I uninstall this mod?
Reverse the edits given in the install file. The edited files include:

• yoursite.com/yourphpbb/includes/functions.php
• yoursite.com/yourphpbb/styles/prosilver/theme/bidi.css
• yoursite.com/yourphpbb/styles/prosilver/theme/buttons.css
• yoursite.com/yourphpbb/styles/prosilver/theme/colours.css
• yoursite.com/yourphpbb/styles/prosilver/theme/stylesheet.css
• yoursite.com/yourphpbb/styles/prosilver/template/overall_header.html

Delete from your server:

• yoursite.com/yourphpbb/audioplayer (delete entire "audioplayer" folder)
• yoursite.com/yourphpbb/audioplayer_files (delete entire "audioplayer_files" folder)
• yoursite.com/yourphpbb/audioplayer.php
• yoursite.com/yourphpbb/flashmp3player.php
• yoursite.com/yourphpbb/flashmp3player.swf
• yoursite.com/yourphpbb/language/en/mods/simple_audio_player_lang.php
• yoursite.com/yourphpbb/styles/prosilver/template/audioplayer.html
• yoursite.com/yourphpbb/styles/prosilver/theme/audioplayer.css
• yoursite.com/yourphpbb/styles/prosilver/theme/images/simple_audio_player_mod.png

6 - What versions of phpBB is this mod compatible with?
The mod was tested on versions 3.0.8, 3.0.9, 3.0.10 and 3.0.11.


7 - I'm having a problem with the audio player. No matter what I try it won't work for me.
Try using the 2nd audio player that is in the "contrib" folder of the download. See the folder titled "audio_player_2".

• Before installing the 2nd audio player, you should completely install the default audio player (as stated in the "install_mod.xml" file).
• Then follow the instructions in the "use_2nd_audio_player.xml" file (be sure to upload the new files/folders).

[Jorup16]

Nice mod!

[artikkk]

Can member upload songs?

[keith10456]

Can member upload songs?

No... Sorry.

It's just a simple player for admins to allow their members to listen to their podcasts, songs, etc. However, the player opens in a new (small) window so members can still listen to your audio as they navigate around your site.

[Acesfool]

Hi,

I'm using PHPBB 3.0.9 and when I try to install this mod I get the following error.

The MOD is missing a find matching the action ‘, .rtl .icon-sap’

I am using Automod and I'll openly admit I'm not very knowledgeable of this stuff so any assistance you can give will need to be really dumbed down.

[keith10456]

Hi,

I'm using PHPBB 3.0.9 and when I try to install this mod I get the following error.

The MOD is missing a find matching the action ‘, .rtl .icon-sap’

I am using Automod and I'll openly admit I'm not very knowledgeable of this stuff so any assistance you can give will need to be really dumbed down.

That's weird

Are you using a prosilver or subsilver based style?


For prosilver, here is the relevant code in bidi.css

Code: Select all

/* Icon images
---------------------------------------- */
.rtl .sitehome, .rtl .icon-faq, .rtl .icon-members, .rtl .icon-home, .rtl .icon-ucp, .rtl .icon-register, .rtl .icon-logout,
.rtl .icon-bookmark, .rtl .icon-bump, .rtl .icon-subscribe, .rtl .icon-unsubscribe, .rtl .icon-pages, .rtl .icon-search {

As stated in the install file, FIND:

Code: Select all

, .rtl .icon-search

IN-LINE ADD AFTER:

Code: Select all

, .rtl .icon-sap

[Acesfool]

Thanks for the reply. I downloaded the bidi.css file and added the line where you said, but still get the same error when I run the install in Automod. I also cleared the cache and did a refresh of everything under the styles tab. This one has me baffled.

Sorry, forgot I'm using prosilver style.

[keith10456]

I literally have no idea as to why you're getting this error. Especially since you made the edit by hand.

As a matter of fact, if you made that edit by hand, then you should be able to safely disregard the error.

[Acesfool]

I literally have no idea as to why you're getting this error. Especially since you made the edit by hand.

As a matter of fact, if you made that edit by hand, then you should be able to safely disregard the error.

Ok, just to test something, I downloaded the Simple Weather mod. When I tried to install it with Automod I get this error.

The MOD is missing a find matching the action ‘, .rtl .icon-swm’

This has me wondering if there is some other mod I must have installed before attempting to load these? Here is my overall info.

PHPBB Version: 3.0.9
MySQL Version: 5.0.91

Mods Installed
Facebook profile link
Twitter Profile link
Share Topic
User Blog mod
Video BBCode

I also had the Stargate Portal mod installed but uninstalled it a few days ago,. It was just a bit more "busy" than what I'm looking for. I used Automod to remove it as well.

[keith10456]

Post the code to your bidi.css.

[keith10456]

Post the code to your bidi.css.

Never mind... The problem is with the install file. I'm working on a fix now.

[keith10456]

Re-download the Simple Audio Player Mod and try it again.

[Acesfool]

Re-download the Simple Audio Player Mod and try it again.

Worked perfectly. Thank you.

[keith10456]

Re-download the Simple Audio Player Mod and try it again.

Worked perfectly. Thank you.

Actually, thank you.

Otherwise I wouldn't have known the problem exist. I'm updating the other mod(s) now