# vinny/phpbb-calendar architecture

> Architecture diagram of the GitHub repository vinny/phpbb-calendar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vinny/phpbb-calendar
- Repository: https://github.com/vinny/phpbb-calendar

## Overview

EventBoard is a phpBB calendar and event-management extension. Forum members browse calendars and event pages, create or manage events, and interact through comments and RSVPs; administrators configure the extension and manage categories and events. Separate capabilities include feeds, calendar exports and sharing, venue search and map previews, and notifications/reminders. The controller, query service, ACP module, listener, and reminder task have sampled evidence; several feature services are represented from the README and tree, so their internal call wiring is intentionally omitted.

Main entry points: [`controller/main.php`](https://github.com/vinny/phpbb-calendar/blob/main/controller/main.php) (Calendar controller), [`acp/main_module.php`](https://github.com/vinny/phpbb-calendar/blob/main/acp/main_module.php) (ACP management), [`service/event_manager.php`](https://github.com/vinny/phpbb-calendar/blob/main/service/event_manager.php) (Event management), [`service/event_query.php`](https://github.com/vinny/phpbb-calendar/blob/main/service/event_query.php) (Event queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Forum experience"]
  node_controller["Calendar controller<br/>[main.php]"]
  node_listener["Forum listener<br/>[main_listener.php]"]
  node_calendar_ui["Calendar interface"]
  node_language["English strings<br/>[common.php]"]
end

subgraph group_domain["Event services"]
  node_query["Event queries<br/>[event_query.php]"]
  node_manager["Event management<br/>[event_manager.php]"]
  node_access["Event access<br/>[event_access.php]"]
  node_forms["Event forms<br/>[event_form.php]"]
  node_display["Event display<br/>[event_display.php]"]
  node_geo["Venue search<br/>[geo_proxy.php]"]
  node_maps["Map previews<br/>[map_image.php]"]
end

subgraph group_engagement["Engagement and alerts"]
  node_feeds["Feeds and export<br/>[feed.php]"]
  node_sharing["Event sharing<br/>[share.php]"]
  node_calendar_links["Calendar links<br/>[calendar_link.php]"]
  node_calendar_add["Calendar export links<br/>[calendar_add.php]"]
  node_comments["Event comments<br/>[comment.php]"]
  node_rsvp["RSVP handling<br/>[rsvp.php]"]
  node_reminder_service["Reminder dispatch<br/>[event_reminder.php]"]
  node_reminder_task["Reminder task<br/>[event_reminder.php]"]
  node_notifications["Event notifications"]
end

subgraph group_admin["Administration"]
  node_acp["ACP management<br/>[main_module.php]"]
  node_acp_categories["Category controls"]
end

node_members(("Forum members"))
node_geoapify{{"Geoapify"}}
node_database[("phpBB database")]
node_admins(("Administrators"))

node_members -->|"use calendar"| node_controller
node_controller -->|"render calendar"| node_calendar_ui
node_controller -.->|"query events"| node_query
node_controller -.->|"manage event forms"| node_forms
node_controller -.->|"manage comments"| node_comments
node_controller -.->|"manage RSVPs"| node_rsvp
node_controller -.->|"provide feeds"| node_feeds
node_controller -.->|"offer exports"| node_calendar_add
node_controller -.->|"offer sharing"| node_sharing
node_controller -.->|"serve venue search"| node_geo
node_geo -->|"search venues"| node_geoapify
node_manager -->|"write events"| node_database
node_query -->|"read events"| node_database
node_manager -->|"generate previews"| node_maps
node_members -.->|"visit forum"| node_listener
node_listener -->|"load event summaries"| node_query
node_admins -->|"configure extension"| node_acp
node_acp -->|"delete events"| node_manager
node_acp -.->|"manage categories"| node_acp_categories
node_reminder_task -->|"dispatch reminders"| node_reminder_service
node_reminder_service -.->|"send reminders"| node_notifications
node_members -->|"discuss events"| node_comments
node_members -->|"confirm attendance"| node_rsvp
node_controller -.->|"show event details"| node_display
node_controller -.->|"check visibility"| node_access
node_controller -.->|"build event links"| node_calendar_links

click node_controller "https://github.com/vinny/phpbb-calendar/blob/main/controller/main.php"
click node_listener "https://github.com/vinny/phpbb-calendar/blob/main/event/main_listener.php"
click node_calendar_ui "https://github.com/vinny/phpbb-calendar/blob/main/styles/prosilver/template/event_calendar.html"
click node_language "https://github.com/vinny/phpbb-calendar/blob/main/language/en/common.php"
click node_query "https://github.com/vinny/phpbb-calendar/blob/main/service/event_query.php"
click node_manager "https://github.com/vinny/phpbb-calendar/blob/main/service/event_manager.php"
click node_access "https://github.com/vinny/phpbb-calendar/blob/main/service/event_access.php"
click node_forms "https://github.com/vinny/phpbb-calendar/blob/main/service/event_form.php"
click node_display "https://github.com/vinny/phpbb-calendar/blob/main/service/event_display.php"
click node_geo "https://github.com/vinny/phpbb-calendar/blob/main/service/geo_proxy.php"
click node_maps "https://github.com/vinny/phpbb-calendar/blob/main/service/map_image.php"
click node_feeds "https://github.com/vinny/phpbb-calendar/blob/main/service/feed.php"
click node_sharing "https://github.com/vinny/phpbb-calendar/blob/main/service/share.php"
click node_calendar_links "https://github.com/vinny/phpbb-calendar/blob/main/service/calendar_link.php"
click node_calendar_add "https://github.com/vinny/phpbb-calendar/blob/main/service/calendar_add.php"
click node_comments "https://github.com/vinny/phpbb-calendar/blob/main/service/comment.php"
click node_rsvp "https://github.com/vinny/phpbb-calendar/blob/main/service/rsvp.php"
click node_reminder_service "https://github.com/vinny/phpbb-calendar/blob/main/service/event_reminder.php"
click node_reminder_task "https://github.com/vinny/phpbb-calendar/blob/main/cron/task/event_reminder.php"
click node_notifications "https://github.com/vinny/phpbb-calendar/blob/main/notification/type/participant_added.php"
click node_acp "https://github.com/vinny/phpbb-calendar/blob/main/acp/main_module.php"
click node_acp_categories "https://github.com/vinny/phpbb-calendar/blob/main/adm/style/acp_eventboard_categories.js"

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_controller,node_listener,node_calendar_ui,node_language toneBlue
class node_query,node_manager,node_access,node_forms,node_display,node_geo,node_maps,node_database toneAmber
class node_feeds,node_sharing,node_calendar_links,node_calendar_add,node_comments,node_rsvp,node_reminder_service,node_reminder_task,node_notifications,node_geoapify toneMint
class node_acp,node_acp_categories toneRose
class node_members,node_admins toneIndigo
```

## Components

### Forum experience

- [Calendar controller](https://github.com/vinny/phpbb-calendar/blob/main/controller/main.php): `controller/main.php`
- [Forum listener](https://github.com/vinny/phpbb-calendar/blob/main/event/main_listener.php): `event/main_listener.php`
- [Calendar interface](https://github.com/vinny/phpbb-calendar/blob/main/styles/prosilver/template/event_calendar.html): `styles/prosilver/template/event_calendar.html`
- [English strings](https://github.com/vinny/phpbb-calendar/blob/main/language/en/common.php): `language/en/common.php`

### Event services

- [Event queries](https://github.com/vinny/phpbb-calendar/blob/main/service/event_query.php): `service/event_query.php`
- [Event management](https://github.com/vinny/phpbb-calendar/blob/main/service/event_manager.php): `service/event_manager.php`
- [Event access](https://github.com/vinny/phpbb-calendar/blob/main/service/event_access.php): `service/event_access.php`
- [Event forms](https://github.com/vinny/phpbb-calendar/blob/main/service/event_form.php): `service/event_form.php`
- [Event display](https://github.com/vinny/phpbb-calendar/blob/main/service/event_display.php): `service/event_display.php`
- [Venue search](https://github.com/vinny/phpbb-calendar/blob/main/service/geo_proxy.php): `service/geo_proxy.php`
- [Map previews](https://github.com/vinny/phpbb-calendar/blob/main/service/map_image.php): `service/map_image.php`

### Engagement and alerts

- [Feeds and export](https://github.com/vinny/phpbb-calendar/blob/main/service/feed.php): `service/feed.php`
- [Event sharing](https://github.com/vinny/phpbb-calendar/blob/main/service/share.php): `service/share.php`
- [Calendar links](https://github.com/vinny/phpbb-calendar/blob/main/service/calendar_link.php): `service/calendar_link.php`
- [Calendar export links](https://github.com/vinny/phpbb-calendar/blob/main/service/calendar_add.php): `service/calendar_add.php`
- [Event comments](https://github.com/vinny/phpbb-calendar/blob/main/service/comment.php): `service/comment.php`
- [RSVP handling](https://github.com/vinny/phpbb-calendar/blob/main/service/rsvp.php): `service/rsvp.php`
- [Reminder dispatch](https://github.com/vinny/phpbb-calendar/blob/main/service/event_reminder.php): `service/event_reminder.php`
- [Reminder task](https://github.com/vinny/phpbb-calendar/blob/main/cron/task/event_reminder.php): `cron/task/event_reminder.php`
- [Event notifications](https://github.com/vinny/phpbb-calendar/blob/main/notification/type/participant_added.php): `notification/type/participant_added.php`

### Administration

- [ACP management](https://github.com/vinny/phpbb-calendar/blob/main/acp/main_module.php): `acp/main_module.php`
- [Category controls](https://github.com/vinny/phpbb-calendar/blob/main/adm/style/acp_eventboard_categories.js): `adm/style/acp_eventboard_categories.js`

### Other components

- **Forum members**
- **Geoapify**
- **phpBB database**
- **Administrators**

## Connections

- Forum members → Calendar controller: use calendar (evidence: `README.md`)
- Calendar controller → Calendar interface: render calendar (evidence: `controller/main.php`)
- Calendar controller → Event queries: query events
- Calendar controller → Event forms: manage event forms
- Calendar controller → Event comments: manage comments
- Calendar controller → RSVP handling: manage RSVPs
- Calendar controller → Feeds and export: provide feeds
- Calendar controller → Calendar export links: offer exports
- Calendar controller → Event sharing: offer sharing
- Calendar controller → Venue search: serve venue search
- Venue search → Geoapify: search venues (evidence: `README.md`)
- Event management → phpBB database: write events (evidence: `service/event_manager.php`)
- Event queries → phpBB database: read events (evidence: `service/event_query.php`)
- Event management → Map previews: generate previews (evidence: `service/event_manager.php`)
- Forum members → Forum listener: visit forum
- Forum listener → Event queries: load event summaries (evidence: `event/main_listener.php`)
- Administrators → ACP management: configure extension (evidence: `acp/main_module.php`)
- ACP management → Event management: delete events (evidence: `acp/main_module.php`)
- ACP management → Category controls: manage categories
- Reminder task → Reminder dispatch: dispatch reminders (evidence: `cron/task/event_reminder.php`)
- Reminder dispatch → Event notifications: send reminders
- Forum members → Event comments: discuss events (evidence: `README.md`)
- Forum members → RSVP handling: confirm attendance (evidence: `README.md`)
- Calendar controller → Event display: show event details
- Calendar controller → Event access: check visibility
- Calendar controller → Calendar links: build event links
