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 / Cmd + Z – Undo the last action.
• Ctrl / Cmd + Y – Redo the last undone action.
• Ctrl / Cmd + A – Select all objects on the canvas.
• Ctrl / Cmd + I – Invert the current selection.
• Ctrl / Cmd + C – Copy selected elements.
• Ctrl / Cmd + 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 first quick pattern.

Do the same for the Seat Id field or just type the pattern [1]! in the field. The code will automatically detect that you want to apply a pattern.

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.

Seat Reservation Time

↑ Back to top

By default, when a customer adds a seat to their cart, the seat is reserved for 24 hours. Other customers will not be able to select the seat until the 24-hour period has passed.

To edit the reservation time value go to Dashboard → WooCommerce → Settings. Click on “Products” tab and scroll down to the “Seat Reservation” section.

Setting the Seat Reservation Time to 0 will disable this feature.

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 → WooCommerce → Seat Scanner.

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.

Enabling PDF Attachments

↑ Back to top

To include a PDF with reservation details in the order completed email, go to Dashboard → WooCommerce → Settings.

Click the Emails tab, scroll down to the Seat Planner Attachments section, and check the Enable PDF Attachments box.

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

Setting up Secret Key

Go to your WordPress Dashboard → Tools → Seat Planner App Settings.

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 Mobile App on your phone.

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

Install and open the application.

In the app, go to Settings and enter the Secret Key from your website.

Make sure the Website API URL matches your site’s REST API base URL, e.g.

https://your-site.com/wp-json/.

If you’re unsure about the URL, you can copy it from the REST API Base URL field on the Seat Planner App Settings page.

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

Booking Integrity Check

↑ Back to top

You can check the booking data integrity by going to Dashboard → Tools → Booking Integrity Checker.

From here you can test your products for accidental Double bookings or Ghost Bookings.