Merge pull request #45 from thenextweb/master

Added attribute publishedTime to the response

Author: oscarotero

README.md

@@ -51,6 +51,8 @@ $info->providerName; //The provider name of the page (youtube, twitter, instagra
 $info->providerUrl; //The provider url
 $info->providerIcons; //All provider icons found in the page
 $info->providerIcon; //The icon choosen as main icon
+
+$info->publishedTime; //The publication date of the article, if present
 ```
 
 Available options

composer.json

@@ -1,5 +1,5 @@
 {
-	"name": "embed/embed",
+	"name": "thenextweb/embed",
 	"type": "library",
 	"description": "PHP library to retrieve page info using oembed, opengraph, etc",
 	"keywords": ["oembed", "opengraph", "twitter cards", "embed", "embedly"],

src/Adapters/Adapter.php

@@ -364,4 +364,12 @@ public function getHeight()
     {
         return $this->getFromProviders('height');
     }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function getPublishedTime()
+    {
+        return $this->getFromProviders('publishedTime');
+    }
 }

src/Adapters/AdapterInterface.php

@@ -163,4 +163,11 @@ public function getHeight();
      * @return float|null
      */
     public function getAspectRatio();
+    
+     /**
+     * Gets the published time, if the webpage is an article
+     *
+     * @return string|null
+     */   
+    public function getPublishedTime ();
 }

src/Adapters/Webpage.php

@@ -28,6 +28,7 @@ protected function initProviders(Request $request)
             'Html' => new Providers\Html($request),
             'TwitterCards' => new Providers\TwitterCards($request),
             'OpenGraph' => new Providers\OpenGraph($request),
+            'Sailthru' => new Providers\Sailthru($request),
         );
 
         if ($this->options['facebookProvider']) {

src/Providers/Html.php

@@ -91,6 +91,11 @@ public function __construct(Request $request)
                         $icons[] = $meta->getAttribute('content');
                         continue 2;
 
+                    case 'pub_date':
+                    case 'date':
+                        $this->set('datepublished', $meta->getAttribute('content'));
+                        continue 2;
+
                     default:
                         if ($meta->hasAttribute('content')) {
                             $this->set($name, $meta->getAttribute('content'));
@@ -99,12 +104,27 @@ public function __construct(Request $request)
                 }
             }
 
+            if ($meta->hasAttribute('itemprop')) {
+                $name = strtolower($meta->getAttribute('itemprop'));
+                $this->set($name, $meta->getAttribute('content'));
+            }
+
             if ($meta->hasAttribute('http-equiv') && $meta->hasAttribute('content')) {
                 $name = strtolower($meta->getAttribute('http-equiv'));
                 $this->set($name, $meta->getAttribute('content'));
             }
         }
 
+        //Time
+        foreach($html->getElementsByTagName('time') as $time) {
+            if ($time->hasAttribute('itemprop')) {
+                $name = strtolower($time->getAttribute('itemprop'));
+                $this->set($name, $time->getAttribute('datetime'));
+            } else if ($time->hasAttribute('datetime')) {
+                $this->set('datepublished', $time->getAttribute('datetime'));
+            }
+        }
+
         //Search the main element:
         $content = $html->getElementsByTagName('main'); //<main> element
 
@@ -280,4 +300,14 @@ public function getHeight()
     {
         return $this->get('video_height');
     }
+
+    /**
+     * Gets the article publication date
+     *
+     * @return string|null
+     */
+    public function getPublishedTime()
+    {
+        return $this->get('datepublished');
+    }
 }

src/Providers/OpenGraph.php

@@ -25,9 +25,15 @@ public function __construct(Request $request)
 
         foreach ($html->getElementsByTagName('meta') as $meta) {
             if (strpos($meta->getAttribute('property'), 'og:') === 0) {
-                $name = substr($meta->getAttribute('property'), 3);
+                if (strpos($meta->getAttribute('property'), 'og:article:') === 0) {
+                    $name = substr($meta->getAttribute('property'), 11);
+                } else {
+                    $name = substr($meta->getAttribute('property'), 3);
+                }
             } elseif (strpos($meta->getAttribute('name'), 'og:') === 0) {
                 $name = substr($meta->getAttribute('name'), 3);
+            } elseif (strpos($meta->getAttribute('property'), 'article:') === 0) {
+                $name = substr($meta->getAttribute('property'), 8);
             } else {
                 continue;
             }
@@ -179,4 +185,14 @@ public function getHeight()
     {
         return $this->get('image:height') ?: $this->get('video:height');
     }
+
+    /**
+     * Gets the article publication date
+     *
+     * @return string|null
+     */
+    public function getPublishedTime()
+    {
+	    return $this->get('published_time');
+    }
 }

src/Providers/Sailthru.php

@@ -0,0 +1,39 @@
+<?php
+/**
+ * Generic Salithru provider.
+ * Load the Salithru data of an url and store it
+ */
+namespace Embed\Providers;
+
+use Embed\Request;
+
+class Sailthru extends Provider
+{
+    /**
+     * Constructor
+     *
+     * @param Request $request
+     */
+    public function __construct(Request $request)
+    {
+        if (!($html = $request->getHtmlContent())) {
+            return false;
+        }
+
+        foreach ($html->getElementsByTagName('meta') as $meta) {
+            if ($meta->hasAttribute('name') && (stripos($meta->getAttribute('name'), 'sailthru.') === 0)) {
+                $this->set(strtolower(substr($meta->getAttribute('name'), 9)), $meta->getAttribute('content'));
+            }
+        }
+    }
+
+    /**
+     * Gets the article publication date
+     *
+     * @return string|null
+     */
+    public function getPublishedTime()
+    {
+        return $this->get('date');
+    }
+}

tests/ArticleTest.php

@@ -0,0 +1,18 @@
+<?php
+include_once dirname(__DIR__).'/src/autoloader.php';
+
+class ArticleTest extends PHPUnit_Framework_TestCase
+{
+    public function testOne()
+    {
+        $info = Embed\Embed::create('http://mashable.com/2015/01/15/booking-now-app/');
+
+        $this->assertEquals($info->title, 'Booking Now app offers hotel reservations in \'just two taps\'');
+        $this->assertEquals($info->description, 'Last-minute accommodations are all the rage in 2015.');
+        $this->assertEquals($info->type, 'link');
+        $this->assertEquals($info->image, 'http://rack.2.mshcdn.com/media/ZgkyMDE1LzAxLzE1LzRlL2hvdGVscm9vbS42YmIyOC5qcGcKcAl0aHVtYgkxMjAweDYyNyMKZQlqcGc/6d24e110/098/hotel-room.jpg');
+        $this->assertEquals($info->providerName, 'Mashable');
+        $this->assertEquals($info->providerUrl, 'http://mashable.com');
+        $this->assertEquals($info->publishedTime, '2015-01-15T13:31:13Z');
+    }
+}