# limegreentangerine/lgttoolkit architecture

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

- Interactive diagram: https://gitdiagram.com/limegreentangerine/lgttoolkit
- Repository: https://github.com/limegreentangerine/lgttoolkit

## Overview

LGT Toolkit is a Concrete CMS package that establishes shared site defaults and adds editor-facing content blocks, attributes, dashboard tools, and application services. The main workflow is package setup registering those capabilities, after which editors configure content in Concrete CMS and visitors receive rendered site features; AJAX list blocks additionally query and render paginated content. The README documents several capabilities whose implementations were not sampled. Edges below rely on those documented relationships or visible source references; unsampled wiring is not asserted.

Main entry points: [`controller.php`](https://github.com/limegreentangerine/lgttoolkit/blob/main/controller.php) (Package defaults), [`blocks`](https://github.com/limegreentangerine/lgttoolkit/tree/main/blocks) (Content blocks), [`controllers/single_page/dashboard/lgt_toolkit.php`](https://github.com/limegreentangerine/lgttoolkit/blob/main/controllers/single_page/dashboard/lgt_toolkit.php) (Dashboard utilities), [`blocks/lgt_social_share/controller.php`](https://github.com/limegreentangerine/lgttoolkit/blob/main/blocks/lgt_social_share/controller.php) (Social share block)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Package setup"]
  node_package["Package defaults<br/>[controller.php]"]
end

subgraph group_content["Content building"]
  node_attributes["Custom attributes"]
  node_blocks["Content blocks"]
  node_ajaxlists["AJAX content lists<br/>[controller.php]"]
  node_manualnav["Manual navigation<br/>[controller.php]"]
  node_socialblock["Social share block<br/>[controller.php]"]
  node_sharelink["Share links<br/>[ShareLink.php]"]
  node_shareservice["Share service<br/>[Service.php]"]
end

subgraph group_admin["Editor utilities"]
  node_dashboard["Dashboard utilities<br/>[lgt_toolkit.php]"]
  node_cookieadmin["Cookie settings<br/>[cookie_popup.php]"]
  node_duplicate["Express duplication"]
  node_focal["Focal point tools"]
  node_focaldata[("Focal point metadata")]
end

subgraph group_services["Application services"]
  node_mail["Custom mail<br/>[LgtMailService.php]"]
  node_mailrequest["Mail request"]
  node_autocache["Auto cache"]
  node_debug["Debug services"]
  node_directors["Debug collectors<br/>[Directors.php]"]
  node_collectors["Data collectors"]
  node_expressdebug["Express debugger"]
end

subgraph group_runtime["Site runtime"]
  node_events["Page and file events<br/>[Page.php]"]
  node_redirect["Redirect values<br/>[RedirectValue.php]"]
  node_cookies["Cookie endpoints<br/>[Cookies.php]"]
  node_placeholder["Placeholder text"]
  node_slideshow["Slideshow helper<br/>[Slideshow.php]"]
  node_slideshowview["Slideshow rendering<br/>[slideshow.php]"]
end

node_cms(("Concrete CMS"))
node_editors(("Content editors"))

node_cms -->|"installs package"| node_package
node_package -->|"installs types"| node_attributes
node_package -->|"installs blocks"| node_blocks
node_package -->|"creates pages"| node_dashboard
node_package -->|"registers service"| node_autocache
node_package -->|"registers service"| node_focal
node_package -->|"registers service"| node_mail
node_package -->|"registers service"| node_expressdebug
node_editors -->|"configures content"| node_blocks
node_editors -->|"uses tools"| node_dashboard
node_dashboard -->|"configures cookies"| node_cookieadmin
node_dashboard -->|"offers duplication"| node_duplicate
node_blocks -->|"includes lists"| node_ajaxlists
node_blocks -->|"includes navigation"| node_manualnav
node_blocks -->|"includes sharing"| node_socialblock
node_socialblock -->|"creates links"| node_sharelink
node_sharelink -->|"uses service"| node_shareservice
node_focal -->|"manages metadata"| node_focaldata
node_mail -->|"validates request"| node_mailrequest
node_debug -->|"creates collectors"| node_directors
node_directors -->|"registers collectors"| node_collectors
node_events -->|"reads redirect value"| node_redirect
node_package -->|"registers endpoint"| node_cookies
node_package -->|"registers route"| node_placeholder
node_slideshowview -.->|"uses options"| node_slideshow

click node_package "https://github.com/limegreentangerine/lgttoolkit/blob/main/controller.php"
click node_attributes "https://github.com/limegreentangerine/lgttoolkit/tree/main/attributes"
click node_blocks "https://github.com/limegreentangerine/lgttoolkit/tree/main/blocks"
click node_ajaxlists "https://github.com/limegreentangerine/lgttoolkit/blob/main/blocks/lgt_ajax_file_list/controller.php"
click node_manualnav "https://github.com/limegreentangerine/lgttoolkit/blob/main/blocks/lgt_manual_nav/controller.php"
click node_socialblock "https://github.com/limegreentangerine/lgttoolkit/blob/main/blocks/lgt_social_share/controller.php"
click node_sharelink "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Block/SocialShare/ShareLink.php"
click node_shareservice "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Block/SocialShare/Service.php"
click node_dashboard "https://github.com/limegreentangerine/lgttoolkit/blob/main/controllers/single_page/dashboard/lgt_toolkit.php"
click node_cookieadmin "https://github.com/limegreentangerine/lgttoolkit/blob/main/single_pages/dashboard/lgt_toolkit/cookie_popup.php"
click node_duplicate "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Express/DuplicateExpressObjects.php"
click node_focal "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Providers/FocalPoint/FocalPointService.php"
click node_focaldata "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Entity/File/ImageFocalPoint.php"
click node_mail "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Providers/LgtMail/LgtMailService.php"
click node_mailrequest "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Mail/SendEmailRequest.php"
click node_autocache "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Providers/AutoCache/AutoCacheService.php"
click node_debug "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Providers/DebugBar/DebugBarService.php"
click node_directors "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/DebugBar/Directors.php"
click node_collectors "https://github.com/limegreentangerine/lgttoolkit/tree/main/src/DebugBar/DataCollector"
click node_expressdebug "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Providers/Express/Debugger/ExpressDebuggerService.php"
click node_events "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Events/Page.php"
click node_redirect "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Concrete/Entity/Attribute/Value/Value/RedirectValue.php"
click node_cookies "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Ajax/Cookies.php"
click node_placeholder "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Ajax/PlaceholderText.php"
click node_slideshow "https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Slideshow/Slideshow.php"
click node_slideshowview "https://github.com/limegreentangerine/lgttoolkit/blob/main/elements/slideshow/slideshow.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_package toneBlue
class node_attributes,node_blocks,node_ajaxlists,node_manualnav,node_socialblock,node_sharelink,node_shareservice toneAmber
class node_dashboard,node_cookieadmin,node_duplicate,node_focal,node_focaldata toneMint
class node_mail,node_mailrequest,node_autocache,node_debug,node_directors,node_collectors,node_expressdebug toneRose
class node_events,node_redirect,node_cookies,node_placeholder,node_slideshow,node_slideshowview,node_cms,node_editors toneIndigo
```

## Components

### Package setup

- [Package defaults](https://github.com/limegreentangerine/lgttoolkit/blob/main/controller.php): `controller.php`

### Content building

- [Custom attributes](https://github.com/limegreentangerine/lgttoolkit/tree/main/attributes): `attributes`
- [Content blocks](https://github.com/limegreentangerine/lgttoolkit/tree/main/blocks): `blocks`
- [AJAX content lists](https://github.com/limegreentangerine/lgttoolkit/blob/main/blocks/lgt_ajax_file_list/controller.php): `blocks/lgt_ajax_file_list/controller.php`
- [Manual navigation](https://github.com/limegreentangerine/lgttoolkit/blob/main/blocks/lgt_manual_nav/controller.php): `blocks/lgt_manual_nav/controller.php`
- [Social share block](https://github.com/limegreentangerine/lgttoolkit/blob/main/blocks/lgt_social_share/controller.php): `blocks/lgt_social_share/controller.php`
- [Share links](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Block/SocialShare/ShareLink.php): `src/Block/SocialShare/ShareLink.php`
- [Share service](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Block/SocialShare/Service.php): `src/Block/SocialShare/Service.php`

### Editor utilities

- [Dashboard utilities](https://github.com/limegreentangerine/lgttoolkit/blob/main/controllers/single_page/dashboard/lgt_toolkit.php): `controllers/single_page/dashboard/lgt_toolkit.php`
- [Cookie settings](https://github.com/limegreentangerine/lgttoolkit/blob/main/single_pages/dashboard/lgt_toolkit/cookie_popup.php): `single_pages/dashboard/lgt_toolkit/cookie_popup.php`
- [Express duplication](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Express/DuplicateExpressObjects.php): `src/Express/DuplicateExpressObjects.php`
- [Focal point tools](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Providers/FocalPoint/FocalPointService.php): `src/Providers/FocalPoint/FocalPointService.php`
- [Focal point metadata](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Entity/File/ImageFocalPoint.php): `src/Entity/File/ImageFocalPoint.php`

### Application services

- [Custom mail](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Providers/LgtMail/LgtMailService.php): `src/Providers/LgtMail/LgtMailService.php`
- [Mail request](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Mail/SendEmailRequest.php): `src/Mail/SendEmailRequest.php`
- [Auto cache](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Providers/AutoCache/AutoCacheService.php): `src/Providers/AutoCache/AutoCacheService.php`
- [Debug services](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Providers/DebugBar/DebugBarService.php): `src/Providers/DebugBar/DebugBarService.php`
- [Debug collectors](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/DebugBar/Directors.php): `src/DebugBar/Directors.php`
- [Data collectors](https://github.com/limegreentangerine/lgttoolkit/tree/main/src/DebugBar/DataCollector): `src/DebugBar/DataCollector`
- [Express debugger](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Providers/Express/Debugger/ExpressDebuggerService.php): `src/Providers/Express/Debugger/ExpressDebuggerService.php`

### Site runtime

- [Page and file events](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Events/Page.php): `src/Events/Page.php`
- [Redirect values](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Concrete/Entity/Attribute/Value/Value/RedirectValue.php): `src/Concrete/Entity/Attribute/Value/Value/RedirectValue.php`
- [Cookie endpoints](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Ajax/Cookies.php): `src/Ajax/Cookies.php`
- [Placeholder text](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Ajax/PlaceholderText.php): `src/Ajax/PlaceholderText.php`
- [Slideshow helper](https://github.com/limegreentangerine/lgttoolkit/blob/main/src/Slideshow/Slideshow.php): `src/Slideshow/Slideshow.php`
- [Slideshow rendering](https://github.com/limegreentangerine/lgttoolkit/blob/main/elements/slideshow/slideshow.php): `elements/slideshow/slideshow.php`

### Other components

- **Concrete CMS**
- **Content editors**

## Connections

- Concrete CMS → Package defaults: installs package
- Package defaults → Custom attributes: installs types
- Package defaults → Content blocks: installs blocks
- Package defaults → Dashboard utilities: creates pages
- Package defaults → Auto cache: registers service
- Package defaults → Focal point tools: registers service
- Package defaults → Custom mail: registers service
- Package defaults → Express debugger: registers service
- Content editors → Content blocks: configures content
- Content editors → Dashboard utilities: uses tools
- Dashboard utilities → Cookie settings: configures cookies
- Dashboard utilities → Express duplication: offers duplication
- Content blocks → AJAX content lists: includes lists
- Content blocks → Manual navigation: includes navigation
- Content blocks → Social share block: includes sharing
- Social share block → Share links: creates links (evidence: `blocks/lgt_social_share/controller.php`)
- Share links → Share service: uses service (evidence: `src/Block/SocialShare/ShareLink.php`)
- Focal point tools → Focal point metadata: manages metadata (evidence: `src/Providers/FocalPoint/FocalPointService.php`)
- Custom mail → Mail request: validates request (evidence: `src/Providers/LgtMail/LgtMailService.php`)
- Debug services → Debug collectors: creates collectors (evidence: `src/Providers/DebugBar/DebugBarService.php`)
- Debug collectors → Data collectors: registers collectors (evidence: `src/DebugBar/Directors.php`)
- Page and file events → Redirect values: reads redirect value (evidence: `src/Events/Page.php`)
- Package defaults → Cookie endpoints: registers endpoint (evidence: `controller.php`)
- Package defaults → Placeholder text: registers route (evidence: `controller.php`)
- Slideshow rendering → Slideshow helper: uses options
