Open-source event management and ticket selling platform — perfect for concerts, conferences, and everything in between 🎟️ If you find this project helpful, please consider giving us a star ⭐️
PHP attendize-alternativedoor-managementevent-check-inevent-managementevent-registrationevent-ticketingeventbrite-alternativeeventslaravelopen-sourcephpreactself-hostedsell-ticketssell-tickets-onlineticket-sellingticketing-systemtickettailor-alternativetito-alternative
<?php
namespace HiEvents\Services\Infrastructure\Email;
use HiEvents\DomainObjects\Enums\EmailTemplateType;
use Liquid\Exception\ParseException;
use Liquid\Template;
use RuntimeException;
use Throwable;
class LiquidTemplateRenderer
{
private Template $liquid;
public function __construct()
{
$this->liquid = new Template;
$this->liquid->parse('');
}
public function render(string $template, array $context): string
{
try {
$this->liquid->parse($template);
return $this->liquid->render($context);
} catch (Throwable $e) {
throw new RuntimeException('Failed to render template: '.$e->getMessage(), 0, $e);
}
}
public function validate(string $template): bool
{
try {
$this->liquid->parse($template);
return true;
} catch (ParseException $e) {
return false;
}
}
public function getValidationErrors(string $template): ?string
{
try {
$this->liquid->parse($template);
return null;
} catch (ParseException $e) {
return $e->getMessage();
}
}
public function getAvailableTokens(EmailTemplateType $type): array
{
$commonTokens = [
[
'token' => '{{ event.title }}',
'description' => __('The name of the event'),
'example' => 'Summer Music Festival 2024',
],
[
'token' => '{{ event.date }}',
'description' => __('The event start date'),
'example' => 'January 15, 2024',
],
[
'token' => '{{ event.time }}',
'description' => __('The event start time'),
'example' => '7:00 PM',
],
[
'token' => '{{ event.end_date }}',
'description' => __('The event end date'),
'example' => 'January 16, 2024',
],
[
'token' => '{{ event.end_time }}',
'description' => __('The event end time'),
'example' => '11:00 PM',
],
[
'token' => '{{ event.full_address }}',
'description' => __('The full event address'),
'example' => '3 Arena, North Wall Quay, Dublin 1, D01 T0X4, Ireland',
],
[
'token' => '{{ event.location_details.venue_name }}',
'description' => __('The event venue name'),
'example' => '3 Arena',
],
[
'token' => '{{ event.location_details.address_line_1 }}',
'description' => __('The venue address line 1'),
'example' => 'North Wall Quay',
],
[
'token' => '{{ event.location_details.address_line_2 }}',
'description' => __('The venue address line 2'),
'example' => '',
],
[
'token' => '{{ event.location_details.city }}',
'description' => __('The venue city'),
'example' => 'Dublin',
],
[
'token' => '{{ event.location_details.state_or_region }}',
'description' => __('The venue state or region'),
'example' => 'Dublin 1',
],
[
'token' => '{{ event.location_details.zip_or_postal_code }}',
'description' => __('The venue ZIP or postal code'),
'example' => 'D01 T0X4',
],
[
'token' => '{{ event.location_details.country }}',
'description' => __('The venue country code'),
'example' => 'IE',
],
[
'token' => '{{ event.description }}',
'description' => __('The event description'),
'example' => 'Join us for an amazing event!',
],
[
'token' => '{{ organizer.name }}',
'description' => __('The organizer\'s name'),
'example' => 'ACME Events Inc.',
],
[
'token' => '{{ organizer.email }}',
'description' => __('The organizer\'s email'),
'example' => '[email protected]',
],
[
'token' => '{{ settings.support_email }}',
'description' => __('The support email address'),
'example' => '[email protected]',
],
[
'token' => '{{ settings.offline_payment_instructions }}',
'description' => __('Instructions for offline payment'),
'example' => 'Please transfer payment to account...',
],
[
'token' => '{{ settings.post_checkout_message }}',
'description' => __('Message shown after checkout'),
'example' => 'Thank you for your purchase!',
],
[
'token' => '{{ occurrence.start_date }}',
'description' => __('The occurrence start date'),
'example' => 'January 15, 2024',
],
[
'token' => '{{ occurrence.start_time }}',
'description' => __('The occurrence start time'),
'example' => '7:00 PM',
],
[
'token' => '{{ occurrence.end_date }}',
'description' => __('The occurrence end date'),
'example' => 'January 16, 2024',
],
[
'token' => '{{ occurrence.end_time }}',
'description' => __('The occurrence end time'),
'example' => '11:00 PM',
],
[
'token' => '{{ occurrence.label }}',
'description' => __('The occurrence title suffix'),
'example' => 'Session A',
],
];
$orderTokens = [
[
'token' => '{{ order.url }}',
'description' => __('Link to view the order summary'),
'example' => 'https://example.com/order/ABC123',
],
[
'token' => '{{ order.number }}',
'description' => __('The order reference number'),
'example' => 'ORD-2024-001234',
],
[
'token' => '{{ order.payment_reference }}',
'description' => __('The reference buyers should use when paying offline. Empty when the order reference is not used as the payment reference.'),
'example' => 'ORD-2024-001234',
],
[
'token' => '{{ order.total }}',
'description' => __('The total order amount'),
'example' => '$150.00',
],
[
'token' => '{{ order.date }}',
'description' => __('The order date'),
'example' => 'January 10, 2024',
],
[
'token' => '{{ order.first_name }}',
'description' => __('The first name of the person who placed the order'),
'example' => 'John',
],
[
'token' => '{{ order.last_name }}',
'description' => __('The last name of the person who placed the order'),
'example' => 'Smith',
],
[
'token' => '{{ order.email }}',
'description' => __('The email of the person who placed the order'),
'example' => '[email protected]',
],
[
'token' => '{{ order.seats }}',
'description' => __('The seats in the order, for reserved seating events'),
'example' => 'Stalls · C-14, Stalls · C-15',
],
];
$attendeeTokens = [
[
'token' => '{{ attendee.name }}',
'description' => __('The attendee\'s full name'),
'example' => 'John Smith',
],
[
'token' => '{{ attendee.email }}',
'description' => __('The attendee\'s email'),
'example' => '[email protected]',
],
[
'token' => '{{ attendee.seat }}',
'description' => __('The attendee\'s seat, for reserved seating events'),
'example' => 'Stalls · C-14',
],
[
'token' => '{{ ticket.name }}',
'description' => __('The ticket type name'),
'example' => 'VIP Pass',
],
[
'token' => '{{ ticket.price }}',
'description' => __('The ticket price'),
'example' => '$75.00',
],
[
'token' => '{{ ticket.url }}',
'description' => __('Link to view/download the ticket'),
'example' => 'https://example.com/ticket/XYZ789',
],
];
$cancellationTokens = [
[
'token' => '{{ cancellation.refund_issued }}',
'description' => __('Whether refunds are being processed for this cancellation'),
'example' => 'true',
],
[
'token' => '{{ event.url }}',
'description' => __('Link to the event homepage'),
'example' => 'https://example.com/event/123/summer-fest',
],
];
$lineupTokens = [
[
'token' => '{{ lineup.heading }}',
'description' => __('Heading for the lineup block, such as Lineup'),
'example' => 'Lineup',
],
[
'token' => '{{ lineup.names | join: ", " }}',
'description' => __('Headliners on the attendee\'s date who aren\'t already listed under the key times'),
'example' => 'Velvet Harbour, The Northern Arcs',
],
[
'token' => '{% for slot in lineup.slots %}{{ slot.time }} {{ slot.title }} {{ slot.stage }}{% endfor %}',
'description' => __('Key times from the schedule for the attendee\'s date'),
'example' => 'Fri 25 Apr · 9:30 PM Velvet Harbour Main Stage',
],
[
'token' => '{{ lineup.url }}',
'description' => __('Link to the full schedule on the event page'),
'example' => 'https://example.com/event/123/summer-fest#schedule',
],
];
return match ($type) {
EmailTemplateType::ORDER_CONFIRMATION => array_merge($commonTokens, $orderTokens, $lineupTokens),
EmailTemplateType::ATTENDEE_TICKET => array_merge($commonTokens, $orderTokens, $attendeeTokens, $lineupTokens),
EmailTemplateType::OCCURRENCE_CANCELLATION => array_merge($commonTokens, $cancellationTokens),
};
}
}