Admin Search

Description

Admin Search makes searching your WordPress website easy by bringing results from all your post types, media, taxonomies, comments, users and admin pages together in a single, simple-to-use interface, seamlessly integrated into the WordPress admin interface.

Choose which post types and taxonomies are searched and the number of results displayed for each. Admin Search also supports custom post types and taxonomies.

Admin Search is a lightweight plugin with filter hooks for deep customization.

Features

  • Search everything on your WordPress site, anywhere
  • Simple and easy to use
  • Sources of search results are customizable
  • Extend the search query with filter hooks

Configure & Extend

Admin Search can be extended by using filter hooks. The following filters are available:

  • admin_search_query to modify the search query string. The filter argument supplied is a string containing the search query
  • admin_search_sources to modify the search sources. The filter argument supplied is an array of sources, add, remove or modify sources
  • admin_search_posts_query to modify the WP_Query arguments array for all searched post types. The filter argument supplied is an array of WP_Query arguments, add, remove or modify supported arguments
  • admin_search_{Post Type}_query to modify the WP_Query arguments array for a specific post type. The filter argument supplied is an array of WP_Query arguments, add, remove or modify supported arguments. Replace {Post Type} with the name of the post type to modify
  • admin_search_terms_query to modify the get_terms arguments array for all searched terms (taxonomies). The filter argument supplied is an array of get_terms arguments, add, remove or modify supported arguments
  • admin_search_{Term}_query to modify the get_terms arguments array for a specific term (taxonomy). The filter argument supplied is an array of get_terms arguments, add, remove or modify supported arguments. Replace {Term} with the name of the term to modify
  • admin_search_comments_query to modify the WP_Comment_Query arguments array for all searched comments. The filter argument supplied is an array of WP_Comment_Query arguments, add, remove or modify supported arguments
  • admin_search_users_query to modify the WP_User_Query arguments array for all searched users. The filter argument supplied is an array of admin_search_users_query arguments, add, remove or modify supported arguments
  • admin_search_website_titles to modify the labels array for external websites. The filter argument supplied is an array of predefined domains and titles, add, remove or modify domains and titles
  • admin_search_pre_results and admin_search_post_results to modify the results array before or after results are appended to the array. The filter argument supplied is an empty array for admin_search_pre_results or search results for a given query for admin_search_post_results, add, remove or modify result items

Eg.

// Correct the spelling of dog when searching
add_filter( 'admin_search_query', function( $query ) {
    if ( $query == 'dog' ) {
        $query = 'doggo';
    }

    return $query;
} );

Or

// Exclude post with the ID 96
add_filter( 'admin_search_posts_query', function( $query ) {
    $query['post__not_in'] = array( 96 );
    return $query;
} );

Or

// Add custom results from external API
add_filter( 'admin_search_post_results', function( $results, $q ) {
    $results[ 'custom' ][ 'post_type' ] => array(
        'name' => 'custom',
        'label' => 'Custom'
    );

    $json = file_get_contents( 'https://example.com?search=' . $q );
    $obj = json_decode( $json );

    foreach ( $obj as $item ) {
        $results[ 'custom' ][ 'posts' ][] = array(
            …
        );
    }

    return $results;
}, 10, 2 );

Screenshots

  • Search by keyword to find posts, pages, media and more with matching titles or content
  • Find media by title, alt text, caption or description
  • Choose result sources and more with settings to tailor your search experience

Installation

  1. Visit Plugins > Add New
  2. Search for “Admin Search”
  3. Activate Admin Search from your Plugins page
  4. Go to Settings > Admin Search and choose what to search on your WordPress website

Reviews

May 29, 2022
I knew someone would make a quick-search plugin for WP, and I'm surprised that it's not a core feature - but here it is, just what I needed! I'm working on an encyclopedia-type site that will eventually have hundreds of articles that are cross-referenced and often need to be updated. Having to click through a few menus to find the one you need to edit is a pain - but not now. Instant search from the backend, and you don't even have to click on anything if you don't want to - just start typing. Very configurable for how you need to use it - and highly recommended for sites with lots of content you need to quickly find.
September 6, 2021
Fácil de usar e facilita muito a busca das páginas no painel de administração.
July 13, 2021
This plugin is awesome! I work on a Wordpress multisite and manually figuring out if a plugin is currently in use is very tricky, especially when I'm not the developer who installed anything. A plugin might SEEM like it's not in use, you'll delete it, and then everyone who had been using it for years (like bookmarked a random page) all of a sudden comes out of the woodwork complaining about how the page is broken. This plugin solves this issue and I can't wait to keep using it!
February 5, 2021
This plugin saves me so much time and works smoothly. Hoping the developer will add User search functionality in the future.
Read all 6 reviews

Contributors & Developers

“Admin Search” is open source software. The following people have contributed to this plugin.

Contributors

“Admin Search” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Admin Search” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.2.0

  • New Feature: Additional search results can now be loaded within the search box. If a source has more results for a query than the Result Count limit, a load more button will appear below those results
  • New Feature: An option has been added to the user profile page which allows users to hide their profile from searches. Admins and other users with the edit_user capability can toggle this option for other users
  • New Feature: Search for items by their ID by typing a hashtag followed by the ID. Eg. Searching #889 will list the item with that ID
  • New Feature: A link to the native WordPress admin search page is displayed at the top of each results group
  • New Feature: A shortcut to the Admin Search settings page now appears in the search box when hovering over the search bar
  • New Feature: Add status: followed by a post status such as published, draft or pending after your search term to only see results with that status. This is limited to post type results
  • Update: Tweaks to the design, including an increased width and height, larger typography and improvements to colors
  • Update: External websites can now be labelled using a new filter. For example: google.com appears as Google. To add a label, use: admin_search_website_titles, learn more about this filter on the plugin page on WordPress.org
  • Update: New filter hook admin_search_sources allows developers to add, modify or remove search sources
  • Update: New filter hook admin_search_{Post Type}_query allows developers to add, modify or remove arguments from the WP_Query arguments for a specific post type. This is a dynamic filter, replace {Post Type} with the name of the post type you wish to filter
  • Update: New filter hook admin_search_{Term}_query allows developers to add, modify or remove arguments from the WP_Query arguments for a specific term. This is a dynamic filter, replace {Term} with the name of the term you wish to filter
  • Update: New filter hook admin_search_pre_results and admin_search_post_results allows developers to add or modify items in the results array before or after other results are appended to the array respectively
  • Update: Links for plugin help and ways to support the plugin have been added to the footer on the plugin settings page
  • Update: The Result Count options have been changed and the unlimited option removed entirely. The default Result Count value is now 10, your current Result Limit is unchanged until you update it on the settings page
  • Update: The minimum query length has been decreased from 3 to 2 to accomodate ID searches
  • Update: Users are now searchable by ID
  • Fix: Addressed an issue causing post, page and attachment results to display in searches when all post types are disabled
  • Fix: Addressed inconsistencies in the accessibility of the search box
  • Fix: Started adding support for keyword highlighting on comments, users and admin page results. This is still WIP and may not show for every result, especially if the keyword is in the content but not in the title
  • Fix: Improved user access. Eg. now only users who have the capability to edit other users’ posts can use Admin Search
  • Fix: The query string has been added to all filter hooks allowing developers to reference the search query in the filter hook callback

1.1.4

  • Fix: Addressed an issue causing the search box to display when typing in an input
  • Fix: Addressed an issue causing result titles to be hidden when a forward slash was used in the search query

1.1.3

  • Update: Tested on version 5.9 of WordPress

1.1.2

  • Update: Tested on version 5.8 of WordPress

1.1.1

  • Update: The search UI is now centered and the scrim is removed. This makes it easier to access or view content on the page when the search UI is open

1.1.0

  • New Feature: Users are now searchable (by username, display name, email address or role)
  • New Feature: Posts can now be searched for by author
  • New Feature: Posts can now be searched for by date (year, month, or day posted, or posted before or after a date). This supports most date formats
  • New Feature: External websites can be added to search results. When performing a search, links to the external websites will be displayed, this is useful for including links to search results on other websites
  • New Feature: The Admin Search is now accessible on the front end of the website. This can be enabled or disabled in the Admin Search settings
  • Update: Taxonomies are now individually selectable
  • Update: Admin menu searches now search the actual admin menus rather than a static list. This is still in beta and is disabled by default, this does not currently work when searching from the front end of the website
  • Update: A new filter has been added to modify the search query string: admin_search_query
  • Update: A new filter has been added to modify the users query: admin_search_users_query
  • Update: The colors of the search UI have been updated to match the WordPress color update. Additionally, developers can customize the search UI colors using CSS variables
  • Update: The search UI colors now match the current admin color scheme (except for the Light scheme)
  • Update: General CSS updates (mostly for mobile and smaller browser sizes)

1.0.3

  • Fix: Addressed javascript error thrown when Admin Search is disabled
  • Update: Tested on version 5.7 of WordPress

1.0.2

  • Fix: Added correct version number to stylesheet and script URLs
  • Update: Tested on version 5.4 of WordPress

1.0.1

  • Fix: Limit is now applied to each post type, not the total number of posts returned
  • Update: Plugin has been tested back to WordPress 4.9.2