D Cartwright

<p>Dice rolling in forums for RP/etc groups.</p>
<h3>Notes</h3>
<p>History.txt – contains all the changes since version 1.0<br />
License.txt – contains the licensing details for this component.</p>


BuddyPress Group Dice

Mark Benewith

<p><strong>Xinc Events for Dice</strong> is the simplest way to embed your Dice.fm event listing on any WordPress site.</p>
<p>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.</p>
<p><strong>Note:</strong> 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.</p>
<h4>Third-party service</h4>
<p>This plugin relies on the <strong>Dice.fm event listing widget</strong>, a JavaScript-based service hosted by Dice FM. When the widget is displayed on your site, a script is loaded from Dice’s CDN (<code>widgets.dice.fm</code>) and event data is fetched from Dice’s API servers on behalf of your visitors.</p>
<ul>
<li>Service provider: <a href="https://dice.fm" rel="nofollow ugc">Dice FM</a></li>
<li>Script loaded: <code>https://widgets.dice.fm/dice-event-list-widget.js</code></li>
<li><a href="https://dice.fm/terms_and_conditions.html" rel="nofollow ugc">Dice FM Terms of Service</a></li>
<li><a href="https://support.dice.fm/article/244-uk-privacy-policy" rel="nofollow ugc">Dice FM Privacy Policy</a></li>
</ul>
<p>No data is sent from your WordPress site to any third party — the widget runs entirely in the visitor’s browser.</p>
<h4>What it does</h4>
<ul>
<li>Adds a <strong>Dice Events block</strong> to the Gutenberg editor — drop it anywhere on any page or post</li>
<li>Provides a <code>[dice_events]</code> shortcode for classic editor users and widget areas</li>
<li>A <strong>Settings page</strong> (Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> Dice Events) to enter your Partner ID and set global defaults once</li>
<li>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</li>
<li>The Dice script is <strong>only loaded on pages that contain the block or shortcode</strong> — never added globally</li>
</ul>
<h4>Features</h4>
<ul>
<li>List or gallery layout</li>
<li>Light or dark colour scheme</li>
<li>Highlight colour (full colour picker in settings, hex in shortcode)</li>
<li>Font family: inherit from your theme, serif (Georgia), or sans-serif (Helvetica)</li>
<li>Square or round booking buttons</li>
<li>Display mode: regular, simple, or full</li>
<li>Event titles: show event name, city, or venue</li>
<li>Toggle event images, ticket prices, track previews, and new badge on/off</li>
<li>Hide postponed and/or cancelled events</li>
<li>Purchase overlay — let fans buy tickets directly through the widget</li>
<li>Custom number of events (1–500)</li>
<li><strong>Powerful filters</strong> — filter by venue name, artist, promoter, city, tags, price range, currency, or Dice internal IDs</li>
<li>Optional container height override (e.g. <code>600px</code>, <code>80vh</code>)</li>
<li>Full width / wide alignment support for the Gutenberg block</li>
<li>Live <strong>Test Widget Preview</strong> on the settings page — see exactly how your events will look before embedding</li>
<li>Multiple instances on the same page — each gets its own unique container</li>
</ul>
<h4>How to use</h4>
<ol>
<li>Install and activate the plugin</li>
<li>Go to <strong>Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> Dice Events</strong> and enter your Partner ID and API Key</li>
<li>Optionally add a venue or other filter to narrow your event feed</li>
<li>Save and check the live preview at the bottom of the page</li>
<li>Add the <strong>Dice Events</strong> block anywhere in the Gutenberg editor, or use <code>[dice_events]</code> in any widget area or classic editor</li>
</ol>
<h4>Shortcode reference</h4>
<pre><code>[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"]
</code></pre>
<p>All attributes are optional — omit any to inherit the global settings value.</p>
<p>The <code>tags</code> attribute accepts a comma-separated list: <code>tags="The Underworld,Fabric London"</code></p>
<h4>Performance</h4>
<p>The Dice widget script (<code>dice-event-list-widget.js</code>) is loaded only on pages that contain the block or shortcode. It is never added to every page globally.</p>


Xinc Events for Dice

Stop pasting raw JavaScript — add your Dice.fm events to WordPress in minutes.

BuddyPress Group Dice vs Xinc Events for Dice