Basker Docs

Spektrix

Embed Spektrix checkout, baskets, accounts, donations, and more directly on a page.

The Spektrix block embeds a Spektrix ticketing experience on the page — an event list, a calendar, the checkout, a basket, a customer's account, donations, memberships, and more. It is one block with a Type option that swaps in the right Spektrix experience. Use it on your What's On, checkout, and account pages.

Connect Spektrix first

This block only appears once Spektrix is connected and synced. Its event, instance, voucher, and subscription pickers are pulled live from Spektrix, so they stay empty until the connection is in place. See Spektrix.

Choosing the type

The Type option at the top of the block sets which Spektrix experience it shows. Event List is the default. The fields below it change to match the type you pick.

The available types are: Event List, Event Calendar, Event Details, Choose Seats, Basket, Secure Checkout, My Account, Login, Donations, Memberships, Merchandise, Gift Vouchers, Offers, Offer Details, Ticket Subscriptions, Supplementary Events, Multi Buy, Choose Attendee, and Generic.

Basket, Secure Checkout, Offers, Offer Details, and Multi Buy need no extra setup — they render their own interface. Title is available for every type.

Shared fields

These appear on more than one type:

  • Title — an optional heading shown above the embedded experience. Available for every type.
  • Optimise For — tailor the layout for Desktop, Tablet, or Mobile. Shown for Event List, Event Calendar, Event Details, and Choose Seats.
  • Attribute Filters — narrow what appears by matching Spektrix attribute name and value pairs; add as many pairs as you need, each with a Name and Value. Shown for Event List, Event Calendar, Donations, Memberships, and Merchandise.

Fields by type

Event List

  • Sort By — order events by Name (default) or Date.
  • Show All Events — when on, every event appears on a single page.

Event Calendar

  • Weeks To Display — how many weeks the calendar covers. Defaults to 6.
  • Week Starts On — the first day of each week, Monday (default) through Sunday.
  • Render Horizontally — lay the calendar out horizontally. On by default.

Event Details

  • Event — select an event from Spektrix.
  • Web Event ID — the identifier configured for the event in Spektrix.

Choose Seats

  • Event — select an event from Spektrix.
  • Event Instance — select a specific performance instead of passing it in the page address.
  • Require Login — make the visitor sign in before choosing seats.
  • Choose Attendee — collect attendee details during seat selection.
  • Display ModeSeat Selection lets visitors pick from a seating plan; Best Available assigns the best open seats automatically.
  • Seating Area ID — an optional area to preselect. Appears once an Event Instance is set.

Passing the performance in the page address

If you leave Event Instance empty, Choose Seats reads the performance from the page address — for example ?EventInstanceId=1234 or a WebInstanceId. Use this when one seat-selection page serves many performances.

Donations

Donations uses only the shared Attribute Filters (here, limiting which funds appear) and Title.

Memberships

  • Choose Attendee — collect attendee details during the membership flow.
  • Sort By — order options by Name, Price Ascending, or Price Descending.

Merchandise

  • Items Per Page — how many items to show per page; defaults to all items when left empty.
  • Items Per Row — how many items sit side by side.

Gift Vouchers

  • Gift Voucher — an optional voucher to preselect.

Login

  • Return URL — an optional address to send the visitor to after they sign in.

My Account

  • Default Screen — which section opens first: Addresses, Preferences, Other Preferences, Offers, Tickets, Orders, Memberships, Account Credit, Payment Cards, Fixed Subscriptions, or Ticket Subscriptions.

Choose Attendee

  • Forward To URL — where to send the visitor after they pick an attendee, for example /clientname/website/Basket2.aspx.

Supplementary Events

  • Event — select an event from Spektrix.
  • Event Instance — select a specific performance.

Ticket Subscriptions

  • Web ID — an optional subscription identifier to filter the results.

Generic

For any Spektrix page not covered by the types above.

  • Iframe Path — required. The path relative to /website/, for example EventList.aspx or secure/Checkout.aspx.
  • Query Parameters — extra values to pass to Spektrix; add as many as you need, each with a Name and Value.

Shared controls

Beyond the fields above, the Spektrix block uses the standard block controls.

Example

To build a browse-and-book journey, add a Spektrix block to your "What's On" page and leave Type on Event List, with Sort By set to Date so upcoming events lead. On a separate seat-picking page, add another Spektrix block, set Type to Choose Seats, leave Event Instance empty, and link to it with the performance in the address — ?EventInstanceId=1234 — so one page handles every performance. Then add Basket and Secure Checkout blocks on their own pages to complete the flow.

Where to go next

On this page