ILIAS  release_5-3 Revision v5.3.23-19-g915713cf615
ilMailFolderTableGUI Class Reference
+ Inheritance diagram for ilMailFolderTableGUI:
+ Collaboration diagram for ilMailFolderTableGUI:

Public Member Functions

 __construct ($a_parent_obj, $a_current_folder_id, $a_parent_cmd='')
 Constructor public. More...
 
 prepareHTML ()
 Call this before using getHTML() public. More...
 
 isDraftFolder ($a_bool=null)
 Setter/Getter for folder status public. More...
 
 isSentFolder ($a_bool=null)
 Setter/Getter for folder status public. More...
 
 isTrashFolder ($a_bool=null)
 Setter/Getter for folder status public. More...
 
 setSelectedItems ($a_selected_items)
 Set the selected items public. More...
 
 getSelectedItems ()
 Get all selected items public. More...
 
 setNumerOfMails ($a_number_of_mails)
 Set the total number of mails of the current folder public. More...
 
 getNumerOfMails ()
 Returns the total number of mails of the current folder public. More...
 
 fillRow ($a_set)
 Fill row public. More...
 
 initFilter ()
 
 writeFilterToSession ()
 Write filter values to session. More...
 
 resetFilter ()
 Reset filter. More...
 
- Public Member Functions inherited from ilTable2GUI
 __construct ($a_parent_obj, $a_parent_cmd="", $a_template_context="")
 ilTable2GUI 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

 isLuceneSearchEnabled ()
 
 fetchTableData ()
 
 setTitleData ($folderLabel, $mailCount, $unreadCount, $imgFolder)
 Function to set the table title protected. 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

 $lng
 
 $ctrl
 
 $user
 
 $_folderNode = array()
 
 $_parentObject = null
 
 $_currentFolderId = 0
 
 $_number_of_mails = 0
 
 $_selectedItems = array()
 
 $_isTrashFolder = false
 
 $_isDraftsFolder = false
 
 $_isSentFolder = false
 
 $filter = array()
 
 $sub_filter = array()
 
- Protected Attributes inherited from ilTable2GUI
 $ctrl
 
 $tpl
 
 $parent_obj
 
 $parent_cmd
 
 $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 = []
 
 $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
 
 $sel_buttons = []
 
- Protected Attributes inherited from ilTableGUI
 $tpl
 
 $lng
 

Private Member Functions

 initCommandButtons ()
 Performs special actions for folders such as user folders, trash and local folders private. More...
 
 initMultiCommands ($actions)
 initMultiCommands private More...
 

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 FILTER_CHECKBOX = 9
 
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

Constructor & Destructor Documentation

◆ __construct()

ilMailFolderTableGUI::__construct (   $a_parent_obj,
  $a_current_folder_id,
  $a_parent_cmd = '' 
)

Constructor public.

Parameters
$a_parent_objPass an instance of ilObjectGUI
integer$a_current_folder_idId of the current mail box folder
string$a_parent_cmdCommand for the parent class

Definition at line 58 of file class.ilMailFolderTableGUI.php.

References $DIC, ilTable2GUI\setDefaultOrderDirection(), ilTable2GUI\setDefaultOrderField(), ilTable2GUI\setEnableTitle(), ilTable2GUI\setExternalSegmentation(), ilTable2GUI\setExternalSorting(), ilTable2GUI\setFilterCommand(), ilTable2GUI\setFormAction(), ilTable2GUI\setId(), ilTable2GUI\setPrefix(), ilTable2GUI\setResetCommand(), ilTable2GUI\setRowTemplate(), ilTable2GUI\setSelectAllCheckbox(), and user().

59  {
60  global $DIC;
61 
62  $this->lng = $DIC->language();
63  $this->ctrl = $DIC->ctrl();
64  $this->user = $DIC->user();
65 
66  $this->_currentFolderId = $a_current_folder_id;
67  $this->_parentObject = $a_parent_obj;
68 
69  $this->setId('mail_folder_tbl_' . $a_current_folder_id);
70  $this->setPrefix('mtable');
71 
72  $this->setExternalSorting(true);
73  $this->setExternalSegmentation(true);
74  $this->setDefaultOrderField('send_time');
75  $this->setDefaultOrderDirection('desc');
76 
77  parent::__construct($a_parent_obj, $a_parent_cmd);
78 
79  $this->setFormAction($this->ctrl->getFormAction($this->_parentObject, 'showFolder'));
80 
81  $this->setEnableTitle(true);
82  $this->setSelectAllCheckbox('mail_id[]');
83  $this->setRowTemplate('tpl.mail_folder_row.html', 'Services/Mail');
84 
85  $this->setFilterCommand('applyFilter');
86  $this->setResetCommand('resetFilter');
87  }
setExternalSorting($a_val)
Set external sorting.
setDefaultOrderField($a_defaultorderfield)
Set Default order field.
global $DIC
Definition: saml.php:7
setExternalSegmentation($a_val)
Set external segmentation.
setId($a_val)
Set id.
user()
Definition: user.php:4
setDefaultOrderDirection($a_defaultorderdirection)
Set Default order direction.
setResetCommand($a_val, $a_caption=null)
Set reset filter command.
setPrefix($a_prefix)
setRowTemplate($a_template, $a_template_dir="")
Set row template.
setFormAction($a_form_action, $a_multipart=false)
Set Form action parameter.
setSelectAllCheckbox($a_select_all_checkbox)
Set the name of the checkbox that should be toggled with a select all button.
setEnableTitle($a_enabletitle)
Set Enable Title.
setFilterCommand($a_val, $a_caption=null)
Set filter command.
+ Here is the call graph for this function:

Member Function Documentation

◆ fetchTableData()

ilMailFolderTableGUI::fetchTableData ( )
protected
Returns
$this
Exceptions
Exception

Definition at line 275 of file class.ilMailFolderTableGUI.php.

References $_currentFolderId, $counter, ilTableGUI\$data, ilMailBoxQuery\$filter, ilMailBoxQuery\$filtered_ids, ilMailBoxQuery\$folderId, $key, ilMailBoxQuery\$limit, ilMailBoxQuery\$offset, ilMailBoxQuery\$orderColumn, ilMailBoxQuery\$orderDirection, $result, $user, ilMailBoxQuery\$userId, ilMailBoxQuery\_getMailBoxListData(), array, ilTable2GUI\determineOffsetAndOrder(), ilDatePresentation\formatDate(), ilUtil\getImagePath(), ilTable2GUI\getLimit(), ilTable2GUI\getOffset(), ilTableGUI\getOrderDirection(), ilTable2GUI\getOrderField(), getSelectedItems(), ilMailUserCache\getUserObjectById(), ilUtil\htmlencodePlainString(), IL_CAL_DATETIME, isDraftFolder(), isLuceneSearchEnabled(), isSentFolder(), ilMailUserCache\preloadUserObjects(), ilTable2GUI\resetOffset(), ilTable2GUI\setData(), ilTableGUI\setMaxCount(), setNumerOfMails(), setTitleData(), and user().

Referenced by prepareHTML().

276  {
277  if ($this->_folderNode['m_type'] == 'user_folder') {
278  $txt_folder = $this->_folderNode['title'];
279  $img_folder = 'icon_user_folder.png';
280  } else {
281  $txt_folder = $this->lng->txt('mail_' . $this->_folderNode['title']);
282  $img_folder = 'icon' . substr($this->_folderNode['title'], 1) . '.png';
283  }
284 
285  try {
286  if ($this->isLuceneSearchEnabled()) {
287  include_once 'Services/Mail/classes/class.ilMailLuceneQueryParser.php';
288  $query_parser = new ilMailLuceneQueryParser($this->filter['mail_filter']);
289  $query_parser->setFields(array(
290  'title' => (bool) $this->filter['mail_filter_subject'],
291  'content' => (bool) $this->filter['mail_filter_body'],
292  'mattachment' => (bool) $this->filter['mail_filter_attach'],
293  'msender' => (bool) $this->filter['mail_filter_sender'],
294  'mrcp' => (bool) $this->filter['mail_filter_recipients']
295  ));
296  $query_parser->parse();
297 
298  require_once 'Services/Mail/classes/class.ilMailLuceneSearcher.php';
299  require_once 'Services/Mail/classes/class.ilMailSearchResult.php';
300  $result = new ilMailSearchResult();
301  $searcher = new ilMailLuceneSearcher($query_parser, $result);
302  $searcher->search($this->user->getId(), $this->_currentFolderId);
303 
304  if (!$result->getIds()) {
305  throw new ilException('mail_search_empty_result');
306  }
307 
310  } else {
311  ilMailBoxQuery::$filter = (array) $this->filter;
312  }
313 
314  $this->determineOffsetAndOrder();
315 
317  ilMailBoxQuery::$userId = $this->user->getId();
318  ilMailBoxQuery::$limit = $this->getLimit();
323 
324  if (!count($data['set']) && $this->getOffset() > 0) {
325  $this->resetOffset();
326 
327  ilMailBoxQuery::$limit = $this->getLimit();
330  }
331  } catch (Exception $e) {
332  $this->setTitleData($txt_folder, 0, 0, $img_folder);
333 
334  if ('mail_search_empty_result' == $e->getMessage()) {
335  $data['set'] = array();
336  $data['cnt'] = 0;
337  } else {
338  throw $e;
339  }
340  }
341 
342  if (!$this->isDraftFolder() && !$this->isSentFolder()) {
343  $user_ids = array();
344  foreach ($data['set'] as $mail) {
345  if ($mail['sender_id'] && $mail['sender_id'] != ANONYMOUS_USER_ID) {
346  $user_ids[$mail['sender_id']] = $mail['sender_id'];
347  }
348  }
349 
351  }
352 
353  $counter = 0;
354  foreach ($data['set'] as $key => $mail) {
355  ++$counter;
356 
357  if (is_array($this->getSelectedItems()) && in_array($mail['mail_id'], $this->getSelectedItems())) {
358  $mail['checked'] = ' checked="checked" ';
359  }
360 
361  if ($this->isDraftFolder() || $this->isSentFolder()) {
362  $mail['rcp_to'] = $mail['mail_login'] = ilUtil::htmlencodePlainString(
363  $this->_parentObject->umail->formatNamesForOutput($mail['rcp_to']),
364  false
365  );
366  } else {
367  if ($mail['sender_id'] == ANONYMOUS_USER_ID) {
368  $mail['img_sender'] = ilUtil::getImagePath('HeaderIconAvatar.svg');
369  $mail['from'] = $mail['mail_login'] = $mail['alt_sender'] = htmlspecialchars(ilMail::_getIliasMailerName());
370  } else {
371  $user = ilMailUserCache::getUserObjectById($mail['sender_id']);
372  if ($user) {
373  $mail['img_sender'] = $user->getPersonalPicturePath('xxsmall');
374  $mail['from'] = $mail['mail_login'] = $mail['alt_sender'] = htmlspecialchars($user->getPublicName());
375  } else {
376  $mail['from'] = $mail['mail_login'] = $mail['import_name'] . ' (' . $this->lng->txt('user_deleted') . ')';
377  }
378  }
379  }
380 
381  if ($this->isDraftFolder()) {
382  $this->ctrl->setParameterByClass('ilmailformgui', 'mail_id', $mail['mail_id']);
383  $this->ctrl->setParameterByClass('ilmailformgui', 'type', 'draft');
384  $link_mark_as_read = $this->ctrl->getLinkTargetByClass('ilmailformgui');
385  $this->ctrl->clearParametersByClass('ilmailformgui');
386  } else {
387  $this->ctrl->setParameter($this->_parentObject, 'mail_id', $mail['mail_id']);
388  $link_mark_as_read = $this->ctrl->getLinkTarget($this->_parentObject, 'showMail');
389  $this->ctrl->clearParameters($this->_parentObject);
390  }
391  $css_class = $mail['m_status'] == 'read' ? 'mailread' : 'mailunread';
392 
393  if ($this->isLuceneSearchEnabled()) {
394  $search_result = array();
395  foreach ($result->getFields($mail['mail_id']) as $content) {
396  if ('title' == $content[0]) {
397  $mail['msr_subject_link_read'] = $link_mark_as_read;
398  $mail['msr_subject_mailclass'] = $css_class;
399  $mail['msr_subject'] = $content[1];
400  } else {
401  $search_result[] = $content[1];
402  }
403  }
404  $mail['msr_data'] = implode('', array_map(function ($value) {
405  return '<p>' . $value . '</p>';
406  }, $search_result));
407 
408  if (!$mail['msr_subject']) {
409  $mail['msr_subject_link_read'] = $link_mark_as_read;
410  $mail['msr_subject_mailclass'] = $css_class;
411  $mail['msr_subject'] = htmlspecialchars($mail['m_subject']);
412  }
413  } else {
414  $mail['mail_link_read'] = $link_mark_as_read;
415  $mail['mailclass'] = $css_class;
416  $mail['mail_subject'] = htmlspecialchars($mail['m_subject']);
417  }
418 
419  $mail['mail_date'] = ilDatePresentation::formatDate(new ilDateTime($mail['send_time'], IL_CAL_DATETIME));
420 
421  $data['set'][$key] = $mail;
422  }
423 
424  $this->setData($data['set']);
425  $this->setMaxCount($data['cnt']);
426  $this->setNumerOfMails($data['cnt']);
427 
428  $this->setTitleData($txt_folder, $data['cnt'], $data['cnt_unread'], $img_folder);
429 
430  return $this;
431  }
getSelectedItems()
Get all selected items public.
const IL_CAL_DATETIME
$result
static formatDate(ilDateTime $date, $a_skip_day=false, $a_include_wd=false)
Format a date public.
static _getMailBoxListData()
_getMailBoxListData
resetOffset($a_in_determination=false)
Reset offset.
setTitleData($folderLabel, $mailCount, $unreadCount, $imgFolder)
Function to set the table title protected.
getOrderDirection()
Get order direction.
setNumerOfMails($a_number_of_mails)
Set the total number of mails of the current folder public.
user()
Definition: user.php:4
isDraftFolder($a_bool=null)
Setter/Getter for folder status public.
$counter
getOffset()
Get offset.
static getImagePath($img, $module_path="", $mode="output", $offline=false)
get image path (for images located in a template directory)
static preloadUserObjects(array $usr_ids)
static getUserObjectById($usr_id)
Date and time handling
Create styles array
The data for the language used.
determineOffsetAndOrder($a_omit_offset=false)
Determine offset and order.
isSentFolder($a_bool=null)
Setter/Getter for folder status public.
getLimit()
Get limit.
static htmlencodePlainString($a_str, $a_make_links_clickable, $a_detect_goto_links=false)
Encodes a plain text string into HTML for display in a browser.
setMaxCount($a_max_count)
set max.
$key
Definition: croninfo.php:18
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ fillRow()

ilMailFolderTableGUI::fillRow (   $a_set)

Fill row public.

Parameters
array$a_setresult set array (assoc.)

Definition at line 488 of file class.ilMailFolderTableGUI.php.

References $key.

489  {
490  foreach ($a_set as $key => $value) {
491  $this->tpl->setVariable(strtoupper($key), $value);
492  }
493  }
$key
Definition: croninfo.php:18

◆ getNumerOfMails()

ilMailFolderTableGUI::getNumerOfMails ( )

Returns the total number of mails of the current folder public.

Returns
integer total number of mails of the current folder

Definition at line 477 of file class.ilMailFolderTableGUI.php.

References $_number_of_mails.

Referenced by initCommandButtons().

+ Here is the caller graph for this function:

◆ getSelectedItems()

ilMailFolderTableGUI::getSelectedItems ( )

Get all selected items public.

Returns
array

Definition at line 255 of file class.ilMailFolderTableGUI.php.

References $_selectedItems.

Referenced by fetchTableData().

+ Here is the caller graph for this function:

◆ initCommandButtons()

ilMailFolderTableGUI::initCommandButtons ( )
private

Performs special actions for folders such as user folders, trash and local folders private.

Returns
ilMailFolderTableGUI

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

References ilTable2GUI\addCommandButton(), and getNumerOfMails().

Referenced by prepareHTML().

192  {
193  if ($this->_folderNode['m_type'] == 'trash' && $this->getNumerOfMails() > 0) {
194  $this->addCommandButton('askForEmptyTrash', $this->lng->txt('mail_empty_trash'));
195  }
196 
197  return $this;
198  }
addCommandButton($a_cmd, $a_text, $a_onclick='', $a_id="", $a_class=null)
Add Command button.
getNumerOfMails()
Returns the total number of mails of the current folder public.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ initFilter()

ilMailFolderTableGUI::initFilter ( )

Definition at line 495 of file class.ilMailFolderTableGUI.php.

References ilTable2GUI\addFilterItem(), array, isDraftFolder(), isSentFolder(), ilCheckboxInputGUI\setOptionTitle(), and ilTextInputGUI\setSubmitFormOnEnter().

496  {
497  $this->filter = array();
498 
499  include_once 'Services/Mail/classes/Form/class.ilMailQuickFilterInputGUI.php';
500  $ti = new ilMailQuickFilterInputGUI($this->lng->txt('mail_filter'), 'mail_filter');
501  $ti->setSubmitFormOnEnter(false);
502  $this->addFilterItem($ti);
503  $ti->readFromSession();
504  $this->filter['mail_filter'] = $ti->getValue();
505 
506  include_once 'Services/Form/classes/class.ilCheckboxInputGUI.php';
507 
508  if ($this->isDraftFolder() || $this->isSentFolder()) {
509  $this->sub_filter[] = $ci = new ilCheckboxInputGUI($this->lng->txt('mail_filter_recipients'), 'mail_filter_recipients');
510  $ci->setOptionTitle($this->lng->txt('mail_filter_recipients'));
511  $ci->setValue(1);
512  $ti->addSubItem($ci);
513  $ci->setParent($this);
514  $ci->readFromSession();
515  $this->filter['mail_filter_recipients'] = (int) $ci->getChecked();
516  } else {
517  $this->sub_filter[] = $ci = new ilCheckboxInputGUI($this->lng->txt('mail_filter_sender'), 'mail_filter_sender');
518  $ci->setOptionTitle($this->lng->txt('mail_filter_sender'));
519  $ci->setValue(1);
520  $ti->addSubItem($ci);
521  $ci->setParent($this);
522  $ci->readFromSession();
523  $this->filter['mail_filter_sender'] = (int) $ci->getChecked();
524  }
525 
526  $this->sub_filter[] = $ci = new ilCheckboxInputGUI($this->lng->txt('mail_filter_subject'), 'mail_filter_subject');
527  $ci->setOptionTitle($this->lng->txt('mail_filter_subject'));
528  $ci->setValue(1);
529  $ti->addSubItem($ci);
530  $ci->setParent($this);
531  $ci->readFromSession();
532  $this->filter['mail_filter_subject'] = (int) $ci->getChecked();
533 
534  $this->sub_filter[] = $ci = new ilCheckboxInputGUI($this->lng->txt('mail_filter_body'), 'mail_filter_body');
535  $ci->setOptionTitle($this->lng->txt('mail_filter_body'));
536  $ci->setValue(1);
537  $ti->addSubItem($ci);
538  $ci->setParent($this);
539  $ci->readFromSession();
540  $this->filter['mail_filter_body'] = (int) $ci->getChecked();
541 
542  $this->sub_filter[] = $ci = new ilCheckboxInputGUI($this->lng->txt('mail_filter_attach'), 'mail_filter_attach');
543  $ci->setOptionTitle($this->lng->txt('mail_filter_attach'));
544  $ci->setValue(1);
545  $ti->addSubItem($ci);
546  $ci->setParent($this);
547  $ci->readFromSession();
548  $this->filter['mail_filter_attach'] = (int) $ci->getChecked();
549  }
setSubmitFormOnEnter($a_val)
Set submit form on enter.
This class represents a checkbox property in a property form.
addFilterItem($a_input_item, $a_optional=false)
Add filter item.
isDraftFolder($a_bool=null)
Setter/Getter for folder status public.
Create styles array
The data for the language used.
isSentFolder($a_bool=null)
Setter/Getter for folder status public.
setOptionTitle($a_optiontitle)
Set Option Title (optional).
+ Here is the call graph for this function:

◆ initMultiCommands()

ilMailFolderTableGUI::initMultiCommands (   $actions)
private

initMultiCommands private

Parameters
array$actionsarray for multi commands
Returns
ilMailFolderTableGUI

Definition at line 207 of file class.ilMailFolderTableGUI.php.

References $action, $key, ilTable2GUI\addMultiCommand(), and isTrashFolder().

Referenced by prepareHTML().

208  {
209  foreach ($actions as $key => $action) {
210  if ($key == 'moveMails') {
211  $folders = $this->_parentObject->mbox->getSubFolders();
212  foreach ($folders as $folder) {
213  if ($folder['type'] != 'trash' ||
214  !$this->isTrashFolder()
215  ) {
216  if ($folder['type'] != 'user_folder') {
217  $label = $action . ' ' . $this->lng->txt('mail_' . $folder['title']) .
218  ($folder['type'] == 'trash' ? ' (' . $this->lng->txt('delete') . ')' : '');
219  $this->addMultiCommand($folder['obj_id'], $label);
220  } else {
221  $this->addMultiCommand($folder['obj_id'], $action . ' ' . $folder['title']);
222  }
223  }
224  }
225  } else {
226  if ($key != 'deleteMails' || $this->isTrashFolder()) {
227  $this->addMultiCommand($key, $action);
228  }
229  }
230  }
231 
232  return $this;
233  }
$action
addMultiCommand($a_cmd, $a_text)
Add Command button.
isTrashFolder($a_bool=null)
Setter/Getter for folder status public.
$key
Definition: croninfo.php:18
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ isDraftFolder()

ilMailFolderTableGUI::isDraftFolder (   $a_bool = null)

Setter/Getter for folder status public.

Parameters
mixed$a_boolBoolean folder status or null
Returns
bool|ilMailFolderTableGUI Either an object of type ilMailFolderTableGUI or the boolean folder status

Definition at line 137 of file class.ilMailFolderTableGUI.php.

References $_isDraftsFolder.

Referenced by fetchTableData(), initFilter(), and prepareHTML().

138  {
139  if (null === $a_bool) {
140  return $this->_isDraftsFolder;
141  }
142 
143  $this->_isDraftsFolder = $a_bool;
144 
145  return $this;
146  }
+ Here is the caller graph for this function:

◆ isLuceneSearchEnabled()

ilMailFolderTableGUI::isLuceneSearchEnabled ( )
protected
Returns
bool

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

References ilSearchSettings\getInstance().

Referenced by fetchTableData(), and prepareHTML().

264  {
265  include_once 'Services/Search/classes/class.ilSearchSettings.php';
266  if (ilSearchSettings::getInstance()->enabledLucene() && strlen($this->filter['mail_filter'])) {
267  return true;
268  }
269  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ isSentFolder()

ilMailFolderTableGUI::isSentFolder (   $a_bool = null)

Setter/Getter for folder status public.

Parameters
mixed$a_boolBoolean folder status or null
Returns
bool|ilMailFolderTableGUI Either an object of type ilMailFolderTableGUI or the boolean folder status

Definition at line 155 of file class.ilMailFolderTableGUI.php.

References $_isSentFolder.

Referenced by fetchTableData(), initFilter(), and prepareHTML().

156  {
157  if (null === $a_bool) {
158  return $this->_isSentFolder;
159  }
160 
161  $this->_isSentFolder = $a_bool;
162 
163  return $this;
164  }
+ Here is the caller graph for this function:

◆ isTrashFolder()

ilMailFolderTableGUI::isTrashFolder (   $a_bool = null)

Setter/Getter for folder status public.

Parameters
mixed$a_boolBoolean folder status or null
Returns
bool|ilMailFolderTableGUI Either an object of type ilMailFolderTableGUI or the boolean folder status

Definition at line 173 of file class.ilMailFolderTableGUI.php.

References $_isTrashFolder.

Referenced by initMultiCommands().

174  {
175  if (null === $a_bool) {
176  return $this->_isTrashFolder;
177  }
178 
179  $this->_isTrashFolder = $a_bool;
180 
181  return $this;
182  }
+ Here is the caller graph for this function:

◆ prepareHTML()

ilMailFolderTableGUI::prepareHTML ( )
final

Call this before using getHTML() public.

Returns
ilMailFolderTableGUI

Definition at line 96 of file class.ilMailFolderTableGUI.php.

References ilTable2GUI\addColumn(), fetchTableData(), initCommandButtons(), initMultiCommands(), isDraftFolder(), isLuceneSearchEnabled(), isSentFolder(), ilTree\setTableNames(), and user().

97  {
98  $this->addColumn('', '', '1px', true);
99  $this->addColumn($this->lng->txt('personal_picture'), '', '10%');
100  if ($this->isDraftFolder() || $this->isSentFolder()) {
101  $this->addColumn($this->lng->txt('recipient'), 'rcp_to', '25%');
102  } else {
103  $this->addColumn($this->lng->txt('sender'), 'from', '25%');
104  }
105 
106  if ($this->isLuceneSearchEnabled()) {
107  $this->addColumn($this->lng->txt('search_content'), '', '40%');
108  } else {
109  $this->addColumn($this->lng->txt('subject'), 'm_subject', '40%');
110  }
111  $this->addColumn($this->lng->txt('date'), 'send_time', '20%');
112 
113  // init folder data
114  $mtree = new ilTree($this->user->getId());
115  $mtree->setTableNames('mail_tree', 'mail_obj_data');
116  $this->_folderNode = $mtree->getNodeData($this->_currentFolderId);
117 
118  // fetch table data
119  $this->fetchTableData();
120 
121  // command buttons
122  $this->initCommandButtons();
123 
124  // mail actions
125  $this->initMultiCommands($this->_parentObject->mbox->getActions($this->_currentFolderId));
126 
127  return $this;
128  }
user()
Definition: user.php:4
isDraftFolder($a_bool=null)
Setter/Getter for folder status public.
setTableNames($a_table_tree, $a_table_obj_data, $a_table_obj_reference="")
set table names The primary key of the table containing your object_data must be &#39;obj_id&#39; You may use...
Tree class data representation in hierachical trees using the Nested Set Model with Gaps by Joe Celco...
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.
isSentFolder($a_bool=null)
Setter/Getter for folder status public.
initCommandButtons()
Performs special actions for folders such as user folders, trash and local folders private...
initMultiCommands($actions)
initMultiCommands private
+ Here is the call graph for this function:

◆ resetFilter()

ilMailFolderTableGUI::resetFilter ( )

Reset filter.

Definition at line 569 of file class.ilMailFolderTableGUI.php.

References $_POST.

570  {
571  parent::resetFilter();
572 
573  foreach ($this->sub_filter as $item) {
574  if ($item->checkInput()) {
575  $item->setValueByArray($_POST);
576  $item->clearFromSession();
577  }
578  }
579  }
$_POST["username"]

◆ setNumerOfMails()

ilMailFolderTableGUI::setNumerOfMails (   $a_number_of_mails)

Set the total number of mails of the current folder public.

Parameters
integer$a_number_of_mailstotal number of mails of the current folder
Returns
ilMailFolderTableGUI

Definition at line 464 of file class.ilMailFolderTableGUI.php.

Referenced by fetchTableData().

465  {
466  $this->_number_of_mails = $a_number_of_mails;
467 
468  return $this;
469  }
+ Here is the caller graph for this function:

◆ setSelectedItems()

ilMailFolderTableGUI::setSelectedItems (   $a_selected_items)

Set the selected items public.

Parameters
integer$a_selected_itemsselected items
Returns
ilMailFolderTableGUI

Definition at line 242 of file class.ilMailFolderTableGUI.php.

243  {
244  $this->_selectedItems = $a_selected_items;
245 
246  return $this;
247  }

◆ setTitleData()

ilMailFolderTableGUI::setTitleData (   $folderLabel,
  $mailCount,
  $unreadCount,
  $imgFolder 
)
protected

Function to set the table title protected.

Parameters
string$folderLabeltable title
integer$mailCountnumber of total mails of the current folder
integer$unreadCountnumber of unread mails of the current folder
string$imgFolderimage path
Returns
ilMailFolderTableGUI

Definition at line 443 of file class.ilMailFolderTableGUI.php.

Referenced by fetchTableData().

444  {
445  $titleTemplate = new ilTemplate('tpl.mail_folder_title.html', true, true, 'Services/Mail');
446  $titleTemplate->setVariable('TXT_FOLDER', $folderLabel);
447  $titleTemplate->setVariable('MAIL_COUNT', $mailCount);
448  $titleTemplate->setVariable('TXT_MAIL_S', $this->lng->txt('mail_s'));
449  $titleTemplate->setVariable('MAIL_COUNT_UNREAD', $unreadCount);
450  $titleTemplate->setVariable('TXT_UNREAD', $this->lng->txt('unread'));
451 
452  parent::setTitle($titleTemplate->get(), $imgFolder);
453 
454  return $this;
455  }
special template class to simplify handling of ITX/PEAR
+ Here is the caller graph for this function:

◆ writeFilterToSession()

ilMailFolderTableGUI::writeFilterToSession ( )

Write filter values to session.

Definition at line 554 of file class.ilMailFolderTableGUI.php.

References $_POST.

555  {
556  parent::writeFilterToSession();
557 
558  foreach ($this->sub_filter as $item) {
559  if ($item->checkInput()) {
560  $item->setValueByArray($_POST);
561  $item->writeToSession();
562  }
563  }
564  }
$_POST["username"]

Field Documentation

◆ $_currentFolderId

ilMailFolderTableGUI::$_currentFolderId = 0
protected

Definition at line 33 of file class.ilMailFolderTableGUI.php.

Referenced by fetchTableData().

◆ $_folderNode

ilMailFolderTableGUI::$_folderNode = array()
protected

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

◆ $_isDraftsFolder

ilMailFolderTableGUI::$_isDraftsFolder = false
protected

Definition at line 37 of file class.ilMailFolderTableGUI.php.

Referenced by isDraftFolder().

◆ $_isSentFolder

ilMailFolderTableGUI::$_isSentFolder = false
protected

Definition at line 38 of file class.ilMailFolderTableGUI.php.

Referenced by isSentFolder().

◆ $_isTrashFolder

ilMailFolderTableGUI::$_isTrashFolder = false
protected

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

Referenced by isTrashFolder().

◆ $_number_of_mails

ilMailFolderTableGUI::$_number_of_mails = 0
protected

Definition at line 34 of file class.ilMailFolderTableGUI.php.

Referenced by getNumerOfMails().

◆ $_parentObject

ilMailFolderTableGUI::$_parentObject = null
protected

Definition at line 32 of file class.ilMailFolderTableGUI.php.

◆ $_selectedItems

ilMailFolderTableGUI::$_selectedItems = array()
protected

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

Referenced by getSelectedItems().

◆ $ctrl

ilMailFolderTableGUI::$ctrl
protected

Definition at line 24 of file class.ilMailFolderTableGUI.php.

◆ $filter

ilMailFolderTableGUI::$filter = array()
protected

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

◆ $lng

ilMailFolderTableGUI::$lng
protected

Definition at line 19 of file class.ilMailFolderTableGUI.php.

◆ $sub_filter

ilMailFolderTableGUI::$sub_filter = array()
protected

Definition at line 48 of file class.ilMailFolderTableGUI.php.

◆ $user

ilMailFolderTableGUI::$user
protected

Definition at line 29 of file class.ilMailFolderTableGUI.php.

Referenced by fetchTableData().


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