How gmaccario/lead-magnet-locker works
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: Plugin.php Plugin composition · AdminController.php Admin pages · DownloadEndpoint.php Download endpoint · ShortcodeController.php Shortcode form
Components 23
WordPress presentation
- Plugin composition
src/Plugin.php - Shortcode form
src/Presentation/ShortcodeController.php - Submission endpoint
src/Presentation/SubmissionEndpoint.php - Download endpoint
src/Presentation/DownloadEndpoint.php - Admin pages
src/Presentation/AdminController.php - File actions
src/Presentation/FileActions.php - History export
src/Presentation/HistoryExport.php - Plugin views
views
Application use cases
- Submit email
src/Application/SubmitEmail.php - Resolve download
src/Application/ResolveDownload.php - Upload file
src/Application/UploadFile.php - Delete file
src/Application/DeleteFile.php - List files
src/Application/ListFiles.php - Save schedule
src/Application/SaveSchedule.php - Application ports
src/Application/Port - Use-case outcomes
src/Application/Outcome.php
WordPress adapters
- Protected file storage
src/Infrastructure/LeadMagnetLockerStorage.php - Download repository
src/Infrastructure/DownloadRepository.php - Settings repository
src/Infrastructure/SettingsRepository.php - WordPress adapters
src/Infrastructure
Domain rules
- Domain models
src/Domain
Other components
- Visitor
- Administrator
Connections 36
- Visitor → Shortcode form: views form
README.md - Shortcode form → Plugin views: renders
src/Presentation/ShortcodeController.php - Shortcode form → Submission endpoint: routes submission
src/Presentation/ShortcodeController.php - Visitor → Submission endpoint: submits email
README.md - Submission endpoint → Submit email: runs use case
src/Presentation/SubmissionEndpoint.php - Submit email → Application ports: uses ports
src/Application/SubmitEmail.php - Submit email → Domain models: generates key
src/Application/SubmitEmail.php - Submit email → Use-case outcomes: returns result
src/Application/Outcome.php - Shortcode form → WordPress adapters: checks availability
src/Presentation/ShortcodeController.php - Submission endpoint → Download endpoint: builds download link
src/Presentation/SubmissionEndpoint.php - Visitor → Download endpoint: requests link
README.md - Download endpoint → Resolve download: resolves request
src/Presentation/DownloadEndpoint.php - Resolve download → Application ports: uses records and files
src/Application/ResolveDownload.php - Download endpoint → Protected file storage: streams protected file
- Administrator → Admin pages: manages plugin
src/Presentation/AdminController.php - Admin pages → List files: lists files
src/Presentation/AdminController.php - Admin pages → File actions: dispatches file actions
src/Presentation/AdminController.php - File actions → Upload file: runs upload
src/Presentation/FileActions.php - File actions → Delete file: runs deletion
src/Presentation/FileActions.php - Upload file → Protected file storage: stores file
src/Infrastructure/LeadMagnetLockerStorage.php - Delete file → Application ports: checks usage and deletes
src/Application/DeleteFile.php - Admin pages → Save schedule: saves schedule
src/Presentation/AdminController.php - Save schedule → Settings repository: persists schedule
src/Infrastructure/SettingsRepository.php - Admin pages → Download repository: reads history and stats
src/Presentation/AdminController.php - Administrator → History export: exports history
README.md - History export → Application ports: reads records
src/Presentation/HistoryExport.php - Administrator → Download endpoint: downloads history file
src/Presentation/DownloadEndpoint.php - Plugin composition → Shortcode form: registers hooks
src/Plugin.php - Plugin composition → Submission endpoint: registers hooks
src/Plugin.php - Plugin composition → Download endpoint: registers hooks
src/Plugin.php - Plugin composition → Admin pages: registers hooks
src/Plugin.php - Plugin composition → History export: registers export hook
src/Plugin.php - Plugin composition → Protected file storage: constructs adapter
src/Plugin.php - Plugin composition → Download repository: constructs repository
src/Plugin.php - Plugin composition → Settings repository: constructs repository
src/Plugin.php - Plugin composition → WordPress adapters: builds adapters
src/Plugin.php