WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

WP_Query::parse_search_terms()

WP_Query::parse_search_terms( string[] $terms ): string[]

In this article

Back to top

Checks if the terms are suitable for searching.

Description

Uses an array of stopwords (terms) that are excluded from the separate term matching when searching for posts. The list of English stopwords is the approximate search engines list, and is translatable.

Parameters

$termsstring[]required
Array of terms to check.

Return

string[] Terms that are not stopwords.

Source

protected function parse_search_terms( $terms ) {
	$strtolower = function_exists( 'mb_strtolower' ) ? 'mb_strtolower' : 'strtolower';
	$checked    = array();

	$stopwords = $this->get_search_stopwords();

	foreach ( $terms as $term ) {
		// Keep before/after spaces when term is for exact match.
		if ( preg_match( '/^".+"$/', $term ) ) {
			$term = trim( $term, "\"'" );
		} else {
			$term = trim( $term, "\"' " );
		}

		// Avoid single A-Z and single dashes.
		if ( ! $term || ( 1 === strlen( $term ) && preg_match( '/^[a-z\-]$/i', $term ) ) ) {
			continue;
		}

		if ( in_array( call_user_func( $strtolower, $term ), $stopwords, true ) ) {
			continue;
		}

		$checked[] = $term;
	}

	return $checked;
}

View all references View on Trac View on GitHub

UsesDescription
WP_Query::get_search_stopwords()wp-includes/class-wp-query.php

Retrieves stopwords used when parsing search terms.

Used byDescription
WP_Query::parse_search()wp-includes/class-wp-query.php

Generates SQL for the WHERE clause based on passed search terms.

Changelog

VersionDescription
3.7.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.