ilGroupAddToGroupActionGUI Class Reference

Add user to group from awareness tool. More...

Collaboration diagram for ilGroupAddToGroupActionGUI:

Public Member Functions
	__construct ()
	Constructor. More...
	executeCommand ()
	Execute command. More...
	show ()
	Show. More...
	sendResponse ($a_content)
	Send response. More...
	selectGroup ()
	Select group. More...
	confirmAddUser ()
	Confirm add user to group. More...
	addUser ()
	Add user. More...
	selectParent ()
	Select group. More...
	createGroup ($form=null)
	Create group. More...
	confirmCreateGroupAndAddUser ()
	Save group. More...
	createGroupAndAddUser ()
	Create group and add user. More...

Protected Member Functions
	getGroupCreationForm ()

Protected Attributes
	$ctrl
	$tpl
	$ui
	$lng
	$tree

Detailed Description

Add user to group from awareness tool.

Author

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

Definition at line 11 of file class.ilGroupAddToGroupActionGUI.php.

Constructor & Destructor Documentation

__construct()

ilGroupAddToGroupActionGUI::__construct

(

)

Constructor.

Parameters

Definition at line 43 of file class.ilGroupAddToGroupActionGUI.php.

References $DIC, ui(), and user().

    {
        global $DIC;

        $this->ctrl = $DIC->ctrl();
        $this->tpl = $DIC["tpl"];
        $this->ui = $DIC->ui();
        $this->lng = $DIC->language();
        $this->tree = $DIC->repositoryTree();
        $this->user = $DIC->user();

        $this->lng->loadLanguageModule("grp");
        $this->ctrl->saveParameter($this, array("user_id", "modal_exists"));
    }

Here is the call graph for this function:

Member Function Documentation

addUser()

ilGroupAddToGroupActionGUI::addUser

(

)

Add user.

Parameters

Definition at line 237 of file class.ilGroupAddToGroupActionGUI.php.

References $_GET, $lng, $tpl, exit, ilParticipants\getInstanceByObjId(), ilUtil\getSystemMessageHTML(), IL_GRP_MEMBER, and ilGroupMembershipMailNotification\TYPE_ADMISSION_MEMBER.

    {
        $tpl = $this->tpl;
        $lng = $this->lng;

        $user_id = (int) $_GET["user_id"];

        // @todo: check permission

        include_once("./Modules/Group/classes/class.ilObjGroup.php");
        $group = new ilObjGroup((int) $_GET["grp_act_ref_id"]);

        include_once './Services/Membership/classes/class.ilParticipants.php';
        $participants = ilParticipants::getInstanceByObjId($group->getId());

        $participants->add($user_id, IL_GRP_MEMBER);

        include_once './Modules/Group/classes/class.ilGroupMembershipMailNotification.php';
        $participants->sendNotification(
            ilGroupMembershipMailNotification::TYPE_ADMISSION_MEMBER,
            $user_id
        );

        echo ilUtil::getSystemMessageHTML($lng->txt("grp_user_been_added"), "success");
        echo "<script>setTimeout(function (){ il.Group.UserActions.closeModal();}, 1000);</script>";
        exit;
    }

Here is the call graph for this function:

confirmAddUser()

ilGroupAddToGroupActionGUI::confirmAddUser

(

)

Confirm add user to group.

Parameters

Definition at line 191 of file class.ilGroupAddToGroupActionGUI.php.

References $_GET, $ctrl, $lng, $tpl, $url, ilObject\_lookupObjId(), ilObject\_lookupTitle(), exit, ilParticipants\getInstanceByObjId(), ilUserUtil\getNamePresentation(), ilUtil\getSystemMessageHTML(), ui(), and ILIAS\UI\Implementation\Component\withOnLoadCode().

    {
        $ctrl = $this->ctrl;
        $tpl = $this->tpl;
        $lng = $this->lng;

        include_once("./Services/Membership/classes/class.ilParticipants.php");
        include_once './Services/Membership/classes/class.ilParticipants.php';
        $participants = ilParticipants::getInstanceByObjId(ilObject::_lookupObjId((int) $_GET["grp_act_ref_id"]));
        if ($participants->isMember((int) $_GET["user_id"])) {
            $url = $ctrl->getLinkTarget($this, "selectGroup", "", true, false);
            $button = $this->ui->factory()->button()->standard($lng->txt("back"), "#")
                ->withOnLoadCode(function ($id) use ($url) {
                    return "$('#$id').on('click', function() {il.Util.ajaxReplaceInner('$url', 'il_grp_action_modal_content'); return false;})";
                });

            echo
                ilUtil::getSystemMessageHTML($lng->txt("grp_user_already_in_group") . "<br>" .
                    $lng->txt("obj_user") . ": " . ilUserUtil::getNamePresentation((int) $_GET["user_id"]) . "<br>" .
                    $lng->txt("obj_grp") . ": " . ilObject::_lookupTitle(ilObject::_lookupObjId($_GET["grp_act_ref_id"])), "failure") .
                $this->ui->renderer()->renderAsync($button);
            exit;
        }


        // button create new group
        $ctrl->setParameter($this, "grp_act_ref_id", $_GET["grp_act_ref_id"]);
        $url = $ctrl->getLinkTarget($this, "addUser", "", true, false);
        $button = $this->ui->factory()->button()->standard($lng->txt("grp_add_user"), "#")
            ->withOnLoadCode(function ($id) use ($url) {
                return "$('#$id').on('click', function() {il.Util.ajaxReplaceInner('$url', 'il_grp_action_modal_content'); return false;})";
            });

        echo
            ilUtil::getSystemMessageHTML($lng->txt("grp_sure_add_user_to_group") . "<br>" .
                $lng->txt("obj_user") . ": " . ilUserUtil::getNamePresentation((int) $_GET["user_id"]) . "<br>" .
                $lng->txt("obj_grp") . ": " . ilObject::_lookupTitle(ilObject::_lookupObjId($_GET["grp_act_ref_id"])), "question") .
            $this->ui->renderer()->renderAsync($button);
        exit;
    }

Here is the call graph for this function:

confirmCreateGroupAndAddUser()

ilGroupAddToGroupActionGUI::confirmCreateGroupAndAddUser

(

)

Save group.

Parameters

Definition at line 336 of file class.ilGroupAddToGroupActionGUI.php.

References $_GET, $_POST, $ctrl, $lng, $tpl, createGroup(), exit, getGroupCreationForm(), ilUserUtil\getNamePresentation(), ilUtil\getSystemMessageHTML(), ui(), and ILIAS\UI\Implementation\Component\withOnLoadCode().

    {
        $ctrl = $this->ctrl;
        $tpl = $this->tpl;
        $lng = $this->lng;

        $form = $this->getGroupCreationForm();
        if (!$form->checkInput()) {
            $this->createGroup($form);
            return;
        }

        $this->ctrl->saveParameter($this, "grp_act_par_ref_id");
        $form->setFormAction($this->ctrl->getLinkTarget($this, "createGroupAndAddUser", "", true, false));
        $form->setValuesByPost();

        $button = $this->ui->factory()->button()->standard($lng->txt("grp_create_and_add_user"), "#")
            ->withOnLoadCode(function ($id) {
                return "$('#$id').on('click', function(e) {il.Group.UserActions.createGroup(e);})";
            });

        echo
            ilUtil::getSystemMessageHTML($lng->txt("grp_sure_create_group_add_user") . "<br>" .
                $lng->txt("obj_user") . ": " . ilUserUtil::getNamePresentation($_GET["user_id"]) . "<br>" .
                $lng->txt("obj_grp") . ": " . $_POST["title"], "question") .
            "<div class='ilNoDisplay'>" . $form->getHTML() . "</div>" .
            "<div class='ilRight'>" . $this->ui->renderer()->renderAsync($button) . "</div>";

        exit;
    }

Here is the call graph for this function:

createGroup()

ilGroupAddToGroupActionGUI::createGroup

(

$form = null

)

Create group.

Parameters

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

References $_GET, $lng, $tpl, ilObject\_lookupObjId(), ilObject\_lookupTitle(), exit, getGroupCreationForm(), and ilUtil\getSystemMessageHTML().

Referenced by confirmCreateGroupAndAddUser().

    {
        $tpl = $this->tpl;
        $lng = $this->lng;

        if ($form == null) {
            $form = $this->getGroupCreationForm();
        }
        $this->ctrl->saveParameter($this, "grp_act_par_ref_id");
        $form->setFormAction($this->ctrl->getLinkTarget($this, "confirmCreateGroupAndAddUser", "", true, false));

        echo ilUtil::getSystemMessageHTML(str_replace("%1", ilObject::_lookupTitle(ilObject::_lookupObjId($_GET["grp_act_par_ref_id"])), $lng->txt("grp_create_new_grp_in")), "info") .
            $form->getHTML();
        exit;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

createGroupAndAddUser()

ilGroupAddToGroupActionGUI::createGroupAndAddUser

(

)

Create group and add user.

Parameters

Definition at line 373 of file class.ilGroupAddToGroupActionGUI.php.

References $_GET, $lng, $tpl, $url, ilLink\_getLink(), exit, getGroupCreationForm(), ilParticipants\getInstanceByObjId(), ilUtil\getSystemMessageHTML(), IL_GRP_MEMBER, and ilGroupMembershipMailNotification\TYPE_ADMISSION_MEMBER.

    {
        $lng = $this->lng;
        $tpl = $this->tpl;

        $user_id = (int) $_GET["user_id"];
        $form = $this->getGroupCreationForm();

        $form->checkInput();

        $group_gui = new ilObjGroupGUI("", 0, true);

        // create instance
        include_once("./Modules/Group/classes/class.ilObjGroup.php");
        $newObj = new ilObjGroup();
        $newObj->setType("grp");
        $newObj->setTitle($form->getInput("title"));
        $newObj->setDescription($form->getInput("desc"));
        $newObj->create();

        $group_gui->putObjectInTree($newObj, (int) $_GET["grp_act_par_ref_id"]);

        // apply didactic template?
        $dtpl = $group_gui->getDidacticTemplateVar("dtpl");
        if ($dtpl) {
            $newObj->applyDidacticTemplate($dtpl);
        }

        $group_gui->afterSave($newObj, false);


        include_once './Services/Membership/classes/class.ilParticipants.php';
        $participants = ilParticipants::getInstanceByObjId($newObj->getId());

        $participants->add($user_id, IL_GRP_MEMBER);

        include_once './Modules/Group/classes/class.ilGroupMembershipMailNotification.php';
        $participants->sendNotification(
            ilGroupMembershipMailNotification::TYPE_ADMISSION_MEMBER,
            $user_id
        );


        include_once("./Services/Link/classes/class.ilLink.php");
        $url = ilLink::_getLink($newObj->getRefId());
        echo ilUtil::getSystemMessageHTML($lng->txt("grp_created_and_user_been_added"), "success");
        echo "<script>setTimeout(function (){ window.location.replace('$url');}, 1500);</script>";
        exit;
    }

Here is the call graph for this function:

executeCommand()

ilGroupAddToGroupActionGUI::executeCommand

(

)

Execute command.

Definition at line 61 of file class.ilGroupAddToGroupActionGUI.php.

References $ctrl, and ilGroupUserActionProvider\getCommandAccess().

    {
        $ctrl = $this->ctrl;
        $user = $this->user;

        $next_class = $ctrl->getNextClass($this);
        $cmd = $ctrl->getCmd("show");

        if ($cmd == "show") {
            include_once("./Modules/Group/UserActions/classes/class.ilGroupUserActionProvider.php");
            $ca = ilGroupUserActionProvider::getCommandAccess($user->getId());
            if (count($ca) == 0) {
                return;
            }
            if (count($ca) == 1) {
                switch (current($ca)) {
                    case "create_grp":
                        $cmd = "selectParent";
                        break;

                    case "manage_members":
                        $cmd = "selectGroup";
                        break;

                    default:
                        return;
                }
            }
        }

        switch ($next_class) {
            default:
                if (in_array($cmd, array("show", "selectGroup", "confirmAddUser", "addUser",
                    "selectParent", "createGroup", "confirmCreateGroupAndAddUser", "createGroupAndAddUser"))) {
                    $ctrl->setParameter($this, "modal_exists", 1);
                    $this->$cmd();
                }
        }
    }

Here is the call graph for this function:

getGroupCreationForm()

ilGroupAddToGroupActionGUI::getGroupCreationForm ( )

protected

Definition at line 313 of file class.ilGroupAddToGroupActionGUI.php.

References $_GET, and $lng.

Referenced by confirmCreateGroupAndAddUser(), createGroup(), and createGroupAndAddUser().

    {
        $lng = $this->lng;

        $group_gui = new ilObjGroupGUI("", 0, true);
        $group_gui->setCreationMode(true);
        // workaround for bug #22748 (which is triggered, if a didactic template for groups exist which is limited to a rep node)
        $ref_id = $_GET["ref_id"];
        $_GET["ref_id"] = $_GET["grp_act_par_ref_id"];
        $form = $group_gui->initForm("create", true);
        $_GET["ref_id"] = $ref_id;
        $form->clearCommandButtons();
        $form->addCommandButton("save", $lng->txt("grp_next"));
        $form->setShowTopButtons(false);
        return $form;
    }

Here is the caller graph for this function:

selectGroup()

ilGroupAddToGroupActionGUI::selectGroup

(

)

Select group.

Parameters

Definition at line 167 of file class.ilGroupAddToGroupActionGUI.php.

References $tree, exit, and sendResponse().

    {
        $tree = $this->tree;

        include_once("./Modules/Group/UserActions/classes/class.ilGroupActionTargetExplorerGUI.php");
        $exp = new ilGroupActionTargetExplorerGUI($this, "selectGroup");

        $exp->setClickableType("grp");
        $exp->setTypeWhiteList(array("root", "cat", "crs", "fold", "grp"));
        $exp->setPathOpen((int) $tree->readRootId());

        if (!$exp->handleCommand()) {
            $this->sendResponse($exp->getHTML());
        }

        exit;
    }

Here is the call graph for this function:

selectParent()

ilGroupAddToGroupActionGUI::selectParent

(

)

Select group.

Parameters

Definition at line 271 of file class.ilGroupAddToGroupActionGUI.php.

References $lng, $tpl, $tree, exit, ilUtil\getSystemMessageHTML(), and sendResponse().

    {
        $tree = $this->tree;
        $lng = $this->lng;
        $tpl = $this->tpl;

        include_once("./Modules/Group/UserActions/classes/class.ilGroupActionTargetExplorerGUI.php");
        $exp = new ilGroupActionTargetExplorerGUI($this, "selectParent", true);

        $exp->setTypeWhiteList(array("root", "cat", "crs"));
        $exp->setPathOpen((int) $tree->readRootId());

        if (!$exp->handleCommand()) {
            $this->sendResponse(ilUtil::getSystemMessageHTML($lng->txt("grp_no_perm_to_add_create_first"), "info") .
                $exp->getHTML());
        }

        exit;
    }

Here is the call graph for this function:

sendResponse()

ilGroupAddToGroupActionGUI::sendResponse

(

$a_content

)

Send response.

Parameters

string

$a_content

Definition at line 139 of file class.ilGroupAddToGroupActionGUI.php.

References $_GET, $a_content, $lng, exit, ui(), and ILIAS\UI\Implementation\Component\withOnLoadCode().

Referenced by selectGroup(), selectParent(), and show().

    {
        $lng = $this->lng;

        if ($_GET["modal_exists"] == 1) {
            echo $this->ui->renderer()->renderAsync($this->ui->factory()->legacy($a_content));
        } else {
            $mtpl = new ilTemplate("tpl.grp_add_to_grp_modal_content.html", true, true, "./Modules/Group/UserActions");
            $mtpl->setVariable("CONTENT", $a_content);
            $content = $this->ui->factory()->legacy($mtpl->get());
            $modal = $this->ui->factory()->modal()->roundtrip(
                $lng->txt("grp_add_user_to_group"),
                $content
            )->withOnLoadCode(function ($id) {
                return "il.UI.modal.showModal('$id', {'ajaxRenderUrl':'','keyboard':true}, {id: '$id'});";
            });
            echo $this->ui->renderer()->renderAsync($modal);
        }
        exit;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

show()

ilGroupAddToGroupActionGUI::show

(

)

Show.

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

References $ctrl, $lng, $tpl, ilUtil\getSystemMessageHTML(), sendResponse(), ui(), and ILIAS\UI\Implementation\Component\withOnLoadCode().

    {
        $tpl = $this->tpl;
        $lng = $this->lng;
        $ctrl = $this->ctrl;

        $toolbar = new ilToolbarGUI();

        // button use existing group
        $url1 = $ctrl->getLinkTarget($this, "selectGroup", "", true, false);
        $button1 = $this->ui->factory()->button()->standard($lng->txt("grp_use_existing"), "#")
            ->withOnLoadCode(function ($id) use ($url1) {
                return "$('#$id').on('click', function() {il.Util.ajaxReplaceInner('$url1', 'il_grp_action_modal_content'); return false;})";
            });
        $toolbar->addComponent($button1);

        // button create new group
        $url2 = $ctrl->getLinkTarget($this, "selectParent", "", true, false);
        $button2 = $this->ui->factory()->button()->standard($lng->txt("grp_create_new"), "#")
            ->withOnLoadCode(function ($id) use ($url2) {
                return "$('#$id').on('click', function() {il.Util.ajaxReplaceInner('$url2', 'il_grp_action_modal_content'); return false;})";
            });
        $toolbar->addComponent($button2);

        $this->sendResponse(
            ilUtil::getSystemMessageHTML($lng->txt("grp_create_or_use_existing"), "question") .
            $toolbar->getHTML()
        );
    }

Here is the call graph for this function:

Field Documentation

$ctrl

ilGroupAddToGroupActionGUI::$ctrl

protected

Definition at line 16 of file class.ilGroupAddToGroupActionGUI.php.

Referenced by confirmAddUser(), confirmCreateGroupAndAddUser(), executeCommand(), and show().

$lng

ilGroupAddToGroupActionGUI::$lng

protected

Definition at line 31 of file class.ilGroupAddToGroupActionGUI.php.

Referenced by addUser(), confirmAddUser(), confirmCreateGroupAndAddUser(), createGroup(), createGroupAndAddUser(), getGroupCreationForm(), selectParent(), sendResponse(), and show().

$tpl

ilGroupAddToGroupActionGUI::$tpl

protected

Definition at line 21 of file class.ilGroupAddToGroupActionGUI.php.

Referenced by addUser(), confirmAddUser(), confirmCreateGroupAndAddUser(), createGroup(), createGroupAndAddUser(), selectParent(), and show().

$tree

ilGroupAddToGroupActionGUI::$tree

protected

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

Referenced by selectGroup(), and selectParent().

$ui

ilGroupAddToGroupActionGUI::$ui

protected

Definition at line 26 of file class.ilGroupAddToGroupActionGUI.php.

---

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

• Modules/Group/UserActions/classes/class.ilGroupAddToGroupActionGUI.php