Views Hooks

add_filter('celersearch_shortcodes', function($shortcodes) {
    // Add a custom shortcode
    $shortcodes[] = new MyCustomShortcode();

    // Remove the default search shortcode
    $shortcodes = array_filter($shortcodes, function($sc) {
        return !($sc instanceof \CelerSearch\Shortcodes\SearchShortcode);
    });

    return $shortcodes;
});

add_filter('celersearch_shortcode_atts', function($atts, $tag) {
    // Override limit for the search shortcode
    if ($tag === 'celersearch') {
        $atts['limit'] = 20;
    }

    return $atts;
}, 10, 2);

add_filter('celersearch_view_config', function($config) {
    // Force live mode for all views
    $config['mode'] = 'live';

    // Set higher default limit
    $config['limit'] = 24;

    // Change debounce timing
    $config['debounce'] = 500;

    return $config;
});

add_filter('celersearch_view_search_js_config', function($config, $view) {
    // Add custom data for JS
    $config['customEndpoint'] = rest_url('my-plugin/v1/search');

    // Modify facet labels
    $config['facetLabels']['taxonomies.custom_tax'] = 'My Taxonomy';

    return $config;
}, 10, 2);

add_filter('celersearch_view_facet_labels', function($labels, $view) {
    // Add custom taxonomy label
    $labels['taxonomies.genre'] = 'Genre';

    // Rename existing label
    $labels['taxonomies.category'] = 'Topic';

    return $labels;
}, 10, 2);

add_filter('celersearch_view_facet_attributes', function($facet_attributes, $index) {
    // Add a custom facet
    $facet_attributes[] = 'in_stock';
    $facet_attributes[] = 'ratings.average_rating';

    return array_unique($facet_attributes);
}, 10, 2);

add_filter('celersearch_view_search_params', function($params, $query, $index) {
    // Add custom filter
    $params['filters'][] = [
        'field'    => 'visibility',
        'operator' => '=',
        'value'    => 'public',
    ];

    // Modify highlighting
    $params['highlighting']['fields'] = ['title', 'content', 'excerpt'];

    return $params;
}, 10, 3);

[
    'limit'        => 12,
    'offset'       => 0,
    'facets'       => ['taxonomies.category', ...],
    'highlighting' => [
        'enabled'  => true,
        'fields'   => ['title', 'content'],
        'pre_tag'  => '<em class="celersearch-highlight">',
        'post_tag' => '</em>',
    ],
    'filters'      => [...],
    'sort'         => [...],
]

add_filter('celersearch_page_has_celersearch_content', function($has, $page) {
    // Support a page builder that stores its canvas in custom meta
    $builder_data = get_post_meta($page->ID, '_my_builder_data', true);
    if (is_string($builder_data) && stripos($builder_data, '[celersearch') !== false) {
        return true;
    }

    return $has;
}, 10, 2);