From a7a41327ce046d5f2d16d1868f7ae08e8b898ce0 Mon Sep 17 00:00:00 2001 From: Rafikooo Date: Tue, 3 Feb 2026 07:28:43 +0100 Subject: [PATCH] Add telemetry support --- README.md | 5 +++ TELEMETRY_POLICY.md | 69 ++++++++++++++++++++++++++++++++++++++ composer.json | 6 +++- src/SyliusMolliePlugin.php | 2 ++ 4 files changed, 81 insertions(+), 1 deletion(-) create mode 100644 TELEMETRY_POLICY.md diff --git a/README.md b/README.md index 5ed862cbf..8d8491f24 100644 --- a/README.md +++ b/README.md @@ -35,3 +35,8 @@ For online communication, we invite you to chat with us and other users on [Syli ## License This plugin is released under the [MIT License](LICENSE). + +## Telemetry + +This plugin enforces telemetry data collection when used with Sylius. +Details are described in [TELEMETRY_POLICY.md](./TELEMETRY_POLICY.md). diff --git a/TELEMETRY_POLICY.md b/TELEMETRY_POLICY.md new file mode 100644 index 000000000..bbdd79685 --- /dev/null +++ b/TELEMETRY_POLICY.md @@ -0,0 +1,69 @@ +# Telemetry Policy + +## Applicability + +This Telemetry Policy applies to the use of this plugin in combination with Sylius. + +By installing or using this plugin with Sylius, the user acknowledges that telemetry data is collected and transmitted as described in this document. + +--- + +## Mandatory telemetry + +Telemetry data collection is mandatory when this plugin is used. + +While this plugin is installed and active, Sylius telemetry operates under the conditions defined by this plugin and cannot be disabled independently. +Telemetry behavior outside of this scope follows the standard Sylius configuration. + +--- + +## Scope of collected data + +Telemetry is limited to non-identifying technical data, which may include: + +- Sylius version +- plugin version +- PHP version and selected dependency versions +- identifiers of installed and enabled plugins +- runtime environment classification (production or non-production) + +Telemetry does not include, and is not intended to include: + +- personal data +- customer data +- order data +- product data +- business, transactional, or confidential information +- authentication credentials or secrets + +A detailed description of the Sylius telemetry mechanism is available in the public issue: +https://github.com/Sylius/Sylius/issues/18588 + +--- + +## Purpose and use of telemetry data + +Telemetry data is collected for the purpose of: + +- understanding usage patterns within the Sylius ecosystem +- analyzing the adoption and frequency of plugin usage +- identifying commonly used versions of Sylius and plugins +- supporting maintenance, compatibility, and future development efforts + +Telemetry data is processed in aggregated form and is not used to identify individual users, installations, or businesses. + +--- + +## Licensing + +This plugin is distributed under the MIT license. + +Telemetry collection constitutes part of the technical operation of the software and does not alter, restrict, or supplement the rights granted under the license. + +--- + +## Changes to this policy + +This Telemetry Policy may be updated to reflect changes in telemetry implementation, legal requirements, or operational practices. + +Updated versions of this policy will be made available in the plugin repository. diff --git a/composer.json b/composer.json index d54d73d9b..dd72ae040 100644 --- a/composer.json +++ b/composer.json @@ -7,6 +7,7 @@ "php": "^8.2", "mollie/mollie-api-php": "^2.73", "sylius/sylius": "^2.0.8", + "sylius/telemetry": "^1.0", "willdurand/js-translation-bundle": "^7.0" }, "require-dev": { @@ -61,7 +62,10 @@ "autoload": { "psr-4": { "Sylius\\MolliePlugin\\": "src/", - "Tests\\Sylius\\MolliePlugin\\": ["tests/", "tests/TestApplication/src/"] + "Tests\\Sylius\\MolliePlugin\\": [ + "tests/", + "tests/TestApplication/src/" + ] } }, "config": { diff --git a/src/SyliusMolliePlugin.php b/src/SyliusMolliePlugin.php index 76eb90c49..327c3361d 100644 --- a/src/SyliusMolliePlugin.php +++ b/src/SyliusMolliePlugin.php @@ -15,6 +15,7 @@ use Sylius\Bundle\CoreBundle\Application\SyliusPluginTrait; use Sylius\MolliePlugin\DependencyInjection\SyliusMessageBusPolyfillPass; +use Sylius\Telemetry\TelemetryCompilerPass; use Symfony\Component\DependencyInjection\ContainerBuilder; use Symfony\Component\HttpKernel\Bundle\Bundle; @@ -31,6 +32,7 @@ public function build(ContainerBuilder $container): void parent::build($container); $container->addCompilerPass(new SyliusMessageBusPolyfillPass()); + $container->addCompilerPass(new TelemetryCompilerPass()); } public function getPath(): string