README

Simple consumer library for oEmbed with discovery support.

Usage

In this example the library automatically discovers the oEmbed enpoint for the http://vimeo.com/31423544 resource, and asks for informations about the resource.

<?php use Alb\OEmbed; $response = OEmbed\Simple::request('http://vimeo.com/31423544', array( 'maxwidth' => 400, 'maxheight' => 300, )); echo $response->getTitle(); echo $response->getHtml();

Advanced usage:

<?php use Alb\OEmbed; // instanciate a Provider from a known endpoint $provider = new OEmbed\Provider('http://vimeo.com/api/oembed.json', 'json'); // request information about a resource $response = $provider->request('http://vimeo.com/31423544');

The library is also capable of discovering the oEmbed enpoint from a resource URL (if the site supports it):

<?php use Alb\OEmbed; $discovery = new OEmbed\Discovery; $provider = $discovery->discover('http://vimeo.com/31423544'); // or, using OEmbed\Simple: $provider = OEmbed\Simple::getProvider('http://vimeo.com/31423544');