Changeset 5720

Timestamp:

07/26/2017 05:27:10 PM (7 years ago)

Author:

coffee2code

Message:

Breathe: Disable showing linked mentions on any handbook page.

Only current exception is a "Credits" page.

A more involved approach (to include clearing meta-cached data) would be needed to more efficiently prevent mentions from being looked for in the first place.

Fixes #2932.

File:

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

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-breathe/functions.php

@@ -151 +151 @@
 }
 add_filter( 'nav_menu_item_args', __NAMESPACE__ . '\add_screen_reader_text_for_icon_menu_items', 10, 2 );
+
+/**
+ * Disables Jetpack Mentions on any handbook page or comment.
+ *
+ * More precisely, this prevents the linked mentions from being shown. A more
+ * involved approach (to include clearing meta-cached data) would be needed to
+ * more efficiently prevent mentions from being looked for in the first place.
+ *
+ * @param string $linked  The linked mention.
+ * @param string $mention The term being mentioned.
+ * @return string
+ */
+function disable_mentions_for_handbook( $linked, $mention ) {
+    if ( function_exists( 'wporg_is_handbook' ) && wporg_is_handbook() && ! is_single( 'credits' ) ) {
+        return '@' . $mention;
+    }
+
+    return $linked;
+}
+add_filter( 'jetpack_mentions_linked_mention', __NAMESPACE__ . '\disable_mentions_for_handbook', 10, 2 );
+