# gmaccario/lead-magnet-locker architecture

> Architecture diagram of the GitHub repository gmaccario/lead-magnet-locker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gmaccario/lead-magnet-locker
- Repository: https://github.com/gmaccario/lead-magnet-locker

## Overview

Lead Magnet Locker is a WordPress plugin that gates private file downloads behind an email form. Visitors select a shortcode-rendered offer, submit an email, and receive a nonce-protected, time-limited download link; administrators manage files and schedules and search, review, export, and download lead history. The graph separates HTTP presentation, application use cases, domain rules, and WordPress adapters. Relationships are limited to calls and hook wiring shown in excerpts, the source index, or README; several unsampled presentation and infrastructure details are therefore represented at subsystem level.

Main entry points: [`src/Plugin.php`](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Plugin.php) (Plugin composition), [`src/Presentation/AdminController.php`](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/AdminController.php) (Admin pages), [`src/Presentation/DownloadEndpoint.php`](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/DownloadEndpoint.php) (Download endpoint), [`src/Presentation/ShortcodeController.php`](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/ShortcodeController.php) (Shortcode form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["WordPress presentation"]
  node_plugin["Plugin composition<br/>[Plugin.php]"]
  node_shortcode["Shortcode form"]
  node_submission["Submission endpoint"]
  node_downloads["Download endpoint"]
  node_admin["Admin pages"]
  node_fileactions["File actions<br/>[FileActions.php]"]
  node_historyexport["History export<br/>[HistoryExport.php]"]
  node_views["Plugin views"]
end

subgraph group_application["Application use cases"]
  node_submit["Submit email<br/>[SubmitEmail.php]"]
  node_resolve["Resolve download"]
  node_upload["Upload file<br/>[UploadFile.php]"]
  node_delete["Delete file<br/>[DeleteFile.php]"]
  node_listfiles["List files<br/>[ListFiles.php]"]
  node_schedule["Save schedule<br/>[SaveSchedule.php]"]
  node_ports["Application ports"]
  node_outcome["Use-case outcomes<br/>[Outcome.php]"]
end

subgraph group_infrastructure["WordPress adapters"]
  node_filestore["Protected file storage"]
  node_records[("Download repository")]
  node_settingsrepo[("Settings repository")]
  node_wpadapters["WordPress adapters"]
end

subgraph group_domain["Domain rules"]
  node_domainrules["Domain models"]
end

node_visitor(("Visitor"))
node_administrator(("Administrator"))

node_visitor -->|"views form"| node_shortcode
node_shortcode -->|"renders"| node_views
node_shortcode -->|"routes submission"| node_submission
node_visitor -->|"submits email"| node_submission
node_submission -->|"runs use case"| node_submit
node_submit -->|"uses ports"| node_ports
node_submit -->|"generates key"| node_domainrules
node_submit -->|"returns result"| node_outcome
node_shortcode -->|"checks availability"| node_wpadapters
node_submission -->|"builds download link"| node_downloads
node_visitor -->|"requests link"| node_downloads
node_downloads -->|"resolves request"| node_resolve
node_resolve -->|"uses records and files"| node_ports
node_downloads -.->|"streams protected file"| node_filestore
node_administrator -->|"manages plugin"| node_admin
node_admin -->|"lists files"| node_listfiles
node_admin -->|"dispatches file actions"| node_fileactions
node_fileactions -->|"runs upload"| node_upload
node_fileactions -->|"runs deletion"| node_delete
node_upload -->|"stores file"| node_filestore
node_delete -->|"checks usage and deletes"| node_ports
node_admin -->|"saves schedule"| node_schedule
node_schedule -->|"persists schedule"| node_settingsrepo
node_admin -->|"reads history and stats"| node_records
node_administrator -->|"exports history"| node_historyexport
node_historyexport -->|"reads records"| node_ports
node_administrator -->|"downloads history file"| node_downloads
node_plugin -->|"registers hooks"| node_shortcode
node_plugin -->|"registers hooks"| node_submission
node_plugin -->|"registers hooks"| node_downloads
node_plugin -->|"registers hooks"| node_admin
node_plugin -->|"registers export hook"| node_historyexport
node_plugin -->|"constructs adapter"| node_filestore
node_plugin -->|"constructs repository"| node_records
node_plugin -->|"constructs repository"| node_settingsrepo
node_plugin -->|"builds adapters"| node_wpadapters

click node_plugin "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Plugin.php"
click node_shortcode "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/ShortcodeController.php"
click node_submission "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/SubmissionEndpoint.php"
click node_downloads "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/DownloadEndpoint.php"
click node_admin "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/AdminController.php"
click node_fileactions "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/FileActions.php"
click node_historyexport "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/HistoryExport.php"
click node_views "https://github.com/gmaccario/lead-magnet-locker/tree/main/views"
click node_submit "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/SubmitEmail.php"
click node_resolve "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/ResolveDownload.php"
click node_upload "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/UploadFile.php"
click node_delete "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/DeleteFile.php"
click node_listfiles "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/ListFiles.php"
click node_schedule "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/SaveSchedule.php"
click node_ports "https://github.com/gmaccario/lead-magnet-locker/tree/main/src/Application/Port"
click node_outcome "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/Outcome.php"
click node_filestore "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Infrastructure/LeadMagnetLockerStorage.php"
click node_records "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Infrastructure/DownloadRepository.php"
click node_settingsrepo "https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Infrastructure/SettingsRepository.php"
click node_wpadapters "https://github.com/gmaccario/lead-magnet-locker/tree/main/src/Infrastructure"
click node_domainrules "https://github.com/gmaccario/lead-magnet-locker/tree/main/src/Domain"

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_plugin,node_shortcode,node_submission,node_downloads,node_admin,node_fileactions,node_historyexport,node_views toneBlue
class node_submit,node_resolve,node_upload,node_delete,node_listfiles,node_schedule,node_ports,node_outcome toneAmber
class node_filestore,node_records,node_settingsrepo,node_wpadapters toneMint
class node_domainrules toneRose
class node_visitor,node_administrator toneIndigo
```

## Components

### WordPress presentation

- [Plugin composition](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Plugin.php): `src/Plugin.php`
- [Shortcode form](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/ShortcodeController.php): `src/Presentation/ShortcodeController.php`
- [Submission endpoint](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/SubmissionEndpoint.php): `src/Presentation/SubmissionEndpoint.php`
- [Download endpoint](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/DownloadEndpoint.php): `src/Presentation/DownloadEndpoint.php`
- [Admin pages](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/AdminController.php): `src/Presentation/AdminController.php`
- [File actions](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/FileActions.php): `src/Presentation/FileActions.php`
- [History export](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Presentation/HistoryExport.php): `src/Presentation/HistoryExport.php`
- [Plugin views](https://github.com/gmaccario/lead-magnet-locker/tree/main/views): `views`

### Application use cases

- [Submit email](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/SubmitEmail.php): `src/Application/SubmitEmail.php`
- [Resolve download](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/ResolveDownload.php): `src/Application/ResolveDownload.php`
- [Upload file](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/UploadFile.php): `src/Application/UploadFile.php`
- [Delete file](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/DeleteFile.php): `src/Application/DeleteFile.php`
- [List files](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/ListFiles.php): `src/Application/ListFiles.php`
- [Save schedule](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/SaveSchedule.php): `src/Application/SaveSchedule.php`
- [Application ports](https://github.com/gmaccario/lead-magnet-locker/tree/main/src/Application/Port): `src/Application/Port`
- [Use-case outcomes](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Application/Outcome.php): `src/Application/Outcome.php`

### WordPress adapters

- [Protected file storage](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Infrastructure/LeadMagnetLockerStorage.php): `src/Infrastructure/LeadMagnetLockerStorage.php`
- [Download repository](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Infrastructure/DownloadRepository.php): `src/Infrastructure/DownloadRepository.php`
- [Settings repository](https://github.com/gmaccario/lead-magnet-locker/blob/main/src/Infrastructure/SettingsRepository.php): `src/Infrastructure/SettingsRepository.php`
- [WordPress adapters](https://github.com/gmaccario/lead-magnet-locker/tree/main/src/Infrastructure): `src/Infrastructure`

### Domain rules

- [Domain models](https://github.com/gmaccario/lead-magnet-locker/tree/main/src/Domain): `src/Domain`

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → Shortcode form: views form (evidence: `README.md`)
- Shortcode form → Plugin views: renders (evidence: `src/Presentation/ShortcodeController.php`)
- Shortcode form → Submission endpoint: routes submission (evidence: `src/Presentation/ShortcodeController.php`)
- Visitor → Submission endpoint: submits email (evidence: `README.md`)
- Submission endpoint → Submit email: runs use case (evidence: `src/Presentation/SubmissionEndpoint.php`)
- Submit email → Application ports: uses ports (evidence: `src/Application/SubmitEmail.php`)
- Submit email → Domain models: generates key (evidence: `src/Application/SubmitEmail.php`)
- Submit email → Use-case outcomes: returns result (evidence: `src/Application/Outcome.php`)
- Shortcode form → WordPress adapters: checks availability (evidence: `src/Presentation/ShortcodeController.php`)
- Submission endpoint → Download endpoint: builds download link (evidence: `src/Presentation/SubmissionEndpoint.php`)
- Visitor → Download endpoint: requests link (evidence: `README.md`)
- Download endpoint → Resolve download: resolves request (evidence: `src/Presentation/DownloadEndpoint.php`)
- Resolve download → Application ports: uses records and files (evidence: `src/Application/ResolveDownload.php`)
- Download endpoint → Protected file storage: streams protected file
- Administrator → Admin pages: manages plugin (evidence: `src/Presentation/AdminController.php`)
- Admin pages → List files: lists files (evidence: `src/Presentation/AdminController.php`)
- Admin pages → File actions: dispatches file actions (evidence: `src/Presentation/AdminController.php`)
- File actions → Upload file: runs upload (evidence: `src/Presentation/FileActions.php`)
- File actions → Delete file: runs deletion (evidence: `src/Presentation/FileActions.php`)
- Upload file → Protected file storage: stores file (evidence: `src/Infrastructure/LeadMagnetLockerStorage.php`)
- Delete file → Application ports: checks usage and deletes (evidence: `src/Application/DeleteFile.php`)
- Admin pages → Save schedule: saves schedule (evidence: `src/Presentation/AdminController.php`)
- Save schedule → Settings repository: persists schedule (evidence: `src/Infrastructure/SettingsRepository.php`)
- Admin pages → Download repository: reads history and stats (evidence: `src/Presentation/AdminController.php`)
- Administrator → History export: exports history (evidence: `README.md`)
- History export → Application ports: reads records (evidence: `src/Presentation/HistoryExport.php`)
- Administrator → Download endpoint: downloads history file (evidence: `src/Presentation/DownloadEndpoint.php`)
- Plugin composition → Shortcode form: registers hooks (evidence: `src/Plugin.php`)
- Plugin composition → Submission endpoint: registers hooks (evidence: `src/Plugin.php`)
- Plugin composition → Download endpoint: registers hooks (evidence: `src/Plugin.php`)
- Plugin composition → Admin pages: registers hooks (evidence: `src/Plugin.php`)
- Plugin composition → History export: registers export hook (evidence: `src/Plugin.php`)
- Plugin composition → Protected file storage: constructs adapter (evidence: `src/Plugin.php`)
- Plugin composition → Download repository: constructs repository (evidence: `src/Plugin.php`)
- Plugin composition → Settings repository: constructs repository (evidence: `src/Plugin.php`)
- Plugin composition → WordPress adapters: builds adapters (evidence: `src/Plugin.php`)
