內容簡介
Xinc Events for Dice 是一款簡單的外掛，讓使用者能夠在任何 WordPress 網站上嵌入 Dice.fm 的活動清單。適合場地、推廣者或藝術家使用，無需編寫原始碼即可輕鬆顯示活動資訊。
【主要功能】
• 在 Gutenberg 編輯器中新增 Dice Events 區塊
• 提供 [dice_events] 短碼供經典編輯器使用
• 設定頁面可輸入夥伴 ID 和全域預設值
• 支援多種佈局和顏色主題選擇
• 自訂事件顯示數量及篩選條件
• 直接在小工具中購票功能
外掛標籤
開發者團隊
原文外掛簡介
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
Install and activate the plugin
Go to Settings → Dice Events and enter your Partner ID and API Key
Optionally add a venue or other filter to narrow your event feed
Save and check the live preview at the bottom of the page
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.
