This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for ilBookingObjectGUI:

Collaboration diagram for ilBookingObjectGUI:

Public Member Functions
	__construct (ilObjBookingPoolGUI $a_parent_obj, string $seed, string $sseed, ilBookingHelpAdapter $help, int $context_obj_id=0)

	activateManagement (bool $a_val)

	isManagementActivated ()
	Is management activated? More...

	render ()
	Render list of booking objects uses ilBookingObjectsTableGUI. More...

	applyFilter ()

	resetFilter ()

	create (ilPropertyFormGUI $a_form=null)
	Render creation form. More...

	edit (ilPropertyFormGUI $a_form=null)
	Render edit form. More...

	initForm (string $a_mode="create", int $id=null)
	Build property form. More...

	save ()

	update ()

	confirmDelete ()

	delete ()

	deliverInfo ()

Protected Member Functions
	getPoolRefId ()

	getPoolObjId ()

	hasPoolSchedule ()
	Has booking pool a schedule? More...

	getPoolOverallLimit ()
	Get booking pool overall limit. More...

	showNoScheduleMessage ()

	returnToPreferences ()

	setHelpId (string $a_id)

Protected Attributes
ILIAS BookingManager StandardGUIRequest	$book_request

ilCtrl	$ctrl

ilGlobalTemplateInterface	$tpl

ilLanguage	$lng

ilAccessHandler	$access

ilTabsGUI	$tabs

ilBookingHelpAdapter	$help

ilObjectDataCache	$obj_data_cache

ilObjUser	$user

bool	$pool_has_schedule

int	$pool_overall_limit

bool	$pool_uses_preferences = false

bool	$management = true

int	$context_obj_id

int	$object_id

string	$seed

string	$sseed

ilObjBookingPoolGUI	$pool_gui

array	$rsv_ids = []

ilAdvancedMDRecordGUI	$record_gui

int	$ref_id

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om @ilCtrl_Calls ilBookingObjectGUI: ilPropertyFormGUI, ilBookingProcessGUI

Definition at line 23 of file class.ilBookingObjectGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilBookingObjectGUI::__construct	(	ilObjBookingPoolGUI	$a_parent_obj,
		string	$seed,
		string	$sseed,
		ilBookingHelpAdapter	$help,
		int	$context_obj_id = `0`
	)

Definition at line 49 of file class.ilBookingObjectGUI.php.

      {
        global $DIC;
 
        $this->ctrl = $DIC->ctrl();
        $this->tpl = $DIC["tpl"];
        $this->lng = $DIC->language();
        $this->access = $DIC->access();
        $this->tabs = $DIC->tabs();
        $this->help = $help;
        $this->obj_data_cache = $DIC["ilObjDataCache"];
        $this->user = $DIC->user();
 
        $this->book_request = $DIC->bookingManager()
                                  ->internal()
                                  ->gui()
                                  ->standardRequest();
 
 
        $this->seed = $seed;
        $this->sseed = $sseed;
 
        $this->context_obj_id = $context_obj_id;
 
        $this->pool_gui = $a_parent_obj;
        $this->pool_has_schedule =
            ($a_parent_obj->getObject()->getScheduleType() === ilObjBookingPool::TYPE_FIX_SCHEDULE);
        $this->pool_uses_preferences =
            ($a_parent_obj->getObject()->getScheduleType() === ilObjBookingPool::TYPE_NO_SCHEDULE_PREFERENCES);
        $this->pool_overall_limit = $this->pool_has_schedule
            ? null
            : $a_parent_obj->getObject()->getOverallLimit();
 
        $this->object_id = $this->book_request->getObjectId();
        $this->ref_id = $this->book_request->getRefId();
        $this->ctrl->saveParameter($this, "object_id");
 
        if ($this->object_id > 0 && ilBookingObject::lookupPoolId($this->object_id) !== $this->pool_gui->getObject()->getId()) {
            throw new ilPermissionException("Booking object pool id does not match pool id.");
        }
 
        $this->rsv_ids = array_map('intval', $this->book_request->getReservationIdsFromString());
    }

References $context_obj_id, $DIC, $help, $seed, $sseed, ILIAS\Repository\access(), ILIAS\Repository\ctrl(), ilObjectGUI\getObject(), ILIAS\Repository\help(), ILIAS\Repository\lng(), ilBookingObject\lookupPoolId(), ILIAS\Repository\tabs(), ilObjBookingPool\TYPE_FIX_SCHEDULE, ilObjBookingPool\TYPE_NO_SCHEDULE_PREFERENCES, and ILIAS\Repository\user().

Here is the call graph for this function:

Member Function Documentation

◆ activateManagement()

ilBookingObjectGUI::activateManagement ( bool $a_val )

Definition at line 98 of file class.ilBookingObjectGUI.php.

                                                   : void
    {
        $this->management = $a_val;
    }

Referenced by ilBookingObjectServiceGUI\__construct().

Here is the caller graph for this function:

◆ applyFilter()

ilBookingObjectGUI::applyFilter ( )

Definition at line 219 of file class.ilBookingObjectGUI.php.

                                 : void
    {
        $table = new ilBookingObjectsTableGUI($this, 'render', $this->getPoolRefId(), $this->getPoolObjId(), $this->hasPoolSchedule(), $this->getPoolOverallLimit(), $this->isManagementActivated());
        $table->resetOffset();
        $table->writeFilterToSession();
        $this->render();
    }

References getPoolObjId(), getPoolOverallLimit(), getPoolRefId(), hasPoolSchedule(), isManagementActivated(), and render().

Here is the call graph for this function:

◆ confirmDelete()

ilBookingObjectGUI::confirmDelete ( )

Definition at line 508 of file class.ilBookingObjectGUI.php.

                                   : void
    {
        if (!$this->access->checkAccess('write', '', $this->ref_id)) {
            return;
        }
 
        $ilCtrl = $this->ctrl;
        $lng = $this->lng;
        $tpl = $this->tpl;
        $ilTabs = $this->tabs;
 
        $ilTabs->clearTargets();
        $ilTabs->setBackTarget($lng->txt('book_back_to_list'), $ilCtrl->getLinkTarget($this, 'render'));
 
        $conf = new ilConfirmationGUI();
        $conf->setFormAction($ilCtrl->getFormAction($this));
        $conf->setHeaderText($lng->txt('book_confirm_delete'));
 
        $type = new ilBookingObject($this->object_id);
        $conf->addItem('object_id', $this->object_id, $type->getTitle());
        $conf->setConfirm($lng->txt('delete'), 'delete');
        $conf->setCancel($lng->txt('cancel'), 'render');
 
        $tpl->setContent($conf->getHTML());
    }

References $lng, $tpl, $type, and ILIAS\Repository\access().

Here is the call graph for this function:

◆ create()

ilBookingObjectGUI::create ( ilPropertyFormGUI $a_form = null )

Render creation form.

Definition at line 238 of file class.ilBookingObjectGUI.php.

                                                            : void
    {
        if (!$this->access->checkAccess('write', '', $this->ref_id)) {
            return;
        }
 
        $ilCtrl = $this->ctrl;
        $tpl = $this->tpl;
        $lng = $this->lng;
        $ilTabs = $this->tabs;
 
        $ilTabs->clearTargets();
        $ilTabs->setBackTarget($lng->txt('book_back_to_list'), $ilCtrl->getLinkTarget($this, 'render'));
 
        $this->setHelpId('create');
 
        if (!$a_form) {
            $a_form = $this->initForm();
        }
        $tpl->setContent($a_form->getHTML());
    }

References $ctrl, $lng, $tabs, $tpl, ILIAS\Repository\access(), ilTabsGUI\clearTargets(), initForm(), ilGlobalTemplateInterface\setContent(), setHelpId(), and ilLanguage\txt().

Here is the call graph for this function:

◆ delete()

ilBookingObjectGUI::delete ( )

Definition at line 534 of file class.ilBookingObjectGUI.php.

                            : void
    {
        if (!$this->access->checkAccess('write', '', $this->ref_id)) {
            return;
        }
 
        $ilCtrl = $this->ctrl;
        $lng = $this->lng;
 
        $obj = new ilBookingObject($this->object_id);
        $obj->deleteReservationsAndCalEntries($this->object_id);
        $obj->delete();
 
        $this->tpl->setOnScreenMessage('success', $lng->txt('book_object_deleted'), true);
        $ilCtrl->setParameter($this, 'object_id', "");
        $ilCtrl->redirect($this, 'render');
    }

References $lng, and ILIAS\Repository\access().

Here is the call graph for this function:

◆ deliverInfo()

ilBookingObjectGUI::deliverInfo ( )

Definition at line 553 of file class.ilBookingObjectGUI.php.

                                 : void
    {
        $id = $this->object_id;
        if (!$id) {
            return;
        }
 
        $obj = new ilBookingObject($id);
        $file = $obj->getFileFullPath();
        if ($file) {
            ilFileDelivery::deliverFileLegacy($file, $obj->getFile());
        }
    }

References $id, and ilFileDelivery\deliverFileLegacy().

Here is the call graph for this function:

◆ edit()

ilBookingObjectGUI::edit ( ilPropertyFormGUI $a_form = null )

Render edit form.

Definition at line 263 of file class.ilBookingObjectGUI.php.

                                                          : void
    {
        if (!$this->access->checkAccess('write', '', $this->ref_id)) {
            return;
        }
 
        $tpl = $this->tpl;
        $ilCtrl = $this->ctrl;
        $ilTabs = $this->tabs;
        $lng = $this->lng;
 
        $ilTabs->clearTargets();
        $ilTabs->setBackTarget($lng->txt('book_back_to_list'), $ilCtrl->getLinkTarget($this, 'render'));
 
        $this->setHelpId('edit');
 
        if (!$a_form) {
            $a_form = $this->initForm('edit', $this->object_id);
        }
        $tpl->setContent($a_form->getHTML());
    }

References $ctrl, $lng, $tabs, $tpl, ILIAS\Repository\access(), initForm(), ilGlobalTemplateInterface\setContent(), setHelpId(), and ilLanguage\txt().

Here is the call graph for this function:

◆ getPoolObjId()

ilBookingObjectGUI::getPoolObjId ( )

protected

Definition at line 116 of file class.ilBookingObjectGUI.php.

                                     : int
    {
        return $this->pool_gui->getObject()->getId();
    }

Referenced by applyFilter(), render(), and resetFilter().

Here is the caller graph for this function:

◆ getPoolOverallLimit()

ilBookingObjectGUI::getPoolOverallLimit ( )

protected

Get booking pool overall limit.

Definition at line 132 of file class.ilBookingObjectGUI.php.

                                            : ?int
    {
        return $this->hasPoolSchedule()
            ? null
            : $this->pool_gui->getObject()->getOverallLimit();
    }

References hasPoolSchedule().

Referenced by applyFilter(), render(), and resetFilter().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPoolRefId()

ilBookingObjectGUI::getPoolRefId ( )

protected

Definition at line 111 of file class.ilBookingObjectGUI.php.

                                     : int
    {
        return $this->pool_gui->getRefId();
    }

Referenced by applyFilter(), render(), and resetFilter().

Here is the caller graph for this function:

◆ hasPoolSchedule()

ilBookingObjectGUI::hasPoolSchedule ( )

protected

Has booking pool a schedule?

Definition at line 124 of file class.ilBookingObjectGUI.php.

                                        : bool
    {
        return ($this->pool_gui->getObject()->getScheduleType() === ilObjBookingPool::TYPE_FIX_SCHEDULE);
    }

References ilObjBookingPool\TYPE_FIX_SCHEDULE.

Referenced by applyFilter(), getPoolOverallLimit(), render(), and resetFilter().

Here is the caller graph for this function:

◆ initForm()

ilBookingObjectGUI::initForm	(	string	$a_mode = `"create"`,
		int	$id = `null`
	)

Build property form.

Definition at line 293 of file class.ilBookingObjectGUI.php.

     : ilPropertyFormGUI {
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;
        $ilObjDataCache = $this->obj_data_cache;
 
        $form_gui = new ilPropertyFormGUI();
 
        $title = new ilTextInputGUI($lng->txt("title"), "title");
        $title->setRequired(true);
        $title->setSize(40);
        $title->setMaxLength(120);
        $form_gui->addItem($title);
 
        $desc = new ilTextAreaInputGUI($lng->txt("description"), "desc");
        $desc->setCols(70);
        $desc->setRows(15);
        $desc->setMaxNumOfChars(1000);
        $form_gui->addItem($desc);
 
        $file = new ilFileInputGUI($lng->txt("book_additional_info_file"), "file");
        $file->setAllowDeletion(true);
        $form_gui->addItem($file);
 
        $nr = new ilNumberInputGUI($lng->txt("booking_nr_of_items"), "items");
        $nr->setRequired(true);
        $nr->setSize(3);
        $nr->setMaxLength(3);
        $nr->setSuffix($lng->txt("book_booking_objects"));
        $form_gui->addItem($nr);
 
        if ($this->hasPoolSchedule()) {
            $options = array();
            foreach (ilBookingSchedule::getList($ilObjDataCache->lookupObjId($this->getPoolRefId())) as $schedule) {
                $options[$schedule["booking_schedule_id"]] = $schedule["title"];
            }
            $schedule = new ilSelectInputGUI($lng->txt("book_schedule"), "schedule");
            $schedule->setRequired(true);
            $schedule->setOptions($options);
            $form_gui->addItem($schedule);
        }
 
        $post = new ilFormSectionHeaderGUI();
        $post->setTitle($lng->txt("book_post_booking_information"));
        $form_gui->addItem($post);
 
        $pdesc = new ilTextAreaInputGUI($lng->txt("book_post_booking_text"), "post_text");
        $pdesc->setCols(70);
        $pdesc->setRows(15);
        $pdesc->setInfo($lng->txt("book_post_booking_text_info"));
        $form_gui->addItem($pdesc);
 
        $pfile = new ilFileInputGUI($lng->txt("book_post_booking_file"), "post_file");
        $pfile->setAllowDeletion(true);
        $form_gui->addItem($pfile);
 
        // #18214 - should also work for new objects
        $this->record_gui = new ilAdvancedMDRecordGUI(
            ilAdvancedMDRecordGUI::MODE_EDITOR,
            "book",
            $this->getPoolObjId(),
            "bobj",
            (int) $id
        );
        $this->record_gui->setPropertyForm($form_gui);
        $this->record_gui->parse();
 
        if ($a_mode === "edit") {
            $form_gui->setTitle($lng->txt("book_edit_object"));
 
            $item = new ilHiddenInputGUI('object_id');
            $item->setValue($id);
            $form_gui->addItem($item);
 
            $obj = new ilBookingObject($id);
            $title->setValue($obj->getTitle());
            $desc->setValue($obj->getDescription());
            $nr->setValue($obj->getNrOfItems());
            $pdesc->setValue($obj->getPostText());
            $file->setValue($obj->getFile());
            $pfile->setValue($obj->getPostFile());
 
            if (isset($schedule)) {
                $schedule->setValue($obj->getScheduleId());
            }
 
            $form_gui->addCommandButton("update", $lng->txt("save"));
        } else {
            $form_gui->setTitle($lng->txt("book_add_object"));
            $form_gui->addCommandButton("save", $lng->txt("save"));
            $form_gui->addCommandButton("render", $lng->txt("cancel"));
        }
        $form_gui->setFormAction($ilCtrl->getFormAction($this));
 
        return $form_gui;
    }

Referenced by create(), and edit().

Here is the caller graph for this function:

◆ isManagementActivated()

ilBookingObjectGUI::isManagementActivated ( )

Is management activated?

Definition at line 106 of file class.ilBookingObjectGUI.php.

                                           : bool
    {
        return $this->management;
    }

References $management.

Referenced by applyFilter(), render(), and resetFilter().

Here is the caller graph for this function:

◆ render()

ilBookingObjectGUI::render ( )

Render list of booking objects uses ilBookingObjectsTableGUI.

Definition at line 196 of file class.ilBookingObjectGUI.php.

                            : void
    {
        $this->showNoScheduleMessage();
 
        $tpl = $this->tpl;
        $ilCtrl = $this->ctrl;
        $lng = $this->lng;
        $ilAccess = $this->access;
 
        $bar = "";
 
        if ($this->isManagementActivated() && $ilAccess->checkAccess('write', '', $this->getPoolRefId())) {
            $bar = new ilToolbarGUI();
            $bar->addButton($lng->txt('book_add_object'), $ilCtrl->getLinkTarget($this, 'create'));
            $bar = $bar->getHTML();
        }
 
        $tpl->setPermanentLink('book', $this->getPoolRefId());
 
        $table = new ilBookingObjectsTableGUI($this, 'render', $this->getPoolRefId(), $this->getPoolObjId(), $this->hasPoolSchedule(), $this->getPoolOverallLimit(), $this->isManagementActivated());
        $tpl->setContent($bar . $table->getHTML());
    }

References $access, Vendor\Package\$bar, $ctrl, $lng, $tpl, getPoolObjId(), getPoolOverallLimit(), getPoolRefId(), hasPoolSchedule(), isManagementActivated(), ilGlobalTemplateInterface\setContent(), ilGlobalTemplateInterface\setPermanentLink(), showNoScheduleMessage(), and ilLanguage\txt().

Referenced by applyFilter(), and resetFilter().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resetFilter()

ilBookingObjectGUI::resetFilter ( )

Definition at line 227 of file class.ilBookingObjectGUI.php.

                                 : void
    {
        $table = new ilBookingObjectsTableGUI($this, 'render', $this->getPoolRefId(), $this->getPoolObjId(), $this->hasPoolSchedule(), $this->getPoolOverallLimit(), $this->isManagementActivated());
        $table->resetOffset();
        $table->resetFilter();
        $this->render();
    }

References getPoolObjId(), getPoolOverallLimit(), getPoolRefId(), hasPoolSchedule(), isManagementActivated(), and render().

Here is the call graph for this function:

◆ returnToPreferences()

ilBookingObjectGUI::returnToPreferences ( )

protected

Definition at line 187 of file class.ilBookingObjectGUI.php.

                                            : void
    {
        $this->ctrl->redirectByClass("ilBookingPreferencesGUI");
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ save()

ilBookingObjectGUI::save ( )

Definition at line 392 of file class.ilBookingObjectGUI.php.

                          : void
    {
        if (!$this->access->checkAccess('write', '', $this->ref_id)) {
            return;
        }
 
        $ilCtrl = $this->ctrl;
        $lng = $this->lng;
 
        $form = $this->initForm();
        if ($form->checkInput()) {
            $valid = true;
            if ($this->record_gui &&
                !$this->record_gui->importEditFormPostValues()) {
                $valid = false;
            }
            if ($valid) {
                $obj = new ilBookingObject();
                $obj->setPoolId($this->getPoolObjId());
                $obj->setTitle($form->getInput("title"));
                $obj->setDescription($form->getInput("desc"));
                $obj->setNrOfItems($form->getInput("items"));
                $obj->setPostText($form->getInput("post_text"));
 
                if ($this->hasPoolSchedule()) {
                    $obj->setScheduleId($form->getInput("schedule"));
                }
 
                $obj->save();
 
                $file = $form->getItemByPostVar("file");
                if ($_FILES["file"]["tmp_name"]) {
                    $obj->uploadFile($_FILES["file"]);
                } elseif ($file !== null && $file->getDeletionFlag()) {
                    $obj->deleteFile();
                }
 
                $pfile = $form->getItemByPostVar("post_file");
                if ($_FILES["post_file"]["tmp_name"]) {
                    $obj->uploadPostFile($_FILES["post_file"]);
                } elseif ($pfile !== null && $pfile->getDeletionFlag()) {
                    $obj->deletePostFile();
                }
 
                $obj->update();
 
                if ($this->record_gui) {
                    $this->record_gui->writeEditForm(null, $obj->getId());
                }
 
                $this->tpl->setOnScreenMessage('success', $lng->txt("book_object_added"), true);
                $ilCtrl->redirect($this, "render");
            }
        }
 
        $form->setValuesByPost();
        $this->create($form);
    }

References $lng, $valid, and ILIAS\Repository\access().

Here is the call graph for this function:

◆ setHelpId()

ilBookingObjectGUI::setHelpId ( string $a_id )

protected

Definition at line 285 of file class.ilBookingObjectGUI.php.

                                              : void
    {
        $this->help->setHelpId($a_id);
    }

References ILIAS\Repository\help().

Referenced by create(), and edit().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showNoScheduleMessage()

ilBookingObjectGUI::showNoScheduleMessage ( )

protected

Definition at line 182 of file class.ilBookingObjectGUI.php.

                                              : void
    {
        $this->pool_gui->showNoScheduleMessage();
    }

Referenced by render().

Here is the caller graph for this function:

◆ update()

ilBookingObjectGUI::update ( )

Definition at line 451 of file class.ilBookingObjectGUI.php.

                            : void
    {
        if (!$this->access->checkAccess('write', '', $this->ref_id)) {
            return;
        }
 
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;
 
        $form = $this->initForm('edit', $this->object_id);
        if ($form->checkInput()) {
            $valid = true;
            if ($this->record_gui &&
                !$this->record_gui->importEditFormPostValues()) {
                $valid = false;
            }
 
            if ($valid) {
                $obj = new ilBookingObject($this->object_id);
                $obj->setTitle($form->getInput("title"));
                $obj->setDescription($form->getInput("desc"));
                $obj->setNrOfItems($form->getInput("items"));
                $obj->setPostText($form->getInput("post_text"));
 
                $file = $form->getItemByPostVar("file");
                if ($_FILES["file"]["tmp_name"]) {
                    $obj->uploadFile($_FILES["file"]);
                } elseif ($file !== null && $file->getDeletionFlag()) {
                    $obj->deleteFile();
                }
 
                $pfile = $form->getItemByPostVar("post_file");
                if ($_FILES["post_file"]["tmp_name"]) {
                    $obj->uploadPostFile($_FILES["post_file"]);
                } elseif ($pfile !== null && $pfile->getDeletionFlag()) {
                    $obj->deletePostFile();
                }
 
                if ($this->hasPoolSchedule()) {
                    $obj->setScheduleId($form->getInput("schedule"));
                }
 
                $obj->update();
 
                if ($this->record_gui) {
                    $this->record_gui->writeEditForm();
                }
 
                $this->tpl->setOnScreenMessage('success', $lng->txt("book_object_updated"), true);
                $ilCtrl->redirect($this, "render");
            }
        }
 
        $form->setValuesByPost();
        $this->edit($form);
    }