class.ilRegistrationGUI.php

Go to the documentation of this file.

<?php
/*
        +-----------------------------------------------------------------------------+
        | ILIAS open source                                                           |
        +-----------------------------------------------------------------------------+
        | Copyright (c) 1998-2006 ILIAS open source, University of Cologne            |
        |                                                                             |
        | This program is free software; you can redistribute it and/or               |
        | modify it under the terms of the GNU General Public License                 |
        | as published by the Free Software Foundation; either version 2              |
        | of the License, or (at your option) any later version.                      |
        |                                                                             |
        | This program is distributed in the hope that it will be useful,             |
        | but WITHOUT ANY WARRANTY; without even the implied warranty of              |
        | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               |
        | GNU General Public License for more details.                                |
        |                                                                             |
        | You should have received a copy of the GNU General Public License           |
        | along with this program; if not, write to the Free Software                 |
        | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. |
        +-----------------------------------------------------------------------------+
*/

abstract class ilRegistrationGUI
{
        protected $container = null;
        protected $ref_id;
        protected $obj_id;
        
        protected $participants;
        protected $waiting_list = null;
        protected $form;
        
        protected $registration_possible = true;
        protected $join_error = '';
        

        protected $tpl;
        protected $lng;
        protected $ctrl; 

        public function __construct($a_container)
        {
                global $lng,$ilCtrl,$tpl;
                
                $this->lng = $lng;
                $this->lng->loadLanguageModule('crs');
                $this->lng->loadLanguageModule('grp');
                
                $this->ctrl = $ilCtrl;
                $this->tpl = $tpl;
                
                $this->container = $a_container;
                $this->ref_id = $this->container->getRefId();
                $this->obj_id = ilObject::_lookupObjId($this->ref_id);
                $this->type = ilObject::_lookupType($this->obj_id);
                
                // Init participants
                $this->initParticipants();
                
                // Init waiting list
                $this->initWaitingList();
        }
        
        protected function isRegistrationPossible()
        {
                return (bool) $this->registration_possible;
        }
        
        protected function enableRegistration($a_status)
        {
                $this->registration_possible = $a_status;
        }
        
        
        abstract protected function initParticipants();
        
        abstract protected function initWaitingList();
        
        abstract protected function isWaitingListActive();
        
        protected function getWaitingList()
        {
                return $this->waiting_list;
        }
        
        protected function leaveWaitingList()
        {
                global $ilUser,$tree,$ilCtrl;
                
                $this->getWaitingList()->removeFromList($ilUser->getId());
                $parent = $tree->getParentId($this->container->getRefId());
                
                $message = sprintf($this->lng->txt($this->container->getType().'_removed_from_waiting_list'),
                        $this->container->getTitle());
                ilUtil::sendSuccess($message,true);
                ilUtil::redirect('repository.php?ref_id='.$parent);
        }
        
        abstract protected function getFormTitle();
        
        abstract protected function fillInformations();
        
        abstract protected function fillRegistrationPeriod();
        
        abstract protected function fillMaxMembers();
        
        
        abstract protected function fillRegistrationType();
        
        protected function fillMembershipLimitation()
        {
                global $ilAccess;
                
                include_once('Modules/Course/classes/class.ilObjCourseGrouping.php');
                if(!$items = ilObjCourseGrouping::_getGroupingItems($this->container))
                {
                        return true;
                }
                
                $mem = new ilCustomInputGUI($this->lng->txt('groupings'));
                
                $tpl = new ilTemplate('tpl.membership_limitation_form.html',true,true,'Services/Membership');
                $tpl->setVariable('LIMIT_INTRO',$this->lng->txt($this->type.'_grp_info_reg'));
                
                foreach($items as $ref_id)
                {
                        $obj_id = ilObject::_lookupObjId($ref_id);
                        $type = ilObject::_lookupType($obj_id);
                        $title = ilObject::_lookupTitle($obj_id);
                        
                        if($ilAccess->checkAccess('visible','',$ref_id,$type))
                        {
                                include_once('./classes/class.ilLink.php');
                                $tpl->setVariable('LINK_ITEM','repository.php?ref_id='.$ref_id);
                                $tpl->setVariable('ITEM_LINKED_TITLE',$title);
                        }
                        else
                        {
                                $tpl->setVariable('ITEM_TITLE');
                        }
                        $tpl->setCurrentBlock('items');
                        $tpl->setVariable('TYPE_ICON',ilUtil::getTypeIconPath($type,$obj_id,'tiny'));
                        $tpl->setVariable('ALT_ICON',$this->lng->txt('obj_'.$type));
                        $tpl->parseCurrentBlock();
                }
                
                $mem->setHtml($tpl->get());
                
                
                if(!ilObjCourseGrouping::_checkGroupingDependencies($this->container))
                {
                        $mem->setAlert($this->container->getMessage());
                        $this->enableRegistration(false);
                }
                $this->form->addItem($mem);
        }
        
        protected function fillAgreement()
        {
                return true;
        }
        
        
        public function cancel()
        {
                global $tree;
                
                ilUtil::redirect('repository.php?ref_id='.
                        $tree->getParentId($this->container->getRefId()));
        }
        
        public function show()
        {
                $this->initForm();
                
                $this->tpl->setContent($this->form->getHTML());
        }
        
        public function join()
        {
                $this->initForm();

                if(!$this->validate())
                {
                        ilUtil::sendFailure($this->join_error);
                        $this->show();
                        return false;
                }
                
                $this->add();
        }
        
        
        protected function validate()
        {
                return true;
        }
        
        protected function initForm()
        {
                global $ilUser;
                
                if(is_object($this->form))
                {
                        return true;
                }

                include_once('./Services/Form/classes/class.ilPropertyFormGUI.php');
                $this->form = new ilPropertyFormGUI();
                $this->form->setFormAction($this->ctrl->getFormAction($this,'join'));
                $this->form->setTitle($this->getFormTitle());
                
                $this->fillInformations();
                $this->fillMembershipLimitation();
                if($this->isRegistrationPossible())
                {
                        $this->fillRegistrationPeriod();
                }
                if($this->isRegistrationPossible())
                {
                        $this->fillRegistrationType();
                }
                if($this->isRegistrationPossible())
                {
                        $this->fillMaxMembers();
                }
                if($this->isRegistrationPossible())
                {
                        $this->fillAgreement();
                }
                $this->addCommandButtons();
        }
        
        protected function addCommandButtons()
        {
                global $ilUser;
                
                if($this->isRegistrationPossible() and $this->isWaitingListActive() and !$this->getWaitingList()->isOnList($ilUser->getId()))
                {
                        $this->form->addCommandButton('join',$this->lng->txt('mem_add_to_wl'));
                        $this->form->addCommandButton('cancel',$this->lng->txt('cancel'));
                }
                elseif($this->isRegistrationPossible() and !$this->getWaitingList()->isOnList($ilUser->getId()))
                {
                        $this->form->addCommandButton('join',$this->lng->txt('join'));
                        $this->form->addCommandButton('cancel',$this->lng->txt('cancel'));
                }
                if($this->getWaitingList()->isOnList($ilUser->getId()))
                {
                        ilUtil::sendQuestion(
                                sprintf($this->lng->txt($this->container->getType().'_cancel_waiting_list'),
                                $this->container->getTitle())
                        );
                        $this->form->addCommandButton('leaveWaitingList', $this->lng->txt('leave_waiting_list'));
                        $this->form->addCommandButton('cancel', $this->lng->txt('cancel'));
                }
        }
        
        protected function updateSubscriptionRequest()
        {
                global $ilUser,$tree;
                
                $this->participants->updateSubject($ilUser->getId(),ilUtil::stripSlashes($_POST['subject']));
                ilUtil::sendSuccess($this->lng->txt('sub_request_saved'),true);
                ilUtil::redirect("repository.php?ref_id=".$tree->getParentId($this->container->getRefId()));
        }
        
        protected function cancelSubscriptionRequest()
        {
                global $ilUser,$tree;
                
                $this->participants->deleteSubscriber($ilUser->getId());
                ilUtil::sendSuccess($this->lng->txt('sub_request_deleted'),true);
                ilUtil::redirect("repository.php?ref_id=".$tree->getParentId($this->container->getRefId()));
                
        }
}
?>