<!-- TITLE: Cross-Sell Cart Popup - Magento 2 module documentation -->
<!-- SUBTITLE: Author: Marek Milewski -->
# Cross-Sell Cart Popup
## Module overview
The module allows you to display a popup after adding a product to the basket. Depending on the configuration set, the recommended products are displayed in the popup, as well as the missing value for free delivery.
## Module compatibility
This module is compatibile with Magento Community versions: **2.2**, **2.3** and **2.4**.
## How it works
After module has been installed, you should it setup. For this purpose, go to **Stores > Configuration > Catalog > Cross-Selling**
![Image 1](/uploads/cross-sell-cart-popup/1.png "Image 1")
We can choose from the following options:
![Image 2](/uploads/cross-sell-cart-popup/2.png "Image 2")
**Module Enable** - enables or disables the module
**Show Free Shipping** - show free delivery information
**Items Count** - number of products displayed in the popup
**Free Shipping Rule** - rule of free delivery
**Amount** - the amount of free delivery when choosing a fixed free delivery rule
After saving the module configuration, and adding the product to the basket in the store, a popup is displayed.
![Image 3](/uploads/cross-sell-cart-popup/3.png "Image 3")
## Demo
demo3.magecreation.com
## Installation
### Composer
1. Add repo to composer.json:
```text
"repositories": [
...
{
"type": "vcs",
"url": "git@git.auroracreation.com:aurora-modules/cross-sell-cart-popup.git"
}
...
],
```
2. Add package to composer.json:
```text
"require": {
...
"aurora/module-cross-selling": "*"
...
},
```
3. In Magento root folder run commands:
```text
composer update aurora/module-cross-selling
php bin/magento module:enable Aurora_CrossSelling
php bin/magento setup:upgrade
```
### Manual
1. Unzip archive.
2. Upload extension files on your server to:
```text
{Magento root}
└── app/
└── code
```
3. In Magento root folder run commands:
```text
php bin/magento module:enable Aurora_CrossSelling
php bin/magento setup:upgrade
```
## Changelog
### v1.2.2
- Fix return type to Collection for getCrossSellingProducts
- addeed tests (phpcs, phpunit, phpmd, phpstan) in pipelines, module refactored
### v1.2.1
- Fix return type to array for getCrossSellingProducts. Fix tests
### v1.2.0
- Selecting the pages on which the popup will be displayed
### v1.1.9
- Support for Magento 2.4.4
### v1.1.8
- Version changed
### v1.1.6
- Patch installed
### v1.1.5
- Fix cart total value
### v1.1.4
- Fix improving module dependency
### v1.1.3
- Fix js prefix
### v1.1.2
- Fix products display
### v1.1.1
- Currency added
### v1.1.0
- Add free shipping in cart
### v1.0.14
- Fix products count in popup
### v1.0.13
- Language update
### v1.0.12
- Fix button text
### v1.0.11
- Fix js file
### v1.0.10
- Fixed translations
### v1.0.9
- Update module version
### v1.0.8
- Add polish translations
### v1.0.7
- Add links to popup template / change checkout url
### v1.0.6
- Css fix
### v1.0.5
- Update to 2.3
### v1.0.4
- Add doc blocks to phpunit tests
### v1.0.3
- Fix double quotes in model
### v1.0.2
- Update
### v1.0.1
- Fix mixin for addToCart method
### v1.0.0
- Composer.json and phpunit added
### Thank you for your interest in our products!