Description
FloInfo38 Search Tool is a powerful yet simple plugin that adds an Ajax-powered search form to your WordPress site. It allows visitors to search through your pages and posts with real-time results.
Features:
- Real-time Ajax search (no page reload)
- Search in pages, posts, or both
- Three shortcodes for different search types
- Customizable search options
- Exclude specific pages from search results
- Smart keyword filtering
- SEO-friendly search (includes meta titles, descriptions, and keywords)
- Relevance scoring system
- Cache system for better performance
- Basic, filterable rate limiting
- Works with page caching plugins
- Several search forms on the same page
- Responsive design
- Lightweight and fast
Available Shortcodes:
[floinfo38_search]– Search in pages and posts (based on your settings)[floinfo38_search_posts]– Search only in posts[floinfo38_search_pages]– Search only in pages
Support
For support, please contact:
* Website: https://www.floinfo38.fr
* Email: contact@floinfo38.fr
Privacy Policy
FloInfo38 Search Tool does not send any data to third parties and does not store the search terms typed by visitors. To limit abuse, a short-lived counter is kept in the WordPress database (transient): its key is a hash of the visitor’s IP address and browser user agent, and it expires after 60 seconds. The IP address and user agent are never stored in readable form.
Credits
Developed by Florian MARREL – Flo Info 38
Installation
- Upload the plugin files to the
/wp-content/plugins/floinfo38-search-tooldirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Use the FloInfo38 ST menu in the WordPress admin sidebar to configure the plugin.
- Add one of the shortcodes to any page or post where you want the search form to appear.
FAQ
How do I add the search form to my site?
Simply add one of these shortcodes to any page or post:
* [floinfo38_search] for general search
* [floinfo38_search_posts] for posts only
* [floinfo38_search_pages] for pages only
What is the minimum search length?
The search requires at least 3 characters to avoid performance issues and provide relevant results.
Can I exclude certain pages from search results?
Yes! Open the FloInfo38 ST menu in the admin sidebar and check the pages you want to exclude from search results.
Does it work with custom post types?
Currently, the plugin supports standard WordPress pages and posts. Custom post type support may be added in future versions.
Are password-protected posts searchable?
No. Password-protected posts and pages are never returned by the search.
How does the relevance scoring work?
The search assigns points based on where keywords are found:
* Title match: 30 points
* Content match: 10 points
* SEO meta match: 5 points
Results are then sorted by total score, with pages optionally prioritized.
Does it work with a page cache (WP Rocket, LiteSpeed, hosting cache…)?
Yes. The security token is refreshed through a request that is never cached, so the search keeps working on cached pages.
Can I change the rate limit?
By default, each visitor can run 60 uncached searches per minute (fixed one-minute window). You can change it with the fi38st_rate_limit_max filter (return 0 to disable it):
add_filter( 'fi38st_rate_limit_max', function () { return 120; } );
If your site is behind a reverse proxy or a CDN, use the fi38st_request_ip filter to return the real visitor IP address.
Can I disable the public search?
Yes, with the fi38st_allow_public_search filter (return false).
Changelog
2.1.0
- Remove uninstall.php on 2.0.0 and 2.0.1 (update WP error)
2.0.1
- New: uninstall.php removes the plugin settings and the search cache when the plugin is deleted
2.0.0
- Security: search results are now rendered with safe DOM methods (no HTML injection from post titles)
- Security: basic, filterable rate limiting on uncached search requests (60 per minute and per visitor by default)
- Security: password-protected posts are no longer searchable
- Fixed: search cache is now separated by search type and settings, and is invalidated reliably (also without a persistent object cache)
- Fixed: several search forms on the same page now work independently; forms added dynamically are supported
- Fixed: expired security tokens are handled again (automatic token refresh and retry)
- Fixed: searches containing numbers now work
- Fixed: searches with punctuation or isolated characters no longer return unrelated results
- Fixed: the “Clear” button no longer submits a form when the shortcode is placed inside one
- Improved: the security token is only refreshed on pages that contain a search form (no more extra request on every page)
- Improved: words containing an apostrophe, hyphen or dot are kept whole; typographic apostrophes and hyphens are treated like their ASCII equivalents
- Improved: the stop words of the site language (for example “été” in French) no longer prevent a word from being found
- Improved: fewer database queries when scoring results
- Improved: admin page filter ignores accents; admin assets are loaded on the settings page only
- Improved: the “[Page]” and “[Article]” result labels are now translatable
- New filters: fi38st_allow_public_search, fi38st_rate_limit_max, fi38st_request_ip
- New: uninstall.php removes the plugin settings and the search cache when the plugin is deleted
- Requires WordPress 6.0 and PHP 8.0 (previously 5.0 and 8.3)
1.6.0
- Admin colors now follow the site’s WordPress admin theme color instead of a fixed blue
- Tested up to WordPress 7.1
- Minor CSS cleanup in the settings page
1.5.0
- Fixed search not working for visitors on sites using a page cache (search relies on a nonce that could expire while a cached page was served to visitors)
- The plugin now automatically refreshes the security token via a request that is never cached, so search works reliably regardless of caching plugin or hosting configuration
- Search errors are now distinguished from “no results” in the browser console for easier troubleshooting
- Settings page logo is now bundled with the plugin instead of loaded from an external server
1.4.1
- Removed wp-element-button class which could break button styling on some themes
1.4.0
- Properly enqueued style CSS
- Added button classes
1.3.6
- search-results items on left
1.3.5
- Change the appearance of the admin page
- Performance optimizations
1.3.4
- Added plugin icon on admin page
1.3.3
- Introduced FI38ST_VERSION constant to centralize version management
1.3.2
- Added plugin icon
1.3.1
- Fixed plugin version on pages
1.3.0
- Tested for WordPress 7.0
1.2.0
- Fixed WordPress Coding Standards compliance
- Added proper nonce verification
- Improved security with wp_unslash() for POST data
- Added GPL v3 license header
- Improved cache management
- Fixed direct database queries
- Enhanced input sanitization
- Better error handling
- Properly enqueued all JavaScript and CSS
- Added unique prefixes to all functions and options
- Updated plugin name to “FloInfo38 Search Tool”
- Updated shortcodes to use new naming convention
1.1.0
- Added support for SEO meta fields
- Improved relevance scoring
- Added cache system
- Performance optimizations
1.0.0
- Initial release