Changeset 62502 for trunk/tests/phpunit/tests/general/template.php

Timestamp:

06/15/2026 08:47:05 PM (4 months ago)

Author:

westonruter

Message:

Embeds: Preserve the site icon fallback URL.

Previously, get_site_icon_url() overwrote a caller-supplied fallback URL with the return value of wp_get_attachment_image_url() even when that lookup returned false, so a defined fallback (such as the bundled WordPress logo) was silently discarded whenever the assigned site icon attachment could not be resolved. Only update the URL when a non-empty attachment URL is returned.

Additionally, the_embed_site_title() now renders the site icon <img> only when a URL is available, and omits the srcset attribute when the 2x URL is missing or identical to the 1x URL. This avoids the malformed markup (an empty src and a bare 2x srcset) that produced a broken image and spurious requests in oEmbed cards.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/11601.
Follow-up to r35571, r36693, r47832.

Props sukhendu2002, sabernhardt, mukesh27, westonruter, pontocinza, mohamedahamed, abcd95, manhar, rollybueno.
Fixes #65098.

File:

• trunk/tests/phpunit/tests/general/template.php (modified) (2 diffs)

trunk/tests/phpunit/tests/general/template.php

@@ -124 +124 @@
 
         /**
+         * @ticket 65098
+         * @group site_icon
+         * @covers ::get_site_icon_url
+         * @requires function imagejpeg
+         */
+        public function test_get_site_icon_url_returns_fallback_when_attachment_url_fails(): void {
+                $this->set_site_icon();
+
+                $fallback = 'https://example.com/fallback-icon.png';
+                add_filter( 'wp_get_attachment_image_src', '__return_false' );
+                $url = get_site_icon_url( 32, $fallback );
+
+                $this->assertSame( $fallback, $url, 'Fallback URL should be returned when attachment URL lookup fails.' );
+        }
+
+        /**
          * @group site_icon
          * @covers ::site_icon_url
@@ -808 +824 @@
                 $this->assertSame( $user_with_no_posts->display_name, $title_when_no_posts );
         }
+
+        /**
+         * @ticket 65098
+         * @group site_icon
+         * @covers ::the_embed_site_title
+         * @requires function imagejpeg
+         */
+        public function test_the_embed_site_title_contains_site_icon_when_set(): void {
+                $this->set_site_icon();
+
+                $url_32 = get_site_icon_url( 32 );
+                $url_64 = get_site_icon_url( 64 );
+
+                $output    = get_echo( 'the_embed_site_title' );
+                $processor = new WP_HTML_Tag_Processor( $output );
+
+                $this->assertTrue( $processor->next_tag( 'IMG' ), 'Expected IMG tag.' );
+                $this->assertTrue( $processor->has_class( 'wp-embed-site-icon' ), 'Expected IMG to have wp-embed-site-icon class.' );
+                $this->assertSame( $url_32, $processor->get_attribute( 'src' ), 'Output should contain 32px site icon URL in src.' );
+                $srcset = $processor->get_attribute( 'srcset' );
+                $this->assertIsString( $srcset, 'Expected srcset to be present.' );
+                $this->assertStringContainsString( $url_64, $srcset, 'Output should contain 64px site icon URL in srcset.' );
+        }
+
+        /**
+         * @ticket 65098
+         * @group site_icon
+         * @covers ::the_embed_site_title
+         * @requires function imagejpeg
+         */
+        public function test_the_embed_site_title_uses_fallback_when_attachment_url_fails(): void {
+                $this->set_site_icon();
+
+                // Simulate wp_get_attachment_image_url() failing.
+                add_filter( 'wp_get_attachment_image_src', '__return_false' );
+                $output = get_echo( 'the_embed_site_title' );
+
+                $fallback  = includes_url( 'images/w-logo-blue.png' );
+                $processor = new WP_HTML_Tag_Processor( $output );
+
+                $this->assertTrue( $processor->next_tag( 'IMG' ), 'Expected IMG tag with fallback.' );
+                $this->assertTrue( $processor->has_class( 'wp-embed-site-icon' ), 'Expected IMG to have wp-embed-site-icon class.' );
+                $this->assertSame( $fallback, $processor->get_attribute( 'src' ), 'Output should contain fallback URL in src when attachment URL fails.' );
+        }
+
+        /**
+         * @ticket 65098
+         * @group site_icon
+         * @covers ::the_embed_site_title
+         */
+        public function test_the_embed_site_title_omits_img_when_url_is_empty(): void {
+                // Force get_site_icon_url() to return empty string via filter.
+                add_filter( 'get_site_icon_url', '__return_empty_string' );
+                $output = get_echo( 'the_embed_site_title' );
+
+                $processor = new WP_HTML_Tag_Processor( $output );
+
+                $this->assertFalse( $processor->next_tag( 'IMG' ), 'IMG tag should be omitted when URL is empty.' );
+                $this->assertStringContainsString( get_bloginfo( 'name' ), $output, 'Site name should still be present.' );
+        }
+
+        /**
+         * @ticket 65098
+         * @group site_icon
+         * @covers ::the_embed_site_title
+         */
+        public function test_the_embed_site_title_omits_srcset_when_1x_and_2x_urls_are_identical(): void {
+                // Force both sizes to return the same URL.
+                $svg_url = 'https://example.com/icon.svg';
+                $filter  = static function () use ( $svg_url ) {
+                        return $svg_url;
+                };
+
+                add_filter( 'get_site_icon_url', $filter );
+                $output = get_echo( 'the_embed_site_title' );
+
+                $processor = new WP_HTML_Tag_Processor( $output );
+
+                $this->assertTrue( $processor->next_tag( 'IMG' ), 'Expected IMG tag.' );
+                $this->assertTrue( $processor->has_class( 'wp-embed-site-icon' ), 'Expected IMG to have wp-embed-site-icon class.' );
+                $this->assertSame( $svg_url, $processor->get_attribute( 'src' ), '1x URL should be present in src.' );
+                $this->assertNull( $processor->get_attribute( 'srcset' ), 'srcset should be omitted when 1x and 2x URLs are identical.' );
+        }
+
+        /**
+         * @ticket 65098
+         * @group site_icon
+         * @covers ::the_embed_site_title
+         */
+        public function test_the_embed_site_title_uses_fallback_without_srcset_when_no_site_icon_set(): void {
+                $output   = get_echo( 'the_embed_site_title' );
+                $fallback = includes_url( 'images/w-logo-blue.png' );
+
+                $processor = new WP_HTML_Tag_Processor( $output );
+
+                $this->assertTrue( $processor->next_tag( 'IMG' ), 'Expected IMG tag with fallback.' );
+                $this->assertTrue( $processor->has_class( 'wp-embed-site-icon' ), 'Expected IMG to have wp-embed-site-icon class.' );
+                $this->assertSame( $fallback, $processor->get_attribute( 'src' ), 'Output should contain fallback icon URL in src.' );
+                $this->assertNull( $processor->get_attribute( 'srcset' ), 'srcset should be omitted when 1x and 2x fallback URLs are identical.' );
+        }
 }