add option for string to og image, closes #24

Author: tobimori

blueprints/fields/og-image.php

@@ -1,8 +1,9 @@
 <?php
 
+use Kirby\Cms\App;
 use Kirby\Toolkit\Str;
 
-return function ($app) {
+return function (App $app) {
   $blueprint = [
     'type' => 'files',
     'multiple' => false,

classes/Meta.php

@@ -4,6 +4,7 @@
 
 use Kirby\Content\Field;
 use Kirby\Cms\Page;
+use Kirby\Exception\InvalidArgumentException;
 use Kirby\Toolkit\Str;
 use Kirby\Toolkit\A;
 
@@ -224,4 +225,26 @@ public function robots()
 
     return A::join($robots, ',');
   }
+
+  /**
+   * Get the og:image url
+   */
+  public function ogImage(): string|null
+  {
+    $field = $this->get('ogImage');
+
+    if ($ogImage = $field->toFile()?->thumb([
+      'width' => 1200,
+      'height' => 630,
+      'crop' => true,
+    ])) {
+      return $ogImage->url();
+    }
+
+    if ($field->isNotEmpty()) {
+      return $field->value();
+    }
+
+    return null;
+  }
 }

config/api.php

@@ -67,12 +67,6 @@
         if ($model instanceof Page) {
           $meta = $model->metadata();
 
-          $ogImage = $meta->ogImage()->toFile()?->thumb([
-            'width' => 1200,
-            'height' => 630,
-            'crop' => true,
-          ]);
-
           return [
             'page' => $model->slug(),
             'url' => $model->url(),
@@ -81,7 +75,7 @@
             'ogSiteName' => $meta->ogSiteName()->value(),
             'ogTitle' => $meta->ogTitle()->value(),
             'ogDescription' => $meta->ogDescription()->value(),
-            'ogImage' => $ogImage?->url(),
+            'ogImage' => $meta->ogImage(),
             'twitterCardType' => $meta->twitterCardType()->value(),
           ];
         }

snippets/head.php

@@ -12,12 +12,6 @@
 
 <?php
 
-$ogImage = $meta->ogImage()->toFile()?->thumb([
-  'width' => 1200,
-  'height' => 630,
-  'crop' => true,
-]);
-
 $map = [
   'description' => $meta->metaDescription(),
   'author' => $meta->metaAuthor(),
@@ -26,7 +20,7 @@
   'twitter:card' => $meta->twitterCardType(),
   'twitter:title' => $meta->ogTitle(),
   'twitter:description' => $meta->ogDescription(),
-  'twitter:image' => $ogImage?->url(),
+  'twitter:image' => $ogImage = $meta->ogImage(),
   'twitter:site' => $meta->twitterSite(),
   'twitter:creator' => $meta->twitterCreator(),
 ];
@@ -46,10 +40,10 @@
   'og:description' => $meta->ogDescription(),
   'og:url' => $meta->canonicalUrl(),
   'og:site_name' => $meta->ogSiteName(),
-  'og:image' => $ogImage?->url(),
-  'og:image:width' => $ogImage?->width(),
-  'og:image:height' => $ogImage?->height(),
-  'og:image:alt' => $ogImage?->alt(),
+  'og:image' => $ogImage,
+  'og:image:width' => $ogImage ? 1200 : null, // TODO: replace this with custom crop preset
+  'og:image:height' => $ogImage ? 630 : null,
+  'og:image:alt' => $meta->get('ogImage')->toFile()?->alt(),
   'og:type' => $meta->ogType(),
 ];