Streamers Webplayer Files

-------------------------------------------------------------------------------
Streamers Webplayer [ A project by djcrackhome | Streamers Admin Panel ]
-------------------------------------------------------------------------------

Version 1.057
Release date: 06/15/2011
-------------------------------------------------------------------------------
Project state:
stable / final [updated]
-------------------------------------------------------------------------------


Requirements:
Webspace/Webserver with PHP 4/5 and JSON extension. [usually its included]
A SHOUTcast server which runs with UTF-8 encoding. Please be aware that some
'special characters' may not be displayed properly through the unicode problem
of SHOUTcast. You will need to know the administration password of this server
you want to use. This player needs to load the playlist settings and other
data from the server.
-------------------------------------------------------------------------------


Development:
Developer: djcrackhome [Sebastian Graebner] [PHP/HTML/Idea]
Thanks to 'Raimund Barendt' [JQuery/JSON] & 'Rico Reinheckel' [Idea] 
-------------------------------------------------------------------------------



Usage:

----------- PARAMETER VARIABLES
You may open just the Link over your personal webbrowser, but you can also ch-
ange variables, since version 1.02, like 'autoplay' and 'volume'.

If you want to use your player with autostart variables you can change it:
http://www.domain.com/folder/?play=1	or
http://www.domain.com/folder/?play=0
You may also change the volume with this parameter change
http://www.domain.com/folder/?vol=65	which is going to set the volume to 65%

You can also use both things, like shown in this example:
http://www.domain.com/folder/?play=1&vol=35



----------- MULTIPLE STREAMS
You may open the file ./includes/config.inc.php to change the standard stream
configuration. In the folder ./includes/streams/ you will find many pregiven 
files with standard blank stream configuration, just edit each file for each
stream you may wish to use. You can rename them however you want to.

If you open then your standard url the standard url, you will be started with
the standard stream, to change to a different stream just open your webplayer
with the following parameter:
http://www.domain.com/folder/?stream=filename

filename = is going to be the filename of the streamfile you would like to open
For example if your streamfile is called 'hiphop.inc.php', you will just need
to open it with:
http://www.domain.com/folder/?stream=hiphop

Of course you can also use the other parameters with this, for example:
http://www.domain.com/folder/?stream=hiphop&play=1&vol=35


----------- SOCIAL MEDIA
If you want your player to be enabled, so users can add your website url to
their Facebook or Twitter account, then you just need to go to your desired
stream configuration file, and edit $social_enable to either TRUE or FALSE.
On $facebook_image please type in your full image url, which will be shown
if the user posts the link to Facebook. You need to provide a full url, no
relative url is allowed! Like: http://www.domain.com/images/fb_img.png
For Twitter everything is pre-set.
-------------------------------------------------------------------------------


License:
Creative Commons Attribution-ShareAlike 3.0 Unported License
This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported License.
 To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/ or
 send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.
-------------------------------------------------------------------------------


Weblinks
url:		http://www.streamerspanel.com/webplayer/
support:	http://support.streamerspanel.com
mail:		info@streamerspanel.com
paypal:		info@streamerspanel.com
-------------------------------------------------------------------------------


Exclusively for "VIP Users" of the Streamers Admin Panel
-------------------------------------------------------------------------------


Update Notes:
[1.057]	-> HTML5 Audio Player added and added also blank value for logos
[1.053]	-> PHP edits so it will work fine :)
[1.05]	-> Social Media CSS and import of their code.
[1.04]	-> Multiple streams are now possible, changed the structure
[1.03]	-> Added a footer and changed a few CSS values
[1.02]	-> Added a preloader image and set the img load time to 3 seconds
[1.01]	-> Fixed a few PHP errors, and added GET parameter changes
[1.00]	-> First stable release with all requirements
[0.95]	-> Beta version , internal, just for demostration purpose



+++++++++++++++++++++++++++INSTALLATION INSTRUCTIONS+++++++++++++++++++++++++++

Please upload all files of the upload folder to your website/webserver and open
the file in the folder:
	./includes/config.inc.php	and
	./includes/streams/stream1.inc.php
You will find various values, there are required and optional values. Please 
edit the 'required values', please type in there your radioservers' ip adress,
port, and administration password. After that please edit the optional values
if desired. After that just open the ./index.php file, which is running on your
webserver, and 'voila', there you go, have fun!
-------------------------------------------------------------------------------


If you like this panel, please donate. We offer all our scripts with no fee, but
we can just do that while you guys are donating, we need those to cover our dev-
elopment expenses. THANK YOU VERY MUCH!



--written by djcrackhome [Sebastian Graebner] | Los Angeles, June 2011