# tun2u/m2-module-klaviyoaddons architecture

> Architecture diagram of the GitHub repository tun2u/m2-module-klaviyoaddons, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tun2u/m2-module-klaviyoaddons
- Repository: https://github.com/tun2u/m2-module-klaviyoaddons

## Overview

This Magento extension reconciles Klaviyo email marketing consent into Magento newsletter subscriptions. A scheduled cron job or the documented CLI command starts synchronization; the service fetches Klaviyo profiles in pages, identifies non-subscribed profiles, and asks Magento to unsubscribe the matching customer. Admin configuration controls cron timing. The core call paths are visible in excerpts; configuration wiring and some Magento/Klaviyo internals are supported only by README or tree-level context, so they are not expanded into speculative edges.

Main entry points: [`Service/KlaviyoService.php`](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Service/KlaviyoService.php) (Sync orchestrator), [`Model/Connector.php`](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Model/Connector.php) (Klaviyo API connector), [`Logger/Logger.php`](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Logger/Logger.php) (Module logger), [`Model/Subscriber.php`](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Model/Subscriber.php) (Subscriber updater)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Sync entry points"]
  node_cron["Scheduled sync"]
  node_cli["Manual CLI<br/>[Commands.php]"]
end

subgraph group_sync["Consent synchronization"]
  node_service["Sync orchestrator<br/>[KlaviyoService.php]"]
  node_connector["Klaviyo API connector<br/>[Connector.php]"]
end

subgraph group_magento["Magento subscriptions"]
  node_subscriber["Subscriber updater<br/>[Subscriber.php]"]
end

subgraph group_config["Schedule configuration"]
  node_admin_config["Admin cron settings<br/>[system.xml]"]
  node_cron_config["Cron expression updater<br/>[Cronconfig.php]"]
end

subgraph group_logging["Logging"]
  node_logger["Module logger<br/>[Logger.php]"]
  node_log_handler["Log file handler<br/>[Handler.php]"]
end

node_klaviyo{{"Klaviyo API"}}
node_magento_newsletter[("Magento newsletter subscriptions")]
node_cron_schedule["Magento cron schedule<br/>[crontab.xml]"]

node_cron -->|"invokes"| node_service
node_cli -->|"invokes"| node_service
node_service -->|"fetches profiles"| node_connector
node_connector -->|"requests API"| node_klaviyo
node_service -->|"unsubscribes email"| node_subscriber
node_subscriber -->|"updates subscription"| node_magento_newsletter
node_connector -->|"logs failures"| node_logger
node_service -->|"logs profile errors"| node_logger
node_admin_config -.->|"saves timing"| node_cron_config
node_cron_config -->|"sets cron expression"| node_cron_schedule
node_logger -.->|"writes through"| node_log_handler

click node_cron "https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Cron/SyncUnsubscribedUsers.php"
click node_cli "https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Console/Command/Commands.php"
click node_service "https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Service/KlaviyoService.php"
click node_connector "https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Model/Connector.php"
click node_subscriber "https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Model/Subscriber.php"
click node_admin_config "https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/etc/adminhtml/system.xml"
click node_cron_config "https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Model/Config/Cronconfig.php"
click node_cron_schedule "https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/etc/crontab.xml"
click node_logger "https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Logger/Logger.php"
click node_log_handler "https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Logger/Handler.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cron,node_cli toneBlue
class node_service,node_connector,node_magento_newsletter toneAmber
class node_subscriber,node_klaviyo toneMint
class node_admin_config,node_cron_config toneRose
class node_logger,node_log_handler toneIndigo
class node_cron_schedule toneTeal
```

## Components

### Sync entry points

- [Scheduled sync](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Cron/SyncUnsubscribedUsers.php): `Cron/SyncUnsubscribedUsers.php`
- [Manual CLI](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Console/Command/Commands.php): `Console/Command/Commands.php`

### Consent synchronization

- [Sync orchestrator](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Service/KlaviyoService.php): `Service/KlaviyoService.php`
- [Klaviyo API connector](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Model/Connector.php): `Model/Connector.php`

### Magento subscriptions

- [Subscriber updater](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Model/Subscriber.php): `Model/Subscriber.php`

### Schedule configuration

- [Admin cron settings](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/etc/adminhtml/system.xml): `etc/adminhtml/system.xml`
- [Cron expression updater](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Model/Config/Cronconfig.php): `Model/Config/Cronconfig.php`

### Logging

- [Module logger](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Logger/Logger.php): `Logger/Logger.php`
- [Log file handler](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/Logger/Handler.php): `Logger/Handler.php`

### Other components

- **Klaviyo API**
- **Magento newsletter subscriptions**
- [Magento cron schedule](https://github.com/tun2u/m2-module-klaviyoaddons/blob/master/etc/crontab.xml): `etc/crontab.xml`

## Connections

- Scheduled sync → Sync orchestrator: invokes (evidence: `Cron/SyncUnsubscribedUsers.php`)
- Manual CLI → Sync orchestrator: invokes (evidence: `Console/Command/Commands.php`)
- Sync orchestrator → Klaviyo API connector: fetches profiles (evidence: `Service/KlaviyoService.php`)
- Klaviyo API connector → Klaviyo API: requests API (evidence: `Model/Connector.php`)
- Sync orchestrator → Subscriber updater: unsubscribes email (evidence: `Service/KlaviyoService.php`)
- Subscriber updater → Magento newsletter subscriptions: updates subscription (evidence: `Model/Subscriber.php`)
- Klaviyo API connector → Module logger: logs failures (evidence: `Model/Connector.php`)
- Sync orchestrator → Module logger: logs profile errors (evidence: `Service/KlaviyoService.php`)
- Admin cron settings → Cron expression updater: saves timing
- Cron expression updater → Magento cron schedule: sets cron expression (evidence: `Model/Config/Cronconfig.php`)
- Module logger → Log file handler: writes through (evidence: `Logger/Handler.php`)
