Changeset 8487 for sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/inc/template-tags.php

Timestamp:

03/21/2019 10:22:37 PM (6 years ago)

Author:

coffee2code

Message:

Developer: Handle exception to deprecated item that refers to an externally-linked resource as its preferred alternative.

Specifically, debug_fwrite() had been deprecated in favor of PHP's error_log(). In every other case, the implicit assumption is that the preferred alternative is another WP resource.

Props rahmohn, coffee2code.
Fixes #4310.

File:

• sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/inc/template-tags.php (modified) (1 diff)

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/inc/template-tags.php

@@ -1063 +1063 @@
                     $refers .= '()';
                 }
+
+                // Exceptions for externally-linked elements.
+                $exceptions = [
+                    'error_log()' => 'https://secure.php.net/manual/en/function.error-log.php',
+                ];
+                if ( ! empty( $exceptions[ $refers ] ) ) {
+                    $link_to = \DevHub_Formatting::generate_link( $exceptions[ $refers ], $refers );
+                }
+                // Else internally-link the element.
+                else {
+                    $link_to = \DevHub_Formatting::link_internal_element( $refers );
+                }
+
                 /* translators: %s: Linked internal element name */
-                $deprecation_info = ' ' . sprintf( __( 'Use %s instead.', 'wporg' ), \DevHub_Formatting::link_internal_element( $refers ) );
+                $deprecation_info = ' ' . sprintf( __( 'Use %s instead.', 'wporg' ), $link_to );
             }
         }