ethernick / statamic-activitypub-events
ActivityPub Events, RSVPs, and Federated Calendar for Statamic 5.x and 6.x
Package info
github.com/ethernick/statamic-activitypub-events
Language:Vue
Type:statamic-addon
pkg:composer/ethernick/statamic-activitypub-events
Requires
- php: ^8.2
- ethernick/statamic-activitypub-core: ^0.9 || ^1.0 || dev-main
- ethernick/statamic-activitypub-places: ^0.1.0 || dev-main
- statamic/cms: ^5.0 | ^6.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Note
Pre-Release:
<<<<<<< HEAD
ActivityPub Events is an early companion addon for statamic-activitypub-core and statamic-activitypub-places. Free for local development and non-production testing under our Commercial Source-Available License. Available for feedback ahead of official Marketplace publication.
=======
ActivityPub Events is an early companion addon for statamic-activitypub-core and statamic-activitypub-places. Free for local development and non-production testing under our Commercial Source-Available License. Available for feedback ahead of official Marketplace publication.
dev
Federate community events, connect OpenStreetMap venues, and broadcast schedules across the Fediverse. ActivityPub Events extends statamic-activitypub-core and statamic-activitypub-places to seamlessly publish W3C ActivityStreams 2.0 Event objects to Mastodon, Mobilizon, and the broader social web.
β¨ Features at a Glance
| Feature | Description |
|---|---|
| π W3C AS2 Event Schema | Broadcast native ActivityStreams 2.0 Event objects with precise UTC start/end times, markdown descriptions, and rich attachments. |
| π Mastodon Fallback Notes | Automatically generates clean, markdown-formatted notes with calendar dates, location links, and ticketing URLs for timeline readers. |
| πΊοΈ Places Integration | Connect venue records directly to ActivityPub Places with OSM geocoding and Leaflet map previews. |
| ποΈ Tickets & Payment Links | Attach ticket prices and direct checkout links via FEP-0ea0 payment link schema and Schema.org Offer integration. |
| π₯οΈ CP Calendar & Agenda | Manage your event schedule in an elegant, responsive Control Panel calendar with monthly and agenda views. |
| π¨ Frontend Antlers Tags | Render upcoming calendars, individual event cards, and ticketing links using clean, semantic Antlers templates. |
| β‘ Zero-Bloat Sidecar Storage | Event payloads and sidecar metadata are stored cleanly alongside flat-file entries, preserving Stache cache performance. |
π Quick Start
1. Require Package via Composer
Install activitypub-events into your Statamic application root:
composer require ethernick/statamic-activitypub-events
2. Run the Interactive Guided Installer
Run the one-step guided installer:
php artisan activitypub:events:install
The installer automatically:
- Provisions the
eventscollection and defaultevent.yamlblueprint with date pickers, venue relationships, and ticketing fields. - Configures
/events/{slug}routing withtemplate: events/show. - Enables Events federation in
settings/activitypub.yaml. - Publishes Control Panel Vue 2 (Statamic 5) and Vue 3 (Statamic 6) assets.
3. Display Events on Your Frontend
Add upcoming events to your Antlers layout:
<div class="events-grid"> {{ collection:events sort="start_time:asc" limit="5" }} <article class="event-card"> <h3>{{ title }}</h3> <time datetime="{{ start_time | format('c') }}"> {{ start_time | format('l, F j, Y @ g:i A') }} </time> {{ if location }} <p>π {{ location:title or location:osm_name }}</p> {{ /if }} {{ if ticket_url }} <a href="{{ ticket_url }}" target="_blank" rel="noopener noreferrer" class="btn"> Get Tickets ({{ ticket_currency or "CAD" }} ${{ ticket_price }}) </a> {{ /if }} </article> {{ /collection:events }} </div>
ποΈ System Architecture
graph LR
subgraph StatamicCP [Statamic Control Panel]
Author[Event Organizer] -->|New Event / Agenda| EventStack[EventStack Modal]
Author -->|View Calendar| CPController[EventsDashboard Vue]
end
subgraph PlacesEcosystem [Places Ecosystem]
EventStack -->|Link Venue| OSMPlaces[ActivityPub Places]
end
subgraph CoreEngine [ActivityPub Core Engine]
EventStack --> CreateEvent[Create 'Event' Activity]
EventStack -.->|Fallback Note| NoteAct[Create 'Note' with Date & Links]
CreateEvent --> OutboxQueue[(activitypub-outbox)]
end
subgraph Fediverse [Decentralized Fediverse]
OutboxQueue -->|Signed HTTP POST| Mastodon[Mastodon / Pleroma]
OutboxQueue -->|Announce Event| Mobilizon[Mobilizon Nodes]
end
Loading
π·οΈ Antlers Frontend Tags
Display event details and schedules on your public site using native Antlers templates:
Event Detail Template (resources/views/events/show.antlers.html)
<div class="event"> <h1>{{ title }}</h1> <div class="event-meta"> <time datetime="{{ start_time | format('c') }}"> {{ start_time | format('l, F j, Y @ g:i A') }} {{ if end_time }} – {{ end_time | format('g:i A') }} {{ /if }} </time> {{ if location }} <p>π {{ location:title or location:osm_name }}</p> {{ /if }} </div> <div class="event-content"> {{ content | markdown }} </div> {{ if ticket_url }} <div class="event-ticketing"> <strong>Admission:</strong> {{ if ticket_price && ticket_price > 0 }} {{ ticket_currency or "CAD" }} ${{ ticket_price }} {{ else }} Free {{ /if }} <a href="{{ ticket_url }}" target="_blank" rel="noopener noreferrer"> Get Tickets → </a> </div> {{ /if }} </div>
πΌοΈ Control Panel Experience
| Events Calendar & Agenda | Event Creation & Venue Stack |
|---|---|
![]() |
![]() |
| Mastodon Federation Proof | Public Antlers Event View |
|---|---|
![]() |
![]() |
π Documentation & Guides
- Production Operator & Installation Guide β Requirements, automated setup, timezone recommendations, and Antlers templates.
- Troubleshooting & Operations Runbook β Resolutions for timezone UTC skew, FEP payment links, and queue inspection.
- Events Federation & Mobilizon Guide β ActivityStreams 2.0
Eventspecifications, Mobilizon compatibility, and ticketing standards. - Extension Developer Guide (HOOKS.md) β Extending outbox formatting, transform hooks, and CP Vue hook points.
- Marketplace Launch Blueprint β Hero banner specs, screenshot capture briefs, demo video storyboard, and marketing copy pack.
- Product Requirements Document β Architectural intent, domain models, and technical history.
- Task Roadmap & Release Checklist β Punch-list and milestones.
π€ Community & Support
- Bug Reports & Issues: GitHub Issues
- Source Code: GitHub Repository
- ActivityPub Core: Core Addon Repository
π License
ActivityPub Events for Statamic is source-available software provided under the Statamic Commercial License (free for local development and non-production testing; requires a valid commercial license for live production deployments).
π¦Ύ AI Disclosure
Written with the assistance of AI agents including Gemini & Claude.




