ilBookingPreferencesManager Class Reference

Booking preferences business logic. More...

Collaboration diagram for ilBookingPreferencesManager:

Public Member Functions
	__construct (ilObjBookingPool $pool, ilBookingPrefBasedBookGatewayRepository $book_repo, int $current_time=null, $bookings_per_user=self::BOOKINGS_PER_USER_DEFAULT)
	Constructor. More...
	isGivingPreferencesPossible ()
	Can participants hand in preferences. More...
	isPreferenceDeadlineReached ()
	Can participants hand in preferences. More...
	storeBookings ($preferences, $booking_object_ids=null)
	Calculate and store bookings. More...
	readBookings ()
	Read the bookings. More...
	calculateBookings (ilBookingPreferences $preferences, $booking_object_ids=null, $availability=null)
	Calculate bookings. More...
	hasRun ()
	resetRun ()

Data Fields
const	BOOKINGS_PER_USER_DEFAULT = 1

Protected Member Functions
	addBooking (&$bookings, &$preferences, &$availability, $user_id, $book_obj_id)
	Add booking. More...
	selectRandomEntry ($items)
	Select a random entry of an array. More...
	getUsersForObject ($preferences, $sel_obj_id)
	Get users for object. More...
	calculatePopularity (array $booking_object_ids, array $preferences)
	Calculate popularity (number of preferences each object got from users) More...
	getObjectWithLowestPopularity ($popularity, $availability)
	Get an availabe object with lowest popularity > 0. More...
	removePreference ($user_id, $obj_id, $preferences)
	Remove a preference from the preference array. More...
	removeObjectFromPreferences ($obj_id, $preferences)
	Remove an object from the preference array. More...
	removeUserFromPreferences ($user_id, $preferences)
	Remove user from preference array. More...
	chooseRandomUserFromPreferences ($preferences)
	Choose random user from the preference array. More...
	getMinimalAssignedEntryForUser ($booking_object_ids, $bookings, $user_preferences, $availability)
	Get an available object within the preferences (if no preferences left, even outside of preferences) of a user that is currently minimal assigned. More...

Protected Attributes
	$pool
	$current_time
	$bookings_per_user
	$book_repo

Detailed Description

Booking preferences business logic.

Author

killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 10 of file class.ilBookingPreferencesManager.php.

Constructor & Destructor Documentation

__construct()

ilBookingPreferencesManager::__construct	(	ilObjBookingPool	$pool,
		ilBookingPrefBasedBookGatewayRepository	$book_repo,
		int	$current_time = null,
			$bookings_per_user = self::BOOKINGS_PER_USER_DEFAULT
	)

Constructor.

Parameters

ilObjBookingPool	$pool
int | null	$current_time

Definition at line 39 of file class.ilBookingPreferencesManager.php.

References $book_repo, $bookings_per_user, $current_time, and $pool.

      {
        $this->current_time = ($current_time > 0)
            ? $current_time
            : time();
        $this->pool = $pool;
        $this->bookings_per_user = $bookings_per_user;
        $this->book_repo = $book_repo;
    }

Member Function Documentation

addBooking()

ilBookingPreferencesManager::addBooking ( &  $bookings, &  $preferences, &  $availability,   $user_id,   $book_obj_id  )

protected

Add booking.

Parameters

$bookings
$preferences
$availability
$user_id
$book_obj_id

Definition at line 200 of file class.ilBookingPreferencesManager.php.

References removeObjectFromPreferences(), removePreference(), and removeUserFromPreferences().

Referenced by calculateBookings().

    {
        $bookings[$user_id][] = $book_obj_id;
        $availability[$book_obj_id]--;
        if (count($bookings[$user_id]) >= $this->bookings_per_user) {
            $preferences = $this->removeUserFromPreferences($user_id, $preferences);
        } else {
            $preferences = $this->removePreference($user_id, $book_obj_id, $preferences);
        }
        if ($availability[$book_obj_id] <= 0) {
            $preferences = $this->removeObjectFromPreferences($book_obj_id, $preferences);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

calculateBookings()

ilBookingPreferencesManager::calculateBookings	(	ilBookingPreferences	$preferences,
			$booking_object_ids = null,
			$availability = null
	)

Calculate bookings.

Parameters

ilBookingPreferences	$preferences
	int[]	$booking_object_ids

Returns

array

Exceptions

ilBookingCalculationException

Definition at line 115 of file class.ilBookingPreferencesManager.php.

References $i, addBooking(), calculatePopularity(), chooseRandomUserFromPreferences(), ilBookingObject\getList(), getMinimalAssignedEntryForUser(), ilBookingReservation\getNumAvailablesNoSchedule(), getObjectWithLowestPopularity(), ilBookingPreferences\getPreferences(), getUsersForObject(), isPreferenceDeadlineReached(), removeObjectFromPreferences(), removeUserFromPreferences(), and selectRandomEntry().

Referenced by storeBookings().

      {
        $preferences = $preferences->getPreferences();

        // we calculate if a) any preferences are given and b) the deadline is reached
        /*if (!is_array($preferences) || count($preferences) == 0) {
            throw new ilBookingCalculationException("No preferences given.");
        }*/
        if (!$this->isPreferenceDeadlineReached()) {
            throw new ilBookingCalculationException("Preference deadline not reached.");
        }

        if ($booking_object_ids == null) {
            $booking_object_ids = array_map(function ($i) {
                return $i["booking_object_id"];
            }, ilBookingObject::getList($this->pool->getId()));
        }

        if ($availability == null) {
            $availability = [];
            foreach ($booking_object_ids as $book_obj_id) {
                $availability[$book_obj_id] = ilBookingReservation::getNumAvailablesNoSchedule($book_obj_id);
            }
        }

        // remove all objects from the preferences
        // that are already not available anymore
        // see bug 30204 (a tutor booked an object already before and made it unavailable)
        foreach ($availability as $book_obj_id => $cnt) {
            if ($cnt == 0) {
                $preferences = $this->removeObjectFromPreferences($book_obj_id, $preferences);
            }
        }

        $bookings = [];

        $end_phase_one = false;

        // phase one: assign lowest popular items to random user
        while (!$end_phase_one) {
            $popularity = $this->calculatePopularity($booking_object_ids, $preferences);

            $low_pop_book_obj_id = $this->getObjectWithLowestPopularity($popularity, $availability);
            if ($low_pop_book_obj_id > 0) {
                $user_ids = $this->getUsersForObject($preferences, $low_pop_book_obj_id);
                if (count($user_ids) > 0) {
                    $user_id = $this->selectRandomEntry($user_ids);
                    $this->addBooking($bookings, $preferences, $availability, $user_id, $low_pop_book_obj_id);
                }
            } else {
                $end_phase_one = true;
            }
        }

        $end_phase_two = false;

        // choose random user from and assign currently rarely assigned objects
        while (!$end_phase_two) {
            $random_user_id = $this->chooseRandomUserFromPreferences($preferences);
            if ($random_user_id > 0) {
                $rare_assigned_book_obj_id = $this->getMinimalAssignedEntryForUser($booking_object_ids, $bookings, $preferences[$random_user_id], $availability);
                if ($rare_assigned_book_obj_id > 0) {
                    $this->addBooking($bookings, $preferences, $availability, $random_user_id, $rare_assigned_book_obj_id);
                } else {
                    $preferences = $this->removeUserFromPreferences($random_user_id, $preferences);
                }
            } else {
                $end_phase_two = true;
            }
        }
        return $bookings;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

calculatePopularity()

ilBookingPreferencesManager::calculatePopularity ( array  $booking_object_ids, array  $preferences  )

protected

Calculate popularity (number of preferences each object got from users)

Parameters

array	$booking_object_ids
array	$preferences

Returns

array

Definition at line 256 of file class.ilBookingPreferencesManager.php.

Referenced by calculateBookings().

    {
        $popularity = [];
        foreach ($booking_object_ids as $book_obj_id) {
            $popularity[$book_obj_id] = 0;
        }
        foreach ($preferences as $user_id => $bobj_ids) {
            foreach ($bobj_ids as $bobj_id) {
                $popularity[$bobj_id] += 1;
            }
        }

        return $popularity;
    }

Here is the caller graph for this function:

chooseRandomUserFromPreferences()

ilBookingPreferencesManager::chooseRandomUserFromPreferences (   $preferences )

protected

Choose random user from the preference array.

Parameters

array

$preferences

Returns

int

Definition at line 347 of file class.ilBookingPreferencesManager.php.

References selectRandomEntry().

Referenced by calculateBookings().

    {
        $user_ids = array_keys($preferences);
        return $this->selectRandomEntry($user_ids);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getMinimalAssignedEntryForUser()

ilBookingPreferencesManager::getMinimalAssignedEntryForUser (   $booking_object_ids,   $bookings,   $user_preferences,   $availability  )

protected

Get an available object within the preferences (if no preferences left, even outside of preferences) of a user that is currently minimal assigned.

Parameters

int[]	$booking_object_ids
int[][]	$bookings
int[]	$user_preferences

Returns

int

Definition at line 362 of file class.ilBookingPreferencesManager.php.

Referenced by calculateBookings().

    {
        // count the assignments per object
        $count_assignments = [];
        foreach ($booking_object_ids as $obj_id) {
            $count_assignments[$obj_id] = 0;
        }
        foreach ($bookings as $user => $obj_ids) {
            foreach ($obj_ids as $obj_id) {
                $count_assignments[$obj_id]++;
            }
        }

        // sort the objects by number of assignments, return the first one being found in the user preferences
        asort($count_assignments, SORT_NUMERIC);
        foreach ($count_assignments as $obj_id => $cnt) {
            // if no preferences left for user, even assign object outside preferences
            // otherwise choose object from preferences
            if ((count($user_preferences) == 0 || in_array($obj_id, $user_preferences))
                && $availability[$obj_id] > 0) {
                return (int) $obj_id;
            }
        }
        return 0;
    }

Here is the caller graph for this function:

getObjectWithLowestPopularity()

ilBookingPreferencesManager::getObjectWithLowestPopularity (   $popularity,   $availability  )

protected

Get an availabe object with lowest popularity > 0.

Parameters

array

$popularity

Returns

int

Definition at line 278 of file class.ilBookingPreferencesManager.php.

Referenced by calculateBookings().

    {
        asort($popularity, SORT_NUMERIC);
        foreach ($popularity as $obj_id => $pop) {
            if ($pop > 0 && $availability[$obj_id] > 0) {
                return (int) $obj_id;
            }
        }
        return 0;
    }

Here is the caller graph for this function:

getUsersForObject()

ilBookingPreferencesManager::getUsersForObject (   $preferences,   $sel_obj_id  )

protected

Get users for object.

Parameters

$preferences
$sel_obj_id

Returns

array

Definition at line 235 of file class.ilBookingPreferencesManager.php.

Referenced by calculateBookings().

    {
        $user_ids = [];
        foreach ($preferences as $user_id => $obj_ids) {
            foreach ($obj_ids as $obj_id) {
                if ($obj_id == $sel_obj_id) {
                    $user_ids[] = $user_id;
                }
            }
        }
        return $user_ids;
    }

Here is the caller graph for this function:

hasRun()

ilBookingPreferencesManager::hasRun

(

)

Definition at line 388 of file class.ilBookingPreferencesManager.php.

                             : bool
    {
        return $this->book_repo->hasRun($this->pool->getId());
    }

isGivingPreferencesPossible()

ilBookingPreferencesManager::isGivingPreferencesPossible

(

)

Can participants hand in preferences.

Returns

bool

Definition at line 58 of file class.ilBookingPreferencesManager.php.

References $current_time, and ilObjBookingPool\TYPE_NO_SCHEDULE_PREFERENCES.

    {
        if ($this->pool->getScheduleType() == ilObjBookingPool::TYPE_NO_SCHEDULE_PREFERENCES &&
            $this->pool->getPreferenceDeadline() > $this->current_time) {
            return true;
        }
        return false;
    }

isPreferenceDeadlineReached()

ilBookingPreferencesManager::isPreferenceDeadlineReached

(

)

Can participants hand in preferences.

Returns

bool

Definition at line 72 of file class.ilBookingPreferencesManager.php.

References $current_time, and ilObjBookingPool\TYPE_NO_SCHEDULE_PREFERENCES.

Referenced by calculateBookings().

    {
        if ($this->pool->getScheduleType() == ilObjBookingPool::TYPE_NO_SCHEDULE_PREFERENCES &&
            $this->pool->getPreferenceDeadline() < $this->current_time) {
            return true;
        }
        return false;
    }

Here is the caller graph for this function:

readBookings()

ilBookingPreferencesManager::readBookings

(

)

Read the bookings.

Returns

int[][]

Definition at line 99 of file class.ilBookingPreferencesManager.php.

References $i, and ilBookingObject\getList().

    {
        $booking_object_ids = array_map(function ($i) {
            return $i["booking_object_id"];
        }, ilBookingObject::getList($this->pool->getId()));
        return $this->book_repo->getBookings($booking_object_ids);
    }

Here is the call graph for this function:

removeObjectFromPreferences()

ilBookingPreferencesManager::removeObjectFromPreferences (   $obj_id,   $preferences  )

protected

Remove an object from the preference array.

Parameters

int	$user_id
int	$obj_id
array	$preferences

Returns

array

Definition at line 315 of file class.ilBookingPreferencesManager.php.

References $i.

Referenced by addBooking(), and calculateBookings().

    {
        $new_preferences = [];
        foreach ($preferences as $user_id => $obj_ids) {
            $new_preferences[$user_id] = array_filter($preferences[$user_id], function ($i) use ($obj_id) {
                return ($i != $obj_id);
            });
        }
        return $new_preferences;
    }

Here is the caller graph for this function:

removePreference()

ilBookingPreferencesManager::removePreference (   $user_id,   $obj_id,   $preferences  )

protected

Remove a preference from the preference array.

Parameters

int	$user_id
int	$obj_id
array	$preferences

Returns

array

Definition at line 297 of file class.ilBookingPreferencesManager.php.

References $i.

Referenced by addBooking().

    {
        if (is_array($preferences[$user_id])) {
            $preferences[$user_id] = array_filter($preferences[$user_id], function ($i) use ($obj_id) {
                return ($i != $obj_id);
            });
        }
        return $preferences;
    }

Here is the caller graph for this function:

removeUserFromPreferences()

ilBookingPreferencesManager::removeUserFromPreferences (   $user_id,   $preferences  )

protected

Remove user from preference array.

Parameters

int	$user_id
array	$preferences

Returns

array

Definition at line 333 of file class.ilBookingPreferencesManager.php.

Referenced by addBooking(), and calculateBookings().

    {
        if (is_array($preferences[$user_id])) {
            unset($preferences[$user_id]);
        }
        return $preferences;
    }

Here is the caller graph for this function:

resetRun()

ilBookingPreferencesManager::resetRun

(

)

Definition at line 393 of file class.ilBookingPreferencesManager.php.

                               : void
    {
        $this->book_repo->resetRun($this->pool->getId());
    }

selectRandomEntry()

ilBookingPreferencesManager::selectRandomEntry (   $items )

protected

Select a random entry of an array.

Parameters

Definition at line 221 of file class.ilBookingPreferencesManager.php.

Referenced by calculateBookings(), and chooseRandomUserFromPreferences().

    {
        $nr = rand(0, count($items) - 1);
        return $items[$nr];
    }

Here is the caller graph for this function:

storeBookings()

ilBookingPreferencesManager::storeBookings	(		$preferences,
			$booking_object_ids = null
	)

Calculate and store bookings.

Parameters

ilBookingPreferences	$preferences
	int[]	$booking_object_ids

Exceptions

ilBookingCalculationException

Definition at line 88 of file class.ilBookingPreferencesManager.php.

References calculateBookings().

    {
        $bookings = $this->calculateBookings($preferences, $booking_object_ids);
        $this->book_repo->storeBookings($this->pool->getId(), $bookings);
    }

Here is the call graph for this function:

Field Documentation

$book_repo

ilBookingPreferencesManager::$book_repo

protected

Definition at line 32 of file class.ilBookingPreferencesManager.php.

Referenced by __construct().

$bookings_per_user

ilBookingPreferencesManager::$bookings_per_user

protected

Definition at line 27 of file class.ilBookingPreferencesManager.php.

Referenced by __construct().

$current_time

ilBookingPreferencesManager::$current_time

protected

Definition at line 22 of file class.ilBookingPreferencesManager.php.

Referenced by __construct(), isGivingPreferencesPossible(), and isPreferenceDeadlineReached().

$pool

ilBookingPreferencesManager::$pool

protected

Definition at line 17 of file class.ilBookingPreferencesManager.php.

Referenced by __construct().

BOOKINGS_PER_USER_DEFAULT

const ilBookingPreferencesManager::BOOKINGS_PER_USER_DEFAULT = 1

Definition at line 12 of file class.ilBookingPreferencesManager.php.

---

The documentation for this class was generated from the following file:

• Modules/BookingManager/Preferences/classes/class.ilBookingPreferencesManager.php