=== Romence ===

Contributors: independentlogic, robhealy
Tags: momence, schedule, classes, events, booking
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.0
Stable tag: 0.8.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html



Display Momence schedules on your WordPress site. Connect your Momence account and choose from multiple schedule templates.



== Description ==



Romence connects your WordPress site to Momence to display class schedules, events, and availability. Choose from Classic, Calendar, Showcase, Grouped, Minimal, or fully custom templates to match your site.

Unlike JavaScript-based embeds, Romence renders your schedule as clean, lightweight HTML—making it easier to style, faster to load, and more accessible to search engines.

Display your live schedule anywhere using a shortcode or Gutenberg block, with no manual updates required.



**Features:**



* Connect via Momence API Key and Host ID

* Multiple schedule templates (Calendar, Classic, Fully Custom, Grouped, Minimal, Showcase)

* Configurable schedule window (how many weeks ahead)

* Linger time for past events

* Automatic 30-minute refresh of event data

* Fully Custom template for complete theme control

* Gutenberg block (`romence/block`) and `[romence]` shortcode



== External Services ==

This plugin connects to the Momence API to retrieve event listings for display on your WordPress site.

**What is Momence?**
Momence (https://momence.com) is an event management and scheduling platform. This plugin uses their API to fetch event listings associated with your Momence account.

**What data is sent and when?**
Every 30 minutes via a scheduled background task, an HTTPS request is made to the following Momence API endpoint:

  https://momence.com/_api/primary/api/v1/Events

The request includes the following parameters:
- hostId: Your Momence Host ID (configured in the plugin settings)
- token:  Your Momence API token (configured in the plugin settings)

These credentials are provided by you (the site administrator) during plugin setup and are used solely to authenticate and retrieve your event listings. No visitor or end-user personal data is collected or transmitted.

This request is made every time a page containing the events display loads (or on a configurable cache interval, if caching is enabled).

**Third-Party Service:**
- Service:         Momence (https://momence.com)
- Purpose:         Fetching event listings from your Momence account to display on your site
- Data sent:       Your Momence Host ID and API token
- Sent to:         https://momence.com/_api/primary/api/v1/Events
- When:            Every 30 minutes via a scheduled background task (default). The cache duration is configurable in the plugin settings, and can be manually refreshed on demand.
- Terms of Service: https://momence.com/privacy-policy/documents/Momence-Terms-of-Service.pdf
- Privacy Policy:  https://momence.com/webflow/documents/privacy-policy.pdf



== Installation ==



1. Install the plugin via the Plugins screen

2. Go to Romence in the admin menu

3. Enter your Momence API Key and Host ID (Momence → Dashboard → Apps & Integrations → Developer API)

4. Choose a schedule template and Save Settings

5. Add the `[romence]` shortcode to any page or post, or insert the **Romence** block (type `/romence` in the block editor)



== Frequently Asked Questions ==



= Where do I get my Momence API credentials? =



Login to your Momence Account → Dashboard → Apps & Integrations → Developer API. Your API token and Host ID are listed there.



= Which template should I use? =



* **Classic** — Day-by-day schedule with pager

* **Calendar** — Grid view (max 12 weeks)

* **Showcase** — Card layout with images

* **Grouped** — Day-by-day grouping with a dark, high-contrast theme

* **Minimal** — Simple list

* **Fully Custom** — No plugin CSS; style with your theme



== Privacy ==



This plugin connects your site to **Momence** using your Host ID and API key. Event data is requested from Momence’s servers and cached temporarily on your site (transients). No data is sent to the plugin author. 

This plugin does not set cookies or collect any data about visitors to your site. Event listings retrieved from Momence may contain booking links that direct visitors to Momence's website to complete a booking. Once on Momence's site, their own tracking and privacy practices apply. Review Momence's privacy policy for details: https://momence.com/webflow/documents/privacy-policy.pdf




== Changelog ==

= 0.8.1 =

* Correct Stable Tag structure and revise Guterberg Block placeholder for production

= 0.8 =

* Initial release


