ILIAS  release_5-2 Revision v5.2.25-18-g3f80b828510
ilObjAdvancedEditing Class Reference

Class ilObjAdvancedEditing. More...

+ Inheritance diagram for ilObjAdvancedEditing:
+ Collaboration diagram for ilObjAdvancedEditing:

Public Member Functions

 __construct ($a_id=0, $a_call_by_reference=true)
 Constructor public. More...
 
 update ()
 update object data More...
 
 delete ()
 delete object and all related data More...
 
 setRichTextEditor ($a_js_editor)
 Sets wheather a Rich Text Editor should be used or not. More...
 
 setUsedHTMLTags ($a_html_tags, $a_module)
 Writes an array with allowed HTML tags to the ILIAS settings. More...
 
getHTMLTags ()
 Returns an array of all possible HTML tags for text editing. More...
 
- Public Member Functions inherited from ilObject
 __construct ($a_id=0, $a_reference=true)
 Constructor public. More...
 
 withReferences ()
 determines wehter objects are referenced or not (got ref ids or not) More...
 
 read ()
 read object data from db into object More...
 
 getId ()
 get object id public More...
 
 setId ($a_id)
 set object id public More...
 
 setRefId ($a_id)
 set reference id public More...
 
 getRefId ()
 get reference id public More...
 
 getType ()
 get object type public More...
 
 setType ($a_type)
 set object type public More...
 
 getPresentationTitle ()
 get presentation title Normally same as title Overwritten for sessions More...
 
 getTitle ()
 get object title public More...
 
 getUntranslatedTitle ()
 get untranslated object title public More...
 
 setTitle ($a_title)
 set object title More...
 
 getDescription ()
 get object description More...
 
 setDescription ($a_desc)
 set object description More...
 
 getLongDescription ()
 get object long description (stored in object_description) More...
 
 getImportId ()
 get import id More...
 
 setImportId ($a_import_id)
 set import id More...
 
 getOwner ()
 get object owner More...
 
 getOwnerName ()
 
 setOwner ($a_owner)
 set object owner More...
 
 getCreateDate ()
 get create date public More...
 
 getLastUpdateDate ()
 get last update date public More...
 
 getDiskUsage ()
 Gets the disk usage of the object in bytes. More...
 
 create ()
 create More...
 
 update ()
 update object in db More...
 
 MDUpdateListener ($a_element)
 Meta data update listener. More...
 
 createMetaData ()
 create meta data entry More...
 
 updateMetaData ()
 update meta data entry More...
 
 deleteMetaData ()
 delete meta data entry More...
 
 updateOwner ()
 update owner of object in db More...
 
 putInTree ($a_parent_ref)
 maybe this method should be in tree object!? More...
 
 setPermissions ($a_parent_ref)
 set permissions of object More...
 
 setParentRolePermissions ($a_parent_ref)
 Initialize the permissions of parent roles (local roles of categories, global roles...) This method is overwritten in e.g courses, groups for building permission intersections with non_member templates. More...
 
 createReference ()
 creates reference for object More...
 
 countReferences ()
 count references of object More...
 
 delete ()
 delete object or referenced object (in the case of a referenced object, object data is only deleted if last reference is deleted) This function removes an object entirely from system!! More...
 
 initDefaultRoles ()
 init default roles settings Purpose of this function is to create a local role folder and local roles, that are needed depending on the object type If you want to setup default local roles you MUST overwrite this method in derived object classes (see ilObjForum for an example) public More...
 
 applyDidacticTemplate ($a_tpl_id)
 Apply template. More...
 
 setRegisterMode ($a_bool)
 
 isUserRegistered ($a_user_id=0)
 
 requireRegistration ()
 
 getXMLZip ()
 
 getHTMLDirectory ()
 
 cloneObject ($a_target_id, $a_copy_id=0, $a_omit_tree=false)
 Clone object permissions, put in tree ... More...
 
 appendCopyInfo ($a_target_id, $a_copy_id)
 Prepend Copy info if object with same name exists in that container. More...
 
 cloneDependencies ($a_target_id, $a_copy_id)
 Clone object dependencies. More...
 
 cloneMetaData ($target_obj)
 Copy meta data. More...
 
 getPossibleSubObjects ($a_filter=true)
 get all possible subobjects of this type the object can decide which types of subobjects are possible jut in time overwrite if the decision distinguish from standard model More...
 

Static Public Member Functions

static _getUsedHTMLTags ($a_module="")
 Returns an array of all allowed HTML tags for text editing. More...
 
static _getUsedHTMLTagsAsString ($a_module="")
 Returns a string of all allowed HTML tags for text editing. More...
 
static _getRichTextEditor ()
 Returns the identifier for the Rich Text Editor. More...
 
static _getAllHTMLTags ()
 Returns an array of all possible HTML tags for text editing. More...
 
static _setRichTextEditorUserState ($a_state)
 Sets the state of the rich text editor visibility for the current user. More...
 
static _getRichTextEditorUserState ()
 Gets the state of the rich text editor visibility for the current user. More...
 
- Static Public Member Functions inherited from ilObject
static _lookupObjIdByImportId ($a_import_id)
 
static _lookupImportId ($a_obj_id)
 
static _lookupOwnerName ($a_owner_id)
 lookup owner name for owner id More...
 
static _getIdForImportId ($a_import_id)
 get current object id for import id (static) More...
 
static _getAllReferences ($a_id)
 get all reference ids of object More...
 
static _lookupTitle ($a_id)
 lookup object title More...
 
static _lookupOwner ($a_id)
 lookup object owner More...
 
static _getIdsForTitle ($title, $type='', $partialmatch=false)
 
static _lookupDescription ($a_id)
 lookup object description More...
 
static _lookupLastUpdate ($a_id, $a_as_string=false)
 lookup last update More...
 
static _getLastUpdateOfObjects ($a_objs)
 Get last update for a set of media objects. More...
 
static _lookupObjId ($a_id)
 
static _setDeletedDate ($a_ref_id)
 only called in ilTree::saveSubTree More...
 
static setDeletedDates ($a_ref_ids)
 Set deleted date type $ilDB. More...
 
static _resetDeletedDate ($a_ref_id)
 only called in ilObjectGUI::insertSavedNodes More...
 
static _lookupDeletedDate ($a_ref_id)
 only called in ilObjectGUI::insertSavedNodes More...
 
static _writeTitle ($a_obj_id, $a_title)
 write title to db (static) More...
 
static _writeDescription ($a_obj_id, $a_desc)
 write description to db (static) More...
 
static _writeImportId ($a_obj_id, $a_import_id)
 write import id to db (static) More...
 
static _lookupType ($a_id, $a_reference=false)
 lookup object type More...
 
static _isInTrash ($a_ref_id)
 checks wether object is in trash More...
 
static _hasUntrashedReference ($a_obj_id)
 checks wether an object has at least one reference that is not in trash More...
 
static _lookupObjectId ($a_ref_id)
 lookup object id More...
 
static _getObjectsDataForType ($a_type, $a_omit_trash=false)
 get all objects of a certain type More...
 
static _exists ($a_id, $a_reference=false, $a_type=null)
 checks if an object exists in object_data More...
 
static _getObjectsByType ($a_obj_type="", $a_owner="")
 Get objects by type. More...
 
static _prepareCloneSelection ($a_ref_ids, $new_type, $show_path=true)
 Prepare copy wizard object selection. More...
 
static _getIcon ($a_obj_id="", $a_size="big", $a_type="", $a_offline=false)
 Get icon for repository item. More...
 
static collectDeletionDependencies (&$deps, $a_ref_id, $a_obj_id, $a_type, $a_depth=0)
 Collect deletion dependencies. More...
 
static getDeletionDependencies ($a_obj_id)
 Get deletion dependencies. More...
 
static getLongDescriptions (array $a_obj_ids)
 Get long description data. More...
 
static getAllOwnedRepositoryObjects ($a_user_id)
 Get all ids of objects user owns. More...
 
static fixMissingTitles ($a_type, array &$a_obj_title_map)
 Try to fix missing object titles. More...
 
static _lookupCreationDate ($a_id)
 Lookup creation date. More...
 
static hasAutoRating ($a_type, $a_ref_id)
 Check if auto rating is active for parent group/course. More...
 

Data Fields

 $setting
 
- Data Fields inherited from ilObject
const TITLE_LENGTH = 255
 max length of object title More...
 
const DESC_LENGTH = 128
 
 $ilias
 
 $lng
 
 $id
 
 $ref_id
 
 $type
 
 $title
 
 $untranslatedTitle
 
 $desc
 
 $long_desc
 
 $owner
 
 $create_date
 
 $last_update
 
 $import_id
 
 $register = false
 
 $referenced
 
 $objectList
 
 $max_title
 
 $max_desc
 
 $add_dots
 

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

ilObjAdvancedEditing::__construct (   $a_id = 0,
  $a_call_by_reference = true 
)

Constructor public.

Parameters
integerreference_id or object_id
booleantreat the id as reference_id (true) or object_id (false)

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

45  {
46  include_once "./Services/Administration/classes/class.ilSetting.php";
47  $this->setting = new ilSetting("advanced_editing");
48  $this->type = "adve";
49  parent::__construct($a_id,$a_call_by_reference);
50  }
ILIAS Setting Class.

Member Function Documentation

◆ _getAllHTMLTags()

static ilObjAdvancedEditing::_getAllHTMLTags ( )
static

Returns an array of all possible HTML tags for text editing.

Returns an array of all possible HTML tags for text editing

Returns
array HTML tags

Definition at line 341 of file class.ilObjAdvancedEditing.php.

References array.

342  {
343  $tags = array(
344  "a",
345  "abbr",
346  "acronym",
347  "address",
348  "applet",
349  "area",
350  "b",
351  "base",
352  "basefont",
353  "bdo",
354  "big",
355  "blockquote",
356  "br",
357  "button",
358  "caption",
359  "center",
360  "cite",
361  "code",
362  "col",
363  "colgroup",
364  "dd",
365  "del",
366  "dfn",
367  "dir",
368  "div",
369  "dl",
370  "dt",
371  "em",
372  "fieldset",
373  "font",
374  "form",
375  "h1",
376  "h2",
377  "h3",
378  "h4",
379  "h5",
380  "h6",
381  "hr",
382  "i",
383  "iframe",
384  "img",
385  "input",
386  "ins",
387  "isindex",
388  "kbd",
389  "label",
390  "legend",
391  "li",
392  "link",
393  "map",
394  "menu",
395  "object",
396  "ol",
397  "optgroup",
398  "option",
399  "p",
400  "param",
401  "pre",
402  "q",
403  "s",
404  "samp",
405  "select",
406  "small",
407  "span",
408  "strike",
409  "strong",
410  "sub",
411  "sup",
412  "table",
413  "tbody",
414  "td",
415  "textarea",
416  "tfoot",
417  "th",
418  "thead",
419  "tr",
420  "tt",
421  "u",
422  "ul",
423  "var",
424  "ruby", // Ruby Annotation XHTML module
425  "rbc",
426  "rtc",
427  "rb",
428  "rt",
429  "rp"
430  );
431  return $tags;
432  }
Create styles array
The data for the language used.

◆ _getRichTextEditor()

static ilObjAdvancedEditing::_getRichTextEditor ( )
static

Returns the identifier for the Rich Text Editor.

Returns the identifier for the Rich Text Editor

Returns
string Identifier for the Rich Text Editor

Definition at line 209 of file class.ilObjAdvancedEditing.php.

References $js.

Referenced by ilRTE\_getRTEClassname(), ilTinyMCE\addRTESupport(), and ilNewsItemGUI\isRteActivated().

210  {
211  include_once "./Services/Administration/classes/class.ilSetting.php";
212  $setting = new ilSetting("advanced_editing");
213  $js = $setting->get("advanced_editing_javascript_editor");
214  return $js;
215  }
ILIAS Setting Class.
$js
+ Here is the caller graph for this function:

◆ _getRichTextEditorUserState()

static ilObjAdvancedEditing::_getRichTextEditorUserState ( )
static

Gets the state of the rich text editor visibility for the current user.

Gets the state of the rich text editor visibility for the current user

Returns
integer 0 if the RTE should be disabled, 1 otherwise

Definition at line 455 of file class.ilObjAdvancedEditing.php.

References $ilUser.

Referenced by ilTinyMCE\addRTESupport(), and ilObjForumGUI\cancelDraftObject().

456  {
457  global $ilUser;
458  if (strlen($ilUser->getPref("show_rte")) > 0)
459  {
460  return $ilUser->getPref("show_rte");
461  }
462  return 1;
463  }
$ilUser
Definition: imgupload.php:18
+ Here is the caller graph for this function:

◆ _getUsedHTMLTags()

static ilObjAdvancedEditing::_getUsedHTMLTags (   $a_module = "")
static

Returns an array of all allowed HTML tags for text editing.

Returns an array of all allowed HTML tags for text editing

Parameters
string$a_moduleName of the module or object which uses the tags
Returns
array HTML tags

Definition at line 98 of file class.ilObjAdvancedEditing.php.

References array.

Referenced by _getUsedHTMLTagsAsString(), assClozeTestGUI\addBasicQuestionFormProperties(), assQuestionGUI\addBasicQuestionFormProperties(), ilTinyMCE\addRTESupport(), ilAssQuestionFeedback\buildFeedbackContentFormProperty(), ilAssQuestionHintGUI\buildForm(), ilAssHtmlPurifier\getElementsUsedForAdvancedEditing(), ilHtmlForumPostPurifier\getPurifierConfigInstance(), SurveyQuestionGUI\initEditForm(), ilSurveyEditorGUI\initHeadingForm(), ilObjSurveyGUI\initPropertiesForm(), ilObjAdvancedEditingGUI\initTagsForm(), assLongMenuGUI\populateQuestionSpecificFormPart(), assClozeTestGUI\populateQuestionSpecificFormPart(), ilSurveyPageGUI\renderPage(), and ilExSubmissionTextGUI\updateAssignmentTextObject().

99  {
100  $usedtags = array();
101  include_once "./Services/Administration/classes/class.ilSetting.php";
102  $setting = new ilSetting("advanced_editing");
103  $tags = $setting->get("advanced_editing_used_html_tags_" . $a_module);
104  if (strlen($tags))
105  {
106  $usedtags = unserialize($tags);
107  }
108  else
109  {
110  if($a_module == 'frm_post' || $a_module == 'exc_ass')
111  {
112  $usedtags = array(
113  "a",
114  "blockquote",
115  "br",
116  "code",
117  "div",
118  "em",
119  "img",
120  "li",
121  "ol",
122  "p",
123  "strong",
124  "u",
125  "ul",
126  "span"
127  );
128  }
129  else
130  {
131  // default: everything but tables
132  $usedtags = array(
133  "a",
134  "blockquote",
135  "br",
136  "cite",
137  "code",
138  "dd",
139  "div",
140  "dl",
141  "dt",
142  "em",
143  "h1",
144  "h2",
145  "h3",
146  "h4",
147  "h5",
148  "h6",
149  "hr",
150  "img",
151  "li",
152  "ol",
153  "p",
154  "pre",
155  "span",
156  "strike",
157  "strong",
158  "sub",
159  "sup",
160  "u",
161  "ul"
162  );
163  }
164  }
165 
166  // frm_posts need blockquote and div urgently
167  if($a_module === 'frm_post')
168  {
169  if(!in_array('div', $usedtags))
170  {
171  $usedtags[] = 'div';
172  }
173 
174  if(!in_array('blockquote', $usedtags))
175  {
176  $usedtags[] = 'blockquote';
177  }
178  }
179 
180  return $usedtags;
181  }
ILIAS Setting Class.
Create styles array
The data for the language used.
+ Here is the caller graph for this function:

◆ _getUsedHTMLTagsAsString()

static ilObjAdvancedEditing::_getUsedHTMLTagsAsString (   $a_module = "")
static

Returns a string of all allowed HTML tags for text editing.

Returns a string of all allowed HTML tags for text editing

Parameters
string$a_moduleName of the module or object which uses the tags
Returns
string Used HTML tags

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

References $result, and _getUsedHTMLTags().

Referenced by ilEssayKeywordWizardInputGUI\checkInput(), ilMultipleChoiceWizardInputGUI\checkInput(), ilKprimChoiceWizardInputGUI\checkInput(), ilMatchingWizardInputGUI\checkInput(), ilSingleChoiceWizardInputGUI\checkInput(), ilObjSurvey\cloneTextblocks(), ilSurveyEditorGUI\saveHeadingObject(), ilTestScoringGUI\saveManScoringParticipantScreen(), ilContainerGUI\savePageContentObject(), ilObjTestSettingsGeneralGUI\saveTestFinishProperties(), and ilObjTestSettingsGeneralGUI\saveTestIntroProperties().

192  {
193  $result = "";
194  $tags = ilObjAdvancedEditing::_getUsedHTMLTags($a_module);
195  foreach ($tags as $tag)
196  {
197  $result .= "<$tag>";
198  }
199  return $result;
200  }
$result
static _getUsedHTMLTags($a_module="")
Returns an array of all allowed HTML tags for text editing.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ _setRichTextEditorUserState()

static ilObjAdvancedEditing::_setRichTextEditorUserState (   $a_state)
static

Sets the state of the rich text editor visibility for the current user.

Sets the state of the rich text editor visibility for the current user

Parameters
integer$a_state0 if the RTE should be disabled, 1 otherwise

Definition at line 441 of file class.ilObjAdvancedEditing.php.

References $ilUser.

Referenced by ilTinyMCE\addRTESupport(), and ilObjForumGUI\cancelDraftObject().

442  {
443  global $ilUser;
444  $ilUser->writePref("show_rte", $a_state);
445  }
$ilUser
Definition: imgupload.php:18
+ Here is the caller graph for this function:

◆ delete()

ilObjAdvancedEditing::delete ( )

delete object and all related data

public

Returns
boolean true if all object data were removed; false if only a references were removed

Definition at line 77 of file class.ilObjAdvancedEditing.php.

78  {
79  // always call parent delete function first!!
80  if (!parent::delete())
81  {
82  return false;
83  }
84 
85  //put here your module specific stuff
86 
87  return true;
88  }

◆ getHTMLTags()

& ilObjAdvancedEditing::getHTMLTags ( )

Returns an array of all possible HTML tags for text editing.

Returns an array of all possible HTML tags for text editing

Returns
array HTML tags

Definition at line 287 of file class.ilObjAdvancedEditing.php.

References array.

288  {
289  $tags = array(
290  "a",
291  "blockquote",
292  "br",
293  "cite",
294  "code",
295  "dd",
296  "div",
297  "dl",
298  "dt",
299  "em",
300  "h1",
301  "h2",
302  "h3",
303  "h4",
304  "h5",
305  "h6",
306  "hr",
307  "img",
308  "li",
309  "object",
310  "ol",
311  "p",
312  "param",
313  "pre",
314  "span",
315  "strike",
316  "strong",
317  "sub",
318  "sup",
319  "table",
320  "td",
321  "tr",
322  "u",
323  "ul",
324  "ruby", // Ruby Annotation XHTML module
325  "rbc",
326  "rtc",
327  "rb",
328  "rt",
329  "rp"
330  );
331  return $tags;
332  }
Create styles array
The data for the language used.

◆ setRichTextEditor()

ilObjAdvancedEditing::setRichTextEditor (   $a_js_editor)

Sets wheather a Rich Text Editor should be used or not.

Sets wheather a Rich Text Editor should be used or not

Parameters
boolean$a_js_editorA boolean indicating if the JS editor should be used or not

Definition at line 224 of file class.ilObjAdvancedEditing.php.

225  {
226  include_once "./Services/Administration/classes/class.ilSetting.php";
227  $setting = new ilSetting("advanced_editing");
228  $setting->set("advanced_editing_javascript_editor", $a_js_editor);
229  }
ILIAS Setting Class.

◆ setUsedHTMLTags()

ilObjAdvancedEditing::setUsedHTMLTags (   $a_html_tags,
  $a_module 
)

Writes an array with allowed HTML tags to the ILIAS settings.

Writes an array with allowed HTML tags to the ILIAS settings

Parameters
array$a_html_tagsAn array containing the allowed HTML tags
string$a_moduleThe name of the module or object which uses the tags
Exceptions
ilAdvancedEditingRequiredTagsException

Definition at line 241 of file class.ilObjAdvancedEditing.php.

References ilObject\$lng, and array.

242  {
243  global $lng;
244 
245  if (strlen($a_module))
246  {
247  $auto_added_tags = array();
248 
249  // frm_posts need blockquote and div urgently
250  if($a_module == 'frm_post')
251  {
252  if(!in_array('div', $a_html_tags))
253  {
254  $auto_added_tags[] = 'div';
255  }
256 
257  if(!in_array('blockquote', $a_html_tags))
258  {
259  $auto_added_tags[] = 'blockquote';
260  }
261  }
262 
263  include_once "./Services/Administration/classes/class.ilSetting.php";
264  $setting = new ilSetting("advanced_editing");
265  $setting->set("advanced_editing_used_html_tags_" . $a_module, serialize(array_merge((array)$a_html_tags, $auto_added_tags)));
266 
267  if(count($auto_added_tags))
268  {
269  require_once 'Services/AdvancedEditing/exceptions/class.ilAdvancedEditingRequiredTagsException.php';
271  sprintf(
272  $lng->txt('advanced_editing_required_tags'),
273  implode(', ', $auto_added_tags)
274  )
275  );
276  }
277  }
278  }
ILIAS Setting Class.
Class for advanced editing exception handling in ILIAS.
Create styles array
The data for the language used.

◆ update()

ilObjAdvancedEditing::update ( )

update object data

public

Returns
boolean

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

59  {
60  if (!parent::update())
61  {
62  return false;
63  }
64 
65  // put here object specific stuff
66 
67  return true;
68  }

Field Documentation

◆ $setting

ilObjAdvancedEditing::$setting

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


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