# pedalcms/pedalcms architecture

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

- Interactive diagram: https://gitdiagram.com/pedalcms/pedalcms
- Repository: https://github.com/pedalcms/pedalcms

## Overview

PedalCMS is a WordPress plugin for managing and presenting academic programs, courses, faculty and related institutional content. The main workflow is institutional staff managing structured content in WordPress, then visitors browsing archives, filtering listings and viewing detailed single-content pages and program subpages. Supporting capabilities include Gutenberg blocks, custom fields, taxonomies, and shared template tags. The README documents the product’s major capabilities; sampled source confirms template rendering and program-subpage behavior. Other subsystem links reflect README descriptions rather than inspected implementation details.

Main entry points: [`src/class-plugin.php`](https://github.com/pedalcms/pedalcms/blob/main/src/class-plugin.php) (Plugin orchestration), [`templates/single-program.php`](https://github.com/pedalcms/pedalcms/blob/main/templates/single-program.php) (Single content views), [`src/field-group-plugin.php`](https://github.com/pedalcms/pedalcms/blob/main/src/field-group-plugin.php) (Custom fields), [`templates/archive-program.php`](https://github.com/pedalcms/pedalcms/blob/main/templates/archive-program.php) (Content archives)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content model"]
  node_programs["Programs<br/>[class-program.php]"]
  node_courses["Courses<br/>[class-course.php]"]
  node_people["People directory<br/>[class-person.php]"]
  node_faqs["FAQs<br/>[class-faq.php]"]
  node_taxonomies["Academic taxonomies"]
end

subgraph group_authoring["Authoring tools"]
  node_fields["Custom fields"]
  node_field_types["Specialized fields"]
  node_blocks["Editor blocks"]
end

subgraph group_browsing["Browse and display"]
  node_archives["Content archives"]
  node_filters["Archive filters"]
  node_singles["Single content views<br/>[single-program.php]"]
  node_subpages["Program subpages"]
end

subgraph group_platform["Plugin platform"]
  node_plugin["Plugin orchestration<br/>[class-plugin.php]"]
  node_template_manager["Template resolution"]
  node_template_tags["Template tags<br/>[template-tags.php]"]
  node_shared_tags["Shared template helpers"]
end

node_staff(("Institutional staff"))
node_visitors(("Site visitors"))
node_wordpress["WordPress"]

node_staff -->|"manages content"| node_wordpress
node_wordpress -.->|"loads plugin"| node_plugin
node_plugin -.->|"registers content"| node_programs
node_plugin -.->|"registers content"| node_courses
node_plugin -.->|"registers content"| node_people
node_plugin -.->|"registers content"| node_faqs
node_plugin -.->|"registers taxonomies"| node_taxonomies
node_staff -->|"edits structured data"| node_fields
node_fields -.->|"uses field types"| node_field_types
node_staff -->|"authors blocks"| node_blocks
node_visitors -.->|"requests pages"| node_wordpress
node_wordpress -->|"serves archive"| node_archives
node_wordpress -->|"serves single page"| node_singles
node_archives -.->|"filters listings"| node_filters
node_singles -->|"selects active subpage"| node_subpages
node_singles -->|"uses display tags"| node_template_tags
node_template_tags -->|"accesses subpage data"| node_subpages
node_singles -.->|"loads templates"| node_template_manager
node_singles -.->|"uses shared helpers"| node_shared_tags

click node_plugin "https://github.com/pedalcms/pedalcms/blob/main/src/class-plugin.php"
click node_programs "https://github.com/pedalcms/pedalcms/blob/main/src/class-program.php"
click node_courses "https://github.com/pedalcms/pedalcms/blob/main/src/class-course.php"
click node_people "https://github.com/pedalcms/pedalcms/blob/main/src/class-person.php"
click node_faqs "https://github.com/pedalcms/pedalcms/blob/main/src/class-faq.php"
click node_taxonomies "https://github.com/pedalcms/pedalcms/blob/main/src/class-customtaxonomy.php"
click node_fields "https://github.com/pedalcms/pedalcms/blob/main/src/field-group-plugin.php"
click node_field_types "https://github.com/pedalcms/pedalcms/tree/main/src/Fields"
click node_blocks "https://github.com/pedalcms/pedalcms/tree/main/src/blocks"
click node_archives "https://github.com/pedalcms/pedalcms/blob/main/templates/archive-program.php"
click node_filters "https://github.com/pedalcms/pedalcms/blob/main/src/class-filtermanager.php"
click node_singles "https://github.com/pedalcms/pedalcms/blob/main/templates/single-program.php"
click node_subpages "https://github.com/pedalcms/pedalcms/blob/main/src/class-subpagemanager.php"
click node_template_manager "https://github.com/pedalcms/pedalcms/blob/main/src/class-templatemanager.php"
click node_template_tags "https://github.com/pedalcms/pedalcms/blob/main/src/template-tags.php"
click node_shared_tags "https://github.com/pedalcms/pedalcms/blob/main/src/template-tags-shared.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_programs,node_courses,node_people,node_faqs,node_taxonomies toneBlue
class node_fields,node_field_types,node_blocks toneAmber
class node_archives,node_filters,node_singles,node_subpages toneMint
class node_plugin,node_template_manager,node_template_tags,node_shared_tags toneRose
class node_staff,node_visitors,node_wordpress toneIndigo
```

## Components

### Content model

- [Programs](https://github.com/pedalcms/pedalcms/blob/main/src/class-program.php): `src/class-program.php`
- [Courses](https://github.com/pedalcms/pedalcms/blob/main/src/class-course.php): `src/class-course.php`
- [People directory](https://github.com/pedalcms/pedalcms/blob/main/src/class-person.php): `src/class-person.php`
- [FAQs](https://github.com/pedalcms/pedalcms/blob/main/src/class-faq.php): `src/class-faq.php`
- [Academic taxonomies](https://github.com/pedalcms/pedalcms/blob/main/src/class-customtaxonomy.php): `src/class-customtaxonomy.php`

### Authoring tools

- [Custom fields](https://github.com/pedalcms/pedalcms/blob/main/src/field-group-plugin.php): `src/field-group-plugin.php`
- [Specialized fields](https://github.com/pedalcms/pedalcms/tree/main/src/Fields): `src/Fields`
- [Editor blocks](https://github.com/pedalcms/pedalcms/tree/main/src/blocks): `src/blocks`

### Browse and display

- [Content archives](https://github.com/pedalcms/pedalcms/blob/main/templates/archive-program.php): `templates/archive-program.php`
- [Archive filters](https://github.com/pedalcms/pedalcms/blob/main/src/class-filtermanager.php): `src/class-filtermanager.php`
- [Single content views](https://github.com/pedalcms/pedalcms/blob/main/templates/single-program.php): `templates/single-program.php`
- [Program subpages](https://github.com/pedalcms/pedalcms/blob/main/src/class-subpagemanager.php): `src/class-subpagemanager.php`

### Plugin platform

- [Plugin orchestration](https://github.com/pedalcms/pedalcms/blob/main/src/class-plugin.php): `src/class-plugin.php`
- [Template resolution](https://github.com/pedalcms/pedalcms/blob/main/src/class-templatemanager.php): `src/class-templatemanager.php`
- [Template tags](https://github.com/pedalcms/pedalcms/blob/main/src/template-tags.php): `src/template-tags.php`
- [Shared template helpers](https://github.com/pedalcms/pedalcms/blob/main/src/template-tags-shared.php): `src/template-tags-shared.php`

### Other components

- **Institutional staff**
- **Site visitors**
- **WordPress**

## Connections

- Institutional staff → WordPress: manages content (evidence: `README.md`)
- WordPress → Plugin orchestration: loads plugin
- Plugin orchestration → Programs: registers content
- Plugin orchestration → Courses: registers content
- Plugin orchestration → People directory: registers content
- Plugin orchestration → FAQs: registers content
- Plugin orchestration → Academic taxonomies: registers taxonomies
- Institutional staff → Custom fields: edits structured data (evidence: `README.md`)
- Custom fields → Specialized fields: uses field types
- Institutional staff → Editor blocks: authors blocks (evidence: `README.md`)
- Site visitors → WordPress: requests pages
- WordPress → Content archives: serves archive (evidence: `README.md`)
- WordPress → Single content views: serves single page (evidence: `README.md`)
- Content archives → Archive filters: filters listings
- Single content views → Program subpages: selects active subpage (evidence: `templates/single-program.php`)
- Single content views → Template tags: uses display tags (evidence: `templates/single-program.php`)
- Template tags → Program subpages: accesses subpage data (evidence: `src/template-tags.php`)
- Single content views → Template resolution: loads templates
- Single content views → Shared template helpers: uses shared helpers
