How to Add Category Filters and Customize Search in Docy

If you are using the Docy WordPress theme and EazyDocs, you may wish to customize the Hero Search feature to filter results by specific categories, ensuring users find relevant documentation efficiently. This post outlines the requirements, technical considerations, and implementation strategies for achieving this level of customization.

Objective: Enhancing Hero Search

The primary goal is to modify the Docy Hero Search bar dropdown to display specific documentation categories (such as product-specific modules or specialized guides) instead of default post types or forums. Additionally, the search functionality should be restricted to return only titles from EazyDocs documentation within those selected categories, excluding standard blog posts or forum entries.

Functional Requirements

• Dropdown Category Filter: Replace default post type selectors in the search bar with a custom list of specific categories.
• Targeted Search Source: Ensure search results are limited to EazyDocs items associated with the selected categories.
• Versatile Placement: The filter should be configurable for use in the main Hero section, sidebars, or tabbed components.
• Scalability: The solution must support hierarchical subcategories to accommodate future content growth.
• Consistent UI: Any associated tabs should reflect the same category logic as the search dropdown.

Implementation Considerations

• Platform Limitations: Since this is not a native feature within Docy or EazyDocs, custom development is required.
• Customization Methods: Implementation is best handled via child theme modifications, template overrides, or a dedicated custom plugin.
• Taxonomy Mapping: Clearly define whether the categories originate from standard WordPress post categories or EazyDocs custom taxonomies to ensure accurate data retrieval.

Development Steps

1. Identify Data Sources: Verify the taxonomy structure of your EazyDocs content.
2. Customize the Dropdown: Implement a custom select field in the Hero search form that dynamically populates with your chosen categories.
3. Refine Query Logic: Use WordPress hooks to filter search results based on the category selected by the user.
4. Ensure UI Consistency: Update secondary UI elements, such as sidebar tabs, to match the selected category filters.
5. Enable Subcategory Support: Build the query logic to handle hierarchical taxonomy terms.

Sample Code Snippet

Developers can use the following approach in a child theme’s functions.php file or a custom plugin to adjust the search query:

add_filter('pre_get_posts', 'filter_docs_by_category');
function filter_docs_by_category($query) {
    if (is_search() && !is_admin() && isset($_GET['doc_category'])) {
        $query->set('post_type', 'eazydocs');
        $query->set('tax_query', array([
            'taxonomy' => 'doc_category',
            'field' => 'slug',
            'terms' => sanitize_text_field($_GET['doc_category'])
        ]));
    }
    return $query;
}

Note: You will require additional custom code to populate the dropdown options and manage frontend template overrides.

Project Management

• Scope and Budget: Costs for such customizations generally vary based on complexity and specific requirements.
• Timeline: Implementation typically takes 2–3 business days, depending on the developer’s workload and project specifications.
• Communication: Clearly define your taxonomy requirements and content structure to your developer to ensure the solution is built correctly.

Conclusion

While Docy and EazyDocs provide a robust foundation for documentation, advanced search filtering often requires bespoke development. By defining your taxonomy structure and search behavior upfront, you can work with a qualified developer to create a seamless, category-aware search experience for your users.