ILIAS  release_9 Revision v9.13-25-g2c18ec4c24f
ilForumThreadFormGUI Class Reference

Class ilForumThreadFormGUI. More...

+ Inheritance diagram for ilForumThreadFormGUI:
+ Collaboration diagram for ilForumThreadFormGUI:

Public Member Functions

 __construct (private ilObjForumGUI $delegatingGui, private ilForumProperties $properties, private bool $allowPseudonyms, private bool $allowNotification, private bool $isDraftContext, private int $draftId)
 
 addInputItem (string $input_item)
 
 generateDefaultForm ()
 
 generateMinimalForm ()
 
- Public Member Functions inherited from ilPropertyFormGUI
 __construct ()
 
 executeCommand ()
 
 setTableWidth (string $a_width)
 
 getTableWidth ()
 
 setMode (string $a_mode)
 
 getMode ()
 
 setTitle (string $a_title)
 
 getTitle ()
 
 setTitleIcon (string $a_titleicon)
 
 getTitleIcon ()
 
 setDescription (string $a_val)
 
 getDescription ()
 
 setTopAnchor (string $a_val)
 
 getTopAnchor ()
 
 setShowTopButtons (bool $a_val)
 
 getShowTopButtons ()
 
 setForceTopButtons (bool $a_val)
 
 getForceTopButtons ()
 
 addItem ($a_item)
 
 removeItemByPostVar (string $a_post_var, bool $a_remove_unused_headers=false)
 
 getItemByPostVar (string $a_post_var)
 
 setItems (array $a_items)
 
 getItems ()
 
 getInputItemsRecursive ()
 returns a flat array of all input items including the possibly existing subitems recursively More...
 
 setDisableStandardMessage (bool $a_val)
 
 getDisableStandardMessage ()
 
 getHideLabels ()
 
 setHideLabels (bool $a_value=true)
 
 setValuesByArray (array $a_values, bool $a_restrict_to_value_keys=false)
 
 setValuesByPost ()
 
 checkInput ()
 
 getInput (string $a_post_var, bool $ensureValidation=true)
 Returns the input of an item, if item provides getInput method and as fallback the value of the HTTP-POST variable, identified by the passed postvar. More...
 
 addCommandButton (string $a_cmd, string $a_text, string $a_id="")
 
 getCommandButtons ()
 
 clearCommandButtons ()
 
 getContent ()
 
 insertItem ( $item, bool $a_sub_item=false)
 
 addAsyncOnloadCode (string $code)
 
 getHTML ()
 
 getHTMLAsync ()
 
 getFileUpload (string $a_field, ?string $a_index=null, ?string $a_sub_index=null)
 Get file upload data. More...
 
 hasFileUpload (string $a_field, ?string $a_index=null, ?string $a_sub_index=null)
 
 moveFileUpload (string $a_target_directory, string $a_field, ?string $a_target_name=null, ?string $a_index=null, ?string $a_sub_index=null)
 Move upload to target directory. More...
 
- Public Member Functions inherited from ilFormGUI
 setFormAction (string $a_formaction)
 
 getFormAction ()
 
 setTarget (string $a_target)
 
 getTarget ()
 
 setMultipart (bool $a_multipart)
 
 getMultipart ()
 
 setId (string $a_id)
 
 getId ()
 
 setName (string $a_name)
 
 getName ()
 
 setKeepOpen (bool $a_keepopen)
 
 getKeepOpen ()
 
 setOpenTag (bool $a_open)
 
 getOpenTag ()
 
 setCloseTag (bool $a_val)
 
 getCloseTag ()
 
 setPreventDoubleSubmission (bool $a_val)
 
 getPreventDoubleSubmission ()
 
 getHTML ()
 
 getContent ()
 

Data Fields

const ALIAS_INPUT = 'alias'
 
const SUBJECT_INPUT = 'subject'
 
const MESSAGE_INPUT = 'message'
 
const FILE_UPLOAD_INPUT = 'file_upload'
 
const ALLOW_NOTIFICATION_INPUT = 'allow_notification'
 
const AUTOSAVE_INFO = 'autosave_info'
 

Private Member Functions

 addAliasInput ()
 
 addSubjectInput ()
 
 addMessageInput ()
 
 addAutosaveInfo ()
 
 addFileUploadInput ()
 
 addAllowNotificationInput ()
 
 generateInputItems ()
 

Private Attributes

array $input_items = []
 

Additional Inherited Members

- Protected Member Functions inherited from ilPropertyFormGUI
 getRequestedPostVar ()
 
 getFileHash ()
 
 hideRequired (string $a_type)
 
 appendOnloadCode (string $html)
 
 rebuildUploadedFiles ()
 
 checkForRequiredField ()
 
- Protected Attributes inherited from ilPropertyFormGUI
bool $required_text = false
 
ilLanguage $lng
 
ilCtrl $ctrl
 
ilTemplate $tpl
 
ilObjUser $user = null
 
ilSetting $settings = null
 
string $mode = "std"
 
bool $check_input_called = false
 
bool $disable_standard_message = false
 
string $top_anchor = "il_form_top"
 
string $title = ''
 
string $titleicon = ""
 
string $description = ""
 
string $tbl_width = ""
 
bool $show_top_buttons = true
 
bool $hide_labels = false
 
bool $force_top_buttons = false
 
HTTP Services $http
 
Refinery Factory $refinery = null
 
ilGlobalTemplateInterface $global_tpl = null
 
 $onload_code = []
 
- Protected Attributes inherited from ilFormGUI
string $formaction = ""
 
bool $multipart = false
 
bool $keepopen = false
 
bool $opentag = true
 
string $id = ''
 
string $name = ''
 
string $target = ''
 
bool $prevent_double_submission = false
 

Detailed Description

Class ilForumThreadFormGUI.

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

Constructor & Destructor Documentation

◆ __construct()

ilForumThreadFormGUI::__construct ( private ilObjForumGUI  $delegatingGui,
private ilForumProperties  $properties,
private bool  $allowPseudonyms,
private bool  $allowNotification,
private bool  $isDraftContext,
private int  $draftId 
)

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

References ILIAS\MetaData\Repository\Validation\Data\__construct().

43  {
45  }
__construct(VocabulariesInterface $vocabularies)
+ Here is the call graph for this function:

Member Function Documentation

◆ addAliasInput()

ilForumThreadFormGUI::addAliasInput ( )
private

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

References ilPropertyFormGUI\addItem(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

Referenced by generateInputItems().

47  : void
48  {
49  if ($this->allowPseudonyms) {
50  $alias = new ilTextInputGUI($this->lng->txt('forums_your_name'), 'alias');
51  $alias->setInfo($this->lng->txt('forums_use_alias'));
52  $alias->setMaxLength(255);
53  $alias->setSize(50);
54  } else {
55  $alias = new ilNonEditableValueGUI($this->lng->txt('forums_your_name'), 'alias');
56  $alias->setValue($this->user->getLogin());
57  }
58  $this->addItem($alias);
59  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ addAllowNotificationInput()

ilForumThreadFormGUI::addAllowNotificationInput ( )
private

Definition at line 145 of file class.ilForumThreadFormGUI.php.

References ilPropertyFormGUI\addItem(), and ILIAS\Repository\lng().

Referenced by generateInputItems().

145  : void
146  {
147  if ($this->allowNotification) {
148  $notifyOnAnswer = new ilCheckboxInputGUI($this->lng->txt('forum_direct_notification'), 'notify');
149  $notifyOnAnswer->setInfo($this->lng->txt('forum_notify_me'));
150  $notifyOnAnswer->setValue('1');
151  $this->addItem($notifyOnAnswer);
152  }
153  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ addAutosaveInfo()

ilForumThreadFormGUI::addAutosaveInfo ( )
private

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

References ilPropertyFormGUI\addItem(), ilForumPostDraft\isAutoSavePostDraftAllowed(), ILIAS\Repository\lng(), and ilForumPostDraft\lookupAutosaveInterval().

Referenced by generateInputItems().

104  : void
105  {
107  $draftInfoGUI = new ilNonEditableValueGUI('', 'autosave_info', true);
108  $draftInfoGUI->setValue(
109  sprintf(
110  $this->lng->txt('autosave_draft_info'),
112  )
113  );
114  $this->addItem($draftInfoGUI);
115  }
116  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ addFileUploadInput()

ilForumThreadFormGUI::addFileUploadInput ( )
private

Definition at line 118 of file class.ilForumThreadFormGUI.php.

References ilPropertyFormGUI\addItem(), ilCheckboxGroupInputGUI\addOption(), ILIAS\Repository\lng(), ilForumPostDraft\newInstanceByDraftId(), and ilFileWizardInputGUI\setFilenames().

Referenced by generateInputItems().

118  : void
119  {
120  if ($this->properties->isFileUploadAllowed()) {
121  $files = new ilFileWizardInputGUI($this->lng->txt('forums_attachments_add'), 'userfile');
122  $files->setFilenames([0 => '']);
123  $this->addItem($files);
124 
125  if ($this->isDraftContext && $this->draftId > 0) {
126  $threadDraft = ilForumPostDraft::newInstanceByDraftId($this->draftId);
127  if ($threadDraft->getDraftId() > 0) {
128  //
129  $draftFileData = new ilFileDataForumDrafts(0, $threadDraft->getDraftId());
130  if ($draftFileData->getFilesOfPost() !== []) {
131  $existingFileSelection = new ilCheckboxGroupInputGUI(
132  $this->lng->txt('forums_delete_file'),
133  'del_file'
134  );
135  foreach ($draftFileData->getFilesOfPost() as $file) {
136  $existingFileSelection->addOption(new ilCheckboxOption($file['name'], $file['md5']));
137  }
138  $this->addItem($existingFileSelection);
139  }
140  }
141  }
142  }
143  }
setFilenames(array $a_filenames)
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
This class represents a file wizard property in a property form.
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
static newInstanceByDraftId(int $draft_id)
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ addInputItem()

ilForumThreadFormGUI::addInputItem ( string  $input_item)

Definition at line 193 of file class.ilForumThreadFormGUI.php.

193  : void
194  {
195  $this->input_items[] = $input_item;
196  }

◆ addMessageInput()

ilForumThreadFormGUI::addMessageInput ( )
private

Definition at line 70 of file class.ilForumThreadFormGUI.php.

References $message, ilPropertyFormGUI\addItem(), ilHtmlPurifierFactory\getInstanceByType(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

Referenced by generateInputItems().

70  : void
71  {
72  $message = new ilTextAreaInputGUI($this->lng->txt('forums_the_post'), 'message');
73  $message->setCols(50);
74  $message->setRows(15);
75  $message->setRequired(true);
76  $message->setUseRte(true);
77  $message->addPlugin('latex');
78  $message->addButton('latex');
79  $message->addButton('pastelatex');
80  $message->addPlugin('ilfrmquote');
81  $message->usePurifier(true);
82  $message->setRTERootBlockElement('');
83  $message->setRTESupport($this->user->getId(), 'frm~', 'frm_post', 'tpl.tinymce_frm_post.js', false, '5.6.0');
84  $message->disableButtons([
85  'charmap',
86  'undo',
87  'redo',
88  'alignleft',
89  'aligncenter',
90  'alignright',
91  'alignjustify',
92  'anchor',
93  'fullscreen',
94  'cut',
95  'copy',
96  'paste',
97  'pastetext',
98  'formatselect'
99  ]);
100  $message->setPurifier(ilHtmlPurifierFactory::getInstanceByType('frm_post'));
101  $this->addItem($message);
102  }
static getInstanceByType(string $type)
This class represents a text area property in a property form.
$message
Definition: xapiexit.php:32
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ addSubjectInput()

ilForumThreadFormGUI::addSubjectInput ( )
private

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

References ilPropertyFormGUI\addItem(), and ILIAS\Repository\lng().

Referenced by generateInputItems().

61  : void
62  {
63  $subject = new ilTextInputGUI($this->lng->txt('forums_thread'), 'subject');
64  $subject->setMaxLength(255);
65  $subject->setSize(50);
66  $subject->setRequired(true);
67  $this->addItem($subject);
68  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ generateDefaultForm()

ilForumThreadFormGUI::generateDefaultForm ( )

Definition at line 198 of file class.ilForumThreadFormGUI.php.

References ilPropertyFormGUI\addCommandButton(), ILIAS\Repository\ctrl(), generateInputItems(), ilForumPostDraft\isSavePostDraftAllowed(), ILIAS\Repository\lng(), ilFormGUI\setFormAction(), and ILIAS\Repository\user().

198  : void
199  {
200  $this->generateInputItems();
201 
202  if (ilForumPostDraft::isSavePostDraftAllowed() && !$this->user->isAnonymous()) {
203  $this->ctrl->setParameter($this->delegatingGui, 'draft_id', $this->draftId);
204  if (in_array($this->ctrl->getCmd(), ['publishThreadDraft', 'editThreadDraft', 'updateThreadDraft'])) {
205  $this->addCommandButton('publishThreadDraft', $this->lng->txt('publish'));
206  $this->addCommandButton('updateThreadDraft', $this->lng->txt('save_message'));
207  $this->setFormAction($this->ctrl->getFormAction($this->delegatingGui, 'updateThreadDraft'));
208  } else {
209  $this->addCommandButton('addThread', $this->lng->txt('create'));
210  $this->addCommandButton('saveThreadAsDraft', $this->lng->txt('save_message'));
211  $this->setFormAction($this->ctrl->getFormAction($this->delegatingGui, 'saveThreadAsDraft'));
212  }
213  $this->addCommandButton('cancelDraft', $this->lng->txt('cancel'));
214  } else {
215  $this->addCommandButton('addThread', $this->lng->txt('create'));
216  $this->addCommandButton('showThreads', $this->lng->txt('cancel'));
217  $this->setFormAction($this->ctrl->getFormAction($this->delegatingGui, 'addThread'));
218  }
219  }
setFormAction(string $a_formaction)
addCommandButton(string $a_cmd, string $a_text, string $a_id="")
+ Here is the call graph for this function:

◆ generateInputItems()

ilForumThreadFormGUI::generateInputItems ( )
private

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

References addAliasInput(), addAllowNotificationInput(), addAutosaveInfo(), addFileUploadInput(), addMessageInput(), addSubjectInput(), ilUtil\getImagePath(), ILIAS\Repository\lng(), ilPropertyFormGUI\setTableWidth(), ilPropertyFormGUI\setTitle(), and ilPropertyFormGUI\setTitleIcon().

Referenced by generateDefaultForm(), and generateMinimalForm().

155  : void
156  {
157  $this->setTitleIcon(ilUtil::getImagePath('standard/icon_frm.svg'));
158  $this->setTableWidth('100%');
159  $this->setTitle($this->lng->txt('forums_new_thread'));
160  if ($this->isDraftContext) {
161  $this->setTitle($this->lng->txt('edit_thread_draft'));
162  }
163 
164  foreach ($this->input_items as $input_item) {
165  switch ($input_item) {
166  case self::ALIAS_INPUT:
167  $this->addAliasInput();
168  break;
169 
170  case self::SUBJECT_INPUT:
171  $this->addSubjectInput();
172  break;
173 
174  case self::MESSAGE_INPUT:
175  $this->addMessageInput();
176  break;
177 
178  case self::FILE_UPLOAD_INPUT:
179  $this->addFileUploadInput();
180  break;
181 
182  case self::ALLOW_NOTIFICATION_INPUT:
183  $this->addAllowNotificationInput();
184  break;
185 
186  case self::AUTOSAVE_INFO:
187  $this->addAutosaveInfo();
188  break;
189  }
190  }
191  }
static getImagePath(string $img, string $module_path="", string $mode="output", bool $offline=false)
get image path (for images located in a template directory)
setTitleIcon(string $a_titleicon)
setTableWidth(string $a_width)
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ generateMinimalForm()

ilForumThreadFormGUI::generateMinimalForm ( )

Definition at line 221 of file class.ilForumThreadFormGUI.php.

References ilPropertyFormGUI\addCommandButton(), ILIAS\Repository\ctrl(), generateInputItems(), ILIAS\Repository\lng(), and ilFormGUI\setFormAction().

221  : void
222  {
223  $this->generateInputItems();
224 
225  $this->addCommandButton('addEmptyThread', $this->lng->txt('create'));
226  $this->addCommandButton('showThreads', $this->lng->txt('cancel'));
227  $this->setFormAction($this->ctrl->getFormAction($this->delegatingGui, 'addThread'));
228  }
setFormAction(string $a_formaction)
addCommandButton(string $a_cmd, string $a_text, string $a_id="")
+ Here is the call graph for this function:

Field Documentation

◆ $input_items

array ilForumThreadFormGUI::$input_items = []
private

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

◆ ALIAS_INPUT

const ilForumThreadFormGUI::ALIAS_INPUT = 'alias'

◆ ALLOW_NOTIFICATION_INPUT

const ilForumThreadFormGUI::ALLOW_NOTIFICATION_INPUT = 'allow_notification'

Definition at line 30 of file class.ilForumThreadFormGUI.php.

Referenced by ilObjForumGUI\buildThreadForm().

◆ AUTOSAVE_INFO

const ilForumThreadFormGUI::AUTOSAVE_INFO = 'autosave_info'

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

Referenced by ilObjForumGUI\buildThreadForm().

◆ FILE_UPLOAD_INPUT

const ilForumThreadFormGUI::FILE_UPLOAD_INPUT = 'file_upload'

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

Referenced by ilObjForumGUI\buildThreadForm().

◆ MESSAGE_INPUT

const ilForumThreadFormGUI::MESSAGE_INPUT = 'message'

Definition at line 28 of file class.ilForumThreadFormGUI.php.

Referenced by ilObjForumGUI\buildThreadForm().

◆ SUBJECT_INPUT

const ilForumThreadFormGUI::SUBJECT_INPUT = 'subject'

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