Changeset 38844 for trunk/src/wp-includes/class-wp-query.php

Timestamp:

10/20/2016 06:41:22 PM (9 years ago)

Author:

boonebgorges

Message:

Query: Allow the prefix used for search term exclusion to be filtered.

[38792] allowed WP_Query's hyphen-as-exclusion-prefix feature to be
disabled via filter. A more general solution is to allow the prefix to
be filtered; returning an empty value from a filter callback works to
disable the feature.

Props dlh.
Fixes #38099.

File:

• trunk/src/wp-includes/class-wp-query.php (modified) (2 diffs)

trunk/src/wp-includes/class-wp-query.php

@@ -722 +722 @@
      *     @type string       $s                       Search keyword(s). Prepending a term with a hyphen will
      *                                                 exclude posts matching that term. Eg, 'pillow -sofa' will
-     *                                                 return posts containing 'pillow' but not 'sofa'. This feature
-     *                                                 can be disabled using the
-     *                                                 'wp_query_use_hyphen_for_exclusion' filter.
+     *                                                 return posts containing 'pillow' but not 'sofa'. The
+     *                                                 character used for exclusion can be modified using the
+     *                                                 the 'wp_query_search_exclusion_prefix' filter.
      *     @type int          $second                  Second of the minute. Default empty. Accepts numbers 0-60.
      *     @type bool         $sentence                Whether to search by phrase. Default false.
@@ -1323 +1323 @@
 
         /**
-         * Filters whether search terms preceded by hyphens should excluded from results.
+         * Filters the prefix that indicates that a search term should be excluded from results.
          *
          * @since 4.7.0
          *
-         * @param bool Whether the query should exclude terms preceded with a hyphen.
+         * @param string $exclusion_prefix The prefix. Default '-'. Returning
+         *                                 an empty value disables exclusions.
          */
-        $hyphen_exclusion = apply_filters( 'wp_query_use_hyphen_for_exclusion', true );
+        $exclusion_prefix = apply_filters( 'wp_query_search_exclusion_prefix', '-' );
 
         foreach ( $q['search_terms'] as $term ) {
-            // Terms prefixed with '-' should be excluded.
-            $include = '-' !== substr( $term, 0, 1 );
-            if ( $include || ! $hyphen_exclusion ) {
-                $like_op  = 'LIKE';
-                $andor_op = 'OR';
-            } else {
+            // If there is an $exclusion_prefix, terms prefixed with it should be excluded.
+            $exclude = $exclusion_prefix && ( $exclusion_prefix === substr( $term, 0, 1 ) );
+            if ( $exclude ) {
                 $like_op  = 'NOT LIKE';
                 $andor_op = 'AND';
                 $term     = substr( $term, 1 );
-            }
-
-            if ( $n && $include ) {
+            } else {
+                $like_op  = 'LIKE';
+                $andor_op = 'OR';
+            }
+
+            if ( $n && ! $exclude ) {
                 $like = '%' . $wpdb->esc_like( $term ) . '%';
                 $q['search_orderby_title'][] = $wpdb->prepare( "{$wpdb->posts}.post_title LIKE %s", $like );