Stachethemes Seat Planner

Creating Auditorium Product

↑ Back to top

Once Stachethemes Seat Planner plugin is installed and activated, a new product type “Auditorium” will be available in WooCommerce.

Steps to Create a Seat-Based Product:

Navigate to Dashboard → Products and click “Add New Product”.

Enter the Product Title, Description, and set a Product Image.

In the Product Data section, where you select the product type (e.g., Simple Product, Grouped Product, Variable Product, etc.), you will see a new option: “Auditorium Product”.

Set the product type as “Auditorium Product“.

Click the “Seat Planner” tab, then open the Seat Planner Editor by clicking the “Open Seat Planner” button.

The Seat Planner Builder includes four elements:

• Screen – A static element indicating the screen’s position in the room, primarily for orientation.
• Seat – Represents a selectable seat that customers can choose on the front end.
• Object – A static, generic element used for various visual representations.
• Text – A static element for displaying custom text on the front end.

Drag and drop a “Seat” element on the workflow.

In the “Seat Properties” toolbar, the most important settings are:

• Label – The text displayed to customers when selecting a seat on the front end.
• Seat ID – A unique identifier for the seat, stored in the database when a customer makes a purchase. Each seat must have a unique ID.
• Price – The cost of the seat. Each seat can have a different price.
• Handicap Seat – A designated seat for accessibility purposes. It helps identify seating options suitable for individuals with disabilities.

The Seat Planner Editor supports the following keyboard shortcuts for faster and more efficient workflow:

• Ctrl + Z – Undo the last action.
• Ctrl + Y – Redo the last undone action.
• Ctrl + A – Select all objects on the canvas.
• Ctrl + I – Invert the current selection.
• Ctrl + C – Copy selected elements.
• Ctrl + V – Paste selected elements.
• Esc – Deselect all selected objects.
• G – Toggle the grid visibility.
• H – Adjust the grid contrast.
• C – Change the grid color.
• [ – Decrease the grid size.
• ] – Increase the grid size.
• L – Toggle the seat text display in the editor (Label, Price, Seat ID…).

Click on the Seat you created and make more copies:

Select all seats.

Go to the Seat Properties Toolbar → Label.

Click on the Auto Increment button.

This will open the Pattern Builder menu.

Assign labels 1,2,3,4… to your seats but clicking on the Numbers quick pattern.

Do the same for the Seat Id field. Each seat must have unique Id number. If a duplicate is detected the seats will be outlined with red border. If your seats don’t have seat id they will be marked as unavailable on the front-end.

Set price for your seats by entering the desired amount, for example, 20.

You can toggle between Seat ID, Label, and Price by pressing L or by clicking on the top right button.

Set the seats Background Color and Text Color to your preference.

Drag a “Screen” element to the Workflow:

Optionally, designate some seats as “Handicap Seats” and change their background color to make them stand out.

In the top right corner, click the Cogwheel Icon to open the Workflow Settings and change the background color.

Once you are done, click the Left Arrow button in the top left corner of the builder to return to your product page.

Click “Publish“.

That’s it! You now have a seat-based product set up.

Adding Discounts

↑ Back to top

To add discounts for your seats click on the “Discounts” tab below the “Seat Planner” tab.

You can pick Fixed or Percentage-based discounts.

Adding “Dates” to your Product

↑ Back to top

As of version 1.0.28 you can add dates to your Auditorium product. Open the “Dates” tab located beneath the “Seat Planner” tab.

If your product has at least two dates, a date selector will show up on the front end.

Custom Fields

↑ Back to top

Custom fields collect additional information from customers when they select seats. Each selected seat can have different values. Fields appear in the seat selection modal after clicking “Next“.

Field Types

↑ Back to top

1. Text – Single line text input
2. Textarea Multi-line text input
3. Checkbox – Yes/no with optional price (adds price when checked)
4. Number – Numeric input with min/max and per-unit pricing (price × quantity)
5. Select – Dropdown with “options” (each option can have a price)

Common Properties

↑ Back to top

• Required – Field must be filled before adding to cart
• Visible – Shows in cart/order details (disable for internal-only fields)
• Label – Field name (must be unique)
• Description – Helper text shown below label

Pricing

↑ Back to top

• Checkbox – Adds fixed price when checked
• Select – Adds price for selected option
• Number – Price per unit × entered quantity

Quick Example

↑ Back to top

Event with add-ons:

• Checkbox: “Extra Legroom” ($15.00)
• Select: “Service Level” – Basic (free), Premium (+$25), VIP (+$50)
• Number: “Programs” (0-5 max, $5 each)

Usage

↑ Back to top

1. Go to product edit page → Custom Fields tab section
2. Click “Add Custom Field”
3. Set label, type, and options
4. Drag to reorder, click × to delete
5. Save product

Admin Settings

↑ Back to top

You can configure the admin settings by going to
Dashboard → Seat Planner → Settings.

From here, you can customize reservation time, cart timer, attachments, order status, and more.

Seat Reservation Time

↑ Back to top

By default, when a customer adds a seat to their cart, the seat is reserved for 15 minutes. Other customers will not be able to select the seat until this period has passed.

To edit the reservation time value go to Dashboard → Seat Planner → Settings.
Click on “Seat Reservation” tab and edit the time value in “Seat Reservation Time” input field.

Reservation Time cannot be set to less than 5 minutes.

Cart Behavior

↑ Back to top

You can configure the cart behavior by going to
Dashboard → Seat Planner → Settings → Cart Behavior.

Here you can set up automatic redirection to the cart or to the checkout page after a customer adds a seat to their cart.

You can also set up a custom message to be displayed during the redirection process.

Cart Timer

↑ Back to top

You can configure the cart timer by going to
Dashboard → Seat Planner → Settings → Cart Timer.

From here, you can choose whether to display a timer under each seat in the cart and customize the timer’s colors.

Enabling PDF Attachments

↑ Back to top

To include a PDF with reservation details in the order completed email, go to 

Dashboard → Seat Planner → Settings → Attachments.

Check the Enable PDF Attachments box.

Auto-Complete Orders

↑ Back to top

Automatically update the order status to “Completed” when payment is received for orders containing Auditorium products.

To enable this setting, go to Dashboard → Seat Planner → Settings → Order Status and check the Auto-Complete Orders box.

Validating Ticket using the QR Code Scanner

↑ Back to top

When an order is marked as “Completed,” WooCommerce emails the user with updated order details and a QR Code for each Auditorium Product.

Admins and Shop Managers can scan the QR Code to verify tickets.

To access the Seat Scanner, go to Dashboard → Seat Planner → Scanner or Click the Seat Scanner button in the Admin Bar at the top of the screen.

Click “Scan Now” to start scanning.

NOTE: Allow camera permissions in your browser for QR code scanning to work.

Scan the QR Code from the customer’s order confirmation email to verify their ticket.

NOTE: Scanning a ticket marks it automatically as “scanned”. Scanning it again will trigger a warning that it was already scanned.

Booking Integrity Check

↑ Back to top

You can check the booking data integrity by going to 

Dashboard → Seat Planner → Tools.

From here you can verify the booking data integrity of your auditorium products.

PDF Preview

↑ Back to top

This tool helps you preview the PDF attachment layout directly without sending it.

To access it, go to Dashboard → Seat Planner → Tools → PDF Preview

PDF templates can be customized by creating stachesepl-pdf-body.php and stachesepl-pdf-loop.php template files in your theme folder. You can use the existing plugin files for reference.

Shortcodes

↑ Back to top

Select Seat / Add to Cart Button Shortcode

↑ Back to top

You can now render a “Select Seat” button for a specific product using a shortcode.

Usage:

[stachesepl_add_to_cart product_id=123]

Parameters:

• product_id (required): The ID of the product for which you want to display the Select Seat button.

Mobile App

↑ Back to top

Setup Secret Key

↑ Back to top

Go to Dashboard → Seat Planner → Settings → Mobile App.

In the App Secret Key field, generate your secret key. It must be at least 8 characters long. This key is used by the app to communicate with your website’s REST API.

Click “Save Changes”.

Installing the Android Mobile App on your phone.

↑ Back to top

On your Android phone, go to Dashboard → Seat Planner → Settings → Mobile App, then tap the “Download Android App button to download the application.

Click “Test Connection” to ensure the application connects to your website successfully.