This plugin requires at least WordPress 3.0
Installation - https://www.youtube.com/watch?v=km5cVH-iH_8
How To Use The Player - https://www.youtube.com/watch?v=DVLHNopEpXw
Manage The Banners - https://www.youtube.com/watch?v=i4CWseyJmLc
From this section you can:
- add a new player
-
select the player you want to edit by clicking "Player Settings"
- add/edit playlist radio streams by clicking "Playlist"
- delete an existing player by clicking "Delete"
From this section you can:
- add a new category
- edit an existing category
- delete an existing category
From this section you can:
- add a new banner
- edit an existing banner
- delete an existing banner
- duplicate an existing banner
From this section you can define the radio player settings.
| Attribute | Description |
| General settings | |
| Skin Name | The audio player comes with 2 predefined controllers skins, which have different colors for hover status of the buttons. By controllers we understand play, pause, volume, facebook, twitter, show/hide playlist buttons. These buttons are saved as .png images. If you need another color for these controllers, you have the PSD files included and you can save over one skin, the controllers with another color.
Possible values: |
| Player Height | You can define the player height. The value should be greater or equal with 94 (pixels) |
| Title Width | The text box width for current playing song, artist & radio name |
| Player Background Color | The background color (hexa or 'transparent' value) of the area beneath the radio station name and current playing title. |
| Player Background Opacity | The background opacity of the area beneath the radio station name and current playing title. Values 0-100. |
| Sticky | Possible values: true - the audio player will be positioned on the bottom of the page beeing fixed while the page scrolls false - the audio player will NOT be positioned on the bottom of the page beeing fixed while the page scrolls |
| Start Minified | Possible values: true - the radio player start minified and only 'show/hie' button will visible. If you set this parameter true you also need to set sticky:true false - the radio player will start with the normal/standard dimension. |
| Banner Width | Banner width (in pixels) |
| Banner Height | Banner height (in pixels) |
| Banner Change Interval | If you'll define multiple banners for the same radio station, this parameter defines how long a banner will be visible until the next one will appear. |
| Banner Link Target | Banner link target. |
| Initial Volume Value |
You can initialize the volume. The range is 0 to 1 |
| Auto Play | Possible values: true - autoplays audio file false - doesn't autoplay audio file |
| Volume Off State Color | Volume slide color (hexa) - off state |
| Volume On State Color | Volume slide color (hexa) - on state |
| Song Title - Text Color | Audio file Title text area color (hexa) which resides next to the image |
| Radio Station - Text Color | Audio file Author text area color (hexa) which resides next to the image |
| Image Border Color | The color (hexa) of the border for the round photo |
| Minimize Button Text | You can translate "open / close " in your own language (if needed) |
| Minimize Button Color | Minimize button color (hexa) - off state |
| Minimize Button Color - Hover | Minimize button color (hexa) - on state |
| FaceBook AppID | FaceBook AppID. Please check Facebook Share section, for more informations |
| FaceBook Share Title | The title which will appear on FaceBook share. Please check Facebook Share section, for more informations |
| FaceBook Share Description | The description which will appear on FaceBook share. Please check Facebook Share section, for more informations |
| Refresh Interval for Now-Playing Info | The calling interval (in seconds) for the file which reads the current playing song |
| Player Loading Delay | The timeout delay (in seconds) for player loading |
| Grab Artist Photo | Possible values: true - it will grab the artist photo false - it will always use the image specified by 'noImageAvailable' parameter |
| Grab Stream Name and Genre | Possible values: true - it will grab the stream name and stream genre false - it will always use the stream name and stream genre defined in the playlist |
| Translate Radio Station | You can translate "Radio Station: " in your own language (if needed) |
| Translate Reading Data | You can translate "reading data..." in your own language (if needed) |
| Translate All Radio Stations | You can translate "ALL RADIO STATIONS" in your own language (if needed) |
| Default 'No Image Available' | The path to 'No Image Available' image which will appear when there's no image found in the database |
| Popup Width | The initial popup window width |
| Popup Height | The initial popup window height |
| Bars Color | The bars animation color |
| Show Gradient Over Bars | Possible values: true - a gradient will appear over the bars animation false - a gradient will not appear over the bars animation |
| Controllers Settings: Show/Hide buttons & elements | |
| Show Banner | Possible values: true - the ads will appear and the current playing song artist image will not false - the ads not will appear and the current playing song artist image will appear |
| Show Volume | Possible values: true - volume buttons will appear false -volume buttons will not appear |
| Show Facebook Button | Possible values: true - facebook button will appear false - facebook button will not appear |
| Show Twitter Button | Possible values: true - twitter button will appear false - twitter button will not appear |
| Show Popup Button | Possible values: true - the pop-up button will appear false - the pop-up button will not appear |
| Show Radio Station | Possible values: true - radio station name will appear false - radio station name will not appear |
| Show Title | Possible values: true - current playing song will appear false - current playing song will appear |
| Show Playlist Button | Possible values: true - show/hide playlist button will appear false - show/hide playlist button will not appear |
| Playlist Settings | |
| Playlist Top Position | Additional playlist distance between player and playlist, when the playlist is visible |
| Playlist Background Color | Playlist background color (hexa) |
| Playlist Record Background Off Color | Playlist item background color (hexa) - OFF state |
| Playlist Record Background On Color | Playlist item background color (hexa) - ON state |
| Playlist Record Bottom Border Off Color | Playlist item bottom border color (hexa) - OFF state |
| Playlist Record Bottom Border On Color | Playlist item bottom border color (hexa) - ON state |
| Playlist Record Text Off Color | Playlist item text color (hexa) - OFF state |
| Playlist Record Text On Color | Playlist item text color (hexa) - ON state |
| Number Of Items Per Screen | Number of items shown in the playlist. You'll have to scroll to see the rest |
| Playlist Padding | Playlist inner padding |
| Show Playlist Number | Possible values: true - the item number in the playlist will appear false - the item number in the playlist will not appear |
| Show Search Area | Possible values: true - the search area will appear false - the search area will not appear |
| Search Area Background Color | Search area background color (hexa) |
| Search Input Text | Search input initial text, useful for translation purpose |
| Search Input Background Color | Search input background color (hexa) |
| Search Input Border Color | Search input border color (hexa) |
| Search Input Text Color | Search input text color (hexa) |
| Category Settings | |
| Show Categories | Possible values: true - the categories will appear false - the categories will not appear |
| First Selected Category | The name of the first displayed category (in the top of the playlist). If no value is selected, since the categories will be alphabetically ordered, the first one will be displayed as the first selected category |
| Selected Category Background Color | Selected category background color (hexa) |
| Selected Category Off Color | Selected category color (hexa) - OFF state |
| Selected Category On Color | Selected category color (hexa) - ON state |
| Selected Category Bottom Margin | Selected category bottom margin |
| Category Record Background Off Color | Category item background color (hexa) - OFF state |
| Category Record Background On Color | Category item background color (hexa) - ON state |
| Category Record Bottom Border Off Color | Category item bottom border color (hexa) - OFF state |
| Category Record Bottom Border On Color | Category item bottom border color (hexa) - ON state |
| Category Record Text Off Color | Category item text color (hexa) - OFF state |
| Category Record Text On Color | Category item text color (hexa) - ON state |
Shoutcast and Iceast Link Structure
- SHOUTCAST LINK
http://[domain]:[port] OR
http://[ip]:[port]
Ex: http://83.169.60.45:80
IMPORTANT: For the vast majority of the shoutcast streams, try appending "/;" to the stream so it looks like this:
http://[ip]:[port]/;
Ex: http://83.169.60.45:80/;
- ICECAST LINK
http://[domain]:[port]/mountpoint
Ex: http://87.230.59.20:80/iloveradio2.mp3
- RADIONOMY LINK
For radio hosted by radionomy.com, the link looks like this: http://streaming.radionomy.com/ABC-Piano
Due to the fact that the IP is unknown, the player can't access current playing song name and artist photo. It will play it and it will display the radio name.
NOTE: Radio Stream should be MP3 type, no support for AAC/AAC+ stream
From this section you can define radio streams in the playlist
| Stream | radio stream. For more informations regarding stream structure please check Shoutcast and Iceast Link Structure section |
| Stream Title | Radio Stream title. This is an OPTIONAL parameter due to the fact that the plugin will automatically obtain the stream title |
| Category | Radio Stream category. This is an OPTIONAL parameter due to the fact that the plugin will automatically obtain the stream categories |
| Banners | Radio Stream associated banners. This is an OPTIONAL parameter due to the fact that you can set Show Banner: false and show the artist image instead |
The shortcode is:
[lbg_audio8_html5_shoutcast settings_id='1']
where
settings_id is the player ID defined in "Manage Players" section
In order for the Facebook share button to work you need to obtain a Facebook Application ID
1. Go to the Facebook Developers Apps page and and sign in with your Facebook username and password.
2. Click the "Create New App" button.
If you do not see the option to create a new app in the upper right hand corner, click on "Register as Developer."
3. After that you'll obtain an 'App ID' which you'll paste in FaceBook AppID field in Manage Players->Player Settings area of our plugin
4. Go to Settings->Basic tab (left area), select 'Website' and insert your website URL and fill all the other information. Below you have a demo screenshot. Of course, you'll use your own info.