geeks4change / untrack_email_storage
1.0.x-dev
2023-03-08 15:53 UTC
Requires
- php: ^8.1
- cweagans/composer-patches: ^1.7
- drupal/cl_components: ^1@rc
- drupal/domainparser: ^1@dev
- drupal/entity: ^1
- drupal/sdc: 1.x-dev
- geeks4change/untrack-email-analyzer: 1.0.x-dev
- symfony/mailer: ^5.4
Requires (Dev)
- phpunit/phpunit: ^9.5
- symfony/var-dumper: ^5 || ^6.2
This package is auto-updated.
Last update: 2024-10-08 18:32:52 UTC
README
Part of the unspy.email suite: Analyzes emails for user tracking links. (The "untrack_email" prefix is for legacy reasons.)
Contains Drupal entities and logic to process emails.
Installation
Follow the usual module installation process: https://www.drupal.org/docs/extending-drupal/installing-modules
What it does
The storage component is responsible for storage of the unspy.email analyzer results (see that), and the complete web frontend:
- Upload of email source file into a form
- Processing via analyzer
- Getting consent to process
- Storing Full Analysis Result (containing all URLs)
- Converting and storing Persistent Analysis Result (containing only anonymized URLs)
- Deleting Full Analysis Results after 90 days
- Referincing Newsletter Lists and Responsible Sender (identified by registrable domain)
- Sending informative Emails to Responsible Sender, containing a secret feedback link
- Accepting feedback from Responsible Sender via webform
- Displaying a table of Responsible Senders, Newsletter Lists, including
- its "does it spy?" status
- feedback from Sender
Data structures
The module defines these entities:
- Full Result: The raw analyzer result
- Persistent Result: The anonymized analyzer result
- List: The newsletter list
- Sender: The sender of the newsletter
Development
This project is not considered stable and makes no BC promises. It is tightly coupled to the analyzer component, and any API changes there will be reflected here.