KayueEssenceBundle
This bundle integrates the Essence library (an oEmbed library) into Symfony 2., (*1)
Installation
Composer
Add the bundle to composer.json
, (*2)
{
"require": {
"kayue/kayue-essence-bundle": "dev-master"
}
}
Update Composer dependency:, (*3)
composer update kayue/kayue-essence-bundle
Register the bundle
<?php
// app/AppKernel.php
public function registerBundles()
{
$bundles = array(
// ...
new Kayue\EssenceBundle\KayueEssenceBundle(),
);
// ...
}
Configuration
No configuration is required. However you should change the cache driver to apc
if your server support it. Default cache driver is array
, (*4)
kayue_essence:
cache_driver: apc
Usage
Service
<?php
class WelcomeController extends Controller
{
public function indexAction()
{
$essence = $this->get('kayue_essence');
$media = $essence->embed('http://www.youtube.com/watch?v=39e3KYAmXK4');
$media->title; // return the video title "Bill Hicks - Revelations (1993)"
}
}
Twig Extension
Replace Filter
Essence can replace any embeddable URL in a text by informations about it., (*5)
{{ 'Some random text plus http://www.youtube.com/watch?v=39e3KYAmXK4'|essence_replace }}
Embed Function
You can retrieve video informations in just one line., (*6)
{{ essence_embed('http://www.youtube.com/watch?v=39e3KYAmXK4').html }}
With max width:, (*7)
{{ essence_embed('http://www.youtube.com/watch?v=39e3KYAmXK4', {'maxwidth': 100}).html }}