Xinc Events for Dice

Description

Xinc Events for Dice is the simplest way to embed your Dice.fm event listing on any WordPress site.

If you’re a venue, promoter, or artist with a Dice.fm partner account, this plugin wraps Dice’s official JS widget in a proper WordPress block and shortcode so you never have to touch raw code again.

Note: This is an independent, community-developed plugin — it is not developed by, endorsed by, or affiliated with Dice FM or any of its parent companies. “Dice” and “Dice.fm” are trademarks of their respective owners.

Third-party service

This plugin relies on the Dice.fm event listing widget, a JavaScript-based service hosted by Dice FM. When the widget is displayed on your site, a script is loaded from Dice’s CDN (widgets.dice.fm) and event data is fetched from Dice’s API servers on behalf of your visitors.

• Service provider: Dice FM
• Script loaded: https://widgets.dice.fm/dice-event-list-widget.js
• Dice FM Terms of Service
• Dice FM Privacy Policy

No data is sent from your WordPress site to any third party — the widget runs entirely in the visitor’s browser.

What it does

• Adds a Dice Events block to the Gutenberg editor — drop it anywhere on any page or post
• Provides a [dice_events] shortcode for classic editor users and widget areas
• A Settings page (Settings → Dice Events) to enter your Partner ID and set global defaults once
• Loads Dice’s official widget script — all event data is fetched directly from Dice’s servers, so your listing is always live and up to date
• The Dice script is only loaded on pages that contain the block or shortcode — never added globally

Features

• List or gallery layout
• Light or dark colour scheme
• Highlight colour (full colour picker in settings, hex in shortcode)
• Font family: inherit from your theme, serif (Georgia), or sans-serif (Helvetica)
• Square or round booking buttons
• Display mode: regular, simple, or full
• Event titles: show event name, city, or venue
• Toggle event images, ticket prices, track previews, and new badge on/off
• Hide postponed and/or cancelled events
• Purchase overlay — let fans buy tickets directly through the widget
• Custom number of events (1–500)
• Powerful filters — filter by venue name, artist, promoter, city, tags, price range, currency, or Dice internal IDs
• Optional container height override (e.g. 600px, 80vh)
• Full width / wide alignment support for the Gutenberg block
• Live Test Widget Preview on the settings page — see exactly how your events will look before embedding
• Multiple instances on the same page — each gets its own unique container

How to use

1. Install and activate the plugin
2. Go to Settings → Dice Events and enter your Partner ID and API Key
3. Optionally add a venue or other filter to narrow your event feed
4. Save and check the live preview at the bottom of the page
5. Add the Dice Events block anywhere in the Gutenberg editor, or use [dice_events] in any widget area or classic editor

Shortcode reference

[dice_events layout="list" theme="light" highlight_colour="#000000" font_family="Georgia" button_style="square" show_images="true" show_price="true" hide_postponed="false" hide_cancelled="false" tags="Venue Name" height="600px"]

All attributes are optional — omit any to inherit the global settings value.

The tags attribute accepts a comma-separated list: tags="The Underworld,Fabric London"

Performance

The Dice widget script (dice-event-list-widget.js) is loaded only on pages that contain the block or shortcode. It is never added to every page globally.