Get Recommendor WooCommerce Documentation

When a visitor opens a product page, the plugin fires the woocommerce_after_single_product_summary action hook (priority 15) calling wc_recommendor_single_product_similar().

Executes [reco type="similar"]. If no explicit product_id attribute is supplied, it automatically resolves the current post ID from global $post->ID.

Calls Reco_Similar::get($product_id, $limit). Checks transient cache key reco_similar_{id}_{limit}. On miss, sends HTTP GET request with X-API-Key to api.getrecommendor.com/recommendations/similar.

Filters returned IDs through wc_recommendor_filter_purchasable() to prevent out-of-stock or hidden items from displaying. Loads template templates/similar-products.php.

Checks if the visitor is logged in using get_current_user_id(). For guest shoppers, it identifies session vectors via cookie reco_session_id or WooCommerce session WC()->session->get_customer_id().

Constructs transient key reco_personalized_user_{id} (or sess_{hash}). On cache miss, queries SaaS endpoint api.getrecommendor.com/recommendations/personalized with user/session parameters.

If a new guest visitor has no clickstream history, the engine automatically falls back to Reco_Trending::get() and backfills with recent in-stock items via wc_get_products().

Hooked to woocommerce_account_dashboard (priority 20) to display "Recommended for You" on customer account pages. Loads template templates/personalized-products.php.

Hooked into woocommerce_after_single_product_summary (or positioned above Add to Cart button).

Calls Reco_FBT::get($product_id) checking transient cache key reco_fbt_{id} before querying the central API.

Computes cumulative bundle price and applies configured bundle discount (wc_recommendor_fbt_discount_percent).

When shoppers click "Add Bundle to Cart", AJAX submits selected IDs to add all checked products to the WooCommerce cart simultaneously.

Monitors active WooCommerce cart items via WC()->cart->get_cart().

Calls Reco_Also_Bought::get_for_cart() passing current cart product IDs to API endpoint api.getrecommendor.com/recommendations/also-bought.

Automatically filters out items that are already in the customer's cart so shoppers are never recommended products they have already added.

Renders automatically on woocommerce_after_cart_table and woocommerce_review_order_before_payment.

Monitors single product pages. Checks ! $product->is_in_stock() or stock quantity <= 0.

Queries API for similar vector items and passes filter stock_status=instock to ensure only active, purchasable products are returned.

Prioritizes in-stock items within the same category and price band (+/- 20% of original price) to maximize purchase probability.

Renders directly below the "Out of Stock" notification badge on the single product detail page.

Script reco-search.js attaches event listeners to search inputs matching wc_recommendor_search_selector (e.g. input.search-field).

Debounces keystrokes (250ms delay) and sends AJAX request to endpoint /wp-json/recommendor/v1/search.

Renders live autocomplete dropdown with product image thumbnails, titles, prices, stock badges, and category tags.

When full_page mode is active, focusing the search box triggers an instant full-screen search modal with price range sliders and category filters.

Hooks into woocommerce_get_price_html filter to strip price HTML or replace it with custom text (e.g. "Price Upon Request").

Hooks into woocommerce_is_purchasable filter (returns false) and removes woocommerce_template_single_add_to_cart.

Renders custom quote inquiry button (wc_recommendor_catalog_btn_text) opening an interactive quote modal form.

Configurable store-wide or scoped to unauthenticated guest visitors, specific user roles (e.g. wholesale customer), or selected product categories.

Analyzes product description, attributes, and category data to auto-generate relevant question and answer pairs (Reco_FAQ::get_for_product()).

Outputs valid <script type="application/ld+json"> containing FAQPage schema for search engine rich results.

Analyzes verified WooCommerce customer reviews (Reco_Review::get_summary()) to surface key rating metrics and positive buyer highlights.

Renders inside WooCommerce Product Tabs (woocommerce_product_tabs) or standalone via shortcodes.

Hooks into woocommerce_before_shop_loop_item_title to position floating heart buttons on product images using CSS classes (reco-wishlist-top-left, reco-wishlist-top-right, etc.).

Clicking heart button triggers instant AJAX request to REST endpoint /wp-json/recommendor/v1/wishlist/toggle.

Guest wishlists are stored via LocalStorage and secure session keys. Upon logging into WooCommerce, guest wishlist items automatically merge into the user's permanent account.

Provides dedicated customer wishlist dashboard page rendered via shortcode [reco_wishlist].

Hooks into wp_footer to render floating chatbot trigger button (Bottom Right or Bottom Left).

When shoppers type questions, queries API endpoint api.getrecommendor.com/chatbot/chat using RAG (Retrieval-Augmented Generation) on your indexed product catalog.

Bot responses dynamically embed clickable product recommendation cards with image, price, and direct "Add to Cart" actions inside the chat window.

Maintains conversational context across page navigation so customers never lose chat history while browsing your store.

Validates wc_recommendor_store_id and wc_recommendor_api_key against endpoint api.getrecommendor.com/notices/latest.

Clicking "Start Bulk Sync" invokes class Reco_Sync::sync_batch(), sending product attributes in background batches of 50 items per payload.

Hooks into save_post_product and woocommerce_update_product to push real-time catalog changes without requiring manual bulk re-syncs.

Includes a 1-click "Clear Recommendation Cache" button to purge all reco_* transients store-wide.