oxid-esales / personalization-module
Econda Personalization & Analytics module for the OXID eShop
Installs: 3 333
Dependents: 0
Suggesters: 0
Security: 0
Stars: 17
Watchers: 5
Forks: 1
Language:JavaScript
Type:oxideshop-module
Requires
- php: ^7.3 || ^8.0
- league/csv: ^9.1.4
- oxid-esales/econda-tracking-component: ^1.2.0
- dev-b-6.3.x
- dev-b-7.0.x
- v3.0.0
- v3.0.0-rc.1
- v2.2.0
- v2.1.0
- v2.0.0
- v1.4.0
- v1.3.2
- v1.3.1
- v1.3.0
- v1.2.2
- v1.2.1
- v1.2.0
- v1.1.1
- v1.1.0
- v1.0.0
- dev-b-7.0.x_improve_lists_wip
- dev-b-7.1.x
- dev-master
- dev-b-6.3.x-powered_by_econda_OXDEV-5581
- dev-b-6.3.x-econda_loader_test-OXDEV-5584
- dev-b-2.x
- dev-b-1.x
- dev-master-compatibility_with_master_shop-OXDEV-3293
- dev-OXDEV-3247-remove_old_configuration
- dev-Support-Promotions
- dev-js-cache-optimization
This package is auto-updated.
Last update: 2024-09-25 17:20:48 UTC
README
Module adds Econda service functionality.
Full documentation can be found on: https://docs.oxid-esales.com/add-ons/personalizationoption/de/3.0/
Compatibility
- 4.0 module versions works with OXID eShop compilations 7.0.x
- 3.0 module versions works with OXID eShop compilations 6.5.x
- 2.2 module version works with OXID eShop compilations 6.3.x, 6.4.x and 6.5.x
- 2.1.0 version of the module works with OXID eShop compilation 6.2.x
- 1.x version of the module works with OXID eShop compilation 6.1.x
Branches:
- Branch b-7.0.x is compatible with OXID eShop 7.0.x branches
- Branch b-6.3.x is compatible with OXID eShop 6.5.x branches
Installation
Run the following commands to install OXID personalization module:
composer require oxid-esales/personalization-module ^3.0.0
Avoid conflicts with existing OXID eShop functionality
Personalization module displays widgets which conflicts with OXID eShop default promotions. To display products nicely it is needed to disable some of OXID eShop functionality:
- Login to admin
- Go to: Customer info -> Promotions and deactivate listed promotions:
- Week's Special;
- Top seller.
- Go to "Master settings" -> "Core settings" -> "Perform." and deactivate some functionality:
- In section Enhanced Performance Settings uncheck Load Crossselling;
- In section Enhanced Performance Settings uncheck Load "Customers who bought this product also purchased ...";
- Click Save.
Privacy protection setup
To comply with the privacy protection laws, the personalization module provides functionality. For the tracking, example texts are provided for the opt-in/opt-out notices. Be sure to review, update and activate them before using the tracking functionality. You can find the texts in "Customer Info" -> "CMS Pages", search for the idents "oeecondaanalyticsoptin", "oeecondaanalyticsoptout" and "oeecondaanalyticsupdate".
Econda Analytics/Tag Manager with OXID eShop on multiple servers
In case module is being used in application on multiple servers, it is not enough just to upload emos.js
or tagmanager.js
files via OXID eShop admin panel.It's also necessary to replicate them through all application servers.
If file was uploaded, it can be found in out/oepersonalization
directory.
Features
Module provides functionality which allows:
- Add widgets
- Provide widget for Visual CMS
- Track visitors behaviour
- Use Econda Tag Manager
- Export data for Econda
Visual CMS Widget
A widget is provided for the Visual CMS module. After installation of the personalization module, the widget will be available in the Visual CMS editor. You can find it by the name "AI Content". To add it, just fill in the required settings for widget id and widget template (options described bellow). There is an optionally setting to limit the number of results; if it is left blank, no limit will be applied.
There are 2 template files prepared for Visual CMS widget:
Component/views/vcms_banner.ejs.html
- To display banner images with links.Component/views/vcms_recommendations.ejs.html
- To display products within widget.
Export data for Econda
There are 2 ways of exporting data:
- Administration panel
- CLI
To export data via CLI execute command:
vendor/bin/oe-console oe:personalization:export
or if there is a need to customize configuration parameters:
vendor/bin/oe-console oe:personalization:export --config /path/to/your/config/file.php
Bugs and Issues
If you experience any bugs or issues, please report them in the section Module OXID Personalization of https://bugs.oxid-esales.com.
License
See LICENSE file for license details.