Calendar Links Laravel Package

Breaking Changes

• Require PHP 8.3+ (previously 8.1+)
• Link::$from and Link::$to are now DateTimeImmutable (previously DateTime)
• Link::$title, $from, $to, and $allDay are now public readonly; $description and $address are public. The magic __get() method has been removed.
• Remove $allDay parameter from Link::create() — use Link::createAllDay() instead
• Link::createAllDay() end date is now inclusive (the constructor internally adds +1 day for calendar services)
• Link constructor is now final
• Remove deprecated InvalidLink::invalidDateRange() — use InvalidLink::negativeDateRange() instead
• BaseOutlook::baseUrl() visibility changed from public to protected
• WebOffice and WebOutlook classes are now final
• Date/time format properties in generators replaced with private const (prevents override via subclassing)
• Require PHPUnit 12+ / 13

Added

• ICS: Allow custom PRODID via options array
• Link::createAllDay() now returns static instead of self

Fixed

• Fix all-day events created via constructor being 1 day short
• ICS: DTSTAMP now always uses UTC datetime for all-day events (RFC 5545 compliance)
• ICS: Add VALUE=DATE parameter to DTSTART for all-day events (RFC 5545 compliance)
• ICS: escapeString() now properly handles backslashes, semicolons, commas, and newlines per RFC 5545 section 3.3.11
• ICS: Fix VALARM trigger not working when a specific date was set

Internal

• Add declare(strict_types=1) to all source files
• Use PHP 8.3 typed class constants and #[\Override] attributes
• Use DateTimeImmutable throughout instead of mutable DateTime
• Replace [@test](https://github.com/test) annotations with PHPUnit #[Test] attributes
• Apply PSR-12 coding style
• Upgrade Psalm to v6 with improved type annotations

Changed

• ICS: Use DESCRIPTION instead of X-ALT-DESC (as it has better support) by @cdubz in #158
• Chore: fix tests, fix and improve CI

Changed

• Remove PHP 7.4 support
• Update dependencies

Changed

• ICS: Add PRODID and DTSTAMP required parameters to make ICS valid by @makbeta
• ICS: Fix HTML description for Outlook 2016 by @karthikbodu
• Outlook: extract common logic for WebOffice and WebOutlook into a parent class by @lptn

Fixed

• Simplify format of test snapshots: do not use base64 by @lptn
• Fix typo in README by @fabpot

Fixed

• Outlook: Fixed #148 Support HTML-formatted description by @dravenk in #150

Changed

• Outlook: Fixed location field characters (by @dravenk in #144)
• Add missing dependency of php-cs-fixer and update it

Changed

• New: Add support for outlook.office.com $link->webOffice(); (@dravenk and @gulios)
• Google: Add timezone name if it is specified in both from and to dates and is the same for both (@bradyemerson)

Changed

• Drop support for PHP 7.2 and PHP 7.3

Changed

• ICS: support URLs as option (@gulios)
• ICS: support all day events spanning multiple days (@mrshowerman)

Fixed

• Yahoo link doesn’t work (yahoo changed param names) (@mukeshsah08).
• Exception message on invalid dates range (idea by @jason-nabooki)

Changed

• Google: use UTC timezone to bypass problems with some timezone names unsupported by Google calendar (⚠️ backwards-incompatible if you extended Google Generator)

Fixed

• Spaces replaced by "+" on Outlook.com #109

Changed

• Simplify extending of ICS Generator

Changed

• Simplify extending of WebOutlook (e.g. for Office365)
• Yahoo: use allday parameter only for a single-day events
• Improve exception hierarchy: InvalidLink now extends \InvalidArgumentException

Added

• Add more tests, reorganize existing

Added

• Allow specifying custom UID ICS links (https://github.com/spatie/calendar-links/pull/85)
• Support PHP 8.0
• Support immutable dates (\DateTimeImmutable::class)

Changed

• Require PHP 7.2+

• Support custom generators ($link->formatWith(new Your\Generator())
• Fix iCal links that contains special chars (use base64 for encoding)
• Fix Outlook links: use new base URI and datetime formats
• Fix Yahoo links: events had invalid end datetime (due to a bug on Yahoo side)

• Fix Google links for all-day events (use next day as end-date for single-day events)
• Fix Outlook links for all-day events (omit enddt for single-day events)
• Add a new Link::createAllDay static constructor to simplify creating of all-day events

• Fix iCal all day links (use DURATION according RFC 5545)

• Fix Yahoo links for multiple days events

• Fix iCal: Use CRLF instead of LF (according RFC 5545)
• Fix iCal: Specify UID property (according RFC 5545)
• Fix iCal: Escape ; character (according RFC 5545)
• Fix iCal: Remove empty new line from .ics files

• Support timezones
• Add outlook.com link generator

• Fix Yahoo links

• Add all day support

• Fix newlines in description

• Fix for iCal links in Safari

• Use \n instead of %0A when generating an ics file

• initial release