Search by

ethernick / statamic-activitypub-events

ethernick

ActivityPub Events, RSVPs, and Federated Calendar for Statamic 5.x and 6.x

Package info

github.com/ethernick/statamic-activitypub-events

Documentation

Language:Vue

Type:statamic-addon

pkg:composer/ethernick/statamic-activitypub-events

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v0.1.0 2026-11-02 15:54 UTC

This package is auto-updated.

Last update: 2026-11-20 19:48:12 UTC


README

ActivityPub Events for Statamic

Statamic 5 & 6 Version PHP 8.2+ Mobilizon ActivityPub Protocol Commercial License

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 events collection and default event.yaml blueprint with date pickers, venue relationships, and ticketing fields.
  • Configures /events/{slug} routing with template: 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 }}
                &ndash; {{ 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 &rarr;
            </a>
        </div>
    {{ /if }}
</div>

πŸ–ΌοΈ Control Panel Experience

Events Calendar & Agenda Event Creation & Venue Stack
Statamic ActivityPub Events Calendar Create New Federated Event Modal
Mastodon Federation Proof Public Antlers Event View
Federated Event Post on Mastodon Public Event Antlers Page

πŸ“š Documentation & Guides

🀝 Community & Support

πŸ“„ 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.