# qtranslate/qtranslate-xt architecture

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

- Interactive diagram: https://gitdiagram.com/qtranslate/qtranslate-xt
- Repository: https://github.com/qtranslate/qtranslate-xt

## Overview

##### Main Components Identification

The system should be represented with these key components:

a. Core Components:
- Language Management System
- Content Translation Storage
- URL Management
- Admin Interface
- Frontend Display
- REST API Integration

b. Module System:
- Module Manager
- Built-in Modules (ACF, WooCommerce, etc.)
- Integration Framework

##### Architectural Layers

**┌─ WordPress Integration Layer ─────────────────────┐**
- Admin Hooks                                     │
- Frontend Hooks                                  │
- Block Editor Integration                        │
- ┘
**┌─ Core Services Layer ───────────────────────────┐**
- Language Detection                            │
- URL Management                                │
- Content Translation                           │
- Language Switching                            │
- ┘
**┌─ Module Layer ──────────────────────────────────┐**
- Module Manager                                │
- Plugin-specific Modules                       │
- i18n Configurations                           │
- ┘
**┌─ Storage Layer ─────────────────────────────────┐**
- WordPress Database                            │
- Options Storage                               │
- Language Configuration                        │
- ┘

##### Integration Points

Integration with:
- WordPress core
- Third-party plugins (via modules)
- Theme integration
- Database layer

##### Notes

Annotations for:
- Language storage strategy (single post)
- Module system extensibility
- Integration points for developers
- Configuration options

Remember to maintain a balance between detail and clarity, focusing on the architectural decisions that make qTranslate-XT unique in its approach to WordPress multilingual content management.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles and classes
    classDef wordpress fill:#4A90E2,color:white
    classDef translation fill:#50C878,color:white
    classDef module fill:#FFA500,color:white
    classDef admin fill:#9370DB,color:white
    classDef storage fill:#808080,color:white
    classDef api fill:#FF6B6B,color:white

    %% WordPress Integration Layer
    subgraph WP[WordPress Integration]
        WPHooks["WordPress Hooks"]:::wordpress
        BlockEditor["Block Editor Integration"]:::wordpress
        WPCompat["Compatibility Layer"]:::wordpress
    end
    click WPHooks "https://github.com/qtranslate/qtranslate-xt/blob/master/src/hooks.php"
    click WPCompat "https://github.com/qtranslate/qtranslate-xt/blob/master/src/compatibility.php"

    %% Core Services Layer
    subgraph Core[Core Services]
        LangDetect["Language Detection"]:::translation
        URLManager["URL Management"]:::translation
        ContentTrans["Content Translation"]:::translation
        LangSwitch["Language Switching"]:::translation
    end
    click LangDetect "https://github.com/qtranslate/qtranslate-xt/blob/master/src/language_detect.php"
    click URLManager "https://github.com/qtranslate/qtranslate-xt/blob/master/src/url.php"
    click ContentTrans "https://github.com/qtranslate/qtranslate-xt/blob/master/src/class_translator.php"

    %% Admin Interface Layer
    subgraph Admin[Admin Interface]
        AdminPanel["Admin Panel"]:::admin
        Settings["Settings Management"]:::admin
        LangConfig["Language Configuration"]:::admin
    end
    click AdminPanel "https://github.com/qtranslate/qtranslate-xt/blob/master/src/admin/admin.php"
    click Settings "https://github.com/qtranslate/qtranslate-xt/blob/master/src/admin/admin_settings.php"
    click LangConfig "https://github.com/qtranslate/qtranslate-xt/blob/master/src/admin/languages.php"

    %% Module Layer
    subgraph Modules[Module System]
        ModuleManager["Module Manager"]:::module
        ACF["ACF Module"]:::module
        WooCommerce["WooCommerce Module"]:::module
        WPSEO["WP SEO Module"]:::module
    end
    click ModuleManager "https://github.com/qtranslate/qtranslate-xt/blob/master/src/modules/module_loader.php"
    click ACF "https://github.com/qtranslate/qtranslate-xt/tree/master/src/modules/acf/"
    click WooCommerce "https://github.com/qtranslate/qtranslate-xt/tree/master/src/modules/woo-commerce/"
    click WPSEO "https://github.com/qtranslate/qtranslate-xt/tree/master/src/modules/wp-seo/"

    %% Storage Layer
    subgraph Storage[Storage Layer]
        WPDatabase["WordPress Database"]:::storage
        Options["Options Storage"]:::storage
        LangStore["Language Storage"]:::storage
    end
    click WPDatabase "https://github.com/qtranslate/qtranslate-xt/blob/master/src/admin/admin_utils_db.php"
    click Options "https://github.com/qtranslate/qtranslate-xt/blob/master/src/options.php"

    %% Frontend and API
    Frontend["Frontend Display"]:::wordpress
    RestAPI["REST API"]:::api
    click Frontend "https://github.com/qtranslate/qtranslate-xt/blob/master/src/frontend.php"
    click RestAPI "https://github.com/qtranslate/qtranslate-xt/blob/master/src/rest_api.php"

    %% Integration Framework
    I18nConfig["i18n Configuration"]:::module
    click I18nConfig "https://github.com/qtranslate/qtranslate-xt/tree/master/i18n-config/"

    %% Relationships
    WP --> Core
    Core --> Storage
    Core --> Frontend
    Core --> RestAPI
    Admin --> Core
    Modules --> Core
    I18nConfig --> Modules
    ModuleManager --> ACF & WooCommerce & WPSEO

    %% Legend
    subgraph Legend
        L1["WordPress Integration"]:::wordpress
        L2["Translation Components"]:::translation
        L3["Module System"]:::module
        L4["Admin Interface"]:::admin
        L5["Storage Components"]:::storage
        L6["API Components"]:::api
    end
```
