WP Manifestindependent plugin directory
manifest / integrations / multiwordpresssearch

Multi WordPress Search

Wordpress extension that search across multiple wordpress instances

by d9pouces · github.com/d9pouces/multiwordpresssearch · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/d9pouces/multiwordpresssearch/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/d9pouces/multiwordpresssearch ↗

A WordPress plugin that replaces the default search form with a custom search engine that queries multiple WordPress sites simultaneously via the official WordPress REST API.

Features

  • Replaces the native WordPress search form site-wide (via the get_search_form filter).
  • Queries any number of remote WordPress sites using /wp-json/wp/v2/search.
  • Displays a live as-you-type dropdown with results from all configured sites.
  • Full-page results view inherits the active theme's header and footer.
  • Simple admin settings page (Settings → Multi WP Search) to manage the list of sites.
  • [multi_wordpress_search] shortcode for placing the search form anywhere.
  • Clean uninstall: all plugin data is removed when the plugin is deleted.

Installation

  1. Copy the MultiWordpressSearch directory into wp-content/plugins/.
  2. Activate the plugin from Plugins → Installed Plugins.
  3. Go to Settings → Multi WP Search and add the base URLs of the WordPress sites you want to search (e.g. https://example.com).
  4. The default search form on your site is now replaced automatically.

Usage

Automatic replacement

Once activated and configured, every call to get_search_form() in your theme is intercepted and returns the Multi WordPress Search form instead.

Shortcode

Place the search form anywhere using:

[multi_wordpress_search placeholder="Search our network…"]

REST API endpoint (AJAX)

The plugin exposes a WordPress AJAX action for live search:

GET /wp-admin/admin-ajax.php?action=mws_search&nonce=<nonce>&query=<term>

Returns a JSON response:

{
  "success": true,
  "data": [
    {
      "title": "Post title",
      "url": "https://example.com/post-slug/",
      "excerpt": "Short excerpt…",
      "type": "post",
      "site_name": "Example Site",
      "site_url": "https://example.com/"
    }
  ]
}

File structure

multi-wordpress-search.php   ← Main plugin file (headers + bootstrap)
uninstall.php                ← Cleanup on deletion
includes/
  class-mws-api-client.php   ← Queries remote WordPress REST APIs
  class-mws-search-form.php  ← Renders & intercepts the search form
admin/
  class-mws-admin.php        ← Settings page registration
  admin-page.php             ← Settings page partial (site list)
  js/mws-admin.js            ← Dynamic add/remove site rows
public/
  css/multi-wordpress-search.css  ← Front-end styles
  js/multi-wordpress-search.js    ← Live search + keyboard navigation
templates/
  search-results.php         ← Full-page results template
languages/                   ← POT / translation files (empty by default)

License

CeCILL-B — see https://cecill.info/licences/Licence_CeCILL-B_V1-en.html.