Changeset 3715169 for simple-seo/trunk/src/link-previews.php

Timestamp:

09/27/2026 08:41:32 AM (5 weeks ago)

Author:

eskapism

Message:

Update to version 1.2.0 from GitHub

File:

• simple-seo/trunk/src/link-previews.php (modified) (5 diffs)

simple-seo/trunk/src/link-previews.php

@@ -43 +43 @@
         }
 
-        $title = get_bloginfo( 'name' );
-        $url   = home_url( '/' );
-        $image = null;
+        $title       = get_bloginfo( 'name' );
+        $description = current_description();
+        $url         = home_url( '/' );
+        $image       = null;
 
         if ( $post_id ) {
@@ -52 +53 @@
                 $url   = (string) get_permalink( $post_id );
                 $image = featured_image( $post_id );
+
+                // No meta description: the excerpt, if someone wrote one. Not an automatic excerpt from the
+                // content, which is usually a worse summary than the apps' own.
+                if ( '' === $description ) {
+                        $description = trim( (string) preg_replace( '/\s+/', ' ', wp_strip_all_tags( (string) get_post_field( 'post_excerpt', $post_id ) ) ) );
+                }
         }
 
@@ -72 +79 @@
                 'og:site_name'    => get_bloginfo( 'name' ),
                 'og:title'        => $title,
-                'og:description'  => current_description(),
+                'og:description'  => $description,
                 'og:url'          => $url,
                 'og:image'        => $image['url'] ?? '',
@@ -79 +86 @@
                 'og:image:alt'    => $image['alt'] ?? '',
                 // Apps that read twitter:card take everything else from the og: tags.
-                'twitter:card'    => $image ? 'summary_large_image' : 'summary',
+                'twitter:card'    => $image && is_wide( $image ) ? 'summary_large_image' : 'summary',
         ];
 
@@ -106 +113 @@
 
 /**
+ * Whether an image suits a large, wide preview card: at least 600 px wide and wider than tall.
+ * A small or square image, like a site icon, gets the small card instead of being cropped or blurred.
+ * An image without a known size (from the filter) counts as wide.
+ *
+ * @param array{url: string, width?: int, height?: int} $image The image.
+ */
+function is_wide( array $image ): bool {
+        $width  = (int) ( $image['width'] ?? 0 );
+        $height = (int) ( $image['height'] ?? 0 );
+
+        return ! $width || ( $width >= 600 && $width > $height );
+}
+
+/**
  * The post's featured image at full size, or null.
  *