Odoo Doofinder Integration

Before adding the installation script to your website, obtain the store identifier in Doofinder and determine the search zone.

Obtaining the Store ID

• 01
  Log in to your Doofinder account
• 02
  Go to Configuration — All stores
• 03
  Copy the Store ID

Determining the Search Zone

Determine the search zone according to the region where your online store operates.

• 01
  Open Configuration — General settings
• 02
  Find the Installation script section
• 03
  Check the script address:

• eu1 — Europe
• us1 — America
• ap1 — Asia

Search Layer Configuration in Doofinder

Search Layer integrates Doofinder search with your website's search field and displays results directly on your website via the Doofinder interface.

• 01
  Open Search — Layer Settings
• 02
  Copy .o_doofinder_product_search and paste it into the Enter the search input CSS selector field
• 03
  Click Save

Activating the Script in Odoo

After installing the module, activate the script by completing the following steps:

• 01
  Go to website settings
• 02
  Enable the Doofinder option in the Tracking and SEO section
• 03
  Paste the copied store identifier into the Store ID field
• 04
  In the Search Zone field, select your store region
• 05
  Save the settings

The module then automatically adds the Doofinder script to all pages of your Odoo website.

Confirming Doofinder Code Installation

To confirm that the Doofinder code is installed on the website, open any page of your Odoo website.

To test, log out of Odoo or use another browser, as the Doofinder installation script does not run for internal Odoo users.

Follow these steps:

• 01
  Right-click on the website page and select View page source
• 02
  Find the and tags in the page code
• 03
  Ensure that the Doofinder installation script is present between these tags in around the following format:

Doofinder recommends this check: if the script is present in the page code in this format, it is installed.

After installing the module, open the feed list to view and configure the feed according to your store's needs. Go to Website — eCommerce — Product Data Feeds.

The module comes with a ready-to-use feed template configured according to Doofinder requirements.

Feed templates are highlighted in green in the list view.

Make a copy of the feed from the template using the Duplicate action. Customize the feed copy for your needs, leaving the template unchanged as a reference.

Specifying the Website

On the Feed’s Settings tab, select the website for which the Doofinder script was previously configured and connected.

Feed Products

The feed works with product variants. If a product has multiple variants, each variant is passed to Doofinder separately.

Use the Product Filter to determine which products to include in the data feed.

Click Edit Domain to add product filters for the data feed.

The Is Published rule is required if you sell products through an Odoo eCommerce website.

Save changes by clicking Confirm. The module automatically recalculates the number of products in the feed based on the selected filters.

To view the list of feed products, click the link with the record count or the Items button at the top of the screen.

Stock Locations

The module allows you to select warehouses (locations) to calculate stock levels and product availability statuses.

Go to the Stock section on the data feed’s Settings tab and select the required Stock Locations.

As a result, the module calculates stock levels for the data feed using only the specified locations.

If you leave Stock Locations empty, the module calculates stock levels and product availability statuses for all company locations.

Doofinder supports two pricing modes. The choice of mode depends on the combination of languages, currencies, and pricelists used in the store.

Single Price mode is designed for stores where each language version of the site uses a single currency. For each language and currency combination, a separate Search Engine is configured in the Doofinder account. Doofinder dynamically determines the required Search Engine based on the site's current language and currency.

Multiprice mode is designed for stores where a single language version of the site has multiple currencies or pricelists. In this mode, one Doofinder Search Engine is used for a single language version, storing price data for all configured currencies.

By default, the feed operates in Single Price mode.

Single Price Mode Setup

Make sure the Multiprice option is disabled for Doofinder in the website settings.

On the feed form, open the Settings tab. In the Advanced section, select the website Language if multiple language versions are available. In the Prices section, select the Pricelist corresponding to the selected website language. This pricelist is used to calculate prices.

If the store uses a single language and uses prices from product cards instead of pricelists, leave the Pricelist field empty.

To send promotional prices via the data feed, fill in the Sale Pricelist field. Configure this pricelist in advance with lower product prices.

A corresponding Search Engine must be created in Doofinder for the selected language in the feed and the pricelist currency.

Multiprice Mode Setup

Enable the Multiprice option for Doofinder in the website settings.

In the Doofinder Language field, enter the store language code used in the corresponding Doofinder Search Engine. You can find the language code in your Doofinder account:

• 01
  Log in to your Doofinder account
• 02
  Select the required Store at the top of the page
• 03
  Open Configuration
• 04
  Go to Search Engines
• 05
  Find the required Search Engine under Published
• 06
  Next to the Search Engine name, a label in code(currency) format is displayed:

• en — language code
• ($) — currency

To change the Search Engine language, click the three dots to the right of the Search Engine and select Edit setup.

To automatically activate the df_multiprice column in all Doofinder feeds for the current website, click Enable df_multiprice column in settings. This column passes product prices in different currencies. To deactivate it, click Disable df_multiprice column.

Next, go to the feed form and open the Settings tab. In the Advanced section, select the website Language for which pricelists in different currencies are used.

To set up pricelists for different currencies, click the Set Pricelists link in the Multiprice section.

In the pop-up window, create a separate line for each currency. Specify the primary Pricelist and optionally select a Sale Pricelist.

After selecting pricelists, configure which price types to pass in the data feed for the df_multiprice column, which handles multi-currency prices in the feed. To do this, click Configure Prices in the Multiprice section and select the required price types in the pop-up window:

• Regular Price: Product price according to the primary pricelist
• Sale Price: Discounted product price according to the sale pricelist
• Best Price: Most favorable selling price of the product excluding taxes
• Purchase Price: Purchase price or cost price of the product

By default, Regular Price and Sale Price are selected in the feed template.

Doofinder recommends sending Best Price and Purchase Price together to obtain product margin information and use it for product promotion.

The module includes data feed columns configured according to Doofinder requirements. The columns are linked to standard fields and use Odoo's base product logic. You can reconfigure feed columns through the interface by linking them to custom product fields.

To manage columns, click Columns at the top of the window.

The list of available columns is in the table below.

Some columns in the feed template are inactive by default. Review the list and activate the ones you need.

The Сategory Column

The category column defines the eCommerce product category hierarchy and allows choosing whether to send a single product category or all categories to which it belongs.

Open the category column in the available columns list. Here you can configure the Export All Categories toggle, which determines whether to send all product categories or only one.

By default, sending all product categories is enabled.

Additional Product Attributes

You can send additional product attributes to Doofinder that do not belong to standard feed fields — for example, material, color, size, or other characteristics used in your online store.

A separate column must be created and configured for each characteristic.

In the column list, click New to create a new column.

On the new column form, enter the column title in the Name field, select Special as Type, select Product Attribute in the Special Type field, and then choose the desired attribute from the Attribute drop-down list.

Use a single lowercase word for the column name, e.g., color.

If a product has multiple values for the selected characteristic, enable Export all Attribute values to send all available values via the feed.

By default, all values are sent via the data feed for additional product attributes.

You can configure the data feed for Doofinder at the product level. Odoo product data feed modules by Garazd Creation include extensions that allow you to enrich your products in Odoo with additional information and share it via the feed:

• Product Brands for Data Feeds — adds the ability to specify the product brand
• Number Fields for Data Feeds — adds fields for international numbers and product codes
• Product Data Feed — adds specific settings according to the analytics system or marketplace

Below are the product settings relevant to Doofinder.

Brand

To specify a brand, open a product on the General Information tab and fill in the Brand field.

Codes

Specify product codes, such as GTIN and MPN, on the Extra tab in the Codes section.

To connect a data feed to Doofinder, you need a configured data feed and a Doofinder account.

Feed Preview

Before connecting the data feed to Doofinder, click Preview to view the configuration result.

Generated feed preview:

How to Connect the Feed to Doofinder

To add a product feed to your Doofinder account, first copy the URL of the required data feed in Odoo.

In your Doofinder account, select the required Store at the top of the page. Go to Configuration — Search Engines, find the required Search Engine in the Published list, and select See indices.

Follow these steps:

• 01
  Click Add Source
• 02
  Paste the copied feed URL into the field and click Add
• 03
  Click Process Now

After processing the feed, Doofinder displays an indexing result message (successful or unsuccessful). If successful, it shows the number of indexed products.

On the same page below, in the Configuration section:

• Configure automatic update frequency
• Enable Group variants as a single item if using group_id and group_leader
• If needed, add feed fields that are not indexed by default under Additional indexed fields

Some additional product attributes and user-created feed columns may not be indexed in Doofinder by default.

Results Preview

You can use Results Preview to test the Search Engine and verify how Doofinder displays products from your feed taking into account transmitted columns. To do this, go to Admin Panel — Search.

The number of displayed products may be smaller than the total feed count if Group variants as a single item is enabled—in this case, variants of a single product are grouped and shown as one item.

Click + to expand detailed product information and check the fields and values sent in the feed.