> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/working-with-other-plugins.md).

# Working with other plugins

How Cross Selling Pro works together with the InsightSearch search plugin, the cogi Commander, the progress bar, configurator plugins and themes.

Cross Selling Pro works on its own. Some plugins in the same shop add useful extras, though: the InsightSearch search plugin, the cogi Commander as a key figures overview, the progress bar and plugins for products that are designed before purchase. This page shows what happens in each case, which requirements apply and where you set it up.

{% hint style="info" %}
Cross Selling Pro does **not** need the search plugin. All combinations described here are optional. If a plugin is missing, Cross Selling Pro behaves as usual.
{% endhint %}

## InsightSearch search plugin

If the InsightSearch search plugin is installed in the same shop, the search can show products from Cross Selling Pro. There are two features. You set up both in the **search plugin**. The Cross Selling Pro admin has no setting for them.

### Replacement products for searches without results

If a search finds nothing, the search asks Cross Selling Pro for products that match the search term. This is based on the AI similarity of the products.

* **In the search overlay**, these products only appear if the search itself could not rescue the query. A relaxed or corrected search takes priority. If there is no answer after about 1.5 seconds, the regular replacement products of the search stay in place.
* **On the search results page**, the search waits for one second at most. If an error occurs, the regular replacement products stay in place as well.
* If you show your own shopping experience for zero results, the products are only added if "Replacement products in addition to the no-results CMS page" is switched on in the search plugin.
* The number follows the search setting "Number of popular products". The heading in the shop reads "You may be interested in".
* Only the placement and the search term are sent, no customer identifier. These replacement products are therefore not personalised.

{% hint style="info" %}
Replacement products from Cross Selling Pro are available from the Starter plan. In the Basic plan, the regular replacement products of the search are used.
{% endhint %}

### "Goes with …" in the search overlay

After the results, the overlay loads up to four complementary products for the **first** result. The heading reads "Goes with" followed by the product name. Products already shown as results do not appear there.

* There is one request per search query. If the visitor keeps typing, the previous request is cancelled.
* If nothing comes back or it takes longer than about 1.5 seconds, the section does not appear.
* The cards only show an add-to-cart button if "Add-to-cart button in the search overlay" is switched on in the search plugin. For variants, the button reads "Choose options".
* This feature uses the type "Similar products (alternatives)" and is already included in the Basic plan.

### Requirements for the link between both plugins

The search only enables both features if all of the following apply:

1. Cross Selling Pro is installed **and active**.
2. Cross Selling Pro is connected, which means the setup wizard has been completed.
3. A source is assigned to the visitor's sales channel and language. You set this in the Cross Selling Pro plugin dashboard under **System → Settings** in the language assignment.
4. The respective feature is switched on in the search plugin and included in your plan.

If any of these does not apply, visitors see nothing of it in the shop: no empty area, no placeholder. Search engines and crawlers never receive these products.

### Settings in the search plugin

You find the switches under **Extensions → My extensions → InsightSearch (search plugin) → Configure**.

| Setting                                                          | Card                           | Effect                                                                           | Default |
| ---------------------------------------------------------------- | ------------------------------ | -------------------------------------------------------------------------------- | ------- |
| ""Goes with" in the search overlay"                              | "Search configuration"         | Shows complementary products for the first result in the overlay                 | on      |
| "Replacement products from Cross-Selling Pro - KI Cross Selling" | "No results & related results" | Fetches replacement products from Cross Selling Pro for searches without results | on      |

If the plugins are not linked, the search shows the switches as "off" and locked, with a note on what is missing. Your saved value is kept. If Cross Selling Pro is not installed at all, a link "View in the Shopware Store" appears.

### Quota, statistics and cart

* Every request from the search counts towards the monthly request quota of **Cross Selling Pro**. If the quota is used up in the Basic plan, the search behaves as if the plugins were not linked.
* If a visitor adds such a product to the cart, the line item carries the recommendation marker. The revenue then counts as revenue from recommendations.
* Clicks on "Goes with …" are recorded in the Cross Selling Pro tracking.

### Other points of contact

* **Fallback image:** If no "Image for products without an image" is selected in Cross Selling Pro under the card "Product images", the plugin uses the fallback image of the search plugin. If that is missing too, a grey placeholder appears.
* **Visitor recognition:** Both plugins recognise visitors and visits in the same way. A visit ends after 30 minutes without activity.
* **Old slider of the search plugin:** The search plugin ships a shopping experience block "Cogi recommendation slider (deprecated)". For new pages, please use the blocks from the category "AI CrossSelling" of Cross Selling Pro.

## cogi Commander

The cogi Commander ("cogi Commander | Analytics, Statistics & more") is a separate plugin by codegiganten GmbH. It collects the key figures of all cogi plugins in the shop and shows one tile per plugin. Cross Selling Pro reports its figures from version 2.2.1 (Shopware 6.7) or 1.4.1 (Shopware 6.6).

{% hint style="info" %}
The figures in the Commander are a separate count within the shop. They do not have to match the statistics in the plugin dashboard exactly. For precise analysis, use the Cross Selling Pro statistics.
{% endhint %}

### The tile

The tile is called "cogi InsightSearch cross-selling" with the description "Impressions, clicks, cart and revenue from recommendations." The main key figure is revenue. A trend chart and tables are added.

| Key figure                           | Broken down by  |
| ------------------------------------ | --------------- |
| "Recommendation impressions"         | Placement       |
| "Booster shown"                      | Display mode    |
| "Booster product seen"               | Display mode    |
| "Booster dismissed"                  | Display mode    |
| "Recommendation clicks"              | Placement       |
| "Added to cart from recommendations" | Placement       |
| "Orders with recommendations"        | not broken down |
| "Revenue from recommendations"       | Placement       |

Placements are, for example, sliders in shopping experiences, offcanvas, cart page, checkout interstitial page, customer account, bundle/set and the two features in the search. "Booster" here means the **Conversion Booster**, not the boosters in a template.

### How counting works

* Impressions and clicks come from the browser. They therefore follow the setting "Events from the browser" in the card "Tracking" and only appear if Cross Selling Pro is connected.
* "Added to cart" counts every line item with the recommendation marker. The main product of the Conversion Booster does not count.
* Orders count once per order. Revenue is the sum of the recommendation line items after proportional discount, converted into the default currency.
* Cancellations are not deducted in the Commander.
* The plugin filters out bots and crawlers beforehand.

### If the Commander is not installed (yet)

If the Commander is not installed, Cross Selling Pro writes daily totals to its own table in the shop. These totals stay in the shop for 90 days. If you install the Commander later, it collects them every hour.

{% hint style="warning" %}
The Commander has the switch "Collect touchpoints reported by cogi Suite plugins" (default on). If it is off, the Commander discards the figures. They are then not stored in between either and are lost.
{% endhint %}

Older orders and their revenue can be added once via the command line. Past impressions, clicks and cart actions cannot be added, because the shop never stored them. The command is described on the page [Technical operation](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/technical-operation.md).

## Progress bar (milestone recommendations)

With the progress bar plugin by codegiganten GmbH, products whose price closes the gap to the next goal move to the front in the offcanvas and on the cart page, for example "20 € left until free shipping". You need the progress bar from version 2.5.0 (Shopware 6.7) or 1.4.0 (Shopware 6.6), installed, active and switched on in its settings. You find the settings under **Delivery → Placements → Milestones**. Everything else is on the page [Milestone recommendations](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/milestone-recommendations.md).

## Printess, Custom Products and custom configurators

Products that have to be designed before purchase are **never added directly** to the cart from a recommendation. The settings are in the plugin configuration.

| Card                                 | Setting                                | Effect                                                                                          | Default             |
| ------------------------------------ | -------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------- |
| "Printess"                           | "Support Printess products"            | The tile shows "Design now" and opens the editor                                                | on                  |
| "Printess"                           | "Open the editor in a modal"           | Opens the editor in a window. If off, or if the editor does not start: goes to the product page | on                  |
| "Custom Products"                    | "Support Custom Products"              | Detects products with an active template from Shopware Custom Products                          | on                  |
| "Custom Products"                    | "Button on the recommendation tile"    | Link "View product", link with the regular details label, or "Hide the button"                  | Link "View product" |
| "Custom configurator (custom build)" | "Support a custom configurator plugin" | Fields for other configurator plugins (custom fields, selectors, buy widget container)          | off                 |

* In bundles and sets, such products can never be selected.
* If a configurator product is added to the cart from a recommendation without being designed, the shop rejects it and shows a notice in the cart. The regular product page is not affected.

{% hint style="warning" %}
If you set up a custom configurator and switch off "Open the configurator in a modal" there, **all** configurator products open on the product page, including Printess products.
{% endhint %}

## Themes

The plugin ships its own layouts for sliders, offcanvas, bundle/set and Conversion Booster. It contains specific adjustments for Zenit themes: Zenit only shows the buy button on product cards on hover and places it over the price. In the recommendation cards, the plugin brings the button back and makes it visible. Notes on compiling the theme are on the page [Technical operation](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/technical-operation.md).

## Other Shopware features

* **Wishlist:** If the wishlist is active in Shopware, the type "Inspired by your wishlist" can use the saved items as starting products (from the Expert plan).
* **Customer groups and visibility:** "Only show products the customer may see" (card "Visibility", default on) checks every recommendation against the visibility in Shopware. This also applies if other plugins release products only for certain customer groups.
* **Cookie notice:** The plugin adds its cookies to the Shopware cookie notice itself. If you use a different consent tool, check whether it picks up these entries. Details on the page [Tracking and data protection](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/tracking-and-data-protection.md).

## Read more

{% content-ref url="/pages/aWOVJOLpaxjqIBUOS3rz" %}
[Milestone recommendations](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/milestone-recommendations.md)
{% endcontent-ref %}

{% content-ref url="/pages/I6Hh3YL63avRayt05N4A" %}
[Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/statistics.md)
{% endcontent-ref %}

{% content-ref url="/pages/2ZVSAniefBU0WuizMlL8" %}
[Technical operation](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/technical-operation.md)
{% endcontent-ref %}

{% content-ref url="/pages/H7hG7KNHBotOdMhNijf5" %}
[Requirements and plans](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/requirements-and-plans.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/working-with-other-plugins.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
