# Theme Events ## Package docs status This page is generated from package source documentation in `the Capell packages repository` and the checked-in manifest. Source documentation is not distribution status. Before running a Composer command, verify that the exact package and compatible 1.x release are available through public Packagist or the authenticated marketplace account. | Field | Value | | --- | --- | | Composer package | `capell-app/theme-events` | | Package slug | `theme-events` | | Product group | Capell Themes | | Tier | premium | | Bundle | `themes` | | Runtime contexts | `frontend` | | Capell version | `^1.0` | | Source repository | `capell-app/packages` | | Source path | `packages/theme-events` | | Docs source | `packages/theme-events/docs` | | Manifest | [`capell.json`](https://github.com/capell-app/packages/edit/main/packages/theme-events/capell.json) | ## What This Plugin Adds Theme Events is an **Available**, **No schema impact** Capell theme in the **Capell Themes** product group. It ships as `capell-app/theme-events` and extends these surfaces: frontend. Theme Events adds event-focused presentation for agendas, speakers, ticket tiers, sponsors, countdowns, and past editions. Event content remains in Capell and Layout Builder; the theme owns its rendering. Editors can compose event pages in Layout Builder, and visitors receive a structured schedule, speaker roster, and ticket comparison in the selected theme. Evidence: [`src/EventsThemeServiceProvider.php`](src/EventsThemeServiceProvider.php), [`resources/views/widget/agenda-grid-days-tracks-rooms.blade.php`](resources/views/widget/agenda-grid-days-tracks-rooms.blade.php), [`resources/views/widget/speaker-wall-hover-bios.blade.php`](resources/views/widget/speaker-wall-hover-bios.blade.php), [`resources/views/widget/ticket-tier-comparison.blade.php`](resources/views/widget/ticket-tier-comparison.blade.php), [`capell.json`](capell.json), [`tests/Feature/EventsBespokeWidgetsTest.php`](tests/Feature/EventsBespokeWidgetsTest.php). Status details: - Status: Available - Tier: premium - Bundle: themes - Composer package: `capell-app/theme-events` - Namespace: `Capell\ThemeEvents` - Theme key: `events` ## Why It Matters **For developers:** The service provider registers layout areas and bespoke widget renderables through the shared Layout Builder pipeline. **For teams:** Event teams can keep schedules, speakers, and commercial details in one editable page workflow while giving each section an appropriate public treatment. Evidence: [`src/EventsThemeServiceProvider.php`](src/EventsThemeServiceProvider.php), [`src/Enums/WidgetComponentEnum.php`](src/Enums/WidgetComponentEnum.php), [`tests/Unit/EventsThemeDefinitionTest.php`](tests/Unit/EventsThemeDefinitionTest.php), [`resources/views/widget/agenda-grid-days-tracks-rooms.blade.php`](resources/views/widget/agenda-grid-days-tracks-rooms.blade.php), [`resources/views/widget/speaker-wall-hover-bios.blade.php`](resources/views/widget/speaker-wall-hover-bios.blade.php), [`resources/views/widget/ticket-tier-comparison.blade.php`](resources/views/widget/ticket-tier-comparison.blade.php). ## Screens And Workflow Screenshot contract: `docs/screenshots.json`. ![Events Homepage](screenshots/events-homepage.png) ![Events Agenda directory](screenshots/events-directory.png) Desktop, tablet, and mobile variants remain defined in the screenshot contract; this list groups them by workflow. - Events Homepage (frontend, required). - Events Agenda directory (frontend, required). - Events Speaker detail (frontend, required). - Events Search results (frontend, optional). - Events Contact (frontend, optional). - Events Page Not Found (frontend, optional). - Events Ticket CTA (frontend, required). ## Technical Shape - Service providers: `Capell\ThemeEvents\EventsThemeServiceProvider`. - Actions: `InstallEventsThemeDemoAction`. - Command signatures: `capell:theme-events-demo`. - Console command classes: `DemoCommand`. - Manifest contributions: `admin-page: Capell\ThemeEvents\Manifest\ThemeManagementPageContribution`. - Health checks: `Capell\ThemeEvents\Health\ThemeEventsHealthCheck`. - Blade views: `packages/theme-events/resources/views/footer.blade.php`, `packages/theme-events/resources/views/header/index.blade.php`, `packages/theme-events/resources/views/widget/agenda-grid-days-tracks-rooms.blade.php`, `packages/theme-events/resources/views/widget/countdown-band.blade.php`, `packages/theme-events/resources/views/widget/live-now-replay-state.blade.php`, `packages/theme-events/resources/views/widget/past-editions-archive.blade.php`, `packages/theme-events/resources/views/widget/speaker-wall-hover-bios.blade.php`, `packages/theme-events/resources/views/widget/sponsor-tier-walls.blade.php`, `packages/theme-events/resources/views/widget/ticket-tier-comparison.blade.php`, `packages/theme-events/resources/views/widget/venue-travel-panels.blade.php`. - Cache tags: `theme-events`. ## Data Model This theme has no schema impact. It relies on core Capell site, page, locale, and theme records instead of declaring package-owned tables. ## Install Impact - Required packages: `capell-app/core`, `capell-app/theme-foundation`, `capell-app/frontend`, `capell-app/layout-builder`. - Admin navigation: declares `admin-page: ThemeManagementPageContribution`; each Filament page or resource controls its own navigation visibility. - Admin/editor extensions: none declared. - Permissions: none declared in `capell.json`. - Public routes: none declared. - Database changes: no package migrations declared. - Config: no package config files. - Settings: no package settings declared. - Queues or schedules: none declared. - Cache tags: `theme-events`. - Commands: `capell:theme-events-demo`. ## Common Pitfalls - Keep required Capell packages on compatible v4 releases: `capell-app/core`, `capell-app/theme-foundation`, `capell-app/frontend`, `capell-app/layout-builder`. - Keep public Blade and cached HTML free of authoring markers, model IDs, permissions, signed editor URLs, and lazy database queries. - Custom write integrations must preserve invalidation for `theme-events` cache tags. ## Troubleshooting | Symptom | Likely cause | Check | Fix | | --- | --- | --- | --- | | Package surface is missing after install | Provider or manifest is not loaded | Confirm `capell.json`, package `composer.json`, and provider registration | Reinstall the package, refresh Composer autoload, and clear host caches | | Public output leaks unexpected state | Render data, cache variation, or authoring boundary has regressed | Check public Blade, cache tags, and public-output safety tests | Move data loading out of Blade and rerun the package public-output tests | ## Quick Start 1. Install the package: `composer require capell-app/theme-events`. 2. No package-specific setup command or migrations are declared. 3. Open the Events Homepage and confirm the public output renders without admin state. ## Next Steps - [Package docs](README.md) - [Overview](overview.md) - [Troubleshooting](#troubleshooting) - [Screenshot contract](screenshots.json) - [Marketplace assets](assets/marketplace/) - [Capell content language plan](../../docs/CONTENT_LANGUAGE_PLAN.md) - [Capell documentation design system](../../docs/DESIGN_SYSTEM.md) - [Capell and package ERD notes](../../docs/erd/capell-and-package-erds.md) - Related packages: [Theme Foundation](../theme-foundation/README.md), [Layout Builder](../layout-builder/README.md). - Focused tests: `vendor/bin/pest packages/theme-events/tests --configuration=phpunit.xml`.