diff --git a/plugins/webp-uploads/settings.php b/plugins/webp-uploads/settings.php index 78cccb2140..95ccbb311b 100644 --- a/plugins/webp-uploads/settings.php +++ b/plugins/webp-uploads/settings.php @@ -79,7 +79,19 @@ function webp_uploads_add_media_settings_fields(): void { add_settings_section( 'perflab_modern_image_format_settings', _x( 'Modern Image Formats', 'settings page section name', 'webp-uploads' ), - '__return_empty_string', + static function (): void { + printf( + '

%s

', + wp_kses( + sprintf( + /* translators: %s: URL to the plugin FAQ on WordPress.org */ + __( 'If modern format images are not being generated after upload, see the FAQ for common reasons.', 'webp-uploads' ), + 'https://wordpress.org/plugins/webp-uploads/#faq' + ), + array( 'a' => array( 'href' => array() ) ) + ) + ); + }, 'media', array( 'before_section' => '
', diff --git a/plugins/webp-uploads/tests/test-settings.php b/plugins/webp-uploads/tests/test-settings.php index 0d167b1d09..52e8a09f86 100644 --- a/plugins/webp-uploads/tests/test-settings.php +++ b/plugins/webp-uploads/tests/test-settings.php @@ -7,6 +7,24 @@ class Test_WebP_Uploads_Settings extends WP_UnitTestCase { + /** + * @covers ::webp_uploads_add_media_settings_fields + */ + public function test_webp_uploads_add_media_settings_fields_section_description(): void { + global $wp_settings_sections; + webp_uploads_add_media_settings_fields(); + + $callback = $wp_settings_sections['media']['perflab_modern_image_format_settings']['callback']; + $this->assertIsCallable( $callback ); + + ob_start(); + call_user_func( $callback ); + $output = ob_get_clean(); + + $this->assertStringContainsString( 'https://wordpress.org/plugins/webp-uploads/#faq', $output ); + $this->assertStringContainsString( '