Installation and Setup of Voxel Events

Step 1: Install the Plugin

1. Go to Plugins → Add New in your WordPress dashboard
2. Click Upload Plugin at the top of the page
3. Select the Voxel Events plugin zip file
4. Click Install Now
5. Once installed, click Activate

Step 2: Activate Your License

1. Go to Event Tickets → License in your WordPress menu
2. Enter your license key
3. Click Activate License

Step 3: Create or Choose Your Event Post Type

You need a post type in Voxel to hold your events. You can use an existing post type or create a new one.

To Create a New Post Type:

1. Go to Structure → Post Types
2. Click Create Post Type
3. Give it a name like “Events” or “Shows”
4. Configure the basic settings as needed
5. Click Save

Step 4: Add a Product Field

The product field is where you’ll configure your tickets.

1. Go to Structure → Post Types
2. Click on your event post type
3. Go to the Fields tab
4. Click Add Field
5. Select Product from the field types
6. Give it a label like “Tickets” or “Admission”
7. Click Save

Step 5: Enable the Voxel Events Product Type

Now you need to tell Voxel to use the Voxel Events product type for your tickets.

1. In your post type settings, find the Product field you just created
2. Click on the product field to open its settings
3. Look for Product Type and select Voxel Events
4. Click Save

Step 6: Configure the Date Source

Your events need dates. Voxel Events uses Voxel’s recurring date field to know when your event happens.

Add a Recurring Date Field:

1. In your post type fields, click Add Field
2. Select Recurring Date as the field type
3. Give it a label like “Event Dates” or “Schedule”
4. Configure the date settings as needed
5. Click Save

Connect the Date Field to Ticketing:

1. Click on your Product field
2. In the product field settings, find Date Source
3. Select the recurring date field you just created
4. Click Save

Now when you create an event and add dates, those dates will automatically be available for ticket time slots.

Step 7: Configure the Location Source

If your events have physical locations, you can connect an address field so ticket buyers see venue information.

Add a Location Field:

1. In your post type fields, click Add Field (if you don’t already have one)
2. Select Location or Address as the field type
3. Give it a label like “Venue” or “Event Location”
4. Click Save

Connect the Location Field:

1. Click on your Product field
2. In the product field settings, find Location Source
3. Select your location/address field
4. Click Save

Step 8: Configure Global Plugin Settings

Before creating your first event, review the global settings.

1. Go to Event Tickets → Settings

Ticket Code Settings

• Ticket Prefix: A short code that appears before ticket numbers (e.g., “EVT” creates codes like EVT-ABC123)
• Code Length: How many characters in the unique part of the code (4-12 characters)

Cart Reservation Settings

When customers add tickets to their cart, you can reserve those seats temporarily:

• Disabled: No reservation (first to complete checkout gets the tickets)
• 5-20 minutes: Tickets are held for this duration while the customer completes checkout

Email Settings

If you plan to message attendees:

• Batch Size: How many emails to send at once (start with 50)
• Batch Delay: Seconds between batches (prevents server overload)
• Hourly Limit: Maximum emails per hour (0 = unlimited)

Troubleshooting

Dates aren’t showing in time slot options

Make sure:

• You have a recurring date field in your post type
• The date field is connected as the Date Source in your product field settings
• Your event has dates added