{
  "name": "Event Espresso 4 - Event Companion",
  "slug": "eea-event-companion",
  "version": "0.16.4",
  "download_url": "https://gitea.mulligan.casa/ee-extensions/foh-updates/raw/branch/main/eea-event-companion/eea-event-companion-0.16.4.zip",
  "homepage": "https://gitea.mulligan.casa/ee-extensions/eea-event-companion",
  "requires": "6.4",
  "tested": "7.0",
  "requires_php": "8.1",
  "last_updated": "2026-06-25 13:08:21",
  "icons": {
    "1x": "https://gitea.mulligan.casa/ee-extensions/foh-updates/raw/branch/main/eea-event-companion/icon-128x128.png",
    "2x": "https://gitea.mulligan.casa/ee-extensions/foh-updates/raw/branch/main/eea-event-companion/icon-256x256.png"
  },
  "author": "Mike Mulligan",
  "author_homepage": "https://gitea.mulligan.casa/mmulligan",
  "tags": [
    "event espresso",
    "companion app",
    "pwa",
    "schedule",
    "announcements",
    "push notifications"
  ],
  "sections": {
    "description": "<p>Event Companion adds an attendee-facing progressive web app (PWA) to any Event Espresso event. Attendees access the companion via a QR code or short link, authenticate with a magic link tied to their registration, and get a mobile-native experience with:</p>\n<ul>\n<li><strong>Schedule / agenda</strong> with per-entry location pins on an uploaded venue map.</li>\n<li><strong>Static pages</strong> for event info, house rules, or sponsor acknowledgements.</li>\n<li><strong>Announcements</strong> with optional timed publication and web push notifications.</li>\n<li><strong>Feedback forms</strong> with configurable fields per event.</li>\n<li><strong>Venue maps</strong> with positioned pins and panzoom navigation.</li>\n<li><strong>Branding</strong> per event (theme, icon, splash screen).</li>\n</ul>\n<p>All configuration is per-event from wp-admin under the Event Espresso menu. The companion is general-purpose and organization-agnostic.</p>\n<p><strong>Self-contained on Event Espresso.</strong> The companion works on a plain Event Espresso install. No additional plugins are required.</p>",
    "installation": "<ol>\n<li>Install and activate Event Espresso 4.</li>\n<li>Upload this plugin to <code>wp-content/plugins/</code> and activate it. Activation creates the companion tables.</li>\n<li>Navigate to Event Espresso &gt; Event Companion in wp-admin to configure the companion for an event.</li>\n</ol>",
    "faq": "<p><strong>Does this require any other plugins?</strong></p>\n<p>Only Event Espresso 4. The companion is fully self-contained.</p>\n<p><strong>How do attendees access the companion?</strong></p>\n<p>Via a magic link sent to the email on their registration, or by scanning a QR code at the event.</p>",
    "changelog": "<p><strong>0.16.4</strong><br />\n* <strong>Location pages split sessions by day.</strong> The \"What's Happening Here\" list on a location's page now groups its sessions under day headers, matching the schedule view.</p>\n<p><strong>0.16.3</strong><br />\n* <strong>Map background colour now applies to the focused map views too.</strong> The \"you are here\" mini-map (on a location's page and on a session's detail) matches the floorplan's background colour like the full map, instead of showing the app's default surface around the plan.</p>\n<p><strong>0.16.2</strong><br />\n* <strong>Announcement formatting now displays.</strong> Rich text in an announcement (paragraphs, bold, links, lists) renders properly in the News feed instead of showing raw HTML tags. (Push notifications remain plain text.)</p>\n<p><strong>0.16.1</strong><br />\n* <strong>Map loading is now reliable.</strong> The map waits for its viewport to finish sizing before fitting the floorplan, then fades in — fixing occasional off-centre loads and the rare blank map (it used to measure too early, during the screen transition, and mis-place or hide the plan). Correctness over a fraction of a second.</p>\n<p><strong>0.16.0</strong><br />\n* <strong>Schedule cards redesigned.</strong> A cleaner, more compact card: time and location share a line, the source schedule and tags sit together, and the calendar / reminder / share actions are tucked into a single overflow (⋮) menu instead of cluttering the card.<br />\n* <strong>New \"Share\" action.</strong> Share a session straight from the menu — uses the phone's native share sheet when available, otherwise copies the link and confirms with a toast.<br />\n* <strong>The same card everywhere.</strong> A location's detail page now shows its sessions as the same cards (tap one to open it), and a session's detail links back to its location — closing the loop between the schedule and the map.<br />\n* <strong>Map background fills the whole view.</strong> A vector floorplan's background colour now paints the entire map viewport, so the area around the plan matches it instead of showing a mismatched band when you pan or zoom.<br />\n* <strong>Cross-floor link markers sit on their rooms.</strong> Navigation-link markers on element-bound Spaces (e.g. \"To Level 3\") now appear on the bound room rather than defaulting to the centre of the map.<br />\n* Fixed a map-switch race where a previous map's failed image could briefly blank the map you just switched to.</p>\n<p><strong>0.15.1</strong><br />\n* The in-app boot splash logo now scales with the screen (instead of a fixed small size), so it fills more of a large/retina display.</p>\n<p><strong>0.15.0</strong><br />\n* <strong>Site-wide settings now live on their own \"Global\" tab</strong> (Event Companion → Global), separate from any event — the App Name / icon / splash / accent and the Web Push setup moved there. No need to pick an event to manage them.<br />\n* <strong>Add-to-calendar is now a provider menu</strong> — Google Calendar, Outlook, Office 365, or Apple/.ics. Each opens that calendar with the session (using that calendar's own default reminder). This works reliably across phones, including Android, instead of relying on a single behaviour.<br />\n* <strong>The reminder star now carries the reminder time.</strong> Tap the star and pick how far ahead to be notified — 15 / 30 / 45 minutes or 1 hour before — delivered as a push notification at that time. (The exact lead lives on the push reminder now; the calendar entry uses your calendar's default.)<br />\n* <strong>The \"notifications blocked\" message is now helpful</strong> — it explains how to re-enable notifications in your browser's site settings (and on iOS, offers to install the app, which can prompt again).</p>\n<p><strong>0.14.0</strong><br />\n* <strong>Add-to-calendar now opens the Calendar app</strong> instead of downloading a file. Tapping a reminder time hands the event straight to the phone's calendar (the \"Add to Calendar\" sheet on iOS, open-with on Android). The service worker serves the event on-device, so it works <strong>fully offline</strong> — no signal needed to add it, and the alarm still fires offline once it's in.</p>\n<p><strong>0.13.0</strong><br />\n* <strong>Pick your reminder time when adding a session to your calendar.</strong> The calendar button now offers None / 15 / 30 / 45 minutes / 1 hour before — set as a real alarm on the calendar event. Because it's the phone's own calendar, the reminder fires <strong>offline, in airplane mode, and with the app closed</strong> (the dependable way to be reminded at a venue with no signal). The in-app star notification remains for when you're online.</p>\n<p><strong>0.12.0</strong><br />\n* <strong>Add any session to your calendar.</strong> Every schedule item now has a calendar button that downloads a standard .ics — works with Apple, Google, and Outlook calendars.<br />\n* <strong>Reminders.</strong> Tap the star on a session to be reminded about 15 minutes before it starts (a push notification). Starring asks to turn on notifications the first time, and your stars sync to the server so they survive a reinstall. No sign-in.<br />\n* <strong>Smarter notification opt-in.</strong> The \"Get notified\" prompt now also appears on the home screen, and installing the app (or starring a session) offers to turn on notifications — all from a tap, never a surprise pop-up.<br />\n* <strong>Feedback forms support more question types on device.</strong> Multiple-choice (radio), number, and \"choose several\" (checkbox) questions now render and submit correctly in the app, matching the form builder.</p>\n<p><strong>0.11.0</strong><br />\n* <strong>App identity is now site-wide.</strong> The installed app's name, home-screen icon, splash, and base accent colour are set once for the whole site/organisation (Event Companion → App Settings → \"App Identity\"), independent of any single event. The install name now follows your App Name (or the site name) instead of the generic \"Event Companion\", and the icon follows your chosen icon everywhere — including at shared <code>/g/…</code> links. (Per-event Design themes still apply as in-app skinning when an event is in focus.)<br />\n* <strong>Announcements can be org-wide.</strong> A new \"Show org-wide\" toggle (on by default) makes an announcement visible across the whole app — even before anyone has picked an event — instead of only inside one event. Turn it off to scope an announcement to a single event.<br />\n* <strong>Clear publish controls for announcements.</strong> The announcement editor now has explicit <strong>Publish now</strong>, <strong>Schedule</strong>, and <strong>Save draft</strong> buttons. (Previously, leaving the time blank silently saved a hidden draft.)</p>\n<p><strong>0.10.0</strong><br />\n* Schedule entries can now carry <strong>tags</strong> (e.g. keynote, workshop, food). Attendees see tag chips on each session and can filter a schedule by tag, right on the schedule view.<br />\n* New optional <strong>All Schedules</strong> view: turn it on per event (Schedule tab) to add an \"All\" tab at the front that merges every schedule's sessions in time order, grouped by day, each labelled with its source schedule. Its tag filter spans every schedule. Exclude individual sessions from the combined view from the entry editor.<br />\n* Tags and the All-Schedules settings travel through Export / Import.</p>\n<p><strong>0.9.0</strong><br />\n* Venue maps can now use a <strong>vector floorplan</strong> (an SVG export from Inkscape, Illustrator, or similar) as the base, with a per-map background colour — upload one when adding or editing a map. Uploaded SVGs are sanitized on upload, on serve, and on import.<br />\n* New <strong>element binding</strong>: instead of re-tracing rooms by hand, pick any area already drawn in the floorplan — through a structure tree of its layers, groups, and shapes — and turn it into a tappable Space. Each bound Space gets its own resting and focused-state highlight colour and opacity, and the floorplan's own room outlines light up on the map.<br />\n* Drawn polygon Spaces still work and mix freely with bound ones on the same map; convert either way (detach a bound Space to a point, or bind a drawn/point feature to an element). The vector floorplan and its bindings travel through Export / Import.</p>\n<p><strong>0.8.0</strong><br />\n* Venue maps can now have <strong>Spaces</strong> — tappable polygon regions (rooms, zones) you draw right on the map. Each Space carries an optional highlight colour, fill opacity, zoom-to-fit on focus, and a centroid marker, and works as a schedule location and a tap target just like a pin.<br />\n* Rebuilt map editor: a toolbar to place pins or draw Spaces (click corners to close), full corner editing (drag, double-click an edge to add, Delete to remove), and a docked options panel for the selected feature — replacing the old prompt() dialogs.<br />\n* Pins and Spaces can now do more on tap: show a basic <strong>info popup</strong> (a short blurb, without leaving the map), or act as a <strong>navigation link</strong> to another location or map (a picker appears when there's more than one destination). Either can also display an optional <strong>glyph</strong> icon.<br />\n* Map saves keep stable ids, so schedule locations, links, and deep-links survive an edit; navigation links remap correctly across export and import.</p>\n<p><strong>0.7.0</strong><br />\n* Added a color-coded plugin icon (delivered through the update channel) and declared WordPress 7.0 compatibility. No functional change.</p>\n<p><strong>0.6.0</strong><br />\n* Web push notifications: attendees can opt in from the News tab to be notified when an announcement is published (deep-linking to the linked session when set). Generate the signing key under App Settings → Web Push. Self-contained — no extra service required; iOS install-gated.<br />\n* The home \"Happening now / next\" ribbon now flags a live or upcoming session that has linked announcements with a 📣 count.</p>\n<p><strong>0.5.0</strong><br />\n* Announcement ↔ session linking: an announcement can point at one schedule session. The attendee app shows a tap-through session chip on the announcement card and a \"Related updates\" list on the session page; set the link from the new \"Related session\" picker in wp-admin (grouped by schedule, times in the event timezone). Deleting a session cleanly unlinks its announcements.</p>\n<p><strong>0.4.0</strong><br />\n* Installed PWA branding: the home-screen icon, iOS splash, and theme color now follow the live event's branding (cascade: live event → a new site-wide default → plugin default), instead of the static default. New \"Default App Branding\" controls on the App Settings tab set the site-wide fallback. Manifest is cache-busted (versioned link + ETag) so changes reach installed apps within the cache window.<br />\n* Import / Export: package an event's whole companion config as a hand-authorable ZIP and import it (merge or replace) into another event — pages, schedules, maps/pins, app/design, shortlinks, feedback form, with bodies and images carried as asset tokens. wp-admin tab + WP-CLI (<code>wp eea-ec export|import</code>); untrusted-ZIP hardened; fully atomic.<br />\n* Fixed: the <code>home</code> short link no longer mints a duplicate on repeat calls.</p>\n<p><strong>0.3.0</strong><br />\n* Attendee PWA: event-aware landing (hero + \"Happening now/next\" across schedules), bottom-nav + drawer, multi-floorplan maps, named multi-schedules with per-session detail pages, announcements, location-scoped feedback, and \"you are here\" QR cards.<br />\n* Device-first identity: feedback with no sign-in; optional email magic-link verification creates/links an attendee.<br />\n* Per-event OKLCH theme engine: accent + neutral + style dials derive contrast-guarded tokens; 10 presets; light/dark/dark-luxe; live preview in wp-admin. Branded boot splash, hero, and motion.<br />\n* Offline support: after one online load the app works in a venue dead zone (cached data + floorplans); QR codes resolve client-side; offline indicator.<br />\n* Self-hosted updates via the foh-updates channel.</p>\n<p><strong>0.1.0</strong><br />\n* Foundation release: plugin activation, DB schema (11 tables), admin page shell with stub tabs, self-hosted updater, release workflow.</p>"
  }
}
