ILIAS  release_5-2 Revision v5.2.25-18-g3f80b828510
ilTermsOfServiceTableGUI Class Reference
+ Inheritance diagram for ilTermsOfServiceTableGUI:
+ Collaboration diagram for ilTermsOfServiceTableGUI:

Public Member Functions

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

Protected Member Functions

 isColumnVisible ($column)
 
 prepareData (array &$data)
 This method can be used to prepare values for sorting (e.g. More...
 
 prepareRow (array &$row)
 This method can be used to manipulate the data of a row after sorting and segmentation. More...
 
 formatCellValue ($column, array $row)
 Define a final formatting for a cell value. More...
 
 fillRow ($row)
 
 getStaticData ()
 Return an array of all static (always visible) data fields in a row. More...
 
- Protected Member Functions inherited from ilTable2GUI
 prepareOutput ()
 Anything that must be done before HTML is generated. More...
 
 isFilterVisible ()
 Check if filter is visible: manually shown (session, db) or default value set. More...
 
 isAdvMDFilter (ilAdvancedMDRecordGUI $a_gui, $a_element)
 Check if filter element is based on adv md. More...
 
 fillRow ($a_set)
 Standard Version of Fill Row. More...
 
 getFilterValue (ilFormPropertyGUI $a_item)
 Get current filter value. More...
 
 SetFilterValue (ilFormPropertyGUI $a_item, $a_value)
 Set current filter value. More...
 
 fillMetaExcel (ilExcel $a_excel, &$a_row)
 Add meta information to excel export. More...
 
 fillHeaderExcel (ilExcel $a_excel, &$a_row)
 Excel Version of Fill Header. More...
 
 fillRowExcel (ilExcel $a_excel, &$a_row, $a_set)
 Excel Version of Fill Row. More...
 
 fillMetaCSV ($a_csv)
 Add meta information to csv export. More...
 
 fillHeaderCSV ($a_csv)
 CSV Version of Fill Header. More...
 
 fillRowCSV ($a_csv, $a_set)
 CSV Version of Fill Row. More...
 

Protected Attributes

 $ctrl
 
 $visibleOptionalColumns = array()
 
 $provider
 
 $optionalColumns = array()
 
 $filter = array()
 
 $optional_filter = 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 = 5
 
 $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 = true
 
 $rows_selector_off = 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
 
 $restore_filter
 
 $restore_filter_values
 
 $default_filter_visibility = false
 
 $sortable_fields = array()
 
 $prevent_double_submission = true
 
 $row_selector_label
 

Additional Inherited Members

- Static Public Member Functions inherited from ilTable2GUI
static getAllCommandLimit ()
 Get maximum number of entries to enable actions for all. More...
 
- 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
 
- Data Fields inherited from ilTableGUI
 $title
 
 $icon
 
 $icon_alt
 
 $help_page
 
 $help_icon
 
 $help_icon_alt
 
 $header_names
 
 $header_vars
 
 $linkbar_vars
 
 $data
 
 $column_count
 
 $column_width
 
 $max_count
 
 $limit
 
 $max_limit = false
 
 $offset
 
 $order_column
 
 $order_direction
 
 $footer_style
 
 $footer_previous
 
 $footer_next
 
 $lang_support = true
 
 $global_tpl
 
 $form_name
 
 $select_all_checkbox
 
 $action_buttons
 
 $prefix
 
 $base = ""
 
 $enabled
 
 $styles
 

Detailed Description

Author
Michael Jansen mjans.nosp@m.en@d.nosp@m.ataba.nosp@m.y.de
Version
$Id$

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

Member Function Documentation

◆ fillRow()

ilTermsOfServiceTableGUI::fillRow (   $row)
finalprotected
Parameters
array$row

Definition at line 108 of file class.ilTermsOfServiceTableGUI.php.

References $column, $row, formatCellValue(), getStaticData(), isColumnVisible(), and prepareRow().

109  {
110  $this->prepareRow($row);
111 
112  foreach($this->getStaticData() as $column)
113  {
114  $value = $this->formatCellValue($column, $row);
115  $this->tpl->setVariable('VAL_' . strtoupper($column), $value);
116  }
117 
118  foreach($this->optionalColumns as $index => $definition)
119  {
120  if(!$this->isColumnVisible($index))
121  {
122  continue;
123  }
124 
125  $this->tpl->setCurrentBlock('optional_column');
126  $value = $this->formatCellValue($index, $row);
127  if((string)$value === '')
128  {
129  $this->tpl->touchBlock('optional_column');
130  }
131  else
132  {
133  $this->tpl->setVariable('OPTIONAL_COLUMN_VAL', $value);
134  }
135 
136  $this->tpl->parseCurrentBlock();
137  }
138  }
getStaticData()
Return an array of all static (always visible) data fields in a row.
$column
Definition: 39dropdown.php:62
prepareRow(array &$row)
This method can be used to manipulate the data of a row after sorting and segmentation.
formatCellValue($column, array $row)
Define a final formatting for a cell value.
+ Here is the call graph for this function:

◆ formatCellValue()

ilTermsOfServiceTableGUI::formatCellValue (   $column,
array  $row 
)
protected

Define a final formatting for a cell value.

Parameters
mixed$column
array$row
Returns
mixed

Definition at line 100 of file class.ilTermsOfServiceTableGUI.php.

References $column.

Referenced by fillRow().

101  {
102  return $row[$column];
103  }
$column
Definition: 39dropdown.php:62
+ Here is the caller graph for this function:

◆ getProvider()

ilTermsOfServiceTableGUI::getProvider ( )

Get the registered provider instance.

Returns
ilTermsOfServiceTableDataProvider

Definition at line 56 of file class.ilTermsOfServiceTableGUI.php.

References $provider.

Referenced by populate().

+ Here is the caller graph for this function:

◆ getStaticData()

ilTermsOfServiceTableGUI::getStaticData ( )
abstractprotected

Return an array of all static (always visible) data fields in a row.

For each key there has to be a variable name VAL_<COLUMN_KEY> in your defined row template. Example: return array('title', 'checkbox'); There have to be two template variables: VAL_TITLE and VAL_CHECKBOX

Returns
array

Referenced by fillRow().

+ Here is the caller graph for this function:

◆ isColumnVisible()

ilTermsOfServiceTableGUI::isColumnVisible (   $column)
protected
Parameters
string$column
Returns
bool

Definition at line 65 of file class.ilTermsOfServiceTableGUI.php.

References $column.

Referenced by fillRow().

66  {
67  if(array_key_exists($column, $this->optionalColumns) && !isset($this->visibleOptionalColumns[$column]))
68  {
69  return false;
70  }
71 
72  return true;
73  }
$column
Definition: 39dropdown.php:62
+ Here is the caller graph for this function:

◆ populate()

ilTermsOfServiceTableGUI::populate ( )
Exceptions
ilException

Definition at line 154 of file class.ilTermsOfServiceTableGUI.php.

References ilTableGUI\$data, $filter, $params, array, ilTable2GUI\determineOffsetAndOrder(), ilTable2GUI\determineSelectedFilters(), ilTable2GUI\getExternalSegmentation(), ilTable2GUI\getExternalSorting(), ilTable2GUI\getLimit(), ilTable2GUI\getOffset(), ilTableGUI\getOrderDirection(), ilTable2GUI\getOrderField(), getProvider(), ilTable2GUI\isFilterSelected(), prepareData(), ilTable2GUI\resetOffset(), ilTable2GUI\setData(), and ilTableGUI\setMaxCount().

155  {
156  if(!$this->getExternalSegmentation() && $this->getExternalSorting())
157  {
158  $this->determineOffsetAndOrder(true);
159  }
160  else if($this->getExternalSegmentation() || $this->getExternalSorting())
161  {
162  $this->determineOffsetAndOrder();
163  }
164 
165  $params = array();
166  if($this->getExternalSegmentation())
167  {
168  $params['limit'] = $this->getLimit();
169  $params['offset'] = $this->getOffset();
170  }
171  if($this->getExternalSorting())
172  {
173  $params['order_field'] = $this->getOrderField();
174  $params['order_direction'] = $this->getOrderDirection();
175  }
176 
177  $this->determineSelectedFilters();
179 
180  foreach($this->optional_filter as $key => $value)
181  {
182  if($this->isFilterSelected($key))
183  {
184  $filter[$key] = $value;
185  }
186  }
187 
188  $data = $this->getProvider()->getList($params, $filter);
189 
190  if(!count($data['items']) && $this->getOffset() > 0 && $this->getExternalSegmentation())
191  {
192  $this->resetOffset();
193  $params['limit'] = $this->getLimit();
194  $params['offset'] = $this->getOffset();
195  $data = $this->getProvider()->getList($params, $filter);
196  }
197 
198  $this->prepareData($data);
199 
200  $this->setData($data['items']);
201  if($this->getExternalSegmentation())
202  {
203  $this->setMaxCount($data['cnt']);
204  }
205  }
getExternalSorting()
Get external sorting.
resetOffset($a_in_determination=false)
Reset offset.
getOrderDirection()
Get order direction.
getOffset()
Get offset.
getExternalSegmentation()
Get external segmentation.
Create styles array
The data for the language used.
isFilterSelected($a_col)
Is given filter selected?
determineOffsetAndOrder($a_omit_offset=false)
Determine offset and order.
determineSelectedFilters()
Determine selected filters.
getProvider()
Get the registered provider instance.
prepareData(array &$data)
This method can be used to prepare values for sorting (e.g.
getLimit()
Get limit.
setMaxCount($a_max_count)
set max.
$params
Definition: example_049.php:96
+ Here is the call graph for this function:

◆ prepareData()

ilTermsOfServiceTableGUI::prepareData ( array $data)
protected

This method can be used to prepare values for sorting (e.g.

translations), to filter items etc. It is called before sorting and segmentation.

Parameters
array$data
Returns
array

Definition at line 81 of file class.ilTermsOfServiceTableGUI.php.

Referenced by populate().

82  {
83  }
+ Here is the caller graph for this function:

◆ prepareRow()

ilTermsOfServiceTableGUI::prepareRow ( array $row)
protected

This method can be used to manipulate the data of a row after sorting and segmentation.

Parameters
array$data
Returns
array

Definition at line 90 of file class.ilTermsOfServiceTableGUI.php.

Referenced by fillRow().

91  {
92  }
+ Here is the caller graph for this function:

◆ setProvider()

ilTermsOfServiceTableGUI::setProvider ( ilTermsOfServiceTableDataProvider  $provider)

Set the provider to be used for data retrieval.

ilTableDataProvider $mapper

Definition at line 47 of file class.ilTermsOfServiceTableGUI.php.

References $provider.

48  {
49  $this->provider = $provider;
50  }

Field Documentation

◆ $ctrl

ilTermsOfServiceTableGUI::$ctrl
protected

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

◆ $filter

ilTermsOfServiceTableGUI::$filter = array()
protected

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

Referenced by populate().

◆ $optional_filter

ilTermsOfServiceTableGUI::$optional_filter = array()
protected

Definition at line 41 of file class.ilTermsOfServiceTableGUI.php.

◆ $optionalColumns

ilTermsOfServiceTableGUI::$optionalColumns = array()
protected

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

◆ $provider

ilTermsOfServiceTableGUI::$provider
protected

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

Referenced by getProvider(), and setProvider().

◆ $visibleOptionalColumns

ilTermsOfServiceTableGUI::$visibleOptionalColumns = array()
protected

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


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