pingpong-labs / oembed by gravitano

Laravel Oembed
2,090
13
3
Package Data
Maintainer Username: gravitano
Maintainer Contact: pingpong.labs@gmail.com (Pingpong Labs)
Package Create Date: 2014-09-10
Package Last Update: 2015-08-08
Home Page: https://packagist.org/packages/pingpong/oembed
Language: PHP
License: BSD-3-Clause
Last Refreshed: 2024-11-15 03:03:35
Package Statistics
Total Downloads: 2,090
Monthly Downloads: 1
Daily Downloads: 0
Total Stars: 13
Total Watchers: 3
Total Forks: 3
Total Open Issues: 2

Oembed

Laravel 4 - Retrieve page info using oembed, opengraph, etc.

Build Status

Server Requirements

Require PHP 5.4+ or higher.

Installation

Open your composer.json file, and add the new required package.

"pingpong/oembed": "1.0.*"

Next, open a terminal and run.

composer update

After the composer updated. Add new service provider in app/config/app.php.

    'Pingpong\Oembed\OembedServiceProvider'

Next, Add new alias.

    'Oembed'           => 'Pingpong\Oembed\Facades\Oembed',

Done.

Usage

Basic Usage

$info = Oembed::get('https://www.youtube.com/watch?v=PP1xn5wHtxE');

//Get content info

$info->title; //The page title
$info->description; //The page description
$info->url; //The canonical url
$info->type; //The page type (link, video, image, rich)

$info->images; //List of all images found in the page
$info->image; //The image choosen as main image
$info->imageWidth; //The with of the main image
$info->imageHeight; //The height  of the main image

$info->code; //The code to embed the image, video, etc
$info->width; //The with of the embed code
$info->height; //The height of the embed code
$info->aspectRatio; //The aspect ratio (width/height)

$info->authorName; //The (video/article/image/whatever) author 
$info->authorUrl; //The author url

$info->providerName; //The provider name of the page (youtube, twitter, instagram, etc)
$info->providerUrl; //The provider url
$info->providerIcons; //All provider icons found in the page
$info->providerIcon; //The icon choosen as main icon

Caching the results.

$info = Oembed::cache($url, $options);

Documentation

Because this package using the library oscarotero/Embed, please refer to its documentation for more info.

License

This package is open-sourced software licensed under The BSD 3-Clause License