Title: MeetPure Events
Author: rajuru
Published: <strong>May 9, 2026</strong>
Last modified: June 25, 2026

---

Search plugins

![](https://s.w.org/plugins/geopattern-icon/meetpure-events.svg)

# MeetPure Events

 By [rajuru](https://profiles.wordpress.org/rajuru/)

[Download](https://downloads.wordpress.org/plugin/meetpure-events.0.3.0.zip)

 * [Details](https://vec.wordpress.org/plugins/meetpure-events/#description)
 * [Reviews](https://vec.wordpress.org/plugins/meetpure-events/#reviews)
 *  [Installation](https://vec.wordpress.org/plugins/meetpure-events/#installation)
 * [Development](https://vec.wordpress.org/plugins/meetpure-events/#developers)

 [Support](https://wordpress.org/support/plugin/meetpure-events/)

## Description

MeetPure Events connects your WordPress site to the [MeetPure](https://meetpure.events)
platform. It fetches your published events via the MeetPure API and displays them
in a beautiful, responsive card grid. Individual events open in a full detail page—
with cover image, date, location, description, speakers, agenda, and a CTA button—
all without leaving your site.

Plugin repository: [https://wordpress.org/plugins/meetpure-events](https://wordpress.org/plugins/meetpure-events)

**Features**

 * Responsive event card grid with cover image, date badge, event type, and CTA 
   button
 * Full single event detail page: description, location, speakers, agenda
 * Automatic page title and featured image taken from the event
 * Configurable cards-per-row, event count, and section heading
 * Support for past events toggle
 * Flexible link routing: internal detail page or direct link to meetpure.events
 * CSS Override tab with ordered editors for listing container, listing grid, listing
   cards, listing custom CSS, single container, single card, and single custom CSS
 * 5-minute transient cache to minimise API calls
 * Theme-inheriting styles via CSS custom properties

### Configuration

Go to **Settings  MeetPure Events** and fill in:

 * **API Token** — Your MeetPure API token. For now, request one from support@meetpure.
   com and provide the exact Team ID configured in the plugin so the key is bound
   only to that team. The plugin rejects keys with write scope and validates team
   access via `/auth/info`.
 * **Team ID** — The team whose events are displayed. The API key must be bound 
   only to this Team ID.
 * **Events Per Page** — Number of events requested per grid page (1–100, default
   10).
 * **Single Event Page** — Select the page that contains `[meetpure_event]` for 
   individual event detail views.

The settings page also includes a **CSS Override** tab. The fields are ordered like
the rendered markup: listing container, listing grid, listing cards, listing custom
CSS, then single container, single card, and single custom CSS. Declaration fields
add their selector automatically; custom CSS fields use full scoped selectors.

### Usage

#### Events Grid

Place the following shortcode on any page or post to display a grid of upcoming 
events:

    ```
    [meetpure_events]
    ```

**Available attributes:**

 * `count` — Override Events Per Page for this grid (1–100). Default: _(from settings)_
 * `title` — Section heading. Hidden by default. When set, it renders inside a targetable
   title block. Default: _(none)_
 * `per_row` — Cards per row on large screens (1–6). Default: `3`
 * `image_ratio` — Card cover aspect ratio, such as `16/9`, `4/3`, `1/1`, or `2/
   5`. Leave empty to use the default fixed height. Use with `image_fit="cover"`
   when the image should fill the custom shape. Default: _(none)_
 * `image_fit` — How cover images fill the image area: `contain` shows the full 
   image, `cover` crops to fill. Default: `contain`
 * `top_radius` — Card top corner radius in pixels (0–80). Default: `12`
 * `bottom_radius` — Card bottom corner radius in pixels (0–80). Default: `12`
 * `include_past` — Set to `"true"` to include past events. Default: `false`
 * `link_to` — Where cards link: `auto`, `internal`, or `external`. Default: `auto`
 * `page_param` — Query parameter used for pagination. Change only when multiple
   event grids appear on the same page. Default: `meetpure_events_page`
 * link_to values:
 * `auto` — Links to the Single Event Page if configured, otherwise to meetpure.
   events.
 * `internal` — Always links to the local Single Event Page.
 * `external` — Always links to meetpure.events.

**Examples:**

    ```
    [meetpure_events]

    [meetpure_events count="6" per_row="2" title="Upcoming Events"]

    [meetpure_events image_ratio="16/9" image_fit="cover"]

    [meetpure_events image_ratio="1/1"]

    [meetpure_events image_ratio="2/5" image_fit="cover"]

    [meetpure_events top_radius="16" bottom_radius="4"]

    [meetpure_events include_past="true" title="All Events"]

    [meetpure_events link_to="external"]
    ```

#### Single Event Detail

Add the following shortcode to a dedicated page to render a full event detail view:

    ```
    [meetpure_event]
    ```

When accessed via `?meetpure_event=EVENT_ID` in the URL (linked automatically from
the grid), it displays the matching event. You can also hardcode a specific event:

    ```
    [meetpure_event event_id="VoUfH"]
    ```

**Available attributes:**

 * `event_id` — MeetPure event ID. Default: _(read from URL query string)_

#### Setting up Individual Event Pages

 1. Create a new WordPress page (e.g. “Event”) and add `[meetpure_event]` to its content.
    Publish it.
 2. In **Settings  MeetPure Events**, select that page under **Single Event Page**.
    Save.
 3. Event cards in your grid will now link to `yoursite.com/event/?meetpure_event=EVENT_ID`.
 4. The page title, featured image, and document title are automatically replaced with
    the event’s data.

### External Services

This plugin connects to the **MeetPure Events platform** (`https://meetpure.events`)
to fetch and display event information.

#### MeetPure Events API

**What it is used for:** The plugin retrieves your team’s published events and individual
event details from the MeetPure Events platform API so they can be displayed on 
your WordPress site via the `[meetpure_events]` and `[meetpure_event]` shortcodes.

**What data is sent and when:**

 * When the `[meetpure_events]` shortcode is rendered, the plugin sends an HTTP 
   GET request to `https://meetpure.events/api/v1/events` containing: your API token(
   in the `X-API-Key` header), your team ID (in the `X-Team-Id` header), a requested
   page number and page size, a status filter (`published`), and optionally a start
   date to filter out past events. API responses are cached for 5 minutes using 
   WordPress transients; no request is made while a valid cache entry exists.
 * When the `[meetpure_event]` shortcode is rendered (or the single event detail
   page is loaded), the plugin sends an HTTP GET request to `https://meetpure.events/
   api/v1/events/{event_id}` containing your API token (in the `X-API-Key` header).
   This request is also cached for 5 minutes.
 * No visitor/end-user data is collected or transmitted — only the site owner’s 
   API credentials and the requested event identifiers are sent.

**Service provider:** MeetPure Events (`https://meetpure.events`)

 * [Terms of Service](https://meetpure.com/tou)
 * [Privacy Policy](https://meetpure.com/privacy-policy)

## Installation

 1. In your WordPress admin go to **Plugins  Add New**.
 2. Search for **MeetPure Events** or click **Upload Plugin** and select the ZIP file.
 3. Click **Install Now**, then **Activate**.
 4. Go to **Settings  MeetPure Events** and enter your API Token and Team ID.

## FAQ

### Where do I find my API Token and Team ID?

For now, API tokens are created by the MeetPure Events support team. Email support@
meetpure.com to request a token, and include the exact Team ID configured in your
plugin settings so the key is bound only to that team.

### Events are not showing up — what should I check?

 1. Confirm your API Token and Team ID are correct in the plugin settings.
 2. Make sure your team has published events.
 3. If you’ve recently saved settings, the cache has been cleared. Try refreshing the
    page.

### Can I show past events?

Yes — add `include_past="true"` to the shortcode: `[meetpure_events include_past
="true"]`

### How does caching work?

API responses are cached for 5 minutes using WordPress transients. Saving the plugin
settings clears the cache immediately.

### Can I customise the HTML layout of the event cards or detail page?

Yes — the plugin supports template overrides. Copy the template you want to change
from the plugin’s `templates/` folder into a `meetpure-events/` folder inside your
active theme, then edit freely. Your changes survive plugin updates.

    ```
    wp-content/themes/your-theme/meetpure-events/events-list.php    events grid
    wp-content/themes/your-theme/meetpure-events/event-template.php  single event detail
    ```

Child themes are checked before parent themes.

### Can I customise the styles?

Yes — use **Settings  MeetPure Events  CSS Override** to style the listing container,
listing grid, listing cards, listing custom CSS, single container, single card, 
and single custom CSS. The CSS is rendered after the plugin stylesheet. You can 
also use the WordPress Customizer (Additional CSS) or your theme stylesheet for 
full custom CSS rules.

Yes — you can paste the shortcodes into any page builder that supports WordPress
shortcodes (Elementor, Divi, WPBakery, etc.).

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“MeetPure Events” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ rajuru ](https://profiles.wordpress.org/rajuru/)
 *   [ meetpure ](https://profiles.wordpress.org/meetpure/)

[Translate “MeetPure Events” into your language.](https://translate.wordpress.org/projects/wp-plugins/meetpure-events)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/meetpure-events/), 
check out the [SVN repository](https://plugins.svn.wordpress.org/meetpure-events/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/meetpure-events/)
by [RSS](https://plugins.trac.wordpress.org/log/meetpure-events/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.3.0

 * Add top-level events block styling for each `[meetpure_events]` shortcode instance.
 * Add scoped custom CSS support for more specific selectors inside `.meetpure-events`.
 * Wrap shortcode titles in a targetable title block.
 * Breaking change: CSS Override fields are replaced by the ordered listing/single
   field set. Declaration fields now add their selector automatically; move selector-
   based listing rules into Listing Custom CSS and selector-based single-event rules
   into Single Custom CSS.

#### 0.2.27

 * Add a CSS Override settings tab with block-specific editors.
 * Render saved CSS overrides after the plugin stylesheet.
 * Add MeetPure as a plugin co-author.

#### 0.2.25

 * Prepare the image controls branch for direct merge.
 * Include review follow-up fixes for SEO tag filtering, ticket data validation,
   cache invalidation, and multisite uninstall cleanup.

#### 0.2.4

 * Add `image_ratio` and `image_fit` shortcode attributes for event card cover images.
 * Increase settings-page token validation timeout to 15 seconds.
 * Refresh cached connection status whenever settings are saved.

#### 0.2.3

 * Add ticket section rendering to single event detail pages.
 * Add event-specific meta description and Open Graph tags for single event pages.
 * Add a settings-page connection status check for API token and team validation.
 * Improve single event title filtering to avoid changing titles in admin screens,
   menus, and widgets.
 * Improve cache invalidation when settings are saved for the first time.
 * Add uninstall cleanup for plugin options and MeetPure transients.

#### 0.2.1

 * Fix: event cards now show the full cover image instead of cropping it.
 * Fix: event grids now sort upcoming events by date, with past events after upcoming
   events in most-recent-first order.
 * Add `top_radius` and `bottom_radius` shortcode attributes for controlling event
   card corner rounding.

#### 0.2.0

 * Add paginated `[meetpure_events]` rendering using the MeetPure API `page` and`
   per_page` parameters.
 * Rename the admin event count setting to **Events Per Page** and document `count`
   as a per-grid page-size override.
 * Improve the admin settings page with a branded header, full-width settings panels,
   and refreshed usage guide styling.
 * Strengthen API token validation for write scopes, multi-team access, and team
   binding checks.
 * Rename **Default Team ID** to **Team ID** and remove the public `team_id` shortcode
   override.

#### 0.1.4

 * Compatibility: tested up to WordPress 6.9.
 * Update plugin URI to https://meetpure.events/integrations.

#### 0.1.2

 * Fix: events grid spacing now resists theme `gap` overrides via `!important` and
   an adjacent-sibling margin fallback.
 * New `min_width` shortcode attribute on `[meetpure_events]` to tune the wrap breakpoint
   per instance.

#### 0.1.1

 * Fix: events grid is now container-width responsive (auto-fit + minmax) instead
   of viewport-only.
 * Cards adapt typography and image height when narrow via container queries.

#### 0.1.0

 * Initial release.
 * Events grid shortcode `[meetpure_events]` with card layout.
 * Single event detail shortcode `[meetpure_event]`.
 * Admin settings page with API token, team ID, event count, and single event page
   picker.
 * Automatic page title and featured image from event data.
 * Speakers and agenda sections.
 * 5-minute transient cache.
 * Theme-inheriting CSS via custom properties.

## Meta

 *  Version **0.3.0**
 *  Last updated **2 weeks ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/meetpure-events/)
 * Tags
 * [event calendar](https://vec.wordpress.org/plugins/tags/event-calendar/)[event listing](https://vec.wordpress.org/plugins/tags/event-listing/)
   [events](https://vec.wordpress.org/plugins/tags/events/)[shortcode](https://vec.wordpress.org/plugins/tags/shortcode/)
 *  [Advanced View](https://vec.wordpress.org/plugins/meetpure-events/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/meetpure-events/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/meetpure-events/reviews/)

## Contributors

 *   [ rajuru ](https://profiles.wordpress.org/rajuru/)
 *   [ meetpure ](https://profiles.wordpress.org/meetpure/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/meetpure-events/)