From 14fc4634a29e3ce541ac388b3c325cfa40096acc Mon Sep 17 00:00:00 2001
From: Andrew Ozz <azaozz@git.wordpress.org>
Date: Tue, 23 Apr 2019 21:04:19 +0000
Subject: [PATCH] Site Health: Allow some HTML (inline tags only) in the
 section descriptions. Add some more docs about expected formatting of the
 gathered data.

Props kraftbj, jeherve, mukesh27, audrasjb, azaozz.
Fixes #46878.

git-svn-id: https://develop.svn.wordpress.org/trunk@45259 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-admin/includes/class-wp-debug-data.php |  4 +++-
 src/wp-admin/site-health-info.php             | 10 +---------
 2 files changed, 4 insertions(+), 10 deletions(-)

diff --git a/src/wp-admin/includes/class-wp-debug-data.php b/src/wp-admin/includes/class-wp-debug-data.php
index 2a3855b146..72df262175 100644
--- a/src/wp-admin/includes/class-wp-debug-data.php
+++ b/src/wp-admin/includes/class-wp-debug-data.php
@@ -983,6 +983,8 @@ class WP_Debug_Data {
 		 * a prefix, both for consistency as well as avoiding key collisions. Note that the array keys are used as labels
 		 * for the copied data.
 		 *
+		 * All strings are expected to be plain text except $description that can contain inline HTML tags (see below).
+		 *
 		 * @since 5.2.0
 		 *
 		 * @param array $args {
@@ -994,7 +996,7 @@ class WP_Debug_Data {
 		 *
 		 *     @type string  $label        The title for this section of the debug output.
 		 *     @type string  $description  Optional. A description for your information section which may contain basic HTML
-		 *                                 markup: `em`, `strong` and `a` for linking to documentation or putting emphasis.
+		 *                                 markup, inline tags only as it is outputted in a paragraph.
 		 *     @type boolean $show_count   Optional. If set to `true` the amount of fields will be included in the title for
 		 *                                 this section.
 		 *     @type boolean $private      Optional. If set to `true` the section and all associated fields will be excluded
diff --git a/src/wp-admin/site-health-info.php b/src/wp-admin/site-health-info.php
index a93b7bcdc7..42f2be0367 100644
--- a/src/wp-admin/site-health-info.php
+++ b/src/wp-admin/site-health-info.php
@@ -137,16 +137,8 @@ require_once( ABSPATH . 'wp-admin/admin-header.php' );
 			<div id="health-check-accordion-block-<?php echo esc_attr( $section ); ?>" class="health-check-accordion-panel" hidden="hidden">
 				<?php
 
-				$kses_settings = array(
-					'a'      => array(
-						'href' => true,
-					),
-					'strong' => true,
-					'em'     => true,
-				);
-
 				if ( isset( $details['description'] ) && ! empty( $details['description'] ) ) {
-					printf( '<p>%s</p>', wp_kses( $details['description'], $kses_settings ) );
+					printf( '<p>%s</p>', $details['description'] );
 				}
 
 				?>