|
Update: Screen Caps are not updated, new features have been added to JBGMusic
It's actually straight forward to setup JBGMusic.
Steps:
1. Create your location for your audio, (ie. I chose /images, as it is accessible to the media manager, but you can use another directory)
2. Upload your audio files with the media manager of Joomla or use your favorite FTP program to upload it to the proper directory
3. Set Show title to no.
4. Set Enabled to yes
5. Set position to a desired position (make sure position is existing in your template)
6. Choose Menu assignment where the JBGMusic module would be activated
7. Point your Audio Location to the directory of your audio
8. Enter the titles of your audio files separated by commas (include the extensions)
9. Set Loop, Autostart and Show Controls as needed.
10. Save.
11. That's it!
You may add all the audio files including the ones from different domains at the audio file section. (ie. audio1.mp3, audio2.mp3, http://www.foo.com/audio3.mp3, http://www..foo2.com/audio4.com). The files audio1.mp3 and audio2.mp3 will be treated as local files corresponding to the local Audio Location, while audio3.mp3 and audio4.mp3 are situated in different domains.
Note: Please do ask permission for any usage of audio from their respective owners.
There is no particular position requirement for JBGMusic, you may place it in any module position, the only requirement is that the module position should be active in your template.
You can't install two copies of any extension in Joomla! But do not fret, Joomla has a method wherein you can have two instances of the same module. Just select the module and click the Copy button in your Module Manager then change the title to your preferred title. You can do this with JBGMusic so you can have different playlist for different menu options.
The answer is yes and no, depends on what you want to happen.
1. No, because of the inherent design of Joomla, each click will force a reload of the entire page.
2. Yes, in a way, Joomla has support for Iframes via the built in module mod_wrapper. This can be viewed in this demo site for JBGMusic.
If this is the objective you wish to achieve, then it is only a workaround solution. It involves 2 joomla installs, the first joomla install will be the one to point to your main domain. The second one is the actual joomla install that you wish to show to the outside world.
The main website should contain an empty template with only 1 or 2 modules, in our demo site, we have 2 modules, the top module and the footer module. Enable JBGMusic on the footer module, and configure normally. On the top module, enable the Wrapper module. Point the Wrapper module to your second module.
In the demo site,
Note: the Blank Wrapper template is part of the Download section.
The demo site is actually two (2) joomla sites intertwined using the mod_wrapper module. The main site is basically an empty site with just 2 module positions, the module to hold the mod_wrapper and another to hold JBGMusic. The site that is visible, is another site referenced by the mod_wrapper module.
The main website should contain an empty template with only 1 or 2 modules, in our demo site, we have 2 modules, the top module and the footer module. Enable JBGMusic on the footer module, and configure normally. On the top module, enable the Wrapper module. Point the Wrapper module to your second module. In the demo site,
Note: the Blank Wrapper template is part of the Download section.
JBGMusic has no set limits for the audio file, but do take note that a larger file will make your webpage longer to load. This is also true for multiple file uploads. Take this into serious consideration if your target audience does not have a fast connection.
You may use the media manager built into Joomla if you are uploading small files, but a better option would be to use an FTP program.
Practically any audio files should work with JBGMusic, having said that JBGMusic have only used it with .mp3 files, tried it with .wav but it took longer to load. So feel free to experiment and give us feedback.
To use JBGMusic plugin in your content, go to your Plugin Manager and look for Content - JBGMusic.
Double click on the Content - JBGMusic plugin.
- Point the Audio Location to the location of your audio files.
- Set the default values for Loop Music, Show Controls, Autostart audio
- Enable the JBGMusic plugin
- Save
In your content just add "{"jbgmusic audiofile|[noloop/loop]|[autostart/dontstart]|[showcontrol/hidecontrol]"}" (Note: the quotation marks are not included, it is just there so the line will not be processed. See example below)
To add audio just insert a
sound by 
to your content.
- [noloop/loop] - sets whether the audio file will play in a loop
- [autostart/dontstart] - set whether the audio file will autostart or not
- [showcontrol/hidecontrol] - set whether the plugin will display the media controls
No, the parameters [noloop/loop]|[autostart/dontstart]|[showcontrol/hidecontrol] are options to give control to the plugin. There is no particular order that needs to be followed. You may use one, two, all or none of the parameters. If you don't use any particular option, the default option set in the Plugin Manager will be used, this gives the plugin versatility in use. Although the name of the audio file is case sensitive, the parameters are not, so AutoStart is the same as autostart or autoStart.
You may have as many instances of JBGMusic in your content, for example, you may have an audio file as background music and another as your narration.
But take note having multiple files to load will make your webpage load slower. So take this into consideration when planning out your content.
At this time, all JBGMusic instances will play (if set to autostart) when it has loaded.
This is not a bug, although we love our logo, we do not wish to clutter up your document, so although you may place as many {jbgmusic} in your document, the plugin will only show the logo of the first occurrence of JBGMusic. So if you put page breaks in your document the JBGMusic logo will not appear in succeeding pages if you have published it your first page. Although, there are many pages to the document, it is still one document. Although, if you set the System-Pagebreak plugin before JBGMusic, the logos will appear once on each page.
This is only applicable to all hidden JBGMusic, all visible JBGMusic controls will contain a logo.
For the JBGMusic module, here are some points to check:
- Check the audio location, see if it is a valid location.
- Check if you have proper permissions set in your Joomla install.
- In J!1.5 Native, remove the leading '/' in your audio location
- In J!1.5 Legacy, you have to add the leading '/' in your audio location.
- In J!1.0, you have to add the leading '/' in your audio location.
- Check if you have entered the correct audio filename, no leading and trailing spaces.
- Audio files are case sensitive.
- Check if module is enabled.
- Check if module position is enabled in your template.
- Check if JBGMusic is enabled for the particular menu.
- In some templates, somehow, JBGMusic would not publish in a submenu.
- Check if your host computer has the appropriate codecs for the audio file.
- Check if JBGMusic is not set to autostart.
- Check if your browser has proper plugin to play your audio (ie. quicktime plugin)
For the JBGMusic plugin, here are some points to check:
- Check the audio location, see if it is a valid location.
- Check if you have the proper permissions set in your Joomla install.
- In J!1.5 Native, remove the leading '/' in your audio location
- In J!1.5 Legacy, you have to add the leading '/' in your audio location.
- In J!1.0, you have to add the leading '/' in your audio location.
- Check if you have entered the correct audio filename, no leading and trailing spaces.
- Audio files are case sensitive.
- Check if plugin is enabled.
- Check if your host computer has the appropriate codecs for the audio file.
- Check if JBGMusic is not set to autostart.
- Check if your browser has proper plugin to play your audio (ie. quicktime plugin)
If all else fails, do contact us, maybe we can help you resolve your problem.
We have only tested JBGMusic with Firefox, IE7 and somewhat Google Chrome. Both Firefox and IE7 should not experience any kind of problems, Google Chrome did have problems displaying the controls, but played the audio. Just make sure that your browser has proper plugins to process your audio file (ie. quicktime).
We did not test with Opera, Safari, IE6 or IE5, but feel free to test it around and give us feedback.
If we have helped you in our small way, we appreciate any kind of contribution or by clicking on our sponsor's link. To buy us a cup of coffee you may use the donate button on our webpage, which should take you to our Paypal's donation page.
Also, we would most appreciate a kind word in the Joomla Extensions Directory.
Thank you.
|
