Developer hooks

Reference for the nine Wow Chat for Woo filter hooks — search results, strategy and dictionary, default-search takeover, related and FBT IDs, chat config, suggestions and the FAQ prompt.

Last updated Sep 4, 2026 · applies to v0.2.1

Conventions

All hooks are WordPress filters. Add them from a small custom plugin or your theme’s functions.php. Return the (possibly modified) first argument.

Filters

wow_chat_for_woo_search_results

Instant search

Filter the ranked list of product results before they are returned to the storefront.

add_filter( 'wow_chat_for_woo_search_results', function ( $results, $query ) {
    // e.g. drop products from a hidden category
    return array_values( array_filter( $results, fn( $r ) => ! has_term( 'archive', 'product_cat', $r['id'] ) ) );
}, 10, 2 );

wow_chat_for_woo_search_strategy

Instant search

Adjust how the search decides between exact SKU matching, FULLTEXT ranking and fallbacks.

add_filter( 'wow_chat_for_woo_search_strategy', function ( $strategy, $query ) {
    return $strategy;
}, 10, 2 );

wow_chat_for_woo_search_dictionary

Instant search

Extend or trim the vocabulary built from categories, tags, brands and attributes.

add_filter( 'wow_chat_for_woo_search_dictionary', function ( $terms ) {
    $terms[] = 'gore-tex';
    return $terms;
} );

wow_chat_for_woo_replace_default_search

Instant search

Programmatically decide whether Wow Search takes over the theme’s default search box.

add_filter( 'wow_chat_for_woo_replace_default_search', '__return_true' );

wow_chat_for_woo_fbt_ids

Frequently Bought Together widget

Filter the product IDs shown as frequently bought together (based on WooCommerce cross-sells).

add_filter( 'wow_chat_for_woo_fbt_ids', function ( $ids, $product_id ) {
    return $ids;
}, 10, 2 );

wow_chat_for_woo_chat_config

Chat & product finder

Modify the configuration object passed to the storefront chat (labels, palette, surface, cards per answer).

add_filter( 'wow_chat_for_woo_chat_config', function ( $config ) {
    $config['launcherLabel'] = 'Ask us';
    return $config;
} );

wow_chat_for_woo_storefront_suggestions

Chat & product finder

Filter the quick-reply suggestion chips shown above the chat input.

add_filter( 'wow_chat_for_woo_storefront_suggestions', function ( $suggestions ) {
    $suggestions[] = 'Gift ideas';
    return $suggestions;
} );

wow_chat_for_woo_faq_generate_prompt

AI FAQ Generator

Adjust the prompt your server sends to OpenAI when drafting FAQ entries.

add_filter( 'wow_chat_for_woo_faq_generate_prompt', function ( $prompt, $context ) {
    return $prompt . "\nAlways mention that shipping is free over $75.";
}, 10, 2 );

Building from source

The plugin ships compiled assets and the source to reproduce them. Build tooling is @wordpress/scripts with the configuration in webpack.config.js and tsconfig.json; dependencies are declared in package.json.

npm install
npm run build

PHP dependencies in composer.json are development-only (PHPUnit, WordPress Coding Standards). Run the PHP tests with:

composer install
vendor/bin/phpunit

Reporting issues

Use the WordPress.org support forum or open an issue via the plugin’s homepage.