# damonsomu/better-adsmanager architecture

> Architecture diagram of the GitHub repository damonsomu/better-adsmanager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/damonsomu/better-adsmanager
- Repository: https://github.com/damonsomu/better-adsmanager

## Overview

##### Project Type and Purpose
- This is a WordPress plugin (“better-adsmanager.php”) that provides ad management features (AdSense, DFP, image ads, AMP support).
- It uses the “Better Framework” (under includes/libs/better-framework) to generate admin panels, Gutenberg blocks, page-builder integrations, shortcodes, widgets, etc.

##### File Structure
Top-level components:
- Plugin root: better-adsmanager.php (bootstrap), functions.php
- Assets: css/, js/, templates/
- Includes/:
– dynamics/ (dynamic CSS injection)
– fia/ (rules engine configuration)
– options/ (settings panels and fields)
– shortcodes/ (PHP classes for ad shortcodes)
– widgets/ (widget classes)
– libs/better-framework/ (core framework modules)

##### Main Components
A. WordPress Core
B. Plugin Bootstrap
– better-adsmanager.php (registers hooks, enqueues assets)
– functions.php
C. Better Framework Library
– Admin-Page & Admin-Panel
– Field Generator (all form fields)
– Gutenberg Adapters & Blocks
– Page-Builder Integrations (Elementor, VC, KC)
– Shortcodes Manager
– Widgets Manager
– Taxonomy & Metabox Generators
– Content Injector & Utilities
D. Plugin-Specific Modules
– Dynamics (editor_css.php): dynamic style injection
– FIA (rule engine + JSON config)
– Options (settings pages + panel-fields)
– Shortcodes (class-better-ads-shortcode.php)
– Widgets (class-better-ads-widget.php)
E. Assets
– CSS (bam.css, admin styles)
– JS (bam.js, bam-admin.js, adsense-lazy.js)
– Templates (normal-adsense.php, normal-dfp.php, AMP variants)
F. External Services
– Google AdSense API / script
– DFP / Google Ad Manager
– (Optionally any other ad network)

##### Relationships & Data Flows
1. WordPress loads plugin bootstrap → registers hooks (init, admin_menu, enqueue_scripts).
2. Admin request:
- Hooks → Better Framework Admin-Page/Panel modules → renders settings UI
- Options saved → WordPress DB (wp_options / postmeta)
3. Content editor (TinyMCE / Gutenberg):
- Editor shortcodes & Gutenberg adapters → display ad blocks in editor
- Field-generator → populates control panels in editor UI
4. Frontend request:
- Hooks → front-end CSS/JS enqueued
- Shortcode / widget → query stored settings from DB
- Templates → render appropriate ad markup (AdSense/DFP calls)
- External scripts loaded to fetch/serve ads
5. Page-Builder integration:
- BF Page-Builder Adapters → map plugin fields to VC/Elementor modules
- Generates shortcodes/widgets under the hood

##### Architectural Patterns & Design Principles
- Modular plugin design (separate folder per feature)
- Dependency injection via Better Framework init files
- Single point of entry (plugin bootstrap)
- Use of WordPress hooks (actions & filters) as events
- MVC-like separation (settings UI vs. rendering logic vs. templates)
- Extensibility layers (page builder & Gutenberg adapters)

##### Diagramming Recommendations
– Blue rectangles for WordPress Core & DB
– Orange for Plugin-Specific modules (Dynamics, FIA, Options, Shortcodes, Widgets)
– WordPress → Plugin Bootstrap
– Plugin Bootstrap → Framework Modules → DB (read/write)
– Frontend → Templates → External Ad Services
– Admin UI layer
– Editor integration layer
– Frontend rendering layer

- Clear component labels (e.g., “BF Field Generator”, “AdSense Template”)

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "WordPress Layer"
        WP["WordPress Core"]:::wordpressCore
    end

    subgraph "Plugin Bootstrap"
        BBP["better-adsmanager.php"]:::plugin
        FN["functions.php"]:::plugin
    end

    subgraph "Better Framework Library"
        BFInit["BF Init"]:::framework
        BFCore["BF Core"]:::framework
        BFAdminMenus["BF Admin Menus"]:::framework
        BFAdminPage["BF Admin Page"]:::framework
        BFAdminPanel["BF Admin Panel"]:::framework
        BFFieldGen["BF Field Generator"]:::framework
        BFContentInject["BF Content Injector"]:::framework
        BFGutenberg["BF Gutenberg"]:::framework
        BFPageBuilder["BF Page-Builder"]:::framework
        BFShortcodesMgr["BF Shortcodes Manager"]:::framework
        BFWidgetsMgr["BF Widgets Manager"]:::framework
        BFTaxonomy["BF Taxonomy"]:::framework
        BFUserMetabox["BF User Metabox"]:::framework
        BFUtils["BF Core Utils"]:::framework
        BFGutenMap["Gutenberg Field Mapper"]:::framework
        BFPageAdapters["PageBuilder Field Adapters"]:::framework
    end

    subgraph "Plugin Modules"
        Dyn["Dynamics"]:::module
        FIA["FIA (Rules Engine)"]:::module
        Opt["Options"]:::module
        SC["Shortcodes"]:::module
        Wg["Widgets"]:::module
    end

    subgraph "Assets & Templates"
        CSS["CSS Assets"]:::assets
        JS["JS Assets"]:::assets
        TPL["Frontend Templates"]:::assets
    end

    DB["WP Database"]:::db

    subgraph "External Ad Services"
        AdSense["Google AdSense"]:::external
        DFP["DFP / Google Ad Manager"]:::external
    end

    WP -->|"init"| BBP
    BBP --> FN
    BBP -->|"loads"| BFInit
    BFInit --> BFCore

    BFCore --> BFAdminMenus
    BFCore --> BFAdminPage
    BFCore --> BFAdminPanel
    BFCore --> BFFieldGen
    BFCore --> BFContentInject
    BFCore --> BFGutenberg
    BFCore --> BFPageBuilder
    BFCore --> BFShortcodesMgr
    BFCore --> BFWidgetsMgr
    BFCore --> BFTaxonomy
    BFCore --> BFUserMetabox
    BFCore --> BFUtils
    BFCore --> BFGutenMap
    BFCore --> BFPageAdapters

    BFFieldGen --> Dyn
    BFContentInject --> Dyn
    BFGutenberg --> SC
    BFPageBuilder --> SC
    SC -->|"renders"| TPL
    Wg -->|"renders"| TPL
    Opt --> DB
    SC --> DB
    Wg --> DB

    TPL --> AdSense
    TPL --> DFP

    CSS -->|"enqueued"| Dyn
    JS -->|"enqueued"| SC

    click BBP "https://github.com/damonsomu/better-adsmanager/blob/main/better-adsmanager.php"
    click FN "https://github.com/damonsomu/better-adsmanager/blob/main/functions.php"
    click Dyn "https://github.com/damonsomu/better-adsmanager/blob/main/includes/dynamics/editor_css.php"
    click FIA "https://github.com/damonsomu/better-adsmanager/blob/main/includes/fia/bam-fia.php"
    click FIA "https://github.com/damonsomu/better-adsmanager/blob/main/includes/fia/rules-configuration.json"
    click Opt "https://github.com/damonsomu/better-adsmanager/blob/main/includes/options/panel.php"
    click Opt "https://github.com/damonsomu/better-adsmanager/blob/main/includes/options/panel-fields-css.php"
    click Opt "https://github.com/damonsomu/better-adsmanager/blob/main/includes/options/panel-config.php"
    click Opt "https://github.com/damonsomu/better-adsmanager/blob/main/includes/options/metabox.php"
    click Opt "https://github.com/damonsomu/better-adsmanager/blob/main/includes/options/metabox-fields.php"
    click Opt "https://github.com/damonsomu/better-adsmanager/blob/main/includes/options/metabox-fields-responsive-cb.php"
    click Opt "https://github.com/damonsomu/better-adsmanager/blob/main/includes/options/metabox-std.php"
    click Opt "https://github.com/damonsomu/better-adsmanager/blob/main/includes/options/taxonomy.php"
    click SC "https://github.com/damonsomu/better-adsmanager/blob/main/includes/shortcodes/class-better-ads-shortcode.php"
    click Wg "https://github.com/damonsomu/better-adsmanager/blob/main/includes/widgets/class-better-ads-widget.php"
    click BFInit "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/init.php"
    click BFInit "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/class-better-framework.php"
    click BFAdminMenus "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/admin-menus/class-bf-admin-menus.php"
    click BFAdminPage "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/admin-page/class-bf-admin-page.php"
    click BFAdminPanel "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/admin-panel/class-bf-admin-panel.php"
    click BFAdminPanel "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/admin-panel/class-bf-options.php"
    click BFFieldGen "https://github.com/damonsomu/better-adsmanager/tree/main/includes/libs/better-framework/core/field-generator/"
    click BFContentInject "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/content-injector/bf-content-inject.php"
    click BFGutenberg "https://github.com/damonsomu/better-adsmanager/tree/main/includes/libs/better-framework/gutenberg/"
    click BFPageBuilder "https://github.com/damonsomu/better-adsmanager/tree/main/includes/libs/better-framework/page-builder/"
    click BFShortcodesMgr "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/shortcode/class-bf-shortcodes-manager.php"
    click BFWidgetsMgr "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/widget/class-bf-widgets-manager.php"
    click BFTaxonomy "https://github.com/damonsomu/better-adsmanager/tree/main/includes/libs/better-framework/taxonomy/"
    click BFUserMetabox "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/user-metabox/class-bf-user-metabox-core.php"
    click CSS "https://github.com/damonsomu/better-adsmanager/blob/main/css/bam.css"
    click JS "https://github.com/damonsomu/better-adsmanager/blob/main/js/bam.js"
    click TPL "https://github.com/damonsomu/better-adsmanager/tree/main/templates/"
    click BFUtils "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/core/class-bf-assets-manager.php"
    click BFGutenMap "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/gutenberg/class-bf-fields-to-gutenberg.php"
    click BFPageAdapters "https://github.com/damonsomu/better-adsmanager/blob/main/includes/libs/better-framework/page-builder/adapters/class-bf-to-vc-fields-adapter.php"

    classDef wordpressCore fill:#dae8fc,stroke:#6c8ebf
    classDef plugin fill:#d5e8d4,stroke:#82b366
    classDef framework fill:#e1d5e7,stroke:#9673a6
    classDef module fill:#f8cecc,stroke:#b85450
    classDef assets fill:#fff2cc,stroke:#d6b656
    classDef db fill:#ffe6cc,stroke:#d79b00,stroke-dasharray:5 5
    classDef external fill:#e0e0e0,stroke:#999999
```
