Minitickets

Plugins

Your Minitickets events on your WordPress site

The Minitickets plugin puts your upcoming public events on your own WordPress site: a ticket widget, a plain list that search engines can read, a block for the block editor, Elementor support, and a page on your site for each event. You enter an event once, on Minitickets; your site follows it. Tickets are always bought on your event page on Minitickets, which opens in a new tab.

Minitickets for WordPress 1.1.0

WordPress 5.8+ · PHP 7.4+ · tested up to WordPress 7.1. No other dependency.

Download the plugin (.zip)

Install

  1. Download minitickets.zip with the button above (it is also in «Widget for your site» on Minitickets).
  2. In WordPress: Plugins → Add New → Upload Plugin, choose the file, Install, Activate.
  3. Settings → Minitickets: choose «Promoter page» or «My events», paste your slug or account id, save.
  4. Add [minitickets] to a page, or the «Minitickets events» block, or the shortcode in Elementor's Shortcode widget.
  5. For a page per event: tick «Make a page on this site for each event», save, then «Sync now».

Where to find your organizer id. Open «Widget for your site» on Minitickets: on your promoter page it is the promoter's slug (for example oshman-jcc), in My Events it is your account id. One event's widget is in that event's Widgets tab.

Shortcodes

Left out, the organizer, label and language come from Settings → Minitickets, and for [minitickets] also the theme, colour and number of events; [minitickets_events] shows 10 unless you set limit. Search, tag and inherit_ref_param have no setting: left out, there is no filter. The shortcodes copied from «Widget for your site» write every look out in full, so the page matches that preview whatever the Settings say.

[minitickets]: the ticket widget

Cards with the cover, the date in the event's time zone, the city, the price and a ticket button. The button opens your event page on Minitickets in a new tab; nothing is bought inside your page.

[minitickets promoter="your-slug" search="watch party" limit="3" ref="home_page"]
promoter, user or event
a promoter's slug, an account id, or one event's slug
Whose events. Left out: the organizer from Settings → Minitickets.
search
words
Only events with all these words in the title or description.
tag
a tag or category slug
Only events with this Minitickets tag or category.
limit
1–20
How many events. Left out: «Events shown» from Settings → Minitickets.
theme
light / dark
Colours.
accent
#rrggbb
The button colour.
lang
en / ru
Words and dates.
minimal
true
Compact rows with no pictures.
show_logo
false
No «Tickets by Minitickets» line.
bg_fill
false
A transparent background: your page shows through.
ref
letters, digits, _ . -
A label for this placement, carried on the ticket links as utm_campaign.
inherit_ref_param
a query parameter name, e.g. ref
Take the label from your page's own address (?ref=newsletter) when it has one.

Every attribute at once:

[minitickets promoter="your-slug" search="watch party" tag="comedy" limit="6" theme="light" accent="#4f46e5" lang="en" minimal="true" show_logo="false" bg_fill="false" ref="home_page" inherit_ref_param="ref"]

[minitickets_events]: a plain list

Rendered by WordPress from your public feed, so it works without JavaScript and search engines read it. Cached for ten minutes.

[minitickets_events promoter="your-slug" limit="10" ref="calendar" lang="en"]
promoter or user
a promoter's slug or an account id
Whose events. Left out: the organizer from Settings → Minitickets.
limit
1–50
How many events. Left out: 10.
search
words
Only events with all these words in the title or description.
tag
a tag or category slug
Only events with this Minitickets tag or category.
ref
letters, digits, _ . -
A label for this placement, carried on the ticket links as utm_campaign.
lang
en / ru
Words and dates.

The block and Elementor

  • Block editor: add the «Minitickets events» block (the widget or the plain list), with the same settings. «Events shown» left empty takes Settings → Minitickets for the widget and 10 for the plain list.
  • Elementor: put either shortcode in Elementor's Shortcode widget.

Event pages

New in 1.1.0. Tick «Make a page on this site for each event» in Settings → Minitickets: each upcoming public event gets its own page on your site at /events/<event>/, and the list of all of them is at /events/ (the address word is a setting).

  • Each page shows the cover, the date and time in the event's own time zone, the place (only the city when the venue is hidden), the price («from …», «Free», «Sold out»), the description and a «Buy tickets» button to the event page on Minitickets in a new tab. The page carries schema.org Event data, and its canonical address stays your own.
  • Pages are refreshed from your feed every 15 minutes, at once with «Sync now», and soon after you save the settings. At most the next 50 events are synced.
  • What the sync rewrites: the title, the description, the event's fields (date, time zone, place, price, sold out, links, cover) and the featured image it downloaded. Change those on Minitickets.
  • What stays yours: «Your text on this page» (shown under the description), the excerpt, a featured image you choose, and anything else you add.
  • An event that ended or left your feed goes to draft, never deleted, and comes back if the event does. A page you put in draft or in the trash yourself is left alone, and a page you delete for good is not made again. If Minitickets cannot be read, nothing changes.
  • Covers are downloaded into your media library once each; until then the page shows the cover from Minitickets.
  • The pages are the post type minitickets_event, in the REST API too, so Elementor's Theme Builder, the block editor and themes can use them.
  • With «titles open these pages» ticked, [minitickets_events] links each title to its page on your site.
  • Events are added on Minitickets, not in WordPress.
  • A page says «Page not found»? Open Settings → Permalinks and press Save once, and check that no page of yours uses the same address word (Settings → Minitickets → Address).

Where sales show

Sales from your site show in each event's Sources on Minitickets. Ticket links from WordPress carry utm_source=wordpress; add a placement label (ref) to tell the home page from the calendar.

What is sent where

  • The widget loads https://minitickets.com/embed.js in the visitor's browser, which shows a frame from Minitickets with your upcoming public events. The visitor's browser sends the usual request data (address, browser, the page's host) to Minitickets. No cookie is set by the frame.
  • The plain list is read by your server from your Minitickets feed (with the limit, filters, ref and your site's host), at most once per ten minutes per list. No visitor data is sent.
  • With event pages on, your server reads the same feed every 15 minutes and downloads each event's cover once from Minitickets' storage. No visitor data is sent.
  • Only upcoming public events are shown. Drafts and events shared by link only are never listed; a hidden venue is shown as its city.

See our Terms and Privacy Policy.

Not on WordPress?

Paste the widget into any page of your site:

<div data-minitickets data-promoter="your-slug" data-theme="light" data-accent="#4f46e5" data-limit="6" data-lang="en"></div>
<script async src="https://minitickets.com/embed.js"></script>

Use data-user for an account id or data-event for one event instead of data-promoter. «Widget for your site» on Minitickets writes this code for you, with a preview.

Questions: support@minitickets.com.