Skip to content

Installation

Requirements

  • Magento 2.4.4 or higher (or Mage-OS 1.0+)
  • PHP 8.1, 8.2, or 8.3
  • Composer 2.x

For Hyvä Theme Support

  • Hyvä Theme installed
  • Qoliber Hyva Module Registration

Installation Options

You can install the GDPR Suite in two ways:

For Luma Theme

composer require qoliber/gdpr-metapackage:1.0.0-rc1
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

For Hyvä Theme

composer require qoliber/gdpr-metapackage-hyva:1.0.0-rc1
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

Note

The Hyvä metapackage automatically includes all core modules plus Hyvä compatibility modules.

Option 2: Individual Modules

You can install individual modules if you only need specific functionality:

# Example: Install only consent management
composer require qoliber/gdpr-consent:1.0.0-rc1
composer require qoliber/gdpr-admin:1.0.0-rc1

# For Hyvä compatibility
composer require qoliber/gdpr-consent-hyva:1.0.0-rc1

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

Available Packages

Core Modules

  • qoliber/gdpr-admin - Administrative interface
  • qoliber/gdpr-consent - Consent management
  • qoliber/gdpr-cookie - Cookie management
  • qoliber/gdpr-data-subject - Data subject rights
  • qoliber/gdpr-privacy-center - Privacy dashboard
  • qoliber/gdpr-policy - Policy management
  • qoliber/gdpr-analytics - Analytics integration
  • qoliber/gdpr-gtm - Google Tag Manager
  • qoliber/gdpr-marketing - Marketing automation
  • qoliber/gdpr-automation - Scheduled tasks
  • qoliber/gdpr-api - REST API
  • qoliber/gdpr-geo - Geographic detection
  • qoliber/gdpr-integration - Third-party integrations
  • qoliber/gdpr-frontend - Frontend components
  • qoliber/gdpr-cookie-templates - Cookie templates

Hyvä Compatibility Modules

  • qoliber/gdpr-consent-hyva
  • qoliber/gdpr-cookie-hyva
  • qoliber/gdpr-data-subject-hyva
  • qoliber/gdpr-privacy-center-hyva
  • qoliber/gdpr-policy-hyva
  • qoliber/gdpr-frontend-hyva

Post-Installation

  1. Navigate to Stores > Configuration > GDPR Compliance in the admin panel
  2. Configure your privacy policy and cookie settings
  3. Create consent definitions for your forms
  4. Test the cookie banner and consent forms on the frontend

Updating

To update to the latest version:

composer update qoliber/gdpr-*
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

Troubleshooting

Issue: Module not appearing in admin

Solution: Ensure you've run all setup commands, especially setup:upgrade

Issue: Frontend components not loading

Solution: Clear cache and regenerate static content: 

php bin/magento cache:flush
php bin/magento setup:static-content:deploy -f

Issue: Composer can't find packages

Solution: Ensure you have access to the Qoliber private repository. Contact support for credentials.

Support

For installation issues, please contact: - Email: [email protected] - Documentation: https://docs.qoliber.com