README

This module provides the Usercentrics functionality for the OXID eShop allowing you to use their Consent Management Platform.

Branch Compatibility

• b-7.6.x branch for b-7.6.x shop compilation branches
• b-7.5.x branch and v3.3.0 for b-7.5.x shop compilation branches
• b-7.4.x branch and v3.2.1 for b-7.4.x shop compilation branches
• b-7.3.x branch and v3.1.0 for b-7.3.x shop compilation branches
• b-7.2.x branch and v3.0.0 for b-7.2.x shop compilation branches
• b-7.1.x branch and v3.0.0 for b-7.1.x shop compilation branches
• b-7.0.x branch and v3.0.0 for b-7.0.x shop compilation branches
• b-6.5.x branch for b-6.5.x shop compilation branches
• b-6.3.x branch for b-6.3.x and b-6.4.x shop compilation branches
• b-6.2.x branch for b-6.2.x shop compilation branches

Installation

Module installation via composer

In order to install the module via composer, run one of the following commands on commandline in your shop base directory (where the shop's composer.json file resides).

• composer require oxid-professional-services/usercentrics:^3.3.0 to install the released version compatible with OXID eShop 7.5.x compilations
• composer require oxid-professional-services/usercentrics:^3.2.0 to install the released version compatible with OXID eShop 7.4.x compilations
• composer require oxid-professional-services/usercentrics:^3.1.0 to install the released version compatible with OXID eShop 7.3.x compilations
• composer require oxid-professional-services/usercentrics:^3.0.0 to install the released version compatible with OXID eShop 7.0.x - 7.2.x compilations

and activate the module.

Development installation

We recommend developing the module as independent as possible. This means that the module for development should be installed as a root package, with its own strict dependencies if such are needed.

The next section shows how to install the module as a root package by using the OXID eShop SDK.

In case of different environment usage, please adjust by your own needs.

Development installation on OXID eShop SDK

The installation instructions below are shown for the current SDK for shop 7.6. Make sure your system meets the requirements of the SDK.

1. Ensure all docker containers are down to avoid port conflicts

2. Clone the SDK for the new project

echo MyProject && git clone https://github.com/OXID-eSales/docker-eshop-sdk.git $_ && cd $_

1. Clone the repository to the source directory

git clone --recurse-submodules https://github.com/OXID-eSales/usercentrics.git --branch=b-7.6.x ./source

1. Run the recipe to setup the development environment, you can decide which shop edition to install. Omitting the flag installs EE.

./source/recipes/setup-development.sh

You should be able to access the shop with http://localhost.local and the admin panel with http://localhost.local/admin (credentials: noreply@oxid-esales.com / admin)

Testing

Linting, syntax check, static analysis

$ composer update
$ composer static

Unit/Integration/Acceptance tests

• Install this module in a running OXID eShop
• Reset the shop's database

$ bin/oe-console oe:database:reset --db-host=db-host --db-port=db-port --db-name=db-name --db-user=db-user --db-password=db-password --force

• Run all the tests

$ composer tests-all

• Or the desired suite

$ composer tests-unit
$ composer tests-integration
$ composer tests-codeception

Contributing

You like to contribute? 🙌 AWESOME 🙌
Go and check the contribution guidelines

Bugs and Issues

If you experience any bugs or issues, please report them in the section Module Usercentrics of https://bugs.oxid-esales.com.

Documentation

The module documentation can be found on our documentation platform: https://docs.oxid-esales.com/modules/usercentrics/de/latest/.

License

OXID Module and Component License, see LICENSE file.