Add support for returning the timestamp the entity was indexed

Add support for returning the canonical URL of an article if it exists

Author: Jonathan Tullett

src/Entity/Article.php

@@ -275,4 +275,13 @@ public function getEstimatedDate()
             new \Carbon\Carbon($date, 'GMT') :
             $date;
     }
+
+    /**
+     * Returns the canonical url from a page, if any.
+     * @return string
+     */
+    public function getCanonicalUrl()
+    {
+        return isset($this->data['canonicalUrl']) ? $this->data['canonicalUrl'] : null;
+    }
 }

src/Traits/StandardEntity.php

@@ -113,10 +113,23 @@ public function getDiffbotUri()
         return $this->data['diffbotUri'];
     }
 
+    /**
+     * Returns the timestamp from the point in time the page was indexed by the engine
+     * Example date: "Wed, 18 Dec 2013 00:00:00 GMT"
+     * This will be a Carbon (https://github.com/briannesbitt/Carbon) instance if Carbon is installed.
+     * @return \Carbon\Carbon | string
+     */
+    public function getTimestamp()
+    {
+        return (class_exists('\Carbon\Carbon')) ?
+            new \Carbon\Carbon($this->data['timestamp'], 'GMT') :
+            $this->data['timestamp'];
+    }
+
     protected function getOrDefault($key, $default = null, $data = null)
     {
         $data = ($data !== null) ?: $this->data;
         return (isset($data[$key]) ? $data[$key] : $default);
     }
 
-}
+}