# code4recovery/12-step-meeting-list architecture

> Architecture diagram of the GitHub repository code4recovery/12-step-meeting-list, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/code4recovery/12-step-meeting-list
- Repository: https://github.com/code4recovery/12-step-meeting-list

## Overview

##### Main Components

a) WordPress Integration Layer
- Plugin's integration with WordPress core
- Init.php as the entry point
- Hooks and filters system

b) Core Functionality Modules
- Admin Module (all files under includes/admin_*)
- Meeting Management System
- Location Management System
- Import/Export System
- Shortcodes System

c) Frontend Components
- Templates Layer (templates directory)
- Public Assets (CSS/JS)
- Blocks System (Gutenberg integration)

d) Data Flow Components
- AJAX Handlers
- Data Filtering System
- Meeting Data Storage

##### Important Elements to Highlight

- Blue: WordPress core integration points
- Green: Public-facing components
- Orange: Admin components
- Purple: Data storage
- Yellow: Asset compilation system

b) Connection Types:

##### Technical Details

- PHP function namespacing (tsml_ prefix)
- WordPress action/filter hooks
- Database schema for custom post types
- Asset compilation flow

##### Component Relationships

- Admin interfaces and data storage
- Public templates and data retrieval
- AJAX handlers and data processing
- Block system and WordPress editor

- Nested components
- Different connection types
- Clear labeling
- Export to common formats

Recommended Tools:
- Lucidchart

Remember to:
- Keep the WordPress-specific architecture patterns visible
- Plugin's integration points clearly
- Version information and date
- Notes about development workflows

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "User Interaction"
        Admin["Admin Interface"]
        Public["Public Interface"]
    end

    subgraph "WordPress Integration"
        Plugin["Plugin Entry Point"]:::entry
        Init["WordPress Integration"]:::wp
        Hooks["Hooks System"]:::wp
    end

    subgraph "Admin Components"
        AdminMenu["Admin Menu"]:::admin
        AdminSettings["Settings"]:::admin
        AdminMeeting["Meeting Management"]:::admin
        AdminImport["Import Management"]:::admin
        AdminRegion["Region Management"]:::admin
    end

    subgraph "Core Functionality"
        MeetingFuncs["Meeting Functions"]:::core
        ImportFuncs["Import Functions"]:::core
        FormatFuncs["Format Functions"]:::core
        Shortcodes["Shortcodes"]:::core
    end

    subgraph "Frontend Components"
        Templates["Templates Layer"]:::frontend
        MeetingTemplate["Meeting Template"]:::frontend
        LocationTemplate["Location Template"]:::frontend
        ArchiveTemplate["Archive Template"]:::frontend
        HeaderTemplate["Header Template"]:::frontend
        FooterTemplate["Footer Template"]:::frontend
    end

    subgraph "Block System"
        BlockImpl["Block Implementation"]:::block
        BlockAssets["Block Assets"]:::block
        BlockEditor["Block Editor"]:::block
    end

    subgraph "Asset Management"
        PublicCSS["Public CSS"]:::asset
        AdminCSS["Admin CSS"]:::asset
        PublicJS["Public JavaScript"]:::asset
        AdminJS["Admin JavaScript"]:::asset
    end

    subgraph "Data Flow"
        AjaxHandler["AJAX Handler"]:::data
        MeetingFilter["Meeting Filter"]:::data
        DataSaving["Data Saving"]:::data
    end

    subgraph "Widget System"
        WidgetImpl["Widget Implementation"]:::widget
        WidgetInit["Widget Initialization"]:::widget
    end

    %% Connections
    Admin --> Plugin
    Public --> Plugin
    Plugin --> Init
    Init --> Hooks

    Hooks --> AdminMenu
    Hooks --> AdminSettings
    Hooks --> AdminMeeting
    Hooks --> AdminImport
    Hooks --> AdminRegion

    Hooks --> MeetingFuncs
    Hooks --> ImportFuncs
    Hooks --> FormatFuncs
    Hooks --> Shortcodes

    Hooks --> Templates
    Templates --> MeetingTemplate
    Templates --> LocationTemplate
    Templates --> ArchiveTemplate
    Templates --> HeaderTemplate
    Templates --> FooterTemplate

    Hooks --> BlockImpl
    BlockImpl --> BlockAssets
    BlockImpl --> BlockEditor

    Hooks --> WidgetImpl
    WidgetImpl --> WidgetInit

    AjaxHandler --> MeetingFilter
    MeetingFilter --> DataSaving

    %% Styles
    classDef entry fill:#f9f,stroke:#333
    classDef wp fill:#9cf,stroke:#333
    classDef admin fill:#fc9,stroke:#333
    classDef core fill:#9f9,stroke:#333
    classDef frontend fill:#9f9,stroke:#333
    classDef block fill:#ff9,stroke:#333
    classDef asset fill:#f99,stroke:#333
    classDef data fill:#c9f,stroke:#333
    classDef widget fill:#ccc,stroke:#333

    %% Click Events
    click Plugin "https://github.com/code4recovery/12-step-meeting-list/blob/main/12-step-meeting-list.php"
    click Init "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/init.php"
    click AdminMenu "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/admin_menu.php"
    click AdminSettings "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/admin_settings.php"
    click AdminMeeting "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/admin_meeting.php"
    click AdminImport "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/admin_import.php"
    click AdminRegion "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/admin_region.php"
    click MeetingTemplate "https://github.com/code4recovery/12-step-meeting-list/blob/main/templates/single-meetings.php"
    click LocationTemplate "https://github.com/code4recovery/12-step-meeting-list/blob/main/templates/single-locations.php"
    click ArchiveTemplate "https://github.com/code4recovery/12-step-meeting-list/blob/main/templates/archive-meetings.php"
    click HeaderTemplate "https://github.com/code4recovery/12-step-meeting-list/blob/main/templates/header.php"
    click FooterTemplate "https://github.com/code4recovery/12-step-meeting-list/blob/main/templates/footer.php"
    click BlockImpl "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/blocks/class-tsml-blocks.php"
    click BlockAssets "https://github.com/code4recovery/12-step-meeting-list/blob/main/assets/build/blocks/meetings.js"
    click BlockEditor "https://github.com/code4recovery/12-step-meeting-list/blob/main/assets/src/blocks/edit.js"
    click PublicCSS "https://github.com/code4recovery/12-step-meeting-list/blob/main/assets/css/public.css"
    click AdminCSS "https://github.com/code4recovery/12-step-meeting-list/blob/main/assets/css/admin.css"
    click PublicJS "https://github.com/code4recovery/12-step-meeting-list/blob/main/assets/src/public.js"
    click AdminJS "https://github.com/code4recovery/12-step-meeting-list/blob/main/assets/src/admin.js"
    click MeetingFuncs "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/functions_get.php"
    click ImportFuncs "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/functions_import.php"
    click FormatFuncs "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/functions_format.php"
    click Shortcodes "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/shortcodes.php"
    click AjaxHandler "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/ajax.php"
    click MeetingFilter "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/filter_meetings.php"
    click DataSaving "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/save.php"
    click WidgetImpl "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/widgets.php"
    click WidgetInit "https://github.com/code4recovery/12-step-meeting-list/blob/main/includes/widgets_init.php"
```
