# quantagra/bricksforge architecture

> Architecture diagram of the GitHub repository quantagra/bricksforge, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/quantagra/bricksforge
- Repository: https://github.com/quantagra/bricksforge

## Overview

##### Main Components Organization

a) Core Plugin Infrastructure:
- Admin Management (from includes/Admin.php)
- Asset Handling (from includes/Assets.php)
- API Layer (from includes/Api.php)
- Frontend Controller (from includes/Frontend.php)

b) Feature Modules:
- Forms System (includes/elements/pro-forms)
- Dynamic Data System (includes/dynamic-data)
- Conditional Logic System (includes/conditional-logic)
- Page Builder Elements (includes/elements)
- Popup System (includes/popups)
- Email Designer (includes/email-designer)

##### Integration Points

Integration with external systems:
- WordPress Core (primary integration point)
- Bricks Builder (main dependency)
- WooCommerce Integration (includes/woocommerce)
- Third-party Services (Mailchimp, SendGrid)

##### Asset Management

An assets management section showing:
- JavaScript Bundle Management
- CSS Management
- Font Management
- Image Resources

##### Specific Implementation Details

- Blue: Core plugin components
- Green: Feature modules
- Orange: Third-party integrations
- Purple: Asset management
- Gray: External services

##### Data Flow Representation

- API Communications
- Form Submissions Flow
- Dynamic Data Flow
- Conditional Logic Processing

##### Component Relationships

Relationships:
- Forms → Form Submissions
- Dynamic Data → Data Providers
- Elements → Builder Integration
- Conditional Logic → Rule Processing

##### Technical Implementation Notes

A technical notes section showing:
- PHP 7.2+ Requirement
- WordPress 4.0+ Compatibility
- Bricks Builder 1.5.1+ Dependency

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Core["Core Plugin Infrastructure"]
        Admin["Admin Management"]
        Assets["Asset Handling"]
        API["API Layer"]
        Frontend["Frontend Controller"]
    end

    subgraph Features["Feature Modules"]
        Forms["Forms System"]
        DynamicData["Dynamic Data System"]
        ConditionalLogic["Conditional Logic System"]
        Elements["Page Builder Elements"]
        Popups["Popup System"]
        EmailDesigner["Email Designer"]
    end

    subgraph Integrations["Third-party Integrations"]
        WooCommerce["WooCommerce"]
        Mailchimp["Mailchimp"]
        SendGrid["SendGrid"]
    end

    subgraph AssetManagement["Asset Management"]
        JS["JavaScript Bundle"]
        CSS["CSS Management"]
        Fonts["Font Management"]
    end

    subgraph FormActions["Form Actions"]
        EmailActions["Email Actions"]
        FormSubmissions["Form Submissions"]
        CustomActions["Custom Actions"]
    end

    subgraph Additional["Additional Features"]
        Permissions["Permissions System"]
        PageTransitions["Page Transitions"]
        WhiteLabel["White Labeling"]
    end

    WordPress((WordPress))
    BricksBuilder((Bricks Builder))

    WordPress --> Core
    BricksBuilder --> Core
    Core --> Features
    Core --> Integrations
    Core --> AssetManagement
    Forms --> FormActions
    Forms --> Integrations

    %% Click events for components
    click Admin "https://github.com/quantagra/bricksforge/blob/main/includes/Admin.php"
    click Assets "https://github.com/quantagra/bricksforge/blob/main/includes/Assets.php"
    click API "https://github.com/quantagra/bricksforge/blob/main/includes/Api.php"
    click Frontend "https://github.com/quantagra/bricksforge/blob/main/includes/Frontend.php"
    click Forms "https://github.com/quantagra/bricksforge/blob/main/includes/elements/pro-forms/ProForms.php"
    click DynamicData "https://github.com/quantagra/bricksforge/blob/main/includes/dynamic-data/DynamicData.php"
    click ConditionalLogic "https://github.com/quantagra/bricksforge/blob/main/includes/conditional-logic/ConditionalLogic.php"
    click Elements "https://github.com/quantagra/bricksforge/blob/main/includes/elements/Elements.php"
    click Popups "https://github.com/quantagra/bricksforge/blob/main/includes/popups/Popups.php"
    click EmailDesigner "https://github.com/quantagra/bricksforge/blob/main/includes/email-designer/EmailDesigner.php"
    click WooCommerce "https://github.com/quantagra/bricksforge/blob/main/includes/woocommerce/WooCommerce.php"
    click Mailchimp "https://github.com/quantagra/bricksforge/blob/main/includes/elements/pro-forms/actions/mailchimp.php"
    click SendGrid "https://github.com/quantagra/bricksforge/blob/main/includes/elements/pro-forms/actions/sendgrid.php"
    click JS "https://github.com/quantagra/bricksforge/tree/main/assets/bundle"
    click CSS "https://github.com/quantagra/bricksforge/tree/main/assets/css"
    click Fonts "https://github.com/quantagra/bricksforge/tree/main/assets/fonts"
    click EmailActions "https://github.com/quantagra/bricksforge/blob/main/includes/elements/pro-forms/actions/email.php"
    click FormSubmissions "https://github.com/quantagra/bricksforge/blob/main/includes/form-submissions/FormSubmissions.php"
    click CustomActions "https://github.com/quantagra/bricksforge/blob/main/includes/elements/pro-forms/actions/custom.php"
    click Permissions "https://github.com/quantagra/bricksforge/blob/main/includes/permissions/Permissions.php"
    click PageTransitions "https://github.com/quantagra/bricksforge/blob/main/includes/page-transitions/PageTransitions.php"
    click WhiteLabel "https://github.com/quantagra/bricksforge/blob/main/includes/whitelabel/WhiteLabel.php"

    %% Styling
    classDef core fill:#a8d1f0
    classDef features fill:#90EE90
    classDef integrations fill:#FFB347
    classDef assets fill:#DDA0DD
    classDef external fill:#D3D3D3
    classDef formactions fill:#F0E68C

    class Admin,Assets,API,Frontend core
    class Forms,DynamicData,ConditionalLogic,Elements,Popups,EmailDesigner features
    class WooCommerce,Mailchimp,SendGrid integrations
    class JS,CSS,Fonts assets
    class WordPress,BricksBuilder external
    class EmailActions,FormSubmissions,CustomActions formactions

    %% Legend
    subgraph Legend
        CoreL["Core Components"]:::core
        FeaturesL["Feature Modules"]:::features
        IntegrationsL["Third-party Integrations"]:::integrations
        AssetsL["Asset Management"]:::assets
        ExternalL["External Systems"]:::external
        FormActionsL["Form Actions"]:::formactions
    end
```
