# wp-plugins/contact-form-7 architecture

> Architecture diagram of the GitHub repository wp-plugins/contact-form-7, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wp-plugins/contact-form-7
- Repository: https://github.com/wp-plugins/contact-form-7

## Overview

##### Project type and purpose
- This is a WordPress plugin (“Contact Form 7”) that provides a highly customizable AJAX-powered contact form system.
- It integrates with WordPress core (hooks, filters) and third-party services (Akismet, reCAPTCHA).

##### File structure
- Top-level files:
- wp-contact-form-7.php – the plugin bootstrap (registers WP hooks, loads dependencies)
- readme.txt, license.txt – metadata
- settings.php, uninstall.php – lifecycle management
- Directories:
- admin/ – admin-side UI: settings pages, editor, help tabs, tag generator
- includes/ – core engine: form controller, formatting, submission, validation, mailing, integration; also enqueues CSS/JS
- modules/ – implementations of form-tag modules (text, email, checkbox, file, CAPTCHA, Akismet, reCAPTCHA, etc.)
- languages/ – gettext .po/.mo files for localization

##### README insights
- Plugin supports multiple forms, Ajax submission, CAPTCHA, spam filtering (Akismet), third-party mail integration, extensibility via modules.
- No built-in persistence beyond mailing unless “Flamingo” plugin is used.

a. Main components
1. WordPress Core
2. Plugin Bootstrap (wp-contact-form-7.php)
3. Admin UI (admin/)
4. Front-end Renderer (includes/contact-form.php + shortcodes)
5. Form Controller & Submission Pipeline (includes/controller.php → submission.php → validation.php)
6. Module Handlers (modules/*.php)
7. Mail & Integration Layer (includes/mail.php, includes/integration.php)
8. External Services:
– Akismet API
– reCAPTCHA service
– Mail server (PHP mail or SMTP)
9. Optional Persistence (Flamingo plugin)
10. Localization (languages/*.mo)

b. Relationships & interactions
- User requests a page → WP core loads plugin bootstrap
- Shortcode → Front-end Renderer injects HTML+JS
- On submit (AJAX): HTTP POST → Form Controller
- Dispatch to validation → Module Handlers for each tag
- Spam check via Akismet module
- CAPTCHA verification via reCAPTCHA module
- On success → Mail & Integration layer sends email and invokes hooks for Flamingo
- Admin UI communicates with plugin bootstrap to CRUD forms & menus

c. Architectural patterns & principles
- Hook-based plugin architecture (WP actions/filters)
- Modular design: each form-tag is a separate module implementing a common interface
- Separation of concerns: admin UI vs. front-end renderer vs. core pipeline

d. Key technologies & frameworks
- PHP 5.2+ running within WordPress
- JavaScript: jQuery, jQuery UI, ajax form submission (jquery.form.js)
- gettext for translations
- Optional external services (Akismet, reCAPTCHA)

## Diagram (Mermaid)

```mermaid
graph TD
    %% Lanes
    subgraph "WordPress Core"
        WP["WordPress Core"]:::wpcore
    end

    subgraph "Plugin Internals"
        PB["Plugin Bootstrap\n(wp-contact-form-7.php)"]:::core
        click PB "https://github.com/wp-plugins/contact-form-7/blob/master/wp-contact-form-7.php"

        subgraph "Lifecycle Management"
            ST["Settings"]:::core
            click ST "https://github.com/wp-plugins/contact-form-7/blob/master/settings.php"
            UL["Uninstall"]:::core
            click UL "https://github.com/wp-plugins/contact-form-7/blob/master/uninstall.php"
        end

        subgraph "Admin UI" 
            AUI["Admin Interface"]:::admin
            click AUI "https://github.com/wp-plugins/contact-form-7/tree/master/admin/"
        end

        subgraph "Front-end Renderer"
            FE1["contact-form.php"]:::frontend
            click FE1 "https://github.com/wp-plugins/contact-form-7/blob/master/includes/contact-form.php"
            FE2["contact-form-template.php"]:::frontend
            click FE2 "https://github.com/wp-plugins/contact-form-7/blob/master/includes/contact-form-template.php"
            FE3["shortcodes.php"]:::frontend
            click FE3 "https://github.com/wp-plugins/contact-form-7/blob/master/includes/shortcodes.php"
        end

        subgraph "Core Pipeline" 
            CTRL["Controller\n(controller.php)"]:::core
            click CTRL "https://github.com/wp-plugins/contact-form-7/blob/master/includes/controller.php"
            SUB["Submission\n(submission.php)"]:::core
            click SUB "https://github.com/wp-plugins/contact-form-7/blob/master/includes/submission.php"
            VAL["Validation\n(validation.php)"]:::core
            click VAL "https://github.com/wp-plugins/contact-form-7/blob/master/includes/validation.php"
            PIPE["Pipeline\n(pipe.php)"]:::core
            click PIPE "https://github.com/wp-plugins/contact-form-7/blob/master/includes/pipe.php"
        end

        subgraph "Modules\n(Form-tag Modules)"
            MOD["Modules Directory"]:::module
            click MOD "https://github.com/wp-plugins/contact-form-7/tree/master/modules/"
        end

        subgraph "Mail & Integration"
            MAIL["Mail Layer\n(mail.php)"]:::core
            click MAIL "https://github.com/wp-plugins/contact-form-7/blob/master/includes/mail.php"
            INTG["Integration\n(integration.php)"]:::core
            click INTG "https://github.com/wp-plugins/contact-form-7/blob/master/includes/integration.php"
        end

        subgraph "Utilities"
            CAP["Capabilities\n(capabilities.php)"]:::util
            click CAP "https://github.com/wp-plugins/contact-form-7/blob/master/includes/capabilities.php"
            FMT["Formatting\n(formatting.php)"]:::util
            click FMT "https://github.com/wp-plugins/contact-form-7/blob/master/includes/formatting.php"
            FUN["Functions\n(functions.php)"]:::util
            click FUN "https://github.com/wp-plugins/contact-form-7/blob/master/includes/functions.php"
            UPG["Upgrade\n(upgrade.php)"]:::util
            click UPG "https://github.com/wp-plugins/contact-form-7/blob/master/includes/upgrade.php"
        end

        subgraph "Assets & Localization"
            LOC["Localization\n(languages/)"]:::util
            click LOC "https://github.com/wp-plugins/contact-form-7/tree/master/languages/"
            CSS["CSS Assets\n(includes/css/)"]:::util
            click CSS "https://github.com/wp-plugins/contact-form-7/tree/master/includes/css/"
            JS["JS Assets\n(includes/js/)"]:::util
            click JS "https://github.com/wp-plugins/contact-form-7/tree/master/includes/js/"
            IMG["Images\n(images/service-icons/)"]:::util
            click IMG "https://github.com/wp-plugins/contact-form-7/tree/master/images/service-icons/"
        end
    end

    subgraph "External Services"
        AK["Akismet API"]:::external
        RC["reCAPTCHA Service"]:::external
        MS["Mail Server\n(PHP mail/SMTP)"]:::external
        FL["Flamingo Plugin (Optional)"]:::external
    end

    %% Connections
    WP -->|loads| PB
    PB -->|registers hooks| AUI
    PB -->|registers shortcode| FE1
    FE1 --> FE2
    FE2 --> FE3

    FE3 -->|"AJAX Submit"| CTRL
    CTRL --> SUB
    SUB --> VAL
    VAL --> PIPE
    PIPE --> MOD
    MOD --> AK
    MOD --> RC
    VAL --> AK
    VAL --> RC
    PIPE --> MAIL
    MAIL --> MS
    PIPE --> INTG
    INTG --> FL

    %% Styles
    classDef wpcore fill:#f2f2f2,stroke:#333,stroke-width:1px;
    classDef core fill:#cce5ff,stroke:#1a73e8,stroke-width:1px;
    classDef admin fill:#e6ffe6,stroke:#20b020,stroke-width:1px;
    classDef frontend fill:#fff0b3,stroke:#e08e00,stroke-width:1px;
    classDef module fill:#ffebcc,stroke:#d99000,stroke-width:1px;
    classDef util fill:#f9e6ff,stroke:#a64da6,stroke-width:1px;
    classDef external fill:#ffd6d6,stroke:#e80000,stroke-width:1px;
```
