Gdy korzystamy z parametru s WP_Query, WordPress wyszuka wpisów, które zawierają podane słowa w tytule lub treści. Zdarza się jednak, że chcemy wyszukiwać jedynie po tytule (bo jest to w danej chwili bardziej intuicyjne – np. jeśli tworzymy pole z automatycznym podpowiadaniem tytułu wpisu).

Poniższy kod pozwoli nam osiągnąć właśnie taki efekt.

function prefiks_search_by_title_only( $search, $query ) {
    global $wpdb;

    if ( empty( $search ) ) {
        return $search;
    }
    $q = $wp_query->query_vars;
    $n = ! empty( $q['exact'] ) ? '' : '%';

    $search = $searchand = '';

    foreach ( (array) $q['search_terms'] as $term ) {
        $term = esc_sql( like_escape( $term ) );
        $search .= "{$searchand}($wpdb->posts.post_title LIKE '{$n}{$term}{$n}')";
        $searchand = ' AND ';
    }

    if ( ! empty( $search ) ) {
        $search = " AND ({$search}) ";
        if ( ! is_user_logged_in() ) {
            $search .= " AND ($wpdb->posts.post_password = '') ";
        }
    }
    return $search;
}
add_filter( 'posts_search', 'prefiks_search_by_title_only' );

Dodatkowe warianty i pytania

Dlaczego nie podpinamy się pod filtr posts_where?

Na to pytanie można odpowiedzieć na wiele sposobów i pewnie każda z tych odpowiedzi byłaby poprawna.

Przede wszystkim dlatego, że skoro filtr posts_search istnieje i służy do modyfikowania części zapytania związanej z wyszukiwaniem, to jest to najbardziej właściwy filtr do naszego celu.

Drugim, całkiem niezłym powodem, jest to, że używając filtru posts_where musielibyśmy pamiętać o wielu innych rzeczach, które nie są związane z wyszukiwaniem, a moglibyśmy zepsuć (bo przecież zapytanie może szukać tylko wpisów danego typu, tylko w określonej kategorii, itd.).

Dlaczego w powyższym kodzie sprawdzamy czy użytkownik jest zalogowany?

Bo tak zachowuje się sam WordPress. W oryginalnym kodzie tworzącym zapytanie przyjęto, że wpisy zabezpieczone hasłem, nie są zwracane w wynikach wyszukiwania.

Dlaczego zapytanie SQL budowane przez ten filtr jest tak skomplikowane?

Żeby nie zmieniać sposobu, w jaki zachowuje się WordPress. Nie chcemy zupełnie zmienić sposobu, w jaki działa wyszukiwanie, a jedynie sprawić, aby szukało jedynie po zawartości tytułu.