Tickets: Create a [camptix] block

[dd32]

Description

Presently it seems we only have the [camptix] shortcode for the tickets system.

We should add a Block for easier customization of the display.

Some initial thoughts from me on features that could benefit site creators:

• The ability to customize/preview the "No tickets available" message
• The ability to customize/preview the "Event closed" message
• The ability to add/remove tickets from the list (This is supported via the shortcode, but not known to be well known)
• The ability to set a max tickets per order (down from 10)
• The ability to auto-set a coupon (ie. EARLYBIRD)

This would benefit us as it'll move the [camptix] documentation from handbooks to an easily usable insertable block.

Worth noting: The camptix shortcode is NOT intended on being added/removed to extra pages, it's expected that it exists on a page that will forever remain accessible. This is due to how the content override works for ticket edit details. It might be worth decoupling this block from that shortcode override functionality.

[dd32]

🤖 This comment was generated by an AI assistant (Claude) based on research across the repository issue history and a deep dive into the CampTix plugin, its addons, and WordCamp-specific customizations.

---

An initial implementation of this block is in #1683. Here is a summary of what has been implemented and a research-backed list of potential future enhancements.

Implemented in #1683

• Ticket selection — choose specific tickets to display or show all (surfaces the shortcode capability that was not well known)
• Max tickets per order — configurable limit from 1–10 (previously only available via camptix_max_tickets_per_order filter)
• Auto-apply coupon — automatically apply a coupon code on page load
• Custom "No tickets available" message — editable with a live preview
• Custom "Event closed" message — editable with a live preview
• Remaining tickets visibility — toggle the "Remaining" column on/off (previously only via camptix_show_remaining_tickets filter)
• Coupon field visibility — auto (hides when no valid coupons exist on the site), always show, or always hide. Adds camptix_have_coupons filter.
• Sold-out ticket visibility — show sold-out tickets with a "Sold out" label instead of hiding them (previously only via camptix_hide_empty_tickets filter)
• Editor preview — static preview table reflecting ticket data and configured settings, with server-side currency formatting via append_currency()

---

Potential future enhancements

These are grouped by theme and informed by the 141 filter/action hooks in CampTix, the addon ecosystem, WordCamp-specific tweaks in camptix-tweaks, and companion plugins.

Form Display & Customization

• Ticket description toggle — tickets have a post_excerpt that renders below the title. Add a toggle to show/hide descriptions in the ticket table. The data is already rendered but there is no organizer control.
• Configurable button text — the "Register →" submit button is hardcoded. A text field would allow "Get Tickets", "RSVP", etc. The camptix_register_button_classes filter exists for styling but not for the label.
• Ticket ordering — allow drag-to-reorder tickets in the block sidebar, independent of post publish date. Currently the order follows the get_posts query order.
• Ticket type filtering — WordCamp has a ticket type system (Default/In-person vs. Livestream/Remote via camptix_ticket_types filter in camptix-tweaks). The block could filter by type, e.g., show only in-person tickets on one page and remote tickets on another.
• Custom CSS class — add a text field for an extra CSS class on the #tix wrapper, useful for theme-specific styling without custom code.

Coupon & Pricing

• Per-ticket quantity limits — per Limit number of tickets per transaction #1361, organizers want per-ticket max quantities (e.g., speaker +1 coupon limited to 1). Currently only a global max exists. The block could allow setting a max per ticket ID.
• Coupon bypass visibility — when a coupon has tix_bypass_max_tickets_per_order set, the max is tripled. The block could surface this as a visible note or control.
• Price display format — toggle between showing the full formatted price vs. just the number, or adding a "from" prefix for tickets with coupon discounts.

Checkout Flow & Multi-step

• Decouple from content override — as noted in the issue description, the multi-step flow (attendee_info, checkout, edit_attendee, refund_request) currently overrides the entire page post_content via the camptix_post_content_override filter. The block could render these steps within its own container, preserving surrounding content. This is architecturally significant — 6 places in camptix.php call this filter (lines 5888, 6229, 6371, 6620, 6840, 7354).
• Custom order summary header — the "Order Summary" and "Registration Information" headers are filterable (camptix_register_order_summary_header, camptix_register_registration_info_header) but not exposed. The block could allow customizing these.
• Post-purchase message — a custom "thank you" or next-steps message shown after successful checkout, using the camptix_form_register_complete_attendee_object action point.

Attendee Form Fields

• Extra field visibility — WordCamp adds several attendee fields via addons: accessibility needs, allergies, code of conduct agreement, first-time attendee, and a health advisory. These are toggled per-addon but the block could surface which ones are active and allow reordering them. The hooks camptix_attendee_form_before_questions and camptix_attendee_form_after_questions provide insertion points.
• Question preview — show which custom questions are configured for each ticket type in the editor preview, using the tix_question_id meta on tickets.
• Name field order — CampTix supports a camptix_name_order filter for first/last name display order (important for East Asian names). The block could surface this as a setting.

Reservation Support

• Reservation-aware mode — CampTix has a reservation system with tokens, IDs, and ticket-specific reserved quantities. The block could accept reservationId and reservationToken attributes, useful for creating separate speaker/sponsor ticket pages with pre-reserved allocations. Currently this is only accessible via URL query parameters.

Addon Integration

• Require-login integration — the require-login addon forces WordPress login before purchase and adds an "I don't know who will use this ticket yet" checkbox. The block could show a notice in the editor when this addon is active, and potentially allow toggling it per-block.
• Invoice addon integration — camptix-invoices adds invoice request fields to the checkout form. The block could indicate whether invoicing is available for the selected tickets.
• Attendance tracking — camptix-attendance provides a mobile check-in UI with secret-based access. The block could surface attendance stats (registered vs. attended) in a companion block or variation.
• Admin flags display — camptix-admin-flags allows private per-attendee flags. While these are admin-only, the block could show flag-filtered attendee counts in the editor preview.

Secondary Events & Multi-ticket

• Secondary ticket linking — per Tickets: Add the ability to handle secondary event tickets #1371, there is demand for tickets that depend on a general admission purchase (workshops, contributor days). The block could support a "requires ticket" attribute linking to a parent ticket ID, with validation during checkout.
• Ticket group labels — group tickets visually with headings (e.g., "General Admission", "Add-ons", "Workshops") within a single block instance.

Scheduling & Availability

• Sale date preview — tickets have tix_start and tix_end meta fields. The editor preview could show the sale window for each ticket, and the block could display a countdown or "Sales open on [date]" message before the start date.
• Scheduled block visibility — hide the entire block before ticket sales open or after they close, using the ticket date metadata. This is different from the "Event closed" message — it would suppress the block entirely.

Accessibility & Internationalization

• RTL preview support — ensure the editor preview table renders correctly in RTL admin contexts.
• Accessible coupon toggle — the current coupon field uses inline JS with onclick and style.display. This could be improved with proper ARIA attributes (aria-expanded, aria-controls) and keyboard support.
• Screen reader improvements — the form uses tix-screen-reader-fieldset classes for radio groups, but the quantity selects lack aria-label attributes describing which ticket they control.

Analytics & Reporting

• Live stats display — a companion block or block variation that shows ticket sales stats using the camptix_summary_fields system: tickets sold, revenue, remaining capacity. Data is already computed by get_summary().
• Conversion tracking — the camptix_payment_result action fires after payment. A block-level setting could configure a conversion tracking pixel or event name for analytics integration.

Payment

• Payment method preview — show which payment methods are enabled (Stripe, PayPal, etc.) in the editor preview. The camptix_available_payment_methods filter provides the list.
• Free ticket flow — when all selected tickets are free, the checkout shows "Claim Tickets →" instead of "Checkout →" and skips payment method selection. The block could preview this distinction.

---

Other relevant issues

• Tickets: Add the ability to handle secondary event tickets #1371 — Add the ability to handle secondary event tickets
• Limit number of tickets per transaction #1361 — Limit number of tickets per transaction
• Ignore locale when sorting for shortcode "camptix_attendees" #1310 — Ignore locale when sorting for shortcode camptix_attendees
• CampTix QR Code Feature #613 — CampTix QR Code Feature
• New Feature: Camptix Webhook Plugin #1383 — New Feature: Camptix Webhook Plugin
• There should be option to initiate partial refund in Camptix #1553 — Partial refund support (implemented separately in Add partial refund support for multi-ticket CampTix orders #1678)
• CampTix: Prevent broken Tickets pages when shortcode removed #402 — Prevent broken Tickets pages when shortcode removed (related to content override decoupling)
• CampTix: Too many emails about special accommodations for large events #508 — Too many emails about special accommodations (related to extra field notifications)
• CampTix: Issues with the [camptix_attendees] shortcode #374 — Issues with the [camptix_attendees] shortcode (companion block opportunity)
• Make it possible to reset the info and edit ticket token #1302 — Make it possible to reset ticket tokens (related to reservation/access flow)