1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889 |
- This is a highly flexible and easy extendable filter module to embed any type
- of video in your site using a simple tag. Other modules can add video
- sites/formats (called codecs) using an easy plug-in architecture.
- ========= Installation =========
- Enable the module on the modules page.
- Go to admin/config/content/formats and configure the text format(s) that should
- be allowed to use this filter. Check the box to enable Video Filter and save.
- Some simple settings are available if you configure the text format. There you
- can change the default size and auto play settings.
- Make sure that Video Filter is processed before "Convert URLs to links".
- You can do this by dragging and dropping Video Filter to the top of the
- processing order list. Do this even if it's allready on top, just to make sure!
- If you're using the "Limit allowed HTML tags" filter, make sure Video Filter is
- processed after that filter.
- To enable WYSIWYG support, go to the WYSIWYG settings for each input format and
- enable the Video Filter button.
- To enable CKEditor (standalone) support, please see plugin instructions in:
- editors/ckeditor/README.txt
- ========= Usage =========
- Single video: [video:url]
- This will output the video using the default settings.
- Random video from multiple URL's: [video:url,url]
- This will output one of the specified videos each time.
- You can also set some parameters in the call:
- [video:url width:X height:Y align:left/right autoplay:1/0]
- This will override the default settings for this video.
- ========= Developers =========
- This module calls hook_codec_info(), so you can add your own codecs.
- Example:
- function MODULE_codec_info() {
- $codecs = array();
- // You can offer multiple video formats in one module.
- $codecs['youtube'] = array(
- // Will be used some day in user information.
- 'name' => t('YouTube'),
- // Special instructions for end users. Optional.
- 'instructions' => t('Any special instructions that users need to know about
- to get this codec working correctly.'),
- // The callback that will output the right embed code.
- 'callback' => 'MODULE_youtube',
- // HTML5 callback, for returning something that's device agnostic.
- // @SEE video_filter_youtube_html5.
- 'html5_callback' => 'MODULE_service_html5',
- // Regexp can be an array. $video['codec']['delta'] will be set to the key.
- 'regexp' => '/youtube\.com\/watch\?v=([a-z0-9]+)/i',
- // Ratio for resizing within user-given width and height (ratio = width / height)
- 'ratio' => 425 / 355,
- );
- return $codecs;
- }
- And this will be your callback function:
- function MODULE_youtube($video) {
- // $video contains the video URL in source, the codec (as above) and also
- // [code][matches] with the result of the regexp and [codec][delta] with the
- // key of the matched regexp.
- $video['source'] = '//www.youtube.com/v/' . $video['codec']['matches'][1] . ($video['autoplay'] ? '&autoplay=1' : '');
- // Outputs a general <object...> for embedding flash players. Needs width,
- // height, source and optionally align (left or right) and params (a list of
- // <param...> attributes)
- return video_filter_flash($video);
- }
- ========= Troubleshooting =========
- If videos don't show up, try disabling any browser plugins, such as AdBlock.
|