=== ProPlayer ===
Contributors: isa.goksu
Donate link: http://isagoksu.com/projects
Tags: flv, video, embed, youtube, vimeo, google, metacafe, veoh, myspace, dailymotion
Requires at least: 2.7
Tested up to: 2.7
Stable tag: tags/1.1
Display online videos from various sources in any Custom FLV Player.
== Description ==
Display online videos from various sources in any FLV Custom Player. I used (JW FLV Media Player). You can customize your player with addons and skins. Please check add-ons page for more information.
Other options might be any FLV player. However I found following players in the Internet:
* ToobPlayer
* MC Media Player
* http://uppod.ru/player/intro
* Xmoov FLV Player
* http://sonettic.com/cinema
* Open FLV Player
* http://flv-mp3.com
* http://www.martijndevisser.com/blog/flv-player
You can use any of following online FLV media players. However, system is optimized for JW FLV Media player. My personal second best is ToobPlayer. When you change the player, it might require some little code changes too. I tried to code as flexible as I can.
Currently supported video sources are:
* All files that you've uploaded to your server (movies, images, etc..)
* 56
* Bebo
* Bofunk
* Clipfish
* Crunchyroll
* Dailymotion
* eBaumsWorld
* Google Video
* Metacafe
* MySpace
* MyVideo
* Supernovatube
* Tudou
* Veoh
* Vimeo
* Youku
* Youtube
== Installation ==
It's pretty simple to install. Just follow the common intention:
1. Unzip the plugin file, it will create a directory named `proplayer`
1. Upload the directory to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
That's it. The usage is like this (Please do not add additional white space, I stripped everything, but some characters cannot be removed!):
[pro-player]http://www.youtube.com/watch?v=2YAvfxA6a94[/pro-player]
[pro-player width="500" height="500"]http://vimeo.com/1473498[/pro-player]
[pro-player type="MP4"]http://www.mydomain.com/media/awesome.mp4[/pro-player]
== Frequently Asked Questions ==
= Can I play YouTube files? =
Yes, indeed you can play any video source file that's supported by ProPlayer.
= Do I have to provide full video URL or just some part of it? =
Yes, you have to provide full video URL. ProPlayer doesn't work if you just place some part of the URL. Please check following usages;
[pro-player]http://www.youtube.com/watch?v=2YAvfxA6a94[/pro-player]
= Are you gonna support more video resources? =
Actually, I've created this plugin for my blog. And I thought all these video sources are enough. However, if there is a big demand for other video sources, I can implement them too.
= Can ProPlayer play mp3 files? =
Yes, ProPlayer supports any of the following file types:
video: [3g2, 3gp, aac, f4b, f4p, f4v, flv, m4a, m4v, mov, mp4, sdp, vp6]
image: [gif, jpg, png, swf]
sound: [rbs, mp3]
The only thing you need to do is adding a type attribute for your video file if it is other than FLV:
[pro-player type="MP3"]http://www.trt.net.tr/medya/ses/2008/11/19/09be6054-1829-4cac-b068-e9493200196c.mp3[/pro-player]
[pro-player type="JPG"]http://www.mydomain.com/albums/summer/1.jpg[/pro-player]
= Can I change the width and height? =
Width, height and type are optional attributes. You can pass these attributes to change the width and height:
[pro-player width="500" height="500"]http://vimeo.com/1473498[/pro-player]
Defaults for these attributes will be used if you don't pass them. And defaults are 'width' = 530, 'height' = 253. If you wanna change the defaults just go and edit plugin source. It's really easy.
= Can I change the theme of the player? =
Yes you can. You can even add some add-ons like rating, etc.. Just check the addons page site JW FLV Media Player for details.
= Can I style a little bit more? =
Yes, if you wanna style your player container like adding borders, changing background etc, just
define "div.pro-player-container" in your CSS file:
div.pro-player-container {
border: 1px solid red;
}
= I wanna change player colors? =
It is easy. Go to ProPlayer settings page in your WordPress admin panel, you are gonna see whole bunch of extra settings.
= I wanna stretch my video? =
Read above answer.
= I'm having some errors? =
First of all, I'm really appreciated everyone's support and interest. However, I wrote this plugin for myself. So it has just semi-advanced functionalities. And there might be bugs too. Because I don't have any business requirements other that show my own videos, youtube and vimeo videos. So if you're having some trouble, please send me an email with "site url, what did you write in your post (from your admin panel), contact information", or add a comment on project page. I'll try to get back to you in ASAP. And please don't forget I've a job to go in day time.
= I wanna follow project =
You can add me on twitter http://twitter.com/IsaGoksu or you can just follow the project page. I'll try to update as much as possible.
= I want MegaVideo? =
Guys I'm really sorry for that, but today I looked at megavideo site. And their video API is full of ads. If you don't have premium account (which I don't have), writing something over that API is really tricky, 'coz every time you develop something, they will change the API according to their needs. Free service doesn't have a fixed API. If the demand for that site is so high, I'll look at again. But for now, I don't wanna spend so much energy on that.
= How about playlist support? =
This one is not that hard. I'll add soon, don't worry :)
= I can't post 2 videos in the same post? =
Unfortunately you cannot. To do that, I have to put some extra things. Not that hard, but requires time. So I'll add this support too, but probably sometime after this month.
= Sometimes I see this video is not available? =
It means that your video link is broken, or the video server blocked your IP for a certain time. Please try after some time.
= Is there a PHP 4 support? =
I really don't have any machine to test php4 right now. However, I removed the version check. I assume it's gonna work without any problem.
= Can I copy your code for my own web projects? =
Honestly, I don't care as long as you carry each person's name in the creative commons/gpl license that I put in the beginning of my php codes. Well my name too :P
= Aren't you sleeping? =
Well, if you help me a little bit more, I would jump in :P
== Screenshots ==
Here are some screenshots from the player.
1. In the post
2. Single
3. New features, customizable colors, width, height, stretching, etc..
== Change History ==
version 1.1
* Added options page
* Customizable skin
* Customizable colors
* Customizable default width and height options
* Customizable video stretching options (fill, uniform, exact fit, none)
version 1.0.5
* Usage changed from <pro-player> to [pro-player]
* Some bug fixes
version 1.0
* Initial release
== Limitations ==
Unfortunately I haven't implemented a ID detection algorithm. So you sometimes have to manually strip the irrelevant tags from the link URL. For example:
instead of:
http://vimeo.com/2440304&embed=23023492873
you should place:
http://vimeo.com/2440304
This is not mandatory. However, some videos doesn't work if you don't strip the irrelevant text from the video URL.
And in some cases, the whitespaces before/after link URL can cause some problems. If you don't want any problems, just please pay attention to not use whitespaces before and after the video URL.