https://github.com/convert-cart/magento2-plugin
This plugin integrates with Magento 2 to track user behavior and synchronize essential ecommerce data for enhanced recommendations.
https://github.com/convert-cart/magento2-plugin
conversion-rate-optimization magento2-cro recommendation-engine
Last synced: 29 days ago
JSON representation
This plugin integrates with Magento 2 to track user behavior and synchronize essential ecommerce data for enhanced recommendations.
- Host: GitHub
- URL: https://github.com/convert-cart/magento2-plugin
- Owner: convert-cart
- Created: 2024-07-10T17:30:26.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-10-23T08:26:12.000Z (4 months ago)
- Last Synced: 2026-01-14T13:59:23.945Z (about 1 month ago)
- Topics: conversion-rate-optimization, magento2-cro, recommendation-engine
- Language: PHP
- Homepage: https://www.convertcart.com
- Size: 287 KB
- Stars: 0
- Watchers: 1
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Convert Cart Magento 2 Plugin
[](https://packagist.org/packages/convert-cart/analytics)
## Table of Contents
- [Introduction](#introduction)
- [Features](#features)
- [Installation](#installation)
- [Composer Installation](#composer-installation)
- [Manual Installation](#manual-installation)
- [Configure Domain Id](#configure-domain-id)
- [Troubleshooting](#troubleshooting)
- [Contact](#contact)
## Introduction
Welcome to the Magento 2 Plugin by Convert Cart. This plugin integrates seamlessly with Magento 2 ecommerce websites, enabling the tracking of user behavior. Additionally, it synchronizes crucial data such as product catalogs, order histories, customer profiles, and category information to our servers on a regular basis. This synchronization powers our recommendation engine, providing personalized and data-driven insights to enhance your ecommerce operations.
## Features
- Script injection on the frontend for user behavior tracking.
- Token generation for synchronizing product/order/customer/category data to Convert Cart servers for recommendations.
- Product deletion tracking to avoid recommending deleted products to the visitors of the store.
## Installation
### Composer Installation
1. Run the following command in the root folder of your Magento installation when the domain is added in app.convertcart.com (for production):
```sh
composer require convert-cart/analytics
```
If you're intending to setting up a domain in app-beta.convertcart.com (for beta testing), please use tag name followed by the suffix `-beta` like `1.0.14-beta`. The command will be like,
```sh
composer require convert-cart/analytics:1.0.14-beta
```
If you wanted to know the exact changes that's needed to setup a beta server on a production tag, you can take a look into this [commit](https://github.com/convert-cart/magento2-plugin/commit/7fcd6766d00aa0c1f9c24365864a5738bc893252).
2. After installing via Composer, run the following commands from the Magento root directory:
```sh
php bin/magento maintenance:enable
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento maintenance:disable
php bin/magento cache:flush
```
### Manual Installation
1. Download the latest version of the plugin from the [releases](https://github.com/convert-cart/magento2-plugin/releases) page.
2. Extract the downloaded archive.
3. Upload the contents to the `app/code/convert-cart/analytics` directory of your Magento installation.
4. Run the following commands from the Magento root directory:
```sh
bin/magento module:enable Convertcart_Analytics
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:clean
bin/magento cache:flush
```
## Configure Domain Id
Please reach out to your Customer Support Manager to Configure your domain with Convert Cart.
## Troubleshooting
If you encounter issues, try the following steps:
1. Ensure the plugin is enabled: `bin/magento module:status Convertcart_Analytics`
2. Clear Magento cache: `bin/magento cache:clean`
3. Check the logs in `var/log` for any error messages.
## Uninstall
Please use the following command to uninstall the plugin and delete all the tables and settings related to the plugin,
bin/magento module:uninstall Convertcart_Analytics
### Setting up folder & file permissions,
If you encounter folder permission issues on folder such as cache, please use the following commands to set the appropriate permissions for public files and directories:
- Goto magento2 directory
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;
find var pub/static pub/media app/etc generated/ -type f -exec chmod g+w {} \;
find var pub/static pub/media app/etc generated/ -type d -exec chmod g+ws {} \;
chown -R : . #(usually by default magento user and we user used to be www-data, check it with your server administrator)
chmod u+x bin/magento
- 644 sets files to read and write for the owner, and read-only for group and others.
- 755 sets directories to read, write, and execute for the owner, and read and execute for group and others.
## Contact
Please contact [sales@convertcart.com](mailto:sales@convertcart.com) if any issues occur during the integration process.
## For Development
### Code Quality: PHPCS and PHPCBF
- **PHP_CodeSniffer (PHPCS):**
- Used to check your code for compliance with Magento 2 and PHP coding standards.
- Run `phpcs .` in the project root to see all coding standard violations and warnings.
- **PHP Code Beautifier and Fixer (PHPCBF):**
- Used to automatically fix many coding standard violations found by PHPCS.
- Run `phpcbf .` in the project root to auto-fix fixable issues.
> **Note:** PHPCS and PHPCBF are installed as development dependencies. If you do not have them globally, you can run them via Composer:
> ```bash
> ./vendor/bin/phpcs .
> ./vendor/bin/phpcbf .
> ```
After making any changes to the master branch, you can create new version tags (for beta and production) by running the following command:
bash tagger.sh VERSION_NUMBER
Make sure to replace `VERSION_NUMBER` with the actual version number you want to create.