Download the PHP package convert-cart/analytics without Composer

Convert Cart Magento 2 Plugin

Table of Contents

• Introduction
• Features
• Installation
  • Composer Installation
  • Manual Installation
• Configure Domain Id
• Troubleshooting
• 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):

   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.13-beta. The command will be like,

   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.

2. After installing via Composer, run the following commands from the Magento root directory:

Manual Installation

1. Download the latest version of the plugin from the 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:

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 [email protected] if any issues occur during the integration process.

For Development

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.