Changeset 4617 for sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/inc/formatting.php

Timestamp:

01/09/2017 07:15:56 PM (10 years ago)

Author:

coffee2code

Message:

developer.wordpress.org: Allow @see notation to reference classes.

While not used much in core docs (except once, and only just recently), the feature could be utilized in explanations and handbooks.

Fixes #2367.

File:

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

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

@@ -184 +184 @@
                                         '">' . esc_html( $link ) . '</a>';
                         }
+                }
+
+                // Link to class: {@see WP_Query}
+                elseif (
+                        ( in_array( $link, array(
+                                'wpdb', 'wp_atom_server', 'wp_xmlrpc_server', // Exceptions that start with lowercase letter
+                                'AtomFeed', 'AtomEntry', 'AtomParser', 'MagpieRSS', 'Requests', 'RSSCache', 'Translations', 'Walker' // Exceptions that lack an underscore
+                        ) ) )
+                        ||
+                        ( 1 === preg_match ( '/^_?[A-Z][a-zA-Z]+_\w+/', $link ) ) // Otherwise, class names start with (optional underscore, then) uppercase and have underscore
+                ) {
+                        $link = sprintf(
+                                '<a href="%s">%s</a>',
+                                esc_url( get_post_type_archive_link( 'wp-parser-class' ) . sanitize_key( $link ) ),
+                                esc_html( $link )
+                        );
                 }