ILIAS  trunk Revision v11.0_alpha-1713-gd8962da2f67
All Data Structures Namespaces Files Functions Variables Enumerations Enumerator Modules Pages
ilForumThreadFormGUI Class Reference
+ Inheritance diagram for ilForumThreadFormGUI:
+ Collaboration diagram for ilForumThreadFormGUI:

Public Member Functions

 __construct (private readonly ilObjForumGUI $delegatingGui, private readonly ilForumProperties $properties, private readonly bool $allowPseudonyms, private readonly bool $allowNotification, private readonly bool $isDraftContext, private readonly 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

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

Constructor & Destructor Documentation

◆ __construct()

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

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

References ILIAS\GlobalScreen\Provider\__construct().

40  {
42  }
__construct(Container $dic, ilPlugin $plugin)
+ Here is the call graph for this function:

Member Function Documentation

◆ addAliasInput()

ilForumThreadFormGUI::addAliasInput ( )
private

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

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

Referenced by generateInputItems().

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

◆ addAllowNotificationInput()

ilForumThreadFormGUI::addAllowNotificationInput ( )
private

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

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

Referenced by generateInputItems().

138  : void
139  {
140  if ($this->allowNotification) {
141  $notifyOnAnswer = new ilCheckboxInputGUI($this->lng->txt('forum_direct_notification'), 'notify');
142  $notifyOnAnswer->setInfo($this->lng->txt('forum_notify_me'));
143  $notifyOnAnswer->setValue('1');
144  $this->addItem($notifyOnAnswer);
145  }
146  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ addAutosaveInfo()

ilForumThreadFormGUI::addAutosaveInfo ( )
private

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

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

Referenced by generateInputItems().

97  : void
98  {
100  $draftInfoGUI = new ilNonEditableValueGUI('', 'autosave_info', true);
101  $draftInfoGUI->setValue(
102  sprintf(
103  $this->lng->txt('autosave_draft_info'),
105  )
106  );
107  $this->addItem($draftInfoGUI);
108  }
109  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ addFileUploadInput()

ilForumThreadFormGUI::addFileUploadInput ( )
private

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

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

Referenced by generateInputItems().

111  : void
112  {
113  if ($this->properties->isFileUploadAllowed()) {
114  $files = new ilFileWizardInputGUI($this->lng->txt('forums_attachments_add'), 'userfile');
115  $files->setFilenames([0 => '']);
116  $this->addItem($files);
117 
118  if ($this->isDraftContext && $this->draftId > 0) {
119  $threadDraft = ilForumPostDraft::newInstanceByDraftId($this->draftId);
120  if ($threadDraft->getDraftId() > 0) {
121  //
122  $draftFileData = new ilFileDataForumDrafts(0, $threadDraft->getDraftId());
123  if ($draftFileData->getFilesOfPost() !== []) {
124  $existingFileSelection = new ilCheckboxGroupInputGUI(
125  $this->lng->txt('forums_delete_file'),
126  'del_file'
127  );
128  foreach ($draftFileData->getFilesOfPost() as $file) {
129  $existingFileSelection->addOption(new ilCheckboxOption($file['name'], $file['md5']));
130  }
131  $this->addItem($existingFileSelection);
132  }
133  }
134  }
135  }
136  }
setFilenames(array $a_filenames)
This class represents an option in a checkbox group.
This class represents a file wizard property in a property form.
This class represents a property in a property form.
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 186 of file class.ilForumThreadFormGUI.php.

186  : void
187  {
188  $this->input_items[] = $input_item;
189  }

◆ addMessageInput()

ilForumThreadFormGUI::addMessageInput ( )
private

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

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

Referenced by generateInputItems().

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

◆ addSubjectInput()

ilForumThreadFormGUI::addSubjectInput ( )
private

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

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

Referenced by generateInputItems().

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

◆ generateDefaultForm()

ilForumThreadFormGUI::generateDefaultForm ( )

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

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

191  : void
192  {
193  $this->generateInputItems();
194 
195  if (ilForumPostDraft::isSavePostDraftAllowed() && !$this->user->isAnonymous()) {
196  $this->ctrl->setParameter($this->delegatingGui, 'draft_id', $this->draftId);
197  if (in_array($this->ctrl->getCmd(), ['publishThreadDraft', 'editThreadDraft', 'updateThreadDraft'])) {
198  $this->addCommandButton('publishThreadDraft', $this->lng->txt('publish'));
199  $this->addCommandButton('updateThreadDraft', $this->lng->txt('save_message'));
200  $this->setFormAction($this->ctrl->getFormAction($this->delegatingGui, 'updateThreadDraft'));
201  } else {
202  $this->addCommandButton('addThread', $this->lng->txt('create'));
203  $this->addCommandButton('saveThreadAsDraft', $this->lng->txt('save_message'));
204  $this->setFormAction($this->ctrl->getFormAction($this->delegatingGui, 'saveThreadAsDraft'));
205  }
206  $this->addCommandButton('cancelDraft', $this->lng->txt('cancel'));
207  } else {
208  $this->addCommandButton('addThread', $this->lng->txt('create'));
209  $this->addCommandButton('showThreads', $this->lng->txt('cancel'));
210  $this->setFormAction($this->ctrl->getFormAction($this->delegatingGui, 'addThread'));
211  }
212  }
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 148 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().

148  : void
149  {
150  $this->setTitleIcon(ilUtil::getImagePath('standard/icon_frm.svg'));
151  $this->setTableWidth('100%');
152  $this->setTitle($this->lng->txt('forums_new_thread'));
153  if ($this->isDraftContext) {
154  $this->setTitle($this->lng->txt('edit_thread_draft'));
155  }
156 
157  foreach ($this->input_items as $input_item) {
158  switch ($input_item) {
159  case self::ALIAS_INPUT:
160  $this->addAliasInput();
161  break;
162 
163  case self::SUBJECT_INPUT:
164  $this->addSubjectInput();
165  break;
166 
167  case self::MESSAGE_INPUT:
168  $this->addMessageInput();
169  break;
170 
171  case self::FILE_UPLOAD_INPUT:
172  $this->addFileUploadInput();
173  break;
174 
175  case self::ALLOW_NOTIFICATION_INPUT:
176  $this->addAllowNotificationInput();
177  break;
178 
179  case self::AUTOSAVE_INFO:
180  $this->addAutosaveInfo();
181  break;
182  }
183  }
184  }
static getImagePath(string $image_name, 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 214 of file class.ilForumThreadFormGUI.php.

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

214  : void
215  {
216  $this->generateInputItems();
217 
218  $this->addCommandButton('addEmptyThread', $this->lng->txt('create'));
219  $this->addCommandButton('showThreads', $this->lng->txt('cancel'));
220  $this->setFormAction($this->ctrl->getFormAction($this->delegatingGui, 'addThread'));
221  }
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 31 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 27 of file class.ilForumThreadFormGUI.php.

Referenced by ilObjForumGUI\buildThreadForm().

◆ AUTOSAVE_INFO

const ilForumThreadFormGUI::AUTOSAVE_INFO = 'autosave_info'

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

◆ FILE_UPLOAD_INPUT

const ilForumThreadFormGUI::FILE_UPLOAD_INPUT = 'file_upload'

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

Referenced by ilObjForumGUI\buildThreadForm().

◆ MESSAGE_INPUT

const ilForumThreadFormGUI::MESSAGE_INPUT = 'message'

Definition at line 25 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: