GUI class for course/group waiting list. More...

Inheritance diagram for ilWaitingListTableGUI:

Collaboration diagram for ilWaitingListTableGUI:

Public Member Functions
	__construct ($a_parent_obj, $waiting_list, $show_content=true)
	Constructor.
	setUsers ($a_sub)
	set subscribers
	getSelectableColumns ()
	Get selectable columns.
	fillRow ($a_set)
	fill row
	readUserData ()
	read data
Public Member Functions inherited from ilTable2GUI
	setOpenFormTag ($a_val)
	Set open form tag.
	getOpenFormTag ()
	Get open form tag.
	setCloseFormTag ($a_val)
	Set close form tag.
	getCloseFormTag ()
	Get close form tag.
	determineLimit ()
	Determine the limit.
	determineSelectedColumns ()
	Determine selected columns.
	isColumnSelected ($a_col)
	Is given column selected?
	getSelectedColumns ()
	Get selected columns.
&	executeCommand ()
	Execute command.
	resetOffset ($a_in_determination=false)
	Reset offset.
	initFilter ()
	Init filter.
	getParentObject ()
	Get parent object.
	getParentCmd ()
	Get parent command.
	setTopAnchor ($a_val)
	Set top anchor.
	getTopAnchor ()
	Get top anchor.
	setNoEntriesText ($a_text)
	Set text for an empty table.
	getNoEntriesText ()
	Get text for an empty table.
	setIsDataTable ($a_val)
	Set is data table.
	getIsDataTable ()
	Get is data table.
	setEnableTitle ($a_enabletitle)
	Set Enable Title.
	getEnableTitle ()
	Get Enable Title.
	setEnableHeader ($a_enableheader)
	Set Enable Header.
	getEnableHeader ()
	Get Enable Header.
	setEnableNumInfo ($a_val)
	Set enable num info.
	getEnableNumInfo ()
	Get enable num info.
	setTitle ($a_title, $a_icon=0, $a_icon_alt=0)
	Set title and title icon.
	setDescription ($a_val)
	Set description.
	getDescription ()
	Get description.
	setOrderField ($a_order_field)
	set order column
	getOrderField ()
	setData ($a_data)
	set table data public
	getData ()
	dataExists ()
	setPrefix ($a_prefix)
	set prefix for sort and offset fields (if you have two or more tables on a page that you want to sort separately) public
	getPrefix ()
	addFilterItem ($a_input_item, $a_optional=false)
	Add filter item.
	addFilterItemByMetaType ($id, $type=self::FILTER_TEXT, $a_optional=false, $caption=NULL)
	Add filter by standard type.
	getFilterItems ($a_optionals=false)
	Get filter items.
	getFilterItemByPostVar ($a_post_var)
	setFilterCols ($a_val)
	Set filter columns.
	getFilterCols ()
	Get filter columns.
	setDisableFilterHiding ($a_val=true)
	Set disable filter hiding.
	getDisableFilterHiding ()
	Get disable filter hiding.
	isFilterSelected ($a_col)
	Is given filter selected?
	getSelectedFilters ()
	Get selected filters.
	determineSelectedFilters ()
	Determine selected filters.
	setCustomPreviousNext ($a_prev_link, $a_next_link)
	Set custom previous/next links.
	setFormAction ($a_form_action)
	Set Form action parameter.
	getFormAction ()
	Get Form action parameter.
	setFormName ($a_formname)
	Set Form name.
	getFormName ()
	Get Form name.
	setId ($a_val)
	Set id.
	getId ()
	Get element id.
	setDisplayAsBlock ($a_val)
	Set display as block.
	getDisplayAsBlock ()
	Get display as block.
	getSelectAllCheckbox ()
	Get the name of the checkbox that should be toggled with a select all button.
	setSelectAllCheckbox ($a_select_all_checkbox)
	Set the name of the checkbox that should be toggled with a select all button.
	setExternalSorting ($a_val)
	Set external sorting.
	getExternalSorting ()
	Get external sorting.
	setFilterCommand ($a_val)
	Set filter command.
	getFilterCommand ()
	Get filter command.
	setResetCommand ($a_val)
	Set reset filter command.
	getResetCommand ()
	Get reset filter command.
	setExternalSegmentation ($a_val)
	Set external segmentation.
	getExternalSegmentation ()
	Get external segmentation.
	setRowTemplate ($a_template, $a_template_dir="")
	Set row template.
	setDefaultOrderField ($a_defaultorderfield)
	Set Default order field.
	getDefaultOrderField ()
	Get Default order field.
	setDefaultOrderDirection ($a_defaultorderdirection)
	Set Default order direction.
	getDefaultOrderDirection ()
	Get Default order direction.
	clearCommandButtons ()
	addCommandButton ($a_cmd, $a_text, $a_onclick= '', $a_id="")
	Add Command button.
	addSelectionButton ($a_sel_var, $a_options, $a_cmd, $a_text, $a_default_selection= '')
	Add Selection List + Command button.
	addMultiItemSelectionButton ($a_sel_var, $a_options, $a_cmd, $a_text, $a_default_selection= '')
	Add Selection List + Command button for selected items.
	setCloseCommand ($a_link)
	Add command for closing table.
	addMultiCommand ($a_cmd, $a_text)
	Add Command button.
	addHiddenInput ($a_name, $a_value)
	Add Hidden Input field.
	addHeaderCommand ($a_href, $a_text, $a_target="", $a_img="")
	Add Header Command (Link) (Image needed for now)
	setTopCommands ($a_val)
	Set top commands (display command buttons on top of table, too)
	getTopCommands ()
	Get top commands (display command buttons on top of table, too)
	addColumn ($a_text, $a_sort_field="", $a_width="", $a_is_checkbox_action_column=false, $a_class="", $a_tooltip="")
	Add a column to the header.
	getNavParameter ()
	setOrderLink ($sort_field, $order_dir)
	fillHeader ()
	determineOffsetAndOrder ($a_omit_offset=false)
	Determine offset and order.
	storeNavParameter ()
	getHTML ()
	Get HTML.
	numericOrdering ($a_field)
	Should this field be sorted numeric?
	render ()
	render table public
	writeFilterToSession ()
	Write filter values to session.
	resetFilter ()
	Reset filter.
	fillFooter ()
	Fill footer row.
	getLinkbar ($a_num)
	Get previous/next linkbar.
	fillHiddenRow ()
	fillActionRow ()
	Fill Action Row.
	setHeaderHTML ($html)
	set header html
	storeProperty ($type, $value)
	Store table property.
	loadProperty ($type)
	Load table property.
	getCurrentState ()
	get current settings for order, limit, columns and filter
	setContext ($id)
	Set context.
	getContext ()
	Get context.
	setShowRowsSelector ($a_value)
	Toggle rows-per-page selector.
	getShowRowsSelector ()
	Get rows-per-page selector state.
	setShowTemplates ($a_value)
	Toggle templates.
	getShowTemplates ()
	Get template state.
	restoreTemplate ($a_name)
	Restore state from template.
	saveTemplate ($a_name)
	Save current state as template.
	deleteTemplate ($a_name)
	Delete template.
	getLimit ()
	Get limit.
	getOffset ()
	Get offset.
	setExportFormats (array $formats)
	Set available export formats.
	setPrintMode ($a_value=false)
	Toogle print mode.
	getPrintMode ()
	Get print mode.
	getExportMode ()
	Was export activated?
	exportData ($format, $send=false)
	Export and optionally send current table data.
	setEnableAllCommand ($a_value)
	Enable actions for all entries in current result.
	setRowSelectorLabel ($row_selector_label)
	getRowSelectorLabel ()
Public Member Functions inherited from ilTableGUI
	ilTableGUI ($a_data=0, $a_global_tpl=true)
	Constructor.
	setTemplate (&$a_tpl)
	set template public
&	getTemplateObject ()
	setHelp ($a_help_page, $a_help_icon, $a_help_icon_alt=0)
	set table help page public
	setHeaderNames ($a_header_names)
	set table header names public
	getColumnCount ()
	Returns the column count based on the number of the header row columns public.
	setHeaderVars ($a_header_vars, $a_header_params=0)
	set table header vars public
	setColumnWidth ($a_column_width)
	set table column widths public
	setOneColumnWidth ($a_column_width, $a_column_number)
	set one table column width public
	setMaxCount ($a_max_count)
	set max.
	setLimit ($a_limit=0, $a_default_limit=0)
	set max.
	setOffset ($a_offset)
	set dataset offset public
	setOrderColumn ($a_order_column=0, $a_default_column=0)
	set order column public
	getOrderColumn ()
	Get order column.
	setOrderDirection ($a_order_direction)
	set order direction public
	getOrderDirection ()
	Get order direction.
	setFooter ($a_style, $a_previous=0, $a_next=0)
	set order direction public
	enable ($a_module_name)
	enables particular modules of table
	disable ($a_module_name)
	diesables particular modules of table
	sortData ()
	renderHeader ()
	setStyle ($a_element, $a_style)
	getStyle ($a_element)
	setBase ($a_base)
	Set Base script name (deprecated, only use this for workarounds).
	getBase ()
	Get Base script name (deprecated, only use this for workarounds).
	clearActionButtons ()
	addActionButton ($btn_name, $btn_value)

Protected Member Functions
	checkAcceptance ()
Protected Member Functions inherited from ilTable2GUI
	prepareOutput ()
	Anything that must be done before HTML is generated.
	getFilterValue (ilFormPropertyGUI $a_item)
	Get current filter value.
	SetFilterValue (ilFormPropertyGUI $a_item, $a_value)
	Set current filter value.
	fillMetaExcel ($worksheet, &$a_row)
	Add meta information to excel export.
	fillHeaderExcel ($worksheet, &$a_row)
	Excel Version of Fill Row.
	fillRowExcel ($a_worksheet, &$a_row, $a_set)
	Excel Version of Fill Row.
	fillMetaCSV ($a_csv)
	Add meta information to csv export.
	fillHeaderCSV ($a_csv)
	CSV Version of Fill Header.
	fillRowCSV ($a_csv, $a_set)
	CSV Version of Fill Row.

Protected Attributes
	$waiting_list = null
	$wait = array()
	$wait_user_ids = array()
Protected Attributes inherited from ilTable2GUI
	$close_command = ""
	$top_anchor = "il_table_top"
	$filters = array()
	$optional_filters = array()
	$filter_cmd = 'applyFilter'
	$reset_cmd = 'resetFilter'
	$filter_cols = 4
	$ext_sort = false
	$ext_seg = false
	$context = ""
	$mi_sel_buttons = null
	$disable_filter_hiding = false
	$selected_filter = false
	$top_commands = true
	$selectable_columns = array()
	$selected_column = array()
	$show_templates = false
	$show_rows_selector = false
	$nav_determined = false
	$limit_determined = false
	$filters_determined = false
	$columns_determined = false
	$open_form_tag = true
	$close_form_tag = true
	$export_formats
	$export_mode
	$print_mode
	$enable_command_for_all
	$row_selector_label

Static Protected Attributes
static	$all_columns = null

Additional Inherited Members
Static Public Member Functions inherited from ilTable2GUI
static	getAllCommandLimit ()
	Get maximum number of entries to enable actions for all.
Data Fields inherited from ilTable2GUI
const	FILTER_TEXT = 1
const	FILTER_SELECT = 2
const	FILTER_DATE = 3
const	FILTER_LANGUAGE = 4
const	FILTER_NUMBER_RANGE = 5
const	FILTER_DATE_RANGE = 6
const	FILTER_DURATION_RANGE = 7
const	FILTER_DATETIME_RANGE = 8
const	EXPORT_EXCEL = 1
const	EXPORT_CSV = 2
const	ACTION_ALL_LIMIT = 1000

Detailed Description

GUI class for course/group waiting list.

Author: Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

Version: $Id$

Definition at line 35 of file class.ilWaitingListTableGUI.php.

Constructor & Destructor Documentation

ilWaitingListTableGUI::__construct	(	$a_parent_obj,
		$waiting_list,
		$show_content = `true`
	)

Constructor.

public

Parameters

@return

Reimplemented from ilTable2GUI.

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

References $ilCtrl, $lng, $waiting_list, ilTable2GUI\addColumn(), ilTable2GUI\addMultiCommand(), ilTableGUI\disable(), ilTableGUI\enable(), getSelectableColumns(), ilTable2GUI\getSelectedColumns(), ilTable2GUI\setFormAction(), ilTable2GUI\setFormName(), ilTable2GUI\setId(), ilTable2GUI\setPrefix(), ilTable2GUI\setRowTemplate(), and ilTable2GUI\setSelectAllCheckbox().

        {
                global $lng,$ilCtrl;
                
                $this->lng = $lng;
                $this->lng->loadLanguageModule('grp');
                $this->lng->loadLanguageModule('crs');
                $this->ctrl = $ilCtrl;
                
                $this->setId('crs_wait_'. $a_parent_obj->object->getId());
                parent::__construct($a_parent_obj,'members');
                $this->setFormName('waiting');
                $this->setFormAction($this->ctrl->getFormAction($a_parent_obj,'members'));
                $this->addColumn('','f',"1");
                $this->addColumn($this->lng->txt('name'),'lastname','20%');
                
                $all_cols = $this->getSelectableColumns();
                foreach($this->getSelectedColumns() as $col)
                {
                        $this->addColumn($all_cols[$col]['txt'], $col);
                }
                
                $this->addColumn($this->lng->txt('application_date'),'sub_time',"10%");
                $this->addColumn('','mail','10%');
                
                $this->addMultiCommand('assignFromWaitingList',$this->lng->txt('assign'));
                $this->addMultiCommand('refuseFromList',$this->lng->txt('refuse'));
                $this->addMultiCommand('sendMailToSelectedUsers',$this->lng->txt('crs_mem_send_mail'));
                
                $this->setPrefix('waiting');
                $this->setSelectAllCheckbox('waiting');
                $this->setRowTemplate("tpl.show_waiting_list_row.html","Services/Membership");
                
                if($show_content)
                {
                        $this->enable('sort');
                        $this->enable('header');
                        $this->enable('numinfo');
                        $this->enable('select_all');
                }
                else
                {
                        $this->disable('content');
                        $this->disable('header');
                        $this->disable('footer');
                        $this->disable('numinfo');
                        $this->disable('select_all');
                }       
                
                $this->waiting_list = $waiting_list;
        }

Here is the call graph for this function:

Member Function Documentation

ilWaitingListTableGUI::checkAcceptance ( )

protected

Definition at line 335 of file class.ilWaitingListTableGUI.php.

Referenced by readUserData().

        {
                return true;
        }

Here is the caller graph for this function:

ilWaitingListTableGUI::fillRow ( $a_set )

fill row

public

Parameters

@return

Reimplemented from ilTable2GUI.

Definition at line 147 of file class.ilWaitingListTableGUI.php.

References $ilUser, ilTableGUI\$prefix, ilObjCourseGrouping\_checkGroupingDependencies(), ilObject\_lookupTitle(), ilDatePresentation\formatDate(), ilObjCourseGrouping\getAssignedObjects(), ilTable2GUI\getParentObject(), ilTable2GUI\getSelectedColumns(), IL_CAL_DATE, and IL_CAL_UNIX.

        {
                global $ilUser;
                
                include_once('./Services/Calendar/classes/class.ilDateTime.php');
                include_once './Modules/Course/classes/class.ilObjCourseGrouping.php';
                
                if(!ilObjCourseGrouping::_checkGroupingDependencies($this->getParentObject()->object,$a_set['usr_id']) and
                        ($ids = ilObjCourseGrouping::getAssignedObjects()))
                {
                        $prefix = $this->getParentObject()->object->getType();
                        $this->tpl->setVariable('ALERT_MSG',
                                sprintf($this->lng->txt($prefix.'_lim_assigned'),
                                ilObject::_lookupTitle(current($ids))
                                ));
                                
                }
                                
                $this->tpl->setVariable('VAL_ID',$a_set['usr_id']);
                $this->tpl->setVariable('VAL_NAME',$a_set['lastname'].', '.$a_set['firstname']);
                foreach($this->getSelectedColumns() as $field)
                {
                        switch($field)
                        {
                                case 'gender':
                                        $a_set['gender'] = $a_set['gender'] ? $this->lng->txt('gender_' . $a_set['gender']) : '';
                                        $this->tpl->setCurrentBlock('custom_fields');
                                        $this->tpl->setVariable('VAL_CUST', $a_set[$field]);
                                        $this->tpl->parseCurrentBlock();
                                        break;
                                case 'birthday':
                                        $a_set['birthday'] = $a_set['birthday'] ? ilDatePresentation::formatDate(new ilDate($a_set['birthday'], IL_CAL_DATE)) : $this->lng->txt('no_date');
                                        $this->tpl->setCurrentBlock('custom_fields');
                                        $this->tpl->setVariable('VAL_CUST', $a_set[$field]);
                                        $this->tpl->parseCurrentBlock();
                                        break;
                                default:
                                        $this->tpl->setCurrentBlock('custom_fields');
                                        $this->tpl->setVariable('VAL_CUST', isset($a_set[$field]) ? (string) $a_set[$field] : '');
                                        $this->tpl->parseCurrentBlock();
                                        break;
                        }
                }
                
                $this->tpl->setVariable('VAL_SUBTIME',ilDatePresentation::formatDate(new ilDateTime($a_set['sub_time'],IL_CAL_UNIX)));
                
                #$this->tpl->setVariable('VAL_LOGIN',$a_set['login']);
                
                $this->ctrl->setParameterByClass(get_class($this->getParentObject()),'member_id',$a_set['id']);
                $link = $this->ctrl->getLinkTargetByClass(get_class($this->getParentObject()),'sendMailToSelectedUsers');
                $this->tpl->setVariable('MAIL_LINK',$link);
                $this->tpl->setVariable('MAIL_TITLE',$this->lng->txt('crs_mem_send_mail'));
        }

Here is the call graph for this function:

ilWaitingListTableGUI::getSelectableColumns ( )

Get selectable columns.

Returns

Reimplemented from ilTable2GUI.

Definition at line 126 of file class.ilWaitingListTableGUI.php.

References $all_columns, ilExportFieldsInfo\_getInstanceByType(), and ilTable2GUI\getParentObject().

Referenced by __construct().

        {
                if(self::$all_columns)
                {
                        return self::$all_columns;
                }
                include_once './Services/PrivacySecurity/classes/class.ilExportFieldsInfo.php';
                $ef = ilExportFieldsInfo::_getInstanceByType($this->getParentObject()->object->getType());
                self::$all_columns = $ef->getSelectableFieldsInfo($this->getParentObject()->object->getId());
                return self::$all_columns;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilWaitingListTableGUI::readUserData ( )

read data

protected

Parameters

@return

Definition at line 211 of file class.ilWaitingListTableGUI.php.

References ilTableGUI\$data, $usr_id, ilCourseUserData\_getValuesByObjId(), checkAcceptance(), ilTable2GUI\determineOffsetAndOrder(), ilTable2GUI\getLimit(), ilTable2GUI\getOffset(), ilTableGUI\getOrderDirection(), ilTable2GUI\getOrderField(), ilTable2GUI\getParentObject(), ilTable2GUI\getSelectedColumns(), ilUserQuery\getUserListData(), ilUserDefinedData\lookupData(), ilTable2GUI\setData(), and ilTableGUI\setMaxCount().

Referenced by setUsers().

        {
                global $rbacreview;
                $this->determineOffsetAndOrder();
                include_once './Services/User/classes/class.ilUserQuery.php';
                $additional_fields = $this->getSelectedColumns();
                unset($additional_fields["firstname"]);
                unset($additional_fields["lastname"]);
                unset($additional_fields["last_login"]);
                unset($additional_fields["access_until"]);
                $udf_ids = $usr_data_fields = $odf_ids = array();
                foreach($additional_fields as $field)
                {
                        if(substr($field, 0, 3) == 'udf')
                        {
                                $udf_ids[] = substr($field, 4);
                                continue;
                        }
                        if(substr($field, 0, 3) == 'odf')
                        {
                                $odf_ids[] = substr($field, 4);
                                continue;
                        }
                        $usr_data_fields[] = $field;
                }
                $usr_data = ilUserQuery::getUserListData(
                        $this->getOrderField(),
                        $this->getOrderDirection(),
                        $this->getOffset(),
                        $this->getLimit(),
                        '',
                        '',
                        null,
                        false,
                        false,
                        0,
                        0,
                        null,
                        $usr_data_fields,
                        $this->wait_user_ids
                );
                
                foreach((array) $usr_data['set'] as $user)
                {
                        $usr_ids[] = $user['usr_id'];
                }
                // merge course data
                $course_user_data = $this->getParentObject()->readMemberData($usr_ids,$this->type == 'admin');
                $a_user_data = array();
                foreach((array) $usr_data['set'] as $ud)
                {                       
                        $a_user_data[$ud['usr_id']] = array_merge($ud,$course_user_data[$ud['usr_id']]);
                }
                // Custom user data fields
                if($udf_ids)
                {
                        include_once './Services/User/classes/class.ilUserDefinedData.php';
                        $data = ilUserDefinedData::lookupData($usr_ids, $udf_ids);
                        foreach($data as $usr_id => $fields)
                        {
                                if(!$this->checkAcceptance($usr_id))
                                {
                                        continue;
                                }
                                foreach($fields as $field_id => $value)
                                {
                                        $a_user_data[$usr_id]['udf_' . $field_id] = $value;
                                }
                        }
                }
                // Object specific user data fields
                if($odf_ids)
                {
                        include_once './Modules/Course/classes/Export/class.ilCourseUserData.php';
                        $data = ilCourseUserData::_getValuesByObjId($this->getParentObject()->object->getId());
                        foreach($data as $usr_id => $fields)
                        {
                                // #7264: as we get data for all course members filter against user data
                                if(!$this->checkAcceptance($usr_id) || !in_array($usr_id, $usr_ids))
                                {
                                        continue;
                                }
                                foreach($fields as $field_id => $value)
                                {
                                        $a_user_data[$usr_id]['odf_' . $field_id] = $value;
                                }
                        }
                }
                foreach($usr_data['set'] as $user)
                {
                        // Check acceptance
                        if(!$this->checkAcceptance($user['usr_id']))
                        {
                                continue;
                        }
                        // DONE: accepted
                        foreach($usr_data_fields as $field)
                        {
                                $a_user_data[$user['usr_id']][$field] = $user[$field] ? $user[$field] : '';
                        }
                }
                
                // Waiting list subscription
                foreach($this->wait as $usr_id => $usr_data)
                {
                        $a_user_data[$usr_id]['sub_time'] = $usr_data['time'];
                }
                
                $this->setMaxCount($usr_data['cnt'] ? $usr_data['cnt'] : 0);
                return $this->setData($a_user_data);            
        }

Here is the call graph for this function:

Here is the caller graph for this function:

ilWaitingListTableGUI::setUsers ( $a_sub )

set subscribers

public

Parameters

@return

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

References $usr_id, and readUserData().

        {
                $this->wait = $a_sub;
                foreach($this->wait as $usr_id => $usr_data)
                {
                        $this->wait_user_ids[] = $usr_id;
                }
                
                $this->readUserData();
        }