badawy/embedly

A Laravel 5.* package for the Embedly api

v2.0.0 2017-06-07 00:11 UTC

Requires

• php: >=5.4.0
• illuminate/support: 5.1.*|5.2.*|5.3.*|5.4.*
• php-curl-class/php-curl-class: 3.*

MIT

• Ahmad Elbadawy

• framework
• package
• php
• api
• class
• laravel
• embedly
• elbadawy
• badawy

README

Custom Embedly Package for the Laravel 5.*

Installation

1. Pull this package in through Composer. (Laravel 5.4)

    {
        "require": {
            "badawy/embedly": "2.*"
        }
    }

if you are using Laravel 5.3 or earlier you should use v1.*

    {
        "require": {
            "badawy/embedly": "1.*"
        }
    }

1. Add the service provider to the providers array in your config/app.php file:

        Badawy\Embedly\EmbedlyServiceProvider::class,

1. Add the facade to your config/app.php file:

        'Embedly' => Badawy\Embedly\Facades\Embedly::class,

1. Copy the package config to your local config with the publish command:

        php artisan vendor:publish --provider="Badawy\Embedly\EmbedlyServiceProvider"

1. Add your api key in your .env file:

        EMBEDLY_API_KEY=xxxxxxxxxxxxxxxxxx

Usage

You can extract or embed single URL or multiple URLs by pass them into an Array instead of String,

You can also pass an Array of your query arguments as second argument in both Extract and Embed (see examples)

[See Embedly documentation for more information about results, errors and query arguments] (http://embed.ly/docs)

Examples

1. Embedly Extract

     $q = Embedly::extract('http://techcrunch.com/2013/03/26/embedly-now-goes-beyond-embedding-with-new-products-extract-display-for-making-sense-of-links-resizing-images/', [
           'maxwidth' => '500'
       ]);

     $q = Embedly::extract([
            'http://techcrunch.com/2013/03/26/embedly-now-goes-beyond-embedding-with-new-products-extract-display-for-making-sense-of-links-resizing-images/',
            'http://deadspin.com/5690535/the-bottom-100-the-worst-players-in-nfl-history-part-1',
            'http://blog.embed.ly/31814817'],[
                'maxwidth' => '500'
       ]);

1. Embedly Embed

     $q = Embedly::oembed('http://vimeo.com/18150336',[
           'maxwidth' => '500'
       ]);

     $q = Embedly::oembed([
            'https://www.youtube.com/watch?v=jofNR_WkoCE',
            'http://soundcloud.com/whichlight/how-to-pronounce-my-name',
            'http://vimeo.com/18150336'],[
                'maxwidth' => '500'
       ]);

Then you can access results :

    if($q->error){
       echo $q->error_message; //Error
    } else {
       echo $q->title; //Get result
    }

ToDo

• Add 'Display' APIs

License

This template is open-sourced software licensed under the MIT license

Contact

Ahmad Elbadawy

• Email: [e-mail]