Collaboration diagram for ILIAS\BookingManager\BookingProcess\BookingProcessManager:

Public Member Functions
	__construct (InternalDataService $data, InternalRepoService $repo, InternalDomainService $domain)

	getRecurrenceMissingAvailability (int $obj_id, int $slot_from, int $slot_to, int $recurrence_weeks, int $requested_nr, \ilDate $until)
	Get missing availability of an object for a given weekly recurrence, object id, starting slot and requested nr. More...

	bookAvailableObjects (int $obj_id, int $user_to_book, int $assigner_id, int $context_obj_id, int $from, int $to, int $recurrence, int $nr, ?\ilDateTime $until, string $message="")

	bookSingle (int $object_id, int $user_to_book, int $assigner_id=0, int $context_obj_id=0, ?int $a_from=null, ?int $a_to=null, ?int $a_group_id=null, string $message="")
	Book object for date. More...

Protected Member Functions
	addDaysDate (string $a_date, int $a_days)

	addDaysStamp (int $a_stamp, int $a_days)

Protected Attributes
InternalDataService	$data

InternalRepoService	$repo

InternalDomainService	$domain

Detailed Description

Author: Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 30 of file class.BookingProcessManager.php.

Constructor & Destructor Documentation

◆ __construct()

ILIAS\BookingManager\BookingProcess\BookingProcessManager::__construct	(	InternalDataService	$data,
		InternalRepoService	$repo,
		InternalDomainService	$domain
	)

Definition at line 36 of file class.BookingProcessManager.php.

References ILIAS\BookingManager\BookingProcess\BookingProcessManager\$data, ILIAS\BookingManager\BookingProcess\BookingProcessManager\$domain, and ILIAS\BookingManager\BookingProcess\BookingProcessManager\$repo.

       {
         $this->data = $data;
         $this->repo = $repo;
         $this->domain = $domain;
     }

Member Function Documentation

◆ addDaysDate()

ILIAS\BookingManager\BookingProcess\BookingProcessManager::addDaysDate	(	string	$a_date,
		int	$a_days
	)

protected

Definition at line 80 of file class.BookingProcessManager.php.

      : string {
         $date = date_parse($a_date);
         $stamp = mktime(0, 0, 1, $date["month"], $date["day"] + $a_days, $date["year"]);
         return date("Y-m-d", $stamp);
     }

◆ addDaysStamp()

ILIAS\BookingManager\BookingProcess\BookingProcessManager::addDaysStamp	(	int	$a_stamp,
		int	$a_days
	)

protected

Definition at line 89 of file class.BookingProcessManager.php.

Referenced by ILIAS\BookingManager\BookingProcess\BookingProcessManager\bookAvailableObjects(), and ILIAS\BookingManager\BookingProcess\BookingProcessManager\getRecurrenceMissingAvailability().

      : int {
         $date = getdate($a_stamp);
         return mktime(
             $date["hours"],
             $date["minutes"],
             $date["seconds"],
             $date["mon"],
             $date["mday"] + $a_days,
             $date["year"]
         );
     }

Here is the caller graph for this function:

◆ bookAvailableObjects()

ILIAS\BookingManager\BookingProcess\BookingProcessManager::bookAvailableObjects	(	int	$obj_id,
		int	$user_to_book,
		int	$assigner_id,
		int	$context_obj_id,
		int	$from,
		int	$to,
		int	$recurrence,
		int	$nr,
		?\ilDateTime	$until,
		string	$message = `""`
	)

Definition at line 104 of file class.BookingProcessManager.php.

References $message, ILIAS\BookingManager\BookingProcess\BookingProcessManager\addDaysStamp(), ILIAS\BookingManager\BookingProcess\BookingProcessManager\bookSingle(), ilDateTime\get(), ilBookingReservation\getAvailableObject(), and IL_CAL_UNIX.

      : array {
         $reservation_repo = $this->repo->reservation();
 
         $rsv_ids = [];
 
         if (is_null($until)) {
             $end = $from;
             $cut = 999;     // only one iteration
             $cycle = 0;     // no recurrence
         } else {
             $end = $until->get(IL_CAL_UNIX);
             $cut = 0;
             $cycle = $recurrence * 7;
         }
         $booked_out_slots = [];
         $check_slot_from = $from;
         $group_id = $reservation_repo->getNewGroupId();
         while ($cut < 1000 && $check_slot_from <= $end) {
             $check_slot_from = $this->addDaysStamp($from, $cycle * $cut);
             $check_slot_to = $this->addDaysStamp($to, $cycle * $cut);
             $available = \ilBookingReservation::getAvailableObject(array($obj_id), $check_slot_from, $check_slot_to, false, true);
             $available = $available[$obj_id] ?? 0;
             $book_nr = min($nr, $available);
             for ($loop = 0; $loop < $book_nr; $loop++) {
                 $rsv_ids[] = $this->bookSingle(
                     $obj_id,
                     $user_to_book,
                     $assigner_id,
                     $context_obj_id,
                     $check_slot_from,
                     $check_slot_to,
                     $group_id,
                     $message
                 );
                 $success = $obj_id;
             }
             $cut++;
         }
         return $rsv_ids;
     }

Here is the call graph for this function:

◆ bookSingle()

ILIAS\BookingManager\BookingProcess\BookingProcessManager::bookSingle	(	int	$object_id,
		int	$user_to_book,
		int	$assigner_id = `0`,
		int	$context_obj_id = `0`,
		?int	$a_from = `null`,
		?int	$a_to = `null`,
		?int	$a_group_id = `null`,
		string	$message = `""`
	)

Book object for date.

Returns: int reservation id

Exceptions

Definition at line 161 of file class.BookingProcessManager.php.

References $lng, $message, IL_CAL_UNIX, ilCalendarUtil\initDefaultCalendarByType(), ilBookingObject\lookupPoolId(), null, and ilCalendarCategory\TYPE_BOOK.

Referenced by ILIAS\BookingManager\BookingProcess\BookingProcessManager\bookAvailableObjects().

      : int {
         $lng = $this->domain->lng();
 
         // add user to participants, if not existing
         $pool_id = \ilBookingObject::lookupPoolId($object_id);
         $this->domain->participants()->createIfNotExisting($user_to_book, $pool_id);
 
         // create new reservation
         $reservation = new \ilBookingReservation();
         $reservation->setObjectId($object_id);
         $reservation->setUserId($user_to_book);
         $reservation->setAssignerId($assigner_id);
         $reservation->setFrom((int) $a_from);
         $reservation->setTo((int) $a_to);
         $reservation->setGroupId((int) $a_group_id);
         $reservation->setContextObjId($context_obj_id);
         $reservation->setMessage($message);
         $reservation->save();
 
         // create calendar entry
         if ($a_from) {
             $lng->loadLanguageModule('dateplaner');
             $def_cat = \ilCalendarUtil::initDefaultCalendarByType(
                 \ilCalendarCategory::TYPE_BOOK,
                 $user_to_book,
                 $lng->txt('cal_ch_personal_book'),
                 true
             );
 
             $object = new \ilBookingObject($object_id);
 
             $entry = new \ilCalendarEntry();
             $entry->setStart(new \ilDateTime($a_from, IL_CAL_UNIX));
             $entry->setEnd(new \ilDateTime($a_to, IL_CAL_UNIX));
             $entry->setTitle($lng->txt('book_cal_entry') . ' ' . $object->getTitle());
             $entry->setContextId($reservation->getId());
             $entry->save();
 
             $assignment = new \ilCalendarCategoryAssignments($entry->getEntryId());
             if ($def_cat !== null) {
                 $assignment->addAssignment($def_cat->getCategoryID());
             }
         }
 
         return $reservation->getId();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRecurrenceMissingAvailability()

ILIAS\BookingManager\BookingProcess\BookingProcessManager::getRecurrenceMissingAvailability	(	int	$obj_id,
		int	$slot_from,
		int	$slot_to,
		int	$recurrence_weeks,
		int	$requested_nr,
		\ilDate	$until
	)

Get missing availability of an object for a given weekly recurrence, object id, starting slot and requested nr.

Definition at line 50 of file class.BookingProcessManager.php.

References ILIAS\BookingManager\BookingProcess\BookingProcessManager\addDaysStamp(), ilDate\get(), ilBookingReservation\getAvailableObject(), and IL_CAL_UNIX.

      : array {
         $end = $until->get(IL_CAL_UNIX);
         $cut = 0;
         $cycle = $recurrence_weeks * 7;
         $booked_out_slots = [];
         $check_slot_from = $slot_from;
         while ($cut < 1000 && $check_slot_from <= $end) {
             $check_slot_from = $this->addDaysStamp($slot_from, $cycle * $cut);
             $check_slot_to = $this->addDaysStamp($slot_to, $cycle * $cut);
             $available = \ilBookingReservation::getAvailableObject(array($obj_id), $check_slot_from, $check_slot_to, false, true);
             $available = $available[$obj_id] ?? 0;
             if ($available < $requested_nr) {
                 $booked_out_slots[] = [
                     "from" => $check_slot_from,
                     "to" => $check_slot_to,
                     "missing" => $requested_nr - $available
                 ];
             }
             $cut++;
         }
         return $booked_out_slots;
     }