feat: First checkin for the ical direct features

actions/event_manager/export/ical.php

@@ -0,0 +1,128 @@
+<?php
+
+/** @var Event[] $events */
+$events = [];
+
+$event_id = get_input('event_id', '');
+
+if (empty($event_id)) {
+	$calendar_type = get_input('calendar_type', 'all');
+	$date_format = elgg_get_config('date_format', elgg_echo('input:date_format'));
+
+	$start_date = (string) get_input('start_date');
+	if (empty($start_date)) {
+		$start_date = time();
+	} else {
+		$start_date = DateTime::createFromFormat($date_format, $start_date)->getTimestamp();
+	}
+
+	$end_date = (string) get_input('end_date');
+	if (empty($end_date)) {
+		$end_date = DateTime::createFromFormat('U', time())
+			->add(DateInterval::createFromDateString('1 month'))
+			->getTimestamp();
+	} else {
+		$end_date = DateTime::createFromFormat($date_format, $end_date)->getTimestamp();
+	}
+
+	$region = (string) get_input('region');
+	$event_type = (string) get_input('event_type');
+
+	$owner = (array) get_input('owner');
+	$group = (array) get_input('group');
+
+	$options = [
+		'types' => ['object'],
+		'subTypes' => [Event::SUBTYPE],
+		'metadata_name_value_pairs' => [
+			[
+				'name' => 'event_start',
+				'operand' => '>=',
+				'value' => $start_date,
+			],
+			[
+				'name' => 'event_end',
+				'operand' => '<=',
+				'value' => $end_date,
+			],
+		]
+	];
+
+	if (!empty($region)) {
+		$options['metadata_name_value_pairs'][] = [
+			'name' => 'region',
+			'operand' => 'IN',
+			'value' => $region,
+		];
+	}
+
+	if (!empty($event_type)) {
+		$options['metadata_name_value_pairs'][] = [
+			'name' => 'event_type',
+			'operand' => 'IN',
+			'value' => $event_type,
+		];
+	}
+
+	switch ($calendar_type) {
+		case 'group':
+			if (empty($group)) {
+				return elgg_error_response(elgg_echo('event_manager:ical_direct:export:errors:groupempty'));
+			}
+
+			$options['container_guids'] = $group;
+			break;
+		case 'owner':
+			if (empty($owner)) {
+				return elgg_error_response(elgg_echo('event_manager:ical_direct:export:errors:ownerempty'));
+			}
+
+			if (!elgg_is_admin_logged_in() && (int) $owner[0] !== elgg_get_logged_in_user_guid()) {
+				return elgg_error_response(elgg_echo('event_manager:ical_direct:export:errors:ownermismatch'));
+			}
+
+			$options['owner_guids'] = [$owner];
+			break;
+	}
+
+	$events = elgg_get_entities($options);
+} else {
+	$event = get_entity($event_id);
+	if (!$event instanceof \Event) {
+		return;
+	}
+
+	$events = [$event];
+}
+
+use Kigkonsult\Icalcreator\IcalInterface;
+use Kigkonsult\Icalcreator\Vcalendar;
+
+try {
+	$vcalendar = Vcalendar::factory(
+		[
+			IcalInterface::UNIQUE_ID => 'https://github.com/ColdTrick/event_manager',
+		]
+	)
+		->setMethod(IcalInterface::PUBLISH)
+		->setXprop(IcalInterface::X_WR_CALNAME, 'Exported event')
+		->setXprop(IcalInterface::X_WR_CALDESC, 'Exported events from event_manager')
+		->setXprop(IcalInterface::X_WR_RELCALID, elgg_get_site_url())
+		->setXprop(IcalInterface::X_WR_TIMEZONE, date_default_timezone_get());
+} catch (Exception $e) {
+	return elgg_error_response(elgg_echo('event_manager:ical_direct:export:errors:errorinstantiatingcalendar', [$e]));
+}
+
+foreach ($events as $event) {
+	try {
+		$vcalendar->setComponent($event->toVEvent());
+	} catch (Exception $e) {
+		return elgg_error_response(elgg_echo('event_manager:ical_direct:export:errors:erroraddingevent', [$e]));
+	}
+}
+
+try {
+	return elgg_download_response($vcalendar->createCalendar(), 'export.ics');
+} catch (Exception $e) {
+	return elgg_error_response(elgg_echo('event_manager:ical_direct:export:errors:errorcreatingcalendar', [$e]));
+}

actions/event_manager/import/ical.php

@@ -0,0 +1,91 @@
+<?php
+
+use Kigkonsult\Icalcreator\IcalInterface;
+use Kigkonsult\Icalcreator\Vcalendar;
+use Kigkonsult\Icalcreator\Vevent;
+
+$calendar_type = get_input('calendar_type', 'all');
+
+$owner = (array) get_input('owner');
+$owner_guid = 0;
+$group = (array) get_input('group');
+$group_guid = 0;
+$file = elgg_get_uploaded_file('import');
+
+switch ($calendar_type) {
+	case 'group':
+		if (empty($group)) {
+			return elgg_error_response(elgg_echo('event_manager:ical_direct:import:errors:groupempty'));
+		}
+
+		$group_guid = $group[0];
+		$group_entity = get_entity($group_guid);
+		if (!get_entity($group_guid) instanceof \ElggGroup) {
+			return elgg_error_response(elgg_echo('event_manager:ical_direct:import:errors:invalidgroup'));
+		}
+
+		if (!elgg_is_admin_logged_in() && !$group_entity->canWriteToContainer(elgg_get_logged_in_user_guid())) {
+			return elgg_error_response(elgg_echo('event_manager:ical_direct:import:errors:grouppermission'));
+		}
+		break;
+	case 'owner':
+		if (empty($owner)) {
+			return elgg_error_response(elgg_echo('event_manager:ical_direct:import:errors:ownerempty'));
+		}
+
+		$owner_guid = $owner[0];
+		if (!get_entity($owner_guid) instanceof \ElggUser) {
+			return elgg_error_response(elgg_echo('event_manager:ical_direct:import:errors:invalidgroup'));
+		}
+
+		if (!elgg_is_admin_logged_in() && (int) $owner_guid !== elgg_get_logged_in_user_guid()) {
+			return elgg_error_response(elgg_echo('event_manager:ical_direct:import:errors:ownermismatch'));
+		}
+		break;
+}
+
+if (!$file) {
+	return elgg_error_response(elgg_echo('event_manager:ical_direct:import:errors:missingfile'));
+}
+
+try {
+	$vcalendar = Vcalendar::factory(
+		[
+			IcalInterface::UNIQUE_ID => 'https://github.com/ColdTrick/event_manager',
+		]
+	);
+} catch (Exception $e) {
+	return elgg_error_response(elgg_echo('event_manager:ical_direct:import:errors:errorinstantiatingcalendar', [$e]));
+}
+
+try {
+	$vcalendar->parse($file->getContent());
+} catch (Exception $e) {
+	return elgg_error_response(elgg_echo('event_manager:ical_direct:import:errors:errorpparsingcalendar', [$e]));
+}
+
+$event_counter = 0;
+
+/** @var Vevent $component */
+foreach ($vcalendar->getComponents('Vevent') as $component) {
+	$event = Event::fromVEvent($component);
+
+	switch ($calendar_type) {
+		case 'group':
+			$event->setContainerGUID($group_guid);
+			break;
+		case 'owner':
+			$event->owner_guid = $owner_guid;
+			break;
+	}
+
+	$event->save();
+	$event_counter++;
+}
+
+$message = elgg_echo('event_manager:ical_direct:import:success', [$event_counter]);
+
+return elgg_ok_response(
+	'',
+	$message
+);

classes/ColdTrick/EventManager/Menus/Entity.php

@@ -35,7 +35,7 @@ public static function registerMailAttendees(\Elgg\Event $event): ?MenuItems {
 			'text' => elgg_echo('event_manager:menu:mail'),
 			'href' => elgg_generate_entity_url($entity, 'mail'),
 		]);
-		
+
 		return $result;
 	}
 
@@ -148,4 +148,35 @@ public static function registerEventUnsubscribe(\Elgg\Event $event): ?MenuItems
 
 		return $result;
 	}
+
+	/**
+	 * Adds menu items to the event entity menu for exporting it to ical
+	 *
+	 * @param \Elgg\Event $event 'register', 'menu:entity'
+	 *
+	 * @return null|MenuItems
+	 */
+	public static function registerICalExport(\Elgg\Event $event): ?MenuItems {
+		$entity = $event->getEntityParam();
+		if (!$entity instanceof \Event) {
+			return null;
+		}
+
+		if (!elgg_get_plugin_setting('ical_direct', 'event_manager')) {
+			return null;
+		}
+
+		// show an ical export link
+		$result = $event->getValue();
+
+		$result[] = \ElggMenuItem::factory([
+			'name' => 'ical-export',
+			'icon' => 'calendar-plus',
+			'text' => elgg_echo('event_manager:ical_direct:export'),
+			'href' => elgg_generate_action_url('event_manager/export/ical', ['event_id' => $entity->guid]),
+			'priority' => 300,
+		]);
+
+		return $result;
+	}
 }

classes/ColdTrick/EventManager/Menus/Title.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace ColdTrick\EventManager\Menus;
+
+use Elgg\Menu\MenuItems;
+
+/**
+ * Site menu related callbacks
+ */
+class Title {
+
+	/**
+	 * Adds items to the site menu
+	 *
+	 * @param \Elgg\Event $event 'register', 'menu:site'
+	 *
+	 * @return MenuItems
+	 */
+	public static function registerICal(\Elgg\Event $event): MenuItems {
+		$result = $event->getValue();
+
+		if ($event->getParam('identifier') !== 'event' || $event->getParam('filter_id') !== 'events') {
+			return $result;
+		}
+
+		if (elgg_get_plugin_setting('ical_direct', 'event_manager')) {
+			$result[] = \ElggMenuItem::factory([
+				'name' => 'export-ical',
+				'icon' => 'download',
+				'text' => elgg_echo('event_manager:ical_direct:export'),
+				'href' => elgg_http_add_url_query_elements('ajax/form/event_manager/export/ical', [
+					'list_route' => elgg_get_current_route_name(),
+					'route_parameters' => elgg_get_current_route()->getMatchedParameters(),
+				]),
+				'link_class' => 'elgg-lightbox'
+			]);
+			$result[] = \ElggMenuItem::factory([
+				'name' => 'import-ical',
+				'icon' => 'upload',
+				'text' => elgg_echo('event_manager:ical_direct:import'),
+				'href' => elgg_http_add_url_query_elements('ajax/form/event_manager/import/ical', [
+					'list_route' => elgg_get_current_route_name(),
+					'route_parameters' => elgg_get_current_route()->getMatchedParameters(),
+				]),
+				'link_class' => 'elgg-lightbox'
+			]);
+		}
+
+		return $result;
+	}
+}