Configure the Sooqr Connect extension

Enable

Master switch for the entire module. When disabled, no feeds are generated and the search overlay won't load.

Version

Shows the installed module version. Useful for support requests.

Environment

Choose between Production and Staging environments.

When to use Staging: Testing feed configuration before going live. Staging feeds don't affect your production Spotler search.

Sooqr Account ID

Your unique Spotler account identifier. Format: SQ-123456-1

Where to find it: In your Spotler dashboard under account settings.

Important: This is configured per store view, not globally. Switch to the specific store view in the scope selector before entering.

Debug Mode

Logs detailed information about feed generation and API calls.

Log location: var/log/sooqr-debug.log

When to enable: Troubleshooting feed generation issues or investigating why products are missing.

Enable

Turns feed generation on or off. Separate from the main module enable - you can have the module active but pause feed generation.

Filename

The XML feed filename. Default works fine for most stores.

When to customize: Multi-brand setups where you need distinct filenames per store view.

Cron Frequency

How often the feed auto-generates via cron.

Options: Every hour, every 2 hours, every 6 hours, daily, etc.

Recommendation: Daily is usually sufficient. More frequent updates only needed for fast-changing catalogs (flash sales, auctions).

Batch Size

Number of products processed per batch during generation.

When to adjust: Lower if you're hitting memory limits during generation. Higher for faster generation on powerful servers.

Feeds Table

Shows generated feeds per store view with URLs. Copy these URLs to configure in Spotler.

Maps your Magento attributes to Spotler's expected fields.

Name

Product name attribute. Default (Product Name) works for most stores.

When to change: If you have a marketing-specific name attribute different from the catalog name.

SKU

Product identifier. Usually left as default SKU.

Description

Product description for search results and indexing.

Options: Use description or short_description depending on what you want searchable and displayed.

Tip: Short descriptions often work better in search result previews.

Brand

Manufacturer or brand attribute.

Why it matters: Enables brand faceting in Spotler search. Customers can filter by brand.

Common attribute names: manufacturer, brand, merk

Image Source

Where to get product images from.

Options: Base Image, Small Image, Thumbnail

Recommendation: Base Image for best quality. Spotler resizes as needed.

Extra Fields

Add custom attributes to your feed. Use this to enable additional facets or searchable fields in Spotler.

How it works: Map a Magento attribute to a custom field name. Spotler can then use this for filtering or search boosting.

Example uses:

• Color attribute for color filtering
• Material for material facet
• Season for seasonal filtering

Add Product Review Score

Includes the average rating in the feed.

When to enable: If you want to show star ratings in search results or allow sorting by rating.

Note: Adds some processing time to feed generation.

Configure how configurable, bundle, and grouped products are handled. This is crucial for getting the right products in your search results.

Configurable Products

Use Configurable/Simple Products

Determines what gets exported for configurable products.

Recommendation: "Only Linked Simple Products" - customers search for specific variants (red shirt, size M).

Use Parent URL for Simples

Whether simple products link to the configurable product page.

Recommendation: "Yes, with Auto-Link" - links directly to the right variant on the product page.

Use Parent Image for Simples

Falls back to parent image if simple has no image.

Recommendation: "Only if Empty" - uses simple's image when available, parent's as fallback.

Use Parent Data for Simples

Which attributes to inherit from the parent configurable.

Common choices: Name, Description (for consistency) Avoid selecting: Color, Size, GTIN (these should be variant-specific)

Use Fallback only on Non Visible Simples

Only applies parent data logic to simples marked "Not Visible Individually."

Recommendation: Yes - visible simples are treated as standalone products.

Bundle Products

Similar options as configurable. For bundles, you typically want:

• Use Bundle Products: "Only Bundle Product"
• Bundle is the purchasable item, not its components

Grouped Products

Similar options. For grouped products, typically:

• Use Grouped Products: "Only Grouped Product"
• The grouped page is where customers purchase

Control which products appear in the feed.

Filter on Visibility

Only include products with specific visibility settings.

When to enable: Exclude "Not Visible Individually" products that shouldn't appear in search.

Typical setup: Include "Catalog", "Search", and "Catalog, Search"

Filter by Category

Include or exclude products based on category assignment.

Use cases:

• Include: Only export products from "Searchable" categories
• Exclude: Skip products in "Hidden" or "B2B Only" categories

Note: For configurable products, simple children must also be in included categories.

Exclude Out of Stock

Removes out-of-stock products from the feed.

When to enable: If you don't want customers finding unavailable products.

Alternative: Keep them in feed but configure Spotler to show "Out of Stock" badge.

Export CMS pages to make them searchable.

Enable

Options: No, All CMS Pages, Selected CMS Pages

When to enable: If customers should find informational pages through search (FAQ, About Us, Contact).

Selection

When using "Selected CMS Pages," choose which pages to include.

Typical exclusions: Checkout pages, 404 page, private policy (unless you want these searchable).

Enable Search

Activates the Spotler search overlay on your frontend.

How it works: Injects the Spotler JavaScript that intercepts search queries and displays the Spotler results overlay.

Sooqr Loader

How the Spotler script loads.

Options:

• Automatic - Loads via standard method
• Custom - You manage the script loading yourself

Recommendation: Automatic unless you have specific performance requirements.

Statistics

Send search analytics to Spotler.

Recommendation: Yes - helps Spotler improve search relevance for your store.

For developers only. Configure if you need custom JavaScript handling.

Parent HTML node

Override the default search input selector.

When to use: Custom theme with non-standard search input markup.

Enable Debugging

Console logs for troubleshooting frontend integration.

Frontend Version

Select Spotler frontend version. Usually leave default unless Spotler support advises otherwise.

Custom JS

Add custom JavaScript configuration in JSON format.

Use case: Advanced Spotler customizations beyond standard options.

Add to Cart Controller

Enables add-to-cart directly from search results.

How it works: Provides a controller endpoint for the Spotler overlay's "Add to Cart" button.

Recommendation: Yes - improves conversion from search.

Use Ajax based Add to Cart

Add to cart without page reload.

Recommendation: Yes for better UX.

Add to Wishlist Controller

Enables wishlist additions from search results.

Add to Compare Controller

Enables compare additions from search results.