Changeset 4998

Timestamp:

06/24/2013 04:19:41 AM (13 years ago)

Author:

johnjamesjacoby

Message:

Introduce bbp_find_mentions_pattern() function to make it easier to change the pattern to match usernames against. Helpful for non-latin characters. Also add additional filter to bbp_find_mentions() to allow for late filtering of results. Props aliso. Fixes #2226.

File:

• trunk/includes/core/functions.php (modified) (2 diffs)

trunk/includes/core/functions.php

@@ -285 +285 @@
 
 /**
+ * Set the pattern used for matching usernames for mentions.
+ *
+ * Moved into its own function to allow filtering of the regex pattern
+ * anywhere mentions might be used.
+ *
+ * @since bbPress (r4997)
+ * @return string Pattern to match usernames with
+ */
+function bbp_find_mentions_pattern() {
+    return apply_filters( 'bbp_find_mentions_pattern', '/[@]+([A-Za-z0-9-_\.@]+)\b/' );
+}
+
+/**
  * Searches through the content to locate usernames, designated by an @ sign.
  *
@@ -293 +306 @@
  */
 function bbp_find_mentions( $content = '' ) {
-    $pattern   = '/[@]+([A-Za-z0-9-_\.@]+)\b/';
+    $pattern   = bbp_find_mentions_pattern();
     preg_match_all( $pattern, $content, $usernames );
     $usernames = array_unique( array_filter( $usernames[1] ) );
 
     // Bail if no usernames
-    if ( empty( $usernames ) )
-        return false;
-
-    return $usernames;
+    if ( empty( $usernames ) ) {
+        $usernames = false;
+    }
+
+    return apply_filters( 'bbp_find_mentions', $usernames, $pattern, $content );
 }