MyListing Quick Search Addon
The {CODICTS} MyListing Quick Search Addon plugin extends MyListing’s built-in quick search (the instant/autocomplete search bar) to include additional result sections beyond the default listing results. When activated, the search dropdown also shows matching blog posts, pages, and post categories — letting users discover all your site’s content directly from the search bar.
The plugin also renames the default MyListing “categories” section header to “Listing categories” to clearly distinguish it from the newly added “Post categories” section
Installation & Activation
Start by downloading the plugin from the Downloads page on your dashboard on the CoDicts website.
After downloading, install and activate the plugin in WordPress by navigating to “Plugins” > “Add New” > “Upload Plugin” and selecting the downloaded zip file. Click “Install Now” and then “Activate”.
The plugin works immediately after activation — no settings page or configuration required. The additional search sections appear automatically in MyListing’s quick search dropdown.
Key Features
| Feature | Description |
|---|---|
| Posts in Quick Search | Surfaces WordPress blog posts matching the search term, showing up to 5 results with thumbnails. |
| Pages in Quick Search | Surfaces WordPress pages matching the search term, showing up to 5 results with thumbnails. |
| Post Categories in Quick Search | Surfaces WordPress post categories matching the search term, showing up to 2 results with icons and colors. |
| Listing Categories Rename | Renames the default MyListing “categories” header to “Listing categories” for clarity alongside the new “Post categories” section. |
| Section Toggle Filters | Developer filters to individually enable or disable each new section via PHP. |
| Fallback Thumbnails | Uses MyListing’s default marker image when a post or page has no featured image. |
| Translation Ready | Fully translatable with included .pot file. |
How It Works
By default, MyListing’s quick search only returns listings and listing categories. This plugin hooks into the same search system and adds three new sections to the dropdown results:
| Section | Content | Max Results | Appears When |
|---|---|---|---|
| Post | WordPress blog posts matching the search term | 5 | At least one post matches |
| Pages | WordPress pages matching the search term | 5 | At least one page matches |
| Post categories | WordPress post categories matching the search term | 2 | At least one category matches |
Each section only appears if there are matching results. If no posts match, the Posts section is simply not shown — the same for Pages and Post Categories.
What Each Result Displays
Post and Page results show a thumbnail (the featured image, or a default placeholder if none is set) and the title, linking to the post or page.
Post Category results show the category icon and color (as configured in MyListing’s term editor) and the category name, linking to the category archive page.
Additionally, the default MyListing “categories” section header is renamed to “Listing categories” so users can clearly tell the difference between listing categories and post categories.
Disabling Individual Sections
You can disable any of the three new sections by adding a filter to your theme’s functions.php file or a custom plugin. This is useful if you only want some of the sections, or if you want to conditionally show them.
Disable the Posts section:
add_filter( 'codicts-mylisting-quick-search-addon::add-post-section', '__return_false' );Disable the Pages section:
add_filter( 'codicts-mylisting-quick-search-addon::add-page-section', '__return_false' );Disable the Post Categories section:
add_filter( 'codicts-mylisting-quick-search-addon::add-post-categories-section', '__return_false' );You can combine these filters. For example, to show only Pages and hide Posts and Post Categories:
add_filter( 'codicts-mylisting-quick-search-addon::add-post-section', '__return_false' );
add_filter( 'codicts-mylisting-quick-search-addon::add-post-categories-section', '__return_false' );Conditional example — only show Posts for logged-in users:
add_filter( 'codicts-mylisting-quick-search-addon::add-post-section', function( $enabled ) {
return is_user_logged_in();
} );Frequently Asked Questions
Does this require a child theme?
No. The plugin uses filter-based integration and does not copy any template files. It works with both the MyListing parent theme and any child theme.
Is there a settings page?
No. The plugin works automatically once activated with zero configuration. Use PHP filters to toggle individual sections if needed (see the section above).
How many results are shown per section?
Posts show up to 5 results, Pages show up to 5 results, and Post Categories show up to 2 results. These limits are built into the plugin.
Can I change the number of results shown?
Not from the admin. The result limits are set directly in the plugin code.
Can I disable a specific section?
Yes. Use the provided PHP filters — see the “Disabling Individual Sections” section above for code examples.
Why was “categories” renamed to “Listing categories”?
Because the plugin adds a new “Post categories” section. Without the rename, there would be two sections labeled “categories” which would be confusing. The rename clarifies that MyListing’s default section shows listing-type categories, while the new section shows WordPress post categories.
What happens if a post or page has no featured image?
The plugin falls back to MyListing’s default marker image as a placeholder thumbnail.
Does the plugin support custom post types?
No. The plugin only adds sections for standard WordPress posts, pages, and the post category taxonomy. Custom post types are not included.
Will this slow down the quick search?
The plugin adds three additional database queries per search request. On most sites this overhead is negligible. On sites with very large amounts of content, there may be a small amount of added latency.
What happens when I deactivate the plugin?
The quick search immediately reverts to the default MyListing behavior (listings and listing categories only). No data is stored or deleted — the plugin is purely filter-based. Re-activating restores the additional sections.
Troubleshooting
New Sections Not Appearing in Quick Search
| Cause | Solution |
|---|---|
| No matching content | Each section only appears if there are matching results. Try searching for a term that matches a known blog post, page, or category name. |
| Section disabled via filter | Check your theme’s functions.php or custom plugins for filters that return false for the section toggle filters (e.g., codicts-mylisting-quick-search-addon::add-post-section). |
| Plugin not activated | Go to Plugins → Installed Plugins and verify the plugin is active. |
| MyListing not active | The MyListing theme must be active. Check Appearance → Themes. |
Post or Page Results Missing Thumbnails
| Cause | Solution |
|---|---|
| No featured image set | The plugin uses each post’s featured image. If none is set, MyListing’s default marker image appears as a placeholder. Set featured images on your posts and pages for proper thumbnails. |
Post Categories Not Showing Icons or Colors
| Cause | Solution |
|---|---|
| Category not configured in MyListing | Post category icons and colors come from MyListing’s term editor. Edit your post categories and set an icon and color for them to display properly in search results. |
Two “Categories” Sections with Same Name
| Cause | Solution |
|---|---|
| Another plugin or customization interfering | The plugin renames MyListing’s default “categories” header to “Listing categories.” If both sections show the same name, another plugin may be overriding the rename. Check for conflicting filters on mylisting/quicksearch/sections. |
“MyListing Theme Not Detected” Error
The MyListing theme must be installed and active. Go to Appearance → Themes to verify.
For further support, visit codicts.com or contact us at support@codicts.com.