WordPress filter hook · part of WordPress core

posts_search

A WordPress core filter that 5 plugins also fire themselves, running on 8,150+ sites between them.

“Filters the search SQL that is used in the WHERE clause of WP_Query.”

How to use posts_search

It's a filter: your callback receives the value, and must return the (changed) value. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_filter( 'posts_search', function( $search, $arg2 ) {
	// Change $search here.
	return $search;
}, 10, 2 );

Argument names come from ALD's source. Other plugins may pass different values: check the call in the plugin you're targeting below.

This hook is fired by WordPress core too. Official reference on developer.wordpress.org →

5 plugins that fire posts_search

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. ALD icon ALD8,000+ installs apply_filters_ref_array( 'posts_search', array( $search, &$this ) ) includes/ali-product-query.php:500
  2. ChinaDS icon ChinaDS100+ installs apply_filters_ref_array( 'posts_search', array( $search, &$this ) ) inc/taobao-post-query.php:506
  3. HANDMADE icon HANDMADE40+ installs apply_filters_ref_array( 'posts_search', array( $search, &$this ) ) includes/class/handmade-post-query.php:569
  4. MarketEngine icon MarketEngine10+ installs apply_filters_ref_array( 'posts_search', array( $search, &$this ) ) includes/class-me-message-query.php:949
  5. Gospel Resource Hub icon Gospel Resource HubFewer than 10 installs apply_filters_ref_array( 'posts_search', array( $search, &$this ) ) includes/class-grh-query.php:339

Need a customisation built on this hook?

Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.