Ticket #1551: 1551.diff

inc/template-tags.php

@@ -833 +833 @@
                 $types          = explode( '-', get_post_type( $post_id ) );
                 $type           = array_pop( $types );
                 $tags           = get_post_meta( $post_id, '_wp-parser_tags', true );
-                $all_deprecated = wp_filter_object_list( $tags, array( 'name' => 'deprecated' ) );
+                $deprecated = wp_filter_object_list( $tags, array( 'name' => 'deprecated' ) );
 
-                if ( empty( $all_deprecated ) ) {
+                if ( empty( $deprecated ) ) {
                         return '';
                 }
 
-                $deprecated  = array_shift( $all_deprecated );
-                // Multi-@deprecated may have been defined, with the second actually having the deprecation text.
-                if ( empty( $deprecated['content'] ) ) {
-                        $deprecated  = array_shift( $all_deprecated );
+                $referral = array_shift( wp_filter_object_list( $tags, array( 'name' => 'see' ) ) );
+
+                if ( ! empty( $referral['refers'] ) ) {
+                        $refers = sanitize_text_field( $referral['refers'] );
+
+                        if ( ! empty( $refers ) ) {
+                                /* translators: 1: Linked internal element name */
+                                $alternative_string = sprintf( __( ' Use %s instead.', 'wporg' ), \DevHub_Formatting::link_internal_element( $refers ) );
+                        }
+                } else {
+                        $alternative_string = '';
                 }
-                $description = empty( $deprecated['content'] ) ? '' : esc_html( $deprecated['content'] );
 
-                return "<div class='deprecated'>"
-                        . wp_kses_post( sprintf( __( 'Warning: This %s has been deprecated. %s', 'wporg' ), $type, $description ) )
-                        . '</div>';
+                /* translators: 1: String for alternative function (if one exists) */
+                $contents = sprintf( __( 'This %1$s has been deprecated.%2$s', 'wporg' ),
+                        $type,
+                        $alternative_string
+                );
+
+                // Use the 'warning' callout box if it's available. Otherwise, fall back to a theme-supported div class.
+                if ( class_exists( 'WPorg_Handbook_Callout_Boxes' ) ) {
+                        $callout = new \WPorg_Handbook_Callout_Boxes();
+                        $message = $callout->warning_shortcode( array(), $contents );
+                } else {
+                        $message  = '<div class="deprecated">';
+                        $message .= '<p>' . $contents . '</p>';
+                        $message .= '</div>';
+                }
+
+                return $message;
         }
 
         /**
@@ -1392 +1412 @@
 
                 /* translators: 1: String for alternative function (if one exists) */
                 $contents = sprintf( __( 'This function&#8217;s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.%s', 'wporg' ),
-                                $alternative_string
+                        $alternative_string
                 );
 
                 // Use the 'alert' callout box if it's available. Otherwise, fall back to a theme-supported div class.

scss/main.scss

@@ -1010 +1010 @@
                         padding: 20px;
                 }
                 .deprecated {
-                        background-color: #be2423;
-                        border: 1px solid #a4322f;
+                        background-color: #fbeaea;
+                        border: 1px solid #dc3232;
                         padding: 20px;
-                        color: #ffffff;
                 }
                 .deprecated-method {
                         color: #be2423;

stylesheets/main.css

@@ -1213 +1213 @@
   padding: 20px;
 }
 .devhub-wrap .wp-parser-class .deprecated, .devhub-wrap .wp-parser-function .deprecated, .devhub-wrap .wp-parser-hook .deprecated, .devhub-wrap .wp-parser-method .deprecated {
-  background-color: #be2423;
-  border: 1px solid #a4322f;
+  background-color: #fbeaea;
+  border: 1px solid #dc3232;
   padding: 20px;
-  color: #ffffff;
 }
 .devhub-wrap .wp-parser-class .deprecated-method, .devhub-wrap .wp-parser-function .deprecated-method, .devhub-wrap .wp-parser-hook .deprecated-method, .devhub-wrap .wp-parser-method .deprecated-method {
   color: #be2423;