WP Loupe Plugin

Features | Installation | Usage | Filters | Acknowledgements | License

Overview

WP Loupe is a plugin for WordPress that significantly improves the search capabilities of your website. It leverages a custom search index to deliver quick and precise search results.

WP Loupe employs the Loupe search engine to construct a search index for your posts and pages. The search index is stored in a SQLite database, which is automatically updated when a post or page is created or updated.

Key Features

(This is my to-do list, not all features are implemented yet)

• Automatic update of search index upon creation or modification of a post or page.
• Tolerant to typos (based on the State Set Index Algorithm and Levenshtein)
• Supports phrase search using " quotation marks
• Supports stemming
• Utilizes stop words from the WordPress translation, e.g., Norwegian bokmål.
• Auto-detects languages
• Option to reindex all posts and pages from the admin interface (Settings > WP Loupe).
• Compatible with the theme's search.php template. Tested with Twenty Twenty-Four and Twenty Twenty-Five.
• Custom post types.
• Adds processing time, as a comment, to the footer.
• Supports translation. .pot file is included in the languages folder.
• Delete posts and pages from the search index when they are deleted.
• Pagination.
• Categories, tags, and custom taxonomies.
• Custom fields.
• Filter search results (AND, OR, IN, NOT IN, etc.)
• Multisite support, including the option to index all sites in a network.
• Multisite support. Select which sites to index.
• Multisite support. Select which site to do search from.
• (Under consideration) Supports filtering (and ordering) on any attribute with any SQL-inspired filter statement

Installation Methods

• Manual installation via command line using git and composer.
• Installation using composer require soderlind/wp-loupe
• Download the latest release wp-loupe.zip file and install from the WordPress admin interface (Plugins > Add New > Upload Plugin).
• Install directly from the WordPress admin interface (Plugins > Add New > Search for "WP Loupe").

The wp-loupe.zip file can also be found in the "Assets" section of the latest release.

After installation, activate the plugin and navigate to Settings > WP Loupem and click the Reindex search index button, to reindex all posts and pages.

How to Use

Searching

• Hello World will search for posts containing Hello or World.
• "Hello World" will search for posts containing the phrase Hello World.
• Hello -World will search for posts containing Hello but not World.

Usage

• The search index is automatically updated when a post or page is created or updated.
• To add older posts or pages to the search index, navigate to Settings > WP Loupe, and click the Reindex search index button.
• Add custom post types to the search index by selecting the post type in the Settings > WP Loupe admin page, or by adding the post type to the wp_loupe_post_types filter (see below).

Filters

1. wp_loupe_db_path: This filter allows you to change the path where the Loupe database files are stored. By default, it's in the WP_CONTENT_DIR .'/wp-loupe-db' directory.

add_filter( 'wp_loupe_db_path', WP_CONTENT_DIR . '/my-path' );

2. wp_loupe_post_types: This filter allows you to modify the array of post types that the WP Loupe plugin works with. By default, it includes 'post' and 'page'.

add_filter( 'wp_loupe_post_types', [ 'post', 'page', 'book' ] );

3. wp_loupe_filterable_attribute_{$post_type}: This dynamic filter allows you to modify the array of filterable attributes for each post type. By default, it includes 'post_title' and 'post_content'.

add_filter( "wp_loupe_filterable_attribute_book", [ 'post_title', 'author', 'isbn' ] );

4. wp_loupe_posts_per_page: This filter allows you to modify the number of search results per page. By default it's 10, set in WPAdmin->Settings->Reading "Blog pages show at most".

add_filter( 'wp_loupe_posts_per_page', 20 );

Acknowledgements

WP Loupe is built upon Loupe. Loupe is licensed under the MIT license.

Copyright and License

WP Loupe is copyright © 2024 Per Søderlind.

WP Loupe is open-source software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.

WP Loupe is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See LICENSE for more information.