ILIAS  release_8 Revision v8.23
ilPCSourceCode Class Reference

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

+ Inheritance diagram for ilPCSourceCode:
+ Collaboration diagram for ilPCSourceCode:

Public Member Functions

 init ()
 
 modifyPageContentPostXsl (string $a_output, string $a_mode="presentation", bool $a_abstract_only=false)
 
 highlightText (string $a_text, string $proglang)
 Highlights Text with given ProgLang. More...
 
- Public Member Functions inherited from ilPCParagraph
 init ()
 
 setNode (php4DOMElement $a_node)
 
 createAtNode (php4DOMElement $node)
 Create new page content (incl. More...
 
 createBeforeNode (php4DOMElement $node)
 Create new page content (incl. More...
 
 createAfter (php4DOMElement $node)
 Create paragraph node (incl. More...
 
 create (ilPageObject $a_pg_obj, string $a_hier_id, string $a_pc_id="", bool $from_placeholder=false)
 Create paragraph node (incl. More...
 
 setText (string $a_text, bool $a_auto_split=false)
 Set (xml) content of text paragraph. More...
 
 getText (bool $a_short_mode=false)
 Get (xml) content of paragraph. More...
 
 getParagraphSequenceContent (ilPageObject $a_pg_obj)
 Get paragraph sequenc of current paragraph. More...
 
 setCharacteristic (string $a_char)
 Set Characteristic of paragraph. More...
 
 getCharacteristic ()
 
 setSubCharacteristic (string $a_char)
 
 getAutoIndent ()
 
 setAutoIndent (string $a_char)
 
 getSubCharacteristic ()
 
 setDownloadTitle (string $a_char)
 
 getDownloadTitle ()
 
 setShowLineNumbers (string $a_char)
 
 getShowLineNumbers ()
 
 setLanguage (string $a_lang)
 
 getLanguage ()
 
 input2xml (string $a_text, bool $a_wysiwyg=false, bool $a_handle_lists=true)
 
 autoSplit (string $a_text)
 This function splits a paragraph text that has been already processed with input2xml at each header position =header1=, ==header2== or ===header3=== and returns an array that contains the single chunks. More...
 
 handleNextBr (string $a_str)
 Remove preceding
More...
 
 removeTrailingBr (string $a_str)
 Remove trailing
More...
 
 getType ()
 Need to override getType from ilPageContent to distinguish between Pararagraph and Source. More...
 
 saveJS (ilPageObject $a_pg_obj, string $a_content, string $a_char, string $a_pc_id, string $a_insert_at="", bool $from_placeholder=false)
 Save input coming from ajax. More...
 
 getLastSavedPCId (ilPageObject $a_pg_obj, bool $a_as_ajax_str=false)
 Get last inserted pc ids. More...
 
 updatePage (ilPageObject $a_page)
 Update page object (it would be better to have this centralized and to change the constructors and pass the page object instead the dom object) More...
 
 autoLinkGlossaries (array $a_glos)
 
 getJavascriptFiles (string $a_mode)
 
 getOnloadCode (string $a_mode)
 
 getModel ()
 
 insert (\ilPageObject $page, string $a_content, string $a_char, string $a_pc_id, string $a_insert_at="", string $a_new_pc_id="")
 Save input coming from ajax. More...
 
- Public Member Functions inherited from ilPageContent
 __construct (ilPageObject $a_pg_obj)
 
 setPage (ilPageObject $a_val)
 
 getPage ()
 
 init ()
 Init object. More...
 
 getType ()
 
 setNode (php4DOMElement $a_node)
 Set xml node of page content. More...
 
 getNode ()
 
 getJavascriptFiles (string $a_mode)
 
 getCssFiles (string $a_mode)
 
 getOnloadCode (string $a_mode)
 
 setHierId (string $a_hier_id)
 
 getHierId ()
 
 lookupHierId ()
 
 readHierId ()
 
 setPcId (string $a_pcid)
 
 getPCId ()
 
 setFileDownloadLink (string $a_download_link)
 
 getFileDownloadLink ()
 
 setProfileBackUrl (string $url)
 
 getProfileBackUrl ()
 
 setFullscreenLink (string $a_fullscreen_link)
 
 getFullscreenLink ()
 
 setSourcecodeDownloadScript (string $script_name)
 
 getSourcecodeDownloadScript ()
 
 readPCId ()
 
 writePCId (string $a_pc_id)
 
 setEnabled (string $value)
 Set Enabled value for page content component. More...
 
 enable ()
 
 disable ()
 
 isEnabled ()
 
 createPageContentNode (bool $a_set_this_node=true)
 Create page content node (always use this method first when adding a new element) More...
 
 modifyPageContentPostXsl (string $a_output, string $a_mode, bool $a_abstract_only=false)
 Modify page content after xsl. More...
 
 getModel ()
 Get model as needed for the front-end editor. More...
 

Static Public Member Functions

static getLangVars ()
 
- Static Public Member Functions inherited from ilPCParagraph
static attribsToArray (string $a_str)
 converts a string of format var1 = "val1" var2 = "val2" ... More...
 
static _input2xml (string $a_text, string $a_lang, bool $a_wysiwyg=false, bool $a_handle_lists=true)
 Converts user input to xml User input comes as bb code information, e.g. More...
 
static intLinks2xml (string $a_text)
 internal links to xml More...
 
static input2xmlReplaceLists (string $a_text)
 Converts xml from DB to output in edit textarea. More...
 
static xml2outputReplaceLists (string $a_text)
 Replaces

with *. More...

 
static segmentString (string $a_haystack, array $a_needles)
 Segments a string into an array at each position of a substring. More...
 
static xml2output (string $a_text, bool $a_wysiwyg=false, bool $a_replace_lists=true, bool $unmask=true)
 Converts xml from DB to output in edit textarea. More...
 
static handleAjaxContent (string $a_content)
 Handle ajax content. More...
 
static handleAjaxContentPost (string $text)
 Post input2xml handling of ajax content. More...
 
static autoLinkGlossariesPage (ilPageObject $a_page, array $a_terms)
 Auto link glossary of whole page. More...
 
static afterPageUpdate (ilPageObject $a_page, DOMDocument $a_domdoc, string $a_xml, bool $a_creation)
 After page has been updated (or created) More...
 
static beforePageDelete (ilPageObject $a_page)
 Before page is being deleted. More...
 
static afterPageHistoryEntry (ilPageObject $a_page, DOMDocument $a_old_domdoc, string $a_old_xml, int $a_old_nr)
 After page history entry has been created. More...
 
static saveAnchors (ilPageObject $a_page, DOMDocument $a_domdoc)
 Save anchors. More...
 
static _deleteAnchors (string $a_parent_type, int $a_page_id, string $a_page_lang)
 Delete anchors of a page. More...
 
static _saveAnchor (string $a_parent_type, int $a_page_id, string $a_page_lang, string $a_anchor_name)
 Save an anchor. More...
 
static _readAnchors (string $a_parent_type, int $a_page_id, string $a_page_lang="-")
 Read anchors of a page. More...
 
static saveMetaKeywords (ilPageObject $a_page, DOMDocument $a_domdoc)
 save all keywords More...
 
- Static Public Member Functions inherited from ilPageContent
static incEdId (string $ed_id)
 Increases an hierarchical editing id at lowest level (last number) More...
 
static decEdId (string $ed_id)
 Decreases an hierarchical editing id at lowest level (last number) More...
 
static sortHierIds (array $a_array)
 Sort an array of Hier IDS in ascending order. More...
 
static isGreaterHierId (string $a, string $b)
 Check whether Hier ID $a is greater than Hier ID $b. More...
 
static getLangVars ()
 Get lang vars needed for editing. More...
 
static handleCopiedContent (DOMDocument $a_domdoc, bool $a_self_ass=true, bool $a_clone_mobs=false, int $new_parent_id=0, int $obj_copy_id=0)
 Handle copied content. More...
 
static afterPageUpdate (ilPageObject $a_page, DOMDocument $a_domdoc, string $a_xml, bool $a_creation)
 After page has been updated (or created) More...
 
static beforePageDelete (ilPageObject $a_page)
 Before page is being deleted. More...
 
static afterRepositoryCopy (ilPageObject $page, array $mapping, int $source_ref_id)
 After repository (container) copy action. More...
 
static afterPageHistoryEntry (ilPageObject $a_page, DOMDocument $a_old_domdoc, string $a_old_xml, int $a_old_nr)
 After page history entry has been created. More...
 
static deleteHistoryLowerEqualThan (string $parent_type, int $page_id, string $lang, int $delete_lower_than_nr)
 Overwrite in derived classes, if old history entries are being deleted. More...
 

Additional Inherited Members

- Data Fields inherited from ilPCParagraph
php4DOMElement $par_node = null
 
- Data Fields inherited from ilPageContent
string $hier_id = ""
 
php4DOMElement $node = null
 
php4DOMDocument $dom = null
 
string $page_lang = ""
 
- Protected Member Functions inherited from ilPCParagraph
 checkTextArray (array $text)
 Check text array. More...
 
 fixTextArray (array $text)
 
- Protected Member Functions inherited from ilPageContent
 setType (string $a_type)
 Set Type. More...
 
- Static Protected Member Functions inherited from ilPCParagraph
static getBBMap ()
 Get bb to xml tag map. More...
 
static getXMLTagMap ()
 Get tag to bb map. More...
 
static replaceBBCode (string $a_text, string $a_bb, string $a_tag)
 
static isValidTagContent (string $content)
 
static replaceBBTagByMatching (string $start_tag, string $end_tag, string $xml_tag_name, string $text, array $attribs)
 Transforms [iln...]...[] to <IntLink...>...</IntLink>, if content is valid, otherwise it removes the bb tags. More...
 
static linkTermsInDom (php4DOMDocument $a_dom, array $a_terms, php4DOMElement $a_par_node=null)
 Link terms in a dom page object in bb style. More...
 
- Protected Attributes inherited from ilPCParagraph
string $inserted_pc_id
 
ilObjUser $user
 
ilLanguage $lng
 
- Protected Attributes inherited from ilPageContent
string $pcid
 
string $type = ""
 
ilPageObject $pg_obj
 
string $file_download_link
 
string $fullscreen_link
 
string $sourcecode_download_script
 
ilLogger $log
 
string $profile_back_url = ""
 
- Static Protected Attributes inherited from ilPCParagraph
static array $bb_tags
 

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Class ilPCSourceCode

Paragraph of ilPageObject

Author
Roland Küstermann
Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Definition at line 27 of file class.ilPCSourceCode.php.

Member Function Documentation

◆ getLangVars()

static ilPCSourceCode::getLangVars ( )
static

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

34  : array
35  {
36  return array("ed_insert_code", "pc_code");
37  }

◆ highlightText()

ilPCSourceCode::highlightText ( string  $a_text,
string  $proglang 
)

Highlights Text with given ProgLang.

Definition at line 160 of file class.ilPCSourceCode.php.

References ilSyntaxHighlighter\getInstance(), ilSyntaxHighlighter\getNewLanguageId(), and ilSyntaxHighlighter\isSupported().

Referenced by modifyPageContentPostXsl().

163  : string {
164  $proglang = ilSyntaxHighlighter::getNewLanguageId($proglang);
165  if (ilSyntaxHighlighter::isSupported($proglang)) {
166  $highl = ilSyntaxHighlighter::getInstance($proglang);
167  $a_text = $highl->highlight($a_text);
168  }
169  return $a_text;
170  }
static getInstance(string $a_lang)
static getNewLanguageId(string $a_old_lang_id)
Get new language id (for an old one)
static isSupported(string $a_lang)
Is language supported?
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ init()

ilPCSourceCode::init ( )

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

References ilPageContent\setType().

29  : void
30  {
31  $this->setType("src");
32  }
setType(string $a_type)
Set Type.
+ Here is the call graph for this function:

◆ modifyPageContentPostXsl()

ilPCSourceCode::modifyPageContentPostXsl ( string  $a_output,
string  $a_mode = "presentation",
bool  $a_abstract_only = false 
)

Definition at line 39 of file class.ilPCSourceCode.php.

References ilPageContent\$dom, $i, $path, $res, $rows, php4DOMDocument\dump_node(), ILIAS\Survey\Mode\getId(), ilPageContent\getPage(), highlightText(), xpath_eval(), and xpath_new_context().

43  : string {
44  $dom = $this->getPage()->getDom();
45 
46  $xpc = xpath_new_context($dom);
47  $path = "//Paragraph"; //"[@Characteristic = 'Code']";
48  $res = xpath_eval($xpc, $path);
49  for ($i = 0; $i < count($res->nodeset); $i++) {
50  $context_node = $res->nodeset[$i];
51  $char = $context_node->get_attribute('Characteristic');
52 
53  if ($char != "Code") {
54  continue;
55  }
56 
57  $n = $context_node->parent_node();
58  $char = $context_node->get_attribute('Characteristic');
59  $subchar = $context_node->get_attribute('SubCharacteristic');
60  $showlinenumbers = $context_node->get_attribute('ShowLineNumbers');
61  $downloadtitle = $context_node->get_attribute('DownloadTitle');
62  $autoindent = $context_node->get_attribute('AutoIndent');
63 
64  $content = "";
65 
66  // get XML Content
67  $childs = $context_node->child_nodes();
68 
69  for ($j = 0; $j < count($childs); $j++) {
70  $content .= $dom->dump_node($childs[$j]);
71  }
72 
73  while ($context_node->has_child_nodes()) {
74  $node_del = $context_node->first_child();
75  $context_node->remove_child($node_del);
76  }
77 
78  $content = str_replace("<br />", "<br/>", utf8_decode($content));
79  $content = str_replace("<br/>", "\n", $content);
80  $rownums = count(explode("\n", $content));
81 
82  // see #23028
83  //$plain_content = html_entity_decode($content);
84  $plain_content = $content;
85 
86  $plain_content = preg_replace_callback(
87  "/\&#x([1-9a-f]{2});?/is",
88  function ($hit) {
89  return chr(base_convert($hit[1], 16, 10));
90  },
91  $plain_content
92  );
93  $plain_content = preg_replace_callback(
94  "/\&#(\d+);?/is",
95  function ($hit) {
96  return chr($hit[1]);
97  },
98  $plain_content
99  );
100  $content = utf8_encode($this->highlightText($plain_content, $subchar));
101 
102  $content = str_replace("&amp;lt;", "&lt;", $content);
103  $content = str_replace("&amp;gt;", "&gt;", $content);
104  // $content = str_replace("&", "&amp;", $content);
105  //var_dump($content);
106  $rows = "<tr valign=\"top\">";
107  $rownumbers = "";
108  $linenumbers = "";
109 
110  //if we have to show line numbers
111  if (strcmp($showlinenumbers, "y") == 0) {
112  $linenumbers = "<td nowrap=\"nowrap\" class=\"ilc_LineNumbers\" >";
113  $linenumbers .= "<pre class=\"ilc_Code ilc_code_block_Code\">";
114 
115  for ($j = 0; $j < $rownums; $j++) {
116  $indentno = strlen($rownums) - strlen($j + 1) + 2;
117  $rownumeration = ($j + 1);
118  $linenumbers .= "<span class=\"ilc_LineNumber\">$rownumeration</span>";
119  if ($j < $rownums - 1) {
120  $linenumbers .= "\n";
121  }
122  }
123  $linenumbers .= "</pre>";
124  $linenumbers .= "</td>";
125  }
126 
127  $rows .= $linenumbers . "<td class=\"ilc_Sourcecode\"><pre class=\"ilc_Code ilc_code_block_Code\">" . $content . "</pre></td>";
128  $rows .= "</tr>";
129 
130  // fix for ie explorer which is not able to produce empty line feeds with <br /><br />;
131  // workaround: add a space after each br.
132  $newcontent = str_replace("\n", "<br/>", $rows);
133  // fix for IE
134  $newcontent = str_replace("<br/><br/>", "<br/> <br/>", $newcontent);
135  // falls drei hintereinander...
136  $newcontent = str_replace("<br/><br/>", "<br/> <br/>", $newcontent);
137 
138  // workaround for preventing template engine
139  // from hiding paragraph text that is enclosed
140  // in curly brackets (e.g. "{a}", see ilLMEditorGUI::executeCommand())
141  $newcontent = str_replace("{", "&#123;", $newcontent);
142  $newcontent = str_replace("}", "&#125;", $newcontent);
143 
144  //echo htmlentities($newcontent);
145  $a_output = str_replace("[[[[[Code;" . ($i + 1) . "]]]]]", $newcontent, $a_output);
146 
147  if ($a_mode != "presentation" && is_object($this->getPage()->getOfflineHandler())
148  && trim($downloadtitle) != "") {
149  // call code handler for offline versions
150  $this->getPage()->getOfflineHandler()->handleCodeParagraph($this->getPage()->getId(), $i + 1, $downloadtitle, $plain_content);
151  }
152  }
153 
154  return $a_output;
155  }
xpath_eval(php4DOMXPath $xpath_context, string $eval_str, $contextnode=null)
$res
Definition: ltiservices.php:69
$path
Definition: ltiservices.php:32
php4DOMDocument $dom
xpath_new_context($dom_document)
$rows
Definition: xhr_table.php:10
highlightText(string $a_text, string $proglang)
Highlights Text with given ProgLang.
$i
Definition: metadata.php:41
+ Here is the call graph for this function:

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