=== liveTV Bundle ===
  
Contributors: Laurent (KwarK) Bertrand
Donate link: http://kwark.allwebtuts.net/
Tags: gamer, livestreams, livestream, plugin, wordpress, own3d, twitch, justin, streaming, live stream, liveTV
Tested up to: 3.3.2
Stable tag: 1.1


LiveTV Bundle for WordPress. Live stream plugin for wordpress compatible with own3d.tv, twitch.tv, justin.tv


== Description ==

* Create automatically a page with a loop of livestream thumbnails from your team members
* Create new roles or use wordpress default roles (all default roles except subscribers - currently not for mass sharing)
* View current game
* View xplit/livestream message
* View live!since date and hour
* Display or not livestreams offline (on, off, off only on widget)
* Generate thumbnails list for each types (own3d, justin, twitch)
* Large view and normal view
* Cache system
* Sidebar widget
* Generate automatically one IRC quakenet under each livestream
* Change quakenet for each original chat (own3d, twitch, justin chat)
* Colorization system for text (all html color) and 3 general themes
* Optional: work also with different manual shortcodes for own3d/twitch/justin in articles or pages
* Optional: work also with different manual shortcodes for ustream/livestream in articles or pages
* Optional: work also with different manual shortcodes for original chat/quakenet IRC lonely
* Compatible with all recent major browser IE9, Safari, Chrome, Firefox, Opera
* Customizable and adaptive to all major themes with administration options
* en_US, en_EN, fr_FR included and original .pot, .mo, .po included and ready to translate
* Only ~100ko, the other is documentation included and screenshots


online documentation & live demo 

* http://livetv.allwebtuts.net/


For css bug or adaptative Work view FAQ 

* http://wordpress.org/extend/plugins/livetv-bundle/faq/


Why I seperated twitch/justin ? 

* During this development, people in Gamers circle says on some channels in test, justin could have its personal Api soon because Justin has more ressource servers. If it is the fact, the code is ready. 


Some rules


* This plugin was thought and coded for gamers team (consequently, also supports team usage or personal usage). Not for mass sharing.
* Mass sharing will work with [shortcode] if you based this mass sharing on the loop of wordpress posts.
* The option "delete one livestream" placed on your profil exist because "errors are human" and a typo is possible. Don't abuse of this function is a good way to have a plugin more efficient.
* If you have abused of this option in your tests or if you have started a mass sharing of a lot of live stream and if you made this live stream creation accessible for all your simple subscribers from your community, a way to restart is search `live_*` on your datas and restart a new installation of the plugin. Make this with caution.


Futur version


* Add a plugin part - optional frontend - for mass sharing from subscribers.
* Dedicated table in database for do that.
* wp-cron task to load the entire xml/Json file with all datas from each platform.
* Validation accept/reject option from an administrator for each deposit in this mode.
* I expect more download and more feedback before make that option. Maybe for 2.0.


Compatibility with frontend profil from connexion plugin


* Currently option "themed-profil" from theme-my-login not supported. If you desire to use the plugin with theme-my-login, themed-profil option must be disable from tab options of theme-my-login. If you have a adaptative solution, I need that.


== Installation ==

* Upload 'livetv-bundle' to the '/wp-content/plugins/' directory
* To activated some parts, its very simple: You may use the part liveTV 2 ? Activate all sub-parts is required ( 0 + 1 ) + 2. View your dashboard plugins section and read each description for more information
* Define attributs and selector on pages options if the default registered options not be suitable for your theme.



== Screenshots ==

1. Administration.
2. Frontend.

== Frequently Asked Questions ==


= Fix css "large view" =


A message for developer for the 'Large view'. 

Currently, the best solution I have found to cheat on one maximum of themes and display a 'Large view' it is a simple css cheating.

This cheating is loaded on request 'large view' and stop the display of the sidebar and enlarge the `<div id='content'>`.

This cheating is in a light css file `/css/page-livetreams-hook.css`

If your class or ID of `<div main content>` and `<ul widgets list>` from your current theme have a exotic class for this div/ul, maybe your large view have a css bug.

Replace the content of this css file with the good class/ID from your theme for this div/ul

e.g.

`
@charset utf-8;

.themename-sidebar{ /* change .themename-sidebar by the good ID/Class of your sidebar container */
    display:none!important;
    overflow:hidden!important
}

.themename-content { /* change .themename-content by the good ID/Class of your content container */
    width:100%!important;
    margin: 0 auto;
    padding: 0;
}

#full-view-switcher {
    width:100%!important;
}
`

I look at the core of wordpress for a php function for the futur and I will added this function in a newest version for unset really the sidebar without css cheating for 'Large view'. Or enventually, a add_class function.


= Fix css page 'livestream' and its thumbnails =


To change the width of thumbnails img and change the width of span of informations @ the right side of each thumbnail img, it is in the file `/css/page-livetreams.css` and @ the bottom of this file and it is `/* commented */`

`
.minithumb-own3d-info, .minithumb-justin-info, .minithumb-twitch-info{
    float: right;
    width: 50%;
}
`

and change also

`
.minithumb-justin-thumb img, .minithumb-twitch-thumb img, .minithumb-own3d-thumb img {
    width: 42.2%!important;
    height: auto!important;
    float: left;
    border: none !important
}
`

play with this two width value and look in the same time for a twitch.tv thumbnail img (because it is not the same ratio img delivered by twitch and by own3d). You may try to have a compromise between these two delivered img (if you use the 2 platforms).


= To change the style of the widget with your own style =


I have added some class/ID for the span of informations @ the right side of each thumbnail (when channel is offline, and also when channel is online).

The class start with `w-*`

You may create a simple css load for the widget only when the page isn't your_livestream_page. A simple wordpress function is 

`
if(!is_page('your-livestream-page-ID')){
  wp_enqueue_style('your-personal-style-for-the-livestream-widget');
}
`

If you are a JQuery developer/passionate, to manipulate this class/ID/css, you may enqueue your script in the same way

`
if(!is_page('your-livestream-page-ID')){
  wp_enqueue_script('your-personal-script-for-the-livestream-widget');
}
`

You may personnalize also the widget only for the home page with is_home function

`
if(is_home()){
  wp_enqueue_style('another-personal-style-for-the-livestream-widget');
}
`

The same way for your JQuery script

`
if(is_home()){
  wp_enqueue_script('another-personal-script-for-the-livestream-widget');
}
`

More information here 

is page: http://codex.wordpress.org/Function_Reference/is_page

enqueue script: http://codex.wordpress.org/Function_Reference/wp_enqueue_script (view also wp_register_script)

enqueue style: http://codex.wordpress.org/Function_Reference/wp_enqueue_style (view also wp_register_style)

is home: http://codex.wordpress.org/Function_Reference/is_home


* When offline class/ID exemple

`
<span class="minithumb-twitch offline">
	<span class="minithumb-twitch-splash"><img src="http://localhost/wp-content/plugins/livetv-bundle/images/offline.png" alt="mask" class="bubble" oldtitle="twitch channel offline"></span>
	<span class="minithumb-twitch-thumb"><a href="http://localhost/livestream?liveview=live_4_twitch_2&amp;mode=normal"><img src="http://localhost/wp-content/plugins/livetv-bundle/images/thumblist-mask-offline.png" class="bubble" alt="twitch thumbnail" oldtitle="Channel par test venant de twitch" aria-describedby="ui-tooltip-33"></a></span>
	<span class="minithumb-twitch-info" style="color:#A8998B">
		<span class="w-off-viewers">Viewers: offline</span>
		<span class="w-off-user">user: test</span><span id="w-off-channel">channel: ironsquid</span>
		<span class="w-off-view">View: <a href="http://localhost/livestream?liveview=live_4_twitch_2&amp;mode=normal" class="bubble button" oldtitle="Changer pour la vue normal">Normal</a> <a href="http://localhost/livestream?liveview=live_4_twitch_2&amp;mode=full" class="bubble button" oldtitle="Changer pour la vue large">Large</a></span>
		<span class="w-off-live">Live: Offline</span>
	</span>
</span>
`

* When online class/ID exemple

`
<span class="minithumb-twitch">
	<span class="minithumb-twitch-splash"><img src="http://localhost/wp-content/plugins/livetv-bundle/images/offline.png" alt="mask" class="bubble" oldtitle="twitch channel offline"></span>
	<span class="minithumb-twitch-thumb"><a href="http://localhost/livestream?liveview=live_4_twitch_2&amp;mode=normal"><img src="http://localhost/wp-content/plugins/livetv-bundle/images/thumblist-mask-offline.png" class="bubble" alt="twitch thumbnail" oldtitle="Channel par test venant de twitch" aria-describedby="ui-tooltip-33"></a></span>
	<span class="minithumb-twitch-info" style="color:#A8998B">
		<span class="w-viewers">Viewers: 12345</span>
		<span class="w-user">user: test</span><span id="w-off-channel">channel: ironsquid</span>
		<span class="w-view">View: <a href="http://localhost/livestream?liveview=live_4_twitch_2&amp;mode=normal" class="bubble button" oldtitle="Changer pour la vue normal">Normal</a> <a href="http://localhost/livestream?liveview=live_4_twitch_2&amp;mode=full" class="bubble button" oldtitle="Changer pour la vue large">Large</a></span>
		<span class="w-live">Live! date and hours</span>
	</span>
</span>
`


= Tip dialog effect bug for some themes = 


I think maybe you have 2 load of q-tip (1.x version or adaptative work of this kind) loaded by your theme and eventually JQuery loaded by your theme from external static repository (Google). It is possible the problem comes from something like that: JQuery loaded 2 times or eventually q-tip css loaded 2 times or 2 different versions of q-tip.js loaded or eventually q-tip.js loaded 2 times. The plugin use the q-tip 2.0 version and the latest JQuery version included by wordpress (this plugin was developed under wordpress 3.3.2 version).

You may try to change one from theme or one from plugin. To changes the loading from the plugin, the good file is the file `plugin-livetv-display-lives.php` (to change or stop the load of JQuery or stop the original css q-tip file). but after some adaptative work is necessary. You may try also to stop the external load of JQuery from your theme (in your header.php file) and see if your theme made a bug for slider or other dependancies of JQuery from your theme.

If you decide to change the tip 'class' for dialog effect from the plugin and made some adaptative work (with the same class from your "q-tip" theme), is in the file `/page-frontend/page-livestreams.php` (just make a search on 'bubble').



== Upgrade Notice ==

* Use the WordPress automatic upgrade notice or upgrade this plugin manually



== Changelog ==

= 1.1 =

* Now option "change the order and display order" act also on each profil.
* Add support of original chat from own3d, twitch, justin.
* Add support of Ustream with shortcode.

= 1.0.1 =

* Fix special roles compatibility with some themes/plugins.
* Fix loop of thumbnails with option "wordpress default role".

= 1.0 =

* Original review