EmbeVi: Embed remote videos and audio in HTML pages

       ___________________________________________________________

            EmbeVi Class (Embed From Link)
            Version 1.2 Release day 22 November 2009
       ___________________________________________________________

        Copyright (c) 2009 Comanici Paul (darkyndy)

_______________________

CONTENTS
_______________________

1. Intro
2. Description
3. System Requirements
4. How to use
5. Change Log
6. Contact

_______________________

1. Intro
_______________________

EmbeVi was released first time on 18 May 2009 as a GreaseMonkey extension with the idea Auto Embed Video From Link (supported only video sites).
Durring the development process I've added support for some audio sites and in the and I've released this PHP class.
You can see the list of supported sites at http://www.embevi.com/home#embevi_support

_______________________

2. Description
_______________________

A PHP class that can return the embeded code from a link.
This class can be used to parse a link and will return the embeded code.
With version 1.1 I've added two new methods:
  parseText($text, $keepLink = false, $addHtmlBefore = false, $addHtmlAfter = false) - that can be used to parse plain text
  parseHtml($html, $keepLink = false, $addHtmlBefore = false, $addHtmlAfter = false) - that can be used to parse HTML code
With version 1.2 I've added support for shorten URL's services, now you can embed media if it's behind a shorten URL

_______________________

3. System Requirements
_______________________

PHP 5.x

______________

4. How to use
______________

Please see "test_embevi.php"
Please see "test_embevi_html.php"
Please see "test_embevi_text.php"
Please see "test_embevi_shorturl.php"

______________

5. Change Log
______________

/**
*  Version 1.2
*  - modified regular expression for parseHtml with a more powerful and quick one
*  - added setAcceptShortUrl method, if you call this method then every link will be parsed 
*                                    to check if it's from a list of supported shorted URL's services
*                                    and get's the real link
*  - added unsetAcceptShortUrl method, call this method if you don't want any more to check if a link
*                                      is a short URL and behind it can be video link
*  - default this script will not parse shorten URL's
*  - added a list of 130 short URL's sites that can be parsed
*/

/**
*  Version 1.1
*  - added setGlobalWidth method, now you can set this width and all embedded video will have this width
*  - added unsetGlobalWidth method, unset the width passed with setGlobalWidth method
*  - added setGlobalHeight method, now you can set this height and all embedded video will have this height
*  - added unsetGlobalHeight method, unset the height passed with setGlobalHeight method
*  - added setBeforeHtml method, you can set HTML that will appear before the embedded code
*  - added setAfterHtml method, you can set HTML that will appear after the embedded code
*  - added two optional parameters for the getCode method
*    ->  $addHtmlBefore, if is set to true then before the embedded code it will be added
*        the default before HTML or the before HTML that you passed using method setBeforeHtml
*    ->  $addHtmlAfter, if is set to true then after the embedded code it will be added
*        the default after HTML or the after HTML that you passed using method setAfterHtml
*  - added parseText method, you can now give to this method plain text and EmbeVi will do the job
*    -> this method has 4 parameters:
*      => $text - compulsory parameter, string that will contain text;
*      => $keepLink - optional parameter (default is false), boolean that will say if the link will be kept
*      => $addHtmlBefore - optional parameter (default is false), boolean that will say if you want to add HTML before the embedded code
*      => $addHtmlAfter - optional parameter (default is false), boolean that will say if you want to add HTML after the embedded code
*  - added parseHtml method, you can now give to this method HTML code and EmbeVi will do the job
*    -> same parameters as parseText method 
*/

______________

6. Contact
______________

Please send your suggestions, bug reports and general feedback at darkyndy@gmail.com or you can complete the online form at http://www.embevi.com/contact
Also visit http://www.embevi.com