Cohost

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. The full Cohost brand guide is published at https://cohost.vip/brand.

Privacy & data

This plugin makes outbound HTTP requests to two Cohost-operated services:

1. Cohost API (default https://api.cohost.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.

2. Cohost templates manifest (default https://templates.cohost.vip/wp/templates.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.

For Cohost’s privacy policy covering data on the Cohost side, see https://cohost.vip/legal/privacy.