elbadawy / embedly-laravel by badawy

A Laravel 5.* package for the Embedly api
902
9
3
Package Data
Maintainer Username: badawy
Maintainer Contact: ahmad.elbadawy@outlook.com (Ahmad Elbadawy)
Package Create Date: 2015-07-07
Package Last Update: 2017-06-07
Home Page:
Language: PHP
License: MIT
Last Refreshed: 2024-04-18 15:23:22
Package Statistics
Total Downloads: 902
Monthly Downloads: 0
Daily Downloads: 0
Total Stars: 9
Total Watchers: 3
Total Forks: 2
Total Open Issues: 1

badawy/embedly

Latest Stable Version Total Downloads Latest Unstable Version License

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: ahmad.elbadawy@outlook.com