seo

composer.json

@@ -35,6 +35,9 @@
         "phpstan/phpstan-phpunit": "^1.3"
     },
     "autoload": {
+        "files": [
+            "src/helpers.php"
+        ],
         "psr-4": {
             "Elegantly\\Seo\\": "src/",
             "Elegantly\\Seo\\Database\\Factories\\": "database/factories/"

config/seo.php

@@ -3,8 +3,12 @@
 // config for Elegantly/Seo
 return [
 
-    'title' => env('APP_NAME'),
+    'title' => env('APP_NAME', 'Laravel'),
 
-    'robots' => null,
+    'robots' => 'max-snippet:-1,max-image-preview:large,max-video-preview:-1',
+
+    'sitemap' => '/sitemap.xml',
+
+    'image' => null,
 
 ];

src/Facades/SeoManager.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Elegantly\Seo\Facades;
+
+use Elegantly\Seo\Contracts\HasSeo;
+use Elegantly\Seo\SeoData;
+use Elegantly\Seo\Unified\SeoUnifiedData;
+use Illuminate\Support\Facades\Facade;
+
+/**
+ * @method static \Elegantly\Seo\SeoManager from(null|SeoData|SeoUnifiedData|\Elegantly\Seo\SeoManager|HasSeo $value = null)
+ *
+ * @see \Elegantly\Seo\Seo
+ */
+class SeoManager extends Facade
+{
+    protected static function getFacadeAccessor(): string
+    {
+        return \Elegantly\Seo\SeoManager::class;
+    }
+}

src/SeoData.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Elegantly\Seo;
+
+use Elegantly\Seo\Schemas\Schema;
+use Elegantly\Seo\Standard\Alternate;
+use Elegantly\Seo\Unified\Image;
+use Elegantly\Seo\Unified\SeoUnifiedData;
+use Illuminate\Support\Facades\URL;
+
+class SeoData extends SeoUnifiedData
+{
+    public string $title;
+
+    public string $canonical;
+
+    /**
+     * @param  null|Alternate[]  $alternates
+     * @param  null|Schema[]  $schemas
+     */
+    public function __construct(
+        ?string $title = null,
+        ?string $canonical = null,
+        public ?string $description = null,
+        public ?string $robots = null,
+        public ?string $sitemap = null,
+        public ?array $alternates = null,
+        public ?Image $image = null,
+        public ?string $locale = null,
+        public ?array $schemas = null,
+        public ?SeoTags $customTags = null,
+    ) {
+        $this->title = $title ?? config('seo.title') ?? '';
+        $this->canonical = $canonical ?? URL::current();
+    }
+}

src/SeoManager.php

@@ -2,11 +2,13 @@
 
 namespace Elegantly\Seo;
 
+use Elegantly\Seo\Contracts\HasSeo;
 use Elegantly\Seo\Contracts\Taggable;
 use Elegantly\Seo\OpenGraph\Verticals\Vertical;
 use Elegantly\Seo\Schemas\Schema;
 use Elegantly\Seo\Standard\StandardData;
 use Elegantly\Seo\Twitter\Cards\Card;
+use Elegantly\Seo\Unified\SeoUnifiedData;
 
 class SeoManager implements Taggable
 {
@@ -21,6 +23,29 @@ public function __construct(
         public ?SeoTags $customTags = null,
     ) {}
 
+    public function from(
+        null|SeoData|SeoUnifiedData|SeoManager|HasSeo $value = null
+    ): SeoManager {
+
+        if ($value instanceof SeoManager) {
+            return $value;
+        }
+
+        if ($value instanceof SeoData) {
+            return $value->toManager();
+        }
+
+        if ($value instanceof SeoUnifiedData) {
+            return $value->toManager();
+        }
+
+        if ($value instanceof HasSeo) {
+            return $this->from($value->getSeoData());
+        }
+
+        return $this->from(new SeoData);
+    }
+
     public function toTags(): SeoTags
     {
         $tags = new SeoTags;

src/helpers.php

@@ -0,0 +1,13 @@
+<?php
+
+use Elegantly\Seo\Contracts\HasSeo;
+use Elegantly\Seo\SeoData;
+use Elegantly\Seo\SeoManager;
+use Elegantly\Seo\Unified\SeoUnifiedData;
+
+if (! function_exists('seo')) {
+    function seo(null|SeoData|SeoUnifiedData|SeoManager|HasSeo $value): SeoManager
+    {
+        return \Elegantly\Seo\Facades\SeoManager::from($value);
+    }
+}

tests/Features/SeoDataTest.php

@@ -0,0 +1,43 @@
+<?php
+
+use Elegantly\Seo\Facades\SeoManager;
+use Elegantly\Seo\SeoData;
+use Illuminate\Support\Facades\URL;
+
+it('renders default seo from config', function () {
+
+    $data = new SeoData;
+
+    $url = URL::current();
+
+    expect(
+        $data->toTags()->toHtml()
+    )->toBe(implode("\n", [
+        '<title >Laravel</title>',
+        '<link rel="canonical" href="'.$url.'" />',
+        '<meta property="og:type" content="website" />',
+        '<meta property="og:title" content="Laravel" />',
+        '<meta property="og:url" content="'.$url.'" />',
+        '<meta name="twitter:card" content="summary" />',
+        '<meta name="twitter:title" content="Laravel" />',
+    ]));
+});
+
+it('renders default seo from config using Facade', function () {
+
+    $data = SeoManager::from();
+
+    $url = URL::current();
+
+    expect(
+        $data->toTags()->toHtml()
+    )->toBe(implode("\n", [
+        '<title >Laravel</title>',
+        '<link rel="canonical" href="'.$url.'" />',
+        '<meta property="og:type" content="website" />',
+        '<meta property="og:title" content="Laravel" />',
+        '<meta property="og:url" content="'.$url.'" />',
+        '<meta name="twitter:card" content="summary" />',
+        '<meta name="twitter:title" content="Laravel" />',
+    ]));
+});