# eviivo/eviivo-wp-booking-widget architecture

> Architecture diagram of the GitHub repository eviivo/eviivo-wp-booking-widget, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eviivo/eviivo-wp-booking-widget
- Repository: https://github.com/eviivo/eviivo-wp-booking-widget

## Overview

eiviivo Booking Widget is a WordPress plugin for configuring and publishing a property booking form. Administrators set property, date, guest, label, and appearance options, save them, and can preview the generated form or inspect its HTML; visitors receive it through a shortcode or widget. The model renders the configured form, while WordPress options persist configuration. The README documents these capabilities and the source index identifies additional modules; unsampled frontend rendering and booking-service handoff are not detailed here, so those links are omitted.

Main entry points: [`src/eviivo/Plugin/Model/BookingForm.php`](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Model/BookingForm.php) (Booking form model), [`src/eviivo/Plugin/Admin/Pages/Forms/BookingFormConfig.php`](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Admin/Pages/Forms/BookingFormConfig.php) (Configuration form), [`src/eviivo/Plugin/Main.php`](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Main.php) (Plugin controller), [`src/eviivo/Plugin/Admin/Pages/Main.php`](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Admin/Pages/Main.php) (Admin page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Plugin lifecycle"]
  node_plugin["Plugin controller<br/>[Main.php]"]
  node_shortcode["Booking shortcode"]
  node_widget["Booking widget<br/>[BookingForm.php]"]
end

subgraph group_admin["Configuration and preview"]
  node_adminpage["Admin page<br/>[Main.php]"]
  node_configform["Configuration form"]
  node_adminview["Admin views<br/>[main.php]"]
  node_previewajax["Preview request"]
  node_htmlajax["Form HTML request"]
end

subgraph group_render["Booking form output"]
  node_model["Booking form model<br/>[BookingForm.php]"]
  node_formtemplate["Public form template<br/>[booking-form.php]"]
  node_options[("WordPress options")]
end

subgraph group_runtime["Request and rendering internals"]
  node_ajax["AJAX request handling<br/>[Request.php]"]
  node_elements["Form elements<br/>[Form.php]"]
  node_htmltag["HTML tag renderer<br/>[HtmlTag.php]"]
  node_viewhelper["View renderer<br/>[View.php]"]
end

node_administrator(("WordPress admin"))
node_visitor(("Site visitor"))
node_wordpress["WordPress"]

node_administrator -->|"configures"| node_wordpress
node_wordpress -.->|"initializes"| node_plugin
node_plugin -->|"registers"| node_shortcode
node_plugin -->|"registers"| node_widget
node_plugin -->|"registers"| node_adminpage
node_plugin -->|"registers"| node_ajax
node_adminpage -->|"creates"| node_configform
node_adminpage -->|"loads"| node_model
node_adminpage -->|"renders"| node_adminview
node_configform -->|"builds"| node_elements
node_configform -->|"hydrates"| node_model
node_adminpage -->|"saves"| node_options
node_adminview -->|"renders"| node_configform
node_adminview -->|"renders preview with"| node_viewhelper
node_previewajax -->|"validates"| node_configform
node_previewajax -->|"generates preview"| node_model
node_htmlajax -->|"uses"| node_configform
node_visitor -.->|"requests form"| node_wordpress
node_shortcode -->|"loads"| node_model
node_widget -->|"loads"| node_model
node_model -->|"persists settings"| node_options
node_model -->|"renders"| node_formtemplate
node_model -->|"uses"| node_viewhelper
node_elements -->|"extends"| node_htmltag

click node_plugin "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Main.php"
click node_shortcode "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/shortcodes/eviivo-booking-form.php"
click node_widget "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Widgets/BookingForm.php"
click node_adminpage "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Admin/Pages/Main.php"
click node_configform "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Admin/Pages/Forms/BookingFormConfig.php"
click node_adminview "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/views/admin/main.php"
click node_previewajax "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Ajax/Calls/PreviewBookingForm.php"
click node_htmlajax "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Ajax/Calls/BookingFormHtml.php"
click node_model "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Model/BookingForm.php"
click node_formtemplate "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/views/booking-form.php"
click node_ajax "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Ajax/Request.php"
click node_elements "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Elements/Form.php"
click node_htmltag "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Elements/HtmlTag.php"
click node_viewhelper "https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Helpers/Php/View.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin,node_shortcode,node_widget toneBlue
class node_adminpage,node_configform,node_adminview,node_previewajax,node_htmlajax toneAmber
class node_model,node_formtemplate,node_options toneMint
class node_ajax,node_elements,node_htmltag,node_viewhelper toneRose
class node_administrator,node_visitor,node_wordpress toneIndigo
```

## Components

### Plugin lifecycle

- [Plugin controller](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Main.php): `src/eviivo/Plugin/Main.php`
- [Booking shortcode](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/shortcodes/eviivo-booking-form.php): `shortcodes/eviivo-booking-form.php`
- [Booking widget](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Widgets/BookingForm.php): `src/eviivo/Plugin/Widgets/BookingForm.php`

### Configuration and preview

- [Admin page](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Admin/Pages/Main.php): `src/eviivo/Plugin/Admin/Pages/Main.php`
- [Configuration form](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Admin/Pages/Forms/BookingFormConfig.php): `src/eviivo/Plugin/Admin/Pages/Forms/BookingFormConfig.php`
- [Admin views](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/views/admin/main.php): `views/admin/main.php`
- [Preview request](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Ajax/Calls/PreviewBookingForm.php): `src/eviivo/Plugin/Ajax/Calls/PreviewBookingForm.php`
- [Form HTML request](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Ajax/Calls/BookingFormHtml.php): `src/eviivo/Plugin/Ajax/Calls/BookingFormHtml.php`

### Booking form output

- [Booking form model](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Model/BookingForm.php): `src/eviivo/Plugin/Model/BookingForm.php`
- [Public form template](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/views/booking-form.php): `views/booking-form.php`
- **WordPress options**

### Request and rendering internals

- [AJAX request handling](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Ajax/Request.php): `src/eviivo/Plugin/Ajax/Request.php`
- [Form elements](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Elements/Form.php): `src/eviivo/Plugin/Elements/Form.php`
- [HTML tag renderer](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Elements/HtmlTag.php): `src/eviivo/Plugin/Elements/HtmlTag.php`
- [View renderer](https://github.com/eviivo/eviivo-wp-booking-widget/blob/master/src/eviivo/Plugin/Helpers/Php/View.php): `src/eviivo/Plugin/Helpers/Php/View.php`

### Other components

- **WordPress admin**
- **Site visitor**
- **WordPress**

## Connections

- WordPress admin → WordPress: configures
- WordPress → Plugin controller: initializes
- Plugin controller → Booking shortcode: registers (evidence: `src/eviivo/Plugin/Main.php`)
- Plugin controller → Booking widget: registers (evidence: `src/eviivo/Plugin/Main.php`)
- Plugin controller → Admin page: registers (evidence: `src/eviivo/Plugin/Main.php`)
- Plugin controller → AJAX request handling: registers (evidence: `src/eviivo/Plugin/Main.php`)
- Admin page → Configuration form: creates (evidence: `src/eviivo/Plugin/Admin/Pages/Main.php`)
- Admin page → Booking form model: loads (evidence: `src/eviivo/Plugin/Admin/Pages/Main.php`)
- Admin page → Admin views: renders (evidence: `src/eviivo/Plugin/Admin/Pages/Main.php`)
- Configuration form → Form elements: builds (evidence: `src/eviivo/Plugin/Admin/Pages/Forms/BookingFormConfig.php`)
- Configuration form → Booking form model: hydrates (evidence: `src/eviivo/Plugin/Admin/Pages/Forms/BookingFormConfig.php`)
- Admin page → WordPress options: saves (evidence: `src/eviivo/Plugin/Admin/Pages/Main.php`)
- Admin views → Configuration form: renders (evidence: `views/admin/main.php`)
- Admin views → View renderer: renders preview with (evidence: `views/admin/main.php`)
- Preview request → Configuration form: validates (evidence: `src/eviivo/Plugin/Ajax/Calls/PreviewBookingForm.php`)
- Preview request → Booking form model: generates preview (evidence: `src/eviivo/Plugin/Ajax/Calls/PreviewBookingForm.php`)
- Form HTML request → Configuration form: uses (evidence: `src/eviivo/Plugin/Ajax/Calls/BookingFormHtml.php`)
- Site visitor → WordPress: requests form
- Booking shortcode → Booking form model: loads (evidence: `shortcodes/eviivo-booking-form.php`)
- Booking widget → Booking form model: loads (evidence: `src/eviivo/Plugin/Widgets/BookingForm.php`)
- Booking form model → WordPress options: persists settings (evidence: `src/eviivo/Plugin/Model/BookingForm.php`)
- Booking form model → Public form template: renders (evidence: `src/eviivo/Plugin/Model/BookingForm.php`)
- Booking form model → View renderer: uses (evidence: `src/eviivo/Plugin/Model/BookingForm.php`)
- Form elements → HTML tag renderer: extends (evidence: `src/eviivo/Plugin/Elements/Form.php`)
