This bundle integrates the Essence library (an oEmbed library) into Symfony 2.
PHP
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
DependencyInjection
Essence
Resources
Twig/Extension
.gitignore
KayueEssenceBundle.php
README.md
composer.json

README.md

KayueEssenceBundle

This bundle integrates the Essence library (an oEmbed library) into Symfony 2.

Installation

Composer

Add the bundle to composer.json

{
    "require": {
        "kayue/kayue-essence-bundle": "dev-master"
    }
}

Update Composer dependency:

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

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.

{{ 'Some random text plus http://www.youtube.com/watch?v=39e3KYAmXK4'|essence_replace }}
Embed Function

You can retrieve video informations in just one line.

{{ essence_embed('http://www.youtube.com/watch?v=39e3KYAmXK4').html }}

With max width:

{{ essence_embed('http://www.youtube.com/watch?v=39e3KYAmXK4', {'maxwidth': 100}).html }}