Get Started

Configuration

You can customise Events’ settings using a PHP configuration file. This is optional: each setting has a default, so you only need to include the values you want to change.

To override a setting, create events.php in your Craft project’s /config directory and return an array of setting names and values. For example, the following will change the name displayed in the control panel:

<?php

return [
    'pluginName' => 'Events Tools',
];

All other settings keep their defaults. Add any further settings you want to change to the same array. The options below explain the available settings and their defaults. You can also manage many of these settings in the control panel under Events → Settings.

Configuration Options

pluginName

Change the plugin name.

defaultEventIndexStatus

Set the default status filter for the Events index. Leave blank to show all statuses.

ticketPdfPath

Set the path to your PDF.

ticketPdfFilenameFormat

Set the default PDF filename format.

checkinTemplate

Set a template to be shown when checking into an event. See events/templates/check-in.html for an example.

ticketsShippable

Whether a ticket should be classified as shippable. If false (the default) no shipping methods will be able to be selected, if tickets are the only items in the cart.

applyPendingTicketUpdates

Whether to automatically queue ticket updates when saving an event that has pending session or ticket type changes. Defaults to false, which preserves the manual Apply ticket updates workflow.

releaseCapacityOrderStatusHandles

Commerce order status handles that should cancel purchased tickets for an order, restoring event capacity. Defaults to cancelled, canceled, and refunded. Set to an empty array to disable automatic cancellation.

purchasedTicketTrashRetentionDays

Number of days to retain soft-deleted purchased tickets before Craft’s garbage collection permanently deletes them. Defaults to 30. Set to 0 to disable automatic purging.

cancelPurchasedTicketsOnRefund

Whether Commerce refunds should automatically cancel purchased tickets. Defaults to true.

allowRestoreWhenOrderCancelled

Whether cancelled purchased tickets can be restored when their order is in a release-capacity status. Defaults to false.

pdfAllowRemoteImages

Whether to allow remote images in the PDF.

pdfPaperSize

Sets the paper size for the PDF.

pdfPaperOrientation

Sets the paper orientation for the PDF.