How 23bitstudio/teamgraph works
TeamGraph is a WordPress plugin for managing an organization and publishing accessible org charts and team directories. The main workflow runs from an admin editing members and reporting relationships, through WordPress REST endpoints and stored member data, to a block or shortcode rendering a filtered tree, grid, or list for visitors. Admin capabilities also include organization terms, color guides, CSV transfer, and sample data. The README and excerpts establish the major features; several PHP internals and front-end implementation details were not excerpted, so their internal call relationships are not expanded.
Main entry points: index.js Admin screen router · class-teamgraph-rest.php REST endpoints · api.js Admin REST client · class-teamgraph-data.php Member records
Components 23
Admin screens
- Member directory
src/admin/pages/Members.js - Member editor
src/admin/pages/MemberForm.js - Chart builder
src/admin/pages/Builder.js - Organization settings
src/admin/pages/Organization.js - Color guide editor
src/admin/pages/Theme.js - Settings and CSV
src/admin/pages/Settings.js
Admin services
- Admin screen router
src/admin/index.js - Admin REST client
src/admin/api.js - Shared admin UI
src/admin/components.js
WordPress integration
- REST endpoints
includes/class-teamgraph-rest.php - Chart block editor
src/block/index.js - Dynamic block
includes/class-teamgraph-block.php - Shortcode renderer
includes/class-teamgraph-shortcode.php
Organization data
- Member records
includes/class-teamgraph-data.php - Departments and locations
includes/class-teamgraph-groups.php - Color guide settings
includes/class-teamgraph-settings.php - CSV transfer
includes/class-teamgraph-csv.php - Sample organization
includes/class-teamgraph-demo.php
Visitor views
- Chart interactions and styles
assets/frontend/teamgraph-chart.js - Chart layout styles
assets/frontend/teamgraph-chart.css
Other components
- Administrator
- WordPress database
- Site visitor
Connections 30
- Administrator → Admin screen router: opens screen
src/admin/index.js - Admin screen router → Member directory: mounts
src/admin/index.js - Admin screen router → Member editor: mounts
src/admin/index.js - Admin screen router → Chart builder: mounts
src/admin/index.js - Admin screen router → Organization settings: mounts
src/admin/index.js - Admin screen router → Color guide editor: mounts
src/admin/index.js - Admin screen router → Settings and CSV: mounts
src/admin/index.js - Member directory → Admin REST client: requests data
src/admin/pages/Members.js - Member editor → Admin REST client: loads and saves
src/admin/pages/MemberForm.js - Chart builder → Admin REST client: updates hierarchy
src/admin/pages/Builder.js - Organization settings → Admin REST client: manages terms
src/admin/pages/Organization.js - Color guide editor → Admin REST client: saves guides
src/admin/pages/Theme.js - Settings and CSV → Admin REST client: manages settings
src/admin/pages/Settings.js - Admin REST client → REST endpoints: calls REST API
src/admin/api.js - Chart block editor → REST endpoints: loads block options
src/block/index.js - REST endpoints → Member records: manages members
- REST endpoints → Departments and locations: manages terms
- REST endpoints → Color guide settings: manages guides
- REST endpoints → CSV transfer: handles CSV
- REST endpoints → Sample organization: handles samples
- Member records → WordPress database: stores records
README.md - Departments and locations → WordPress database: stores taxonomies
README.md - Color guide settings → WordPress database: stores options
README.md - Site visitor → Shortcode renderer: uses shortcode
README.md - Site visitor → Dynamic block: views block
README.md - Shortcode renderer → Member records: renders organization
- Dynamic block → Member records: renders organization
- Shortcode renderer → Chart interactions and styles: outputs chart
- Dynamic block → Chart interactions and styles: outputs chart
- Chart interactions and styles → Chart layout styles: enhances layout