Merge pull request #47 from HiEventsDev/develop

Attach ICS calendar event to attendee ticket emails

Author: daveearley

backend/app/DomainObjects/EventSettingDomainObject.php

@@ -20,4 +20,27 @@ public function getGetEmailFooterHtml(): string
 </div>
 HTML;
     }
+
+    public function getAddressString(): string
+    {
+        $locationDetails = $this->getLocationDetails();
+
+        if (is_null($locationDetails)) {
+            return '';
+        }
+
+        $addressParts = [
+            $locationDetails['venue_name'] ?? null,
+            $locationDetails['address_line_1'] ?? null,
+            $locationDetails['address_line_2'] ?? null,
+            $locationDetails['city'] ?? null,
+            $locationDetails['state_or_region'] ?? null,
+            $locationDetails['zip_or_postal_code'] ?? null,
+            $locationDetails['country'] ?? null
+        ];
+
+        $filteredAddressParts = array_filter($addressParts, static fn($part) => !is_null($part) && $part !== '');
+
+        return implode(', ', $filteredAddressParts);
+    }
 }

backend/app/Mail/Attendee/AttendeeTicketMail.php

@@ -2,14 +2,20 @@
 
 namespace HiEvents\Mail\Attendee;
 
+use Carbon\Carbon;
 use HiEvents\DomainObjects\AttendeeDomainObject;
 use HiEvents\DomainObjects\EventDomainObject;
 use HiEvents\DomainObjects\EventSettingDomainObject;
+use HiEvents\DomainObjects\OrganizerDomainObject;
+use HiEvents\Helper\StringHelper;
 use HiEvents\Helper\Url;
 use HiEvents\Mail\BaseMail;
+use Illuminate\Mail\Mailables\Attachment;
 use Illuminate\Mail\Mailables\Content;
 use Illuminate\Mail\Mailables\Envelope;
 use Illuminate\Support\Str;
+use Spatie\IcalendarGenerator\Components\Calendar;
+use Spatie\IcalendarGenerator\Components\Event;
 
 /**
  * @uses /backend/resources/views/emails/orders/attendee-ticket.blade.php
@@ -20,6 +26,7 @@ public function __construct(
         private readonly AttendeeDomainObject     $attendee,
         private readonly EventDomainObject        $event,
         private readonly EventSettingDomainObject $eventSettings,
+        private readonly OrganizerDomainObject    $organizer,
     )
     {
         parent::__construct();
@@ -51,4 +58,38 @@ public function content(): Content
             ]
         );
     }
+
+    public function attachments(): array
+    {
+        $startDateTime = Carbon::parse($this->event->getStartDate(), $this->event->getTimezone());
+        $endDateTime = $this->event->getEndDate() ? Carbon::parse($this->event->getEndDate(), $this->event->getTimezone()) : null;
+
+        $event = Event::create()
+            ->name($this->event->getTitle())
+            ->uniqueIdentifier('event-' . $this->attendee->getId())
+            ->startsAt($startDateTime)
+            ->url($this->event->getEventUrl())
+            ->organizer($this->organizer->getEmail(), $this->organizer->getName());
+
+        if ($this->event->getDescription()) {
+            $event->description(StringHelper::previewFromHtml($this->event->getDescription()));
+        }
+
+        if ($this->eventSettings->getLocationDetails()) {
+            $event->address($this->eventSettings->getAddressString());
+        }
+
+        if ($endDateTime) {
+            $event->endsAt($endDateTime);
+        }
+
+        $calendar = Calendar::create()
+            ->event($event)
+            ->get();
+
+        return [
+            Attachment::fromData(static fn() => $calendar, 'event.ics')
+                ->withMime('text/calendar')
+        ];
+    }
 }

backend/app/Services/Domain/Attendee/SendAttendeeTicketService.php

@@ -5,6 +5,7 @@
 use HiEvents\DomainObjects\AttendeeDomainObject;
 use HiEvents\DomainObjects\EventDomainObject;
 use HiEvents\DomainObjects\EventSettingDomainObject;
+use HiEvents\DomainObjects\OrganizerDomainObject;
 use HiEvents\Mail\Attendee\AttendeeTicketMail;
 use Illuminate\Contracts\Mail\Mailer;
 
@@ -20,12 +21,14 @@ public function send(
         AttendeeDomainObject $attendee,
         EventDomainObject $event,
         EventSettingDomainObject $eventSettings,
+        OrganizerDomainObject $organizer,
     ): void
     {
         $this->mailer->to($attendee->getEmail())->send(new AttendeeTicketMail(
             attendee: $attendee,
             event: $event,
             eventSettings: $eventSettings,
+            organizer: $organizer,
         ));
     }
 }

backend/app/Services/Domain/Mail/SendOrderDetailsService.php

@@ -62,7 +62,13 @@ private function sendAttendeeTicketEmails(OrderDomainObject $order, EventDomainO
                 continue;
             }
 
-            $this->sendAttendeeTicketService->send($attendee, $event, $event->getEventSettings());
+            $this->sendAttendeeTicketService->send(
+                attendee: $attendee,
+                event: $event,
+                eventSettings: $event->getEventSettings(),
+                organizer: $event->getOrganizer(),
+            );
+
             $sentEmails[] = $attendee->getEmail();
         }
     }

backend/app/Services/Handlers/Attendee/ResendAttendeeTicketHandler.php

@@ -3,8 +3,10 @@
 namespace HiEvents\Services\Handlers\Attendee;
 
 use HiEvents\DomainObjects\EventSettingDomainObject;
+use HiEvents\DomainObjects\OrganizerDomainObject;
 use HiEvents\DomainObjects\Status\AttendeeStatus;
 use HiEvents\Exceptions\ResourceConflictException;
+use HiEvents\Repository\Eloquent\Value\Relationship;
 use HiEvents\Repository\Interfaces\AttendeeRepositoryInterface;
 use HiEvents\Repository\Interfaces\EventRepositoryInterface;
 use HiEvents\Services\Domain\Attendee\SendAttendeeTicketService;
@@ -42,10 +44,16 @@ public function handle(ResendAttendeeTicketDTO $resendAttendeeTicketDTO): void
         }
 
         $event = $this->eventRepository
+            ->loadRelation(new Relationship(OrganizerDomainObject::class, name: 'organizer'))
             ->loadRelation(EventSettingDomainObject::class)
             ->findById($resendAttendeeTicketDTO->eventId);
 
-        $this->sendAttendeeTicketService->send($attendee, $event, $event->getEventSettings());
+        $this->sendAttendeeTicketService->send(
+            attendee: $attendee,
+            event: $event,
+            eventSettings: $event->getEventSettings(),
+            organizer: $event->getOrganizer(),
+        );
 
         $this->logger->info('Attendee ticket resent', [
             'attendeeId' => $resendAttendeeTicketDTO->attendeeId,

backend/app/Services/Handlers/EventSettings/PartialUpdateEventSettingsHandler.php

@@ -31,6 +31,13 @@ public function handle(PartialUpdateEventSettingsDTO $eventSettingsDTO): EventSe
             throw new RefundNotPossibleException('Event settings not found');
         }
 
+        $locationDetails = $eventSettingsDTO->settings['location_details'] ?? $existingSettings->getLocationDetails();
+        $isOnlineEvent = $eventSettingsDTO->settings['is_online_event'] ?? $existingSettings->getIsOnlineEvent();
+
+        if ($isOnlineEvent) {
+            $locationDetails = null;
+        }
+
         return $this->eventSettingsHandler->handle(
             UpdateEventSettingsDTO::fromArray([
                 'event_id' => $eventSettingsDTO->event_id,
@@ -59,7 +66,7 @@ public function handle(PartialUpdateEventSettingsDTO $eventSettingsDTO): EventSe
                 'order_timeout_in_minutes' => $eventSettingsDTO->settings['order_timeout_in_minutes'] ?? $existingSettings->getOrderTimeoutInMinutes(),
                 'website_url' => $eventSettingsDTO->settings['website_url'] ?? $existingSettings->getWebsiteUrl(),
                 'maps_url' => $eventSettingsDTO->settings['maps_url'] ?? $existingSettings->getMapsUrl(),
-                'location_details' => $eventSettingsDTO->settings['location_details'] ?? $existingSettings->getLocationDetails(),
+                'location_details' => $locationDetails,
                 'is_online_event' => $eventSettingsDTO->settings['is_online_event'] ?? $existingSettings->getIsOnlineEvent(),
                 'online_event_connection_details' => array_key_exists('online_event_connection_details', $eventSettingsDTO->settings)
                     ? $eventSettingsDTO->settings['online_event_connection_details']

backend/composer.json

@@ -19,6 +19,7 @@
         "maatwebsite/excel": "^3.1",
         "nette/php-generator": "^4.0",
         "php-open-source-saver/jwt-auth": "^2.1",
+        "spatie/icalendar-generator": "^2.8",
         "stripe/stripe-php": "^10.15"
     },
     "require-dev": {