Pin a post for all searches

Relevanssi Premium has tools for pinning posts for specific queries and all searches where the post appears, but what if you want to pin a post for all searches? That’s also possible but requires a bit of code.

Pin the post for all searches and add this function to your site:

add_filter( 'relevanssi_hits_filter', function( $hits ) {
    $pinned_post_id = 1234;
    if ( ! in_array( $pinned_post_id, array_column( $hits[0], 'ID' ), false ) ) {
        $pinned_post = get_post( $pinned_post_id );
        array_unshift( $hits[0], $pinned_post );
    }
    return $hits;
}, 11 );

PHP
​x
 
add_filter( 'relevanssi_hits_filter', function( $hits ) {    $pinned_post_id = 1234;    if ( ! in_array( $pinned_post_id, array_column( $hits[0], 'ID' ), false ) ) {        $pinned_post = get_post( $pinned_post_id );        array_unshift( $hits[0], $pinned_post );    }    return $hits;}, 11 );

Replace 1234 with the ID of the post you want to pin. This function runs on the relevanssi_hits_filter hook that can be used to modify the search results. The function checks if the post appears in the results; if it doesn’t, it fetches the post object and adds it to the top.

Pinning posts

Sometimes you want to get a specific post as the first result for a certain search, but Relevanssi doesn't return the right post as the first result by itself for some reason. Relevanssi Premium has a...

relevanssi_hits_filter

apply_filters( 'relevanssi_hits_filter', array $data, WP_Query $query ) Filters all the result post objects found. Parameters $data(array) An array of post objects in the index 0 and the sear...

Using Relevanssi without a search term

Deprecated: Relevanssi has long supported searching without a search term. These instructions are not necessary. Version 1.7.3 introduces the possibility to use Relevanssi without a search term. Th...

Wishlist Member: Sorting the posts by membership levels

Someone wanted a way to prioritize posts that are targeting particular Wishlist Member membership level. The basic implementation here is simple: create a relevanssi_hits_filter function that will sor...

WooCommerce: Return only exact matches for SKU searches

This little filter function works on relevanssi_hits_filter. When a search query is made that matches an SKU (or any other custom field, but SKUs are the most likely scenario here), only results that ...

Search results breakdown by type

Do you want to have a breakdown of search results by post type? This could be used for example to show a list of post types like books, movies, or albums on a review site, and make them links to limit...