About this plugin
Connect your WordPress site to your Cohost account and show upcoming events as a list, with click-through to per-event profile pages — natively in your theme. No iframes. No redirect to a third-party ticketing page.
Cohost is the headless platform for event managers — events, attendees, ticketing, scanning, check-in, and workflows — and this plugin embeds your event catalog into any WordPress theme.
Authentication: API token (Bearer). OAuth support is planned.
Brand-aligned UI: uses the canonical Cohost palette (dark #161616, light #F2F2F2, accent square #f97316 ) and Inter typography. Easy to override from your theme.
Shortcodes
[cohost_events] — events grid. All attributes are optional:
- limit — events per page (default 12)
- columns — grid columns 1–6 (default 3, display only)
- from, to — ISO date range (e.g. from="2026-06-01" to="2026-12-31" )
- sort, order — e.g. sort="startDate" order="asc"
Example: [cohost_events from="2026-06-01" to="2026-12-31" limit="6" columns="2"]
[cohost_event id="…"] — single event profile. **The `id` attribute accepts either an event ID or an event slug** — the Cohost API resolves both at the same endpoint, so `[cohost_event id="evt_abc123"]` and `[cohost_event id="summer-festival-2026"]` both work.
When a configured “Events page” exists, clicking a card navigates to /{page-slug}/{event-id-or-slug} and the same page renders the profile.
Brand
The plugin ships the canonical Cohost dark “C” app icon and dark wordmark. The accent square is always #f97316. vip/brand.
Privacy & data
This plugin makes outbound HTTP requests to two Cohost-operated services:
-
vip/v1 ) — fetches the events the site displays. Each request includes the Bearer API token configured in Cohost → Settings. No user data leaves your site; only your token is sent.
The base URL is configurable for self-hosted or staging Cohost environments.
-
json ) — fetched when an admin opens the Cohost → Templates page. Returns a list of starter layouts the admin can apply. No user data is sent.
The URL is configurable under Settings → Advanced.
The plugin does not:
- Track end-users or store cookies.
- Send page-view analytics, telemetry, or installation pings.
- Embed third-party scripts on the public-facing site.
The plugin caches API responses in WP transients (60-second TTL for events, 15-minute TTL for templates) to minimize outbound traffic. All cached data is removed when the plugin is uninstalled.
vip/legal/privacy.