ILIAS  release_7 Revision v7.30-3-g800a261c036
All Data Structures Namespaces Files Functions Variables Modules Pages
class.ilPCPlugged.php
Go to the documentation of this file.
1 <?php
2 
3 /* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */
4 
5 require_once("./Services/COPage/classes/class.ilPageContent.php");
6 
17 {
21  protected $lng;
22 
26  protected $plugin_admin;
27 
28  public $dom;
29  public $plug_node;
30 
34  public function init()
35  {
36  global $DIC;
37 
38  $this->lng = $DIC->language();
39  $this->plugin_admin = $DIC["ilPluginAdmin"];
40  $this->setType("plug");
41  }
42 
46  public function setNode($a_node)
47  {
48  parent::setNode($a_node); // this is the PageContent node
49  $this->plug_node = $a_node->first_child(); // this is the Plugged node
50  }
51 
58  public function create(
59  $a_pg_obj,
60  $a_hier_id,
61  $a_pc_id,
62  $a_plugin_name,
63  $a_plugin_version
64  ) {
65  $this->node = $this->createPageContentNode();
66  $a_pg_obj->insertContent($this, $a_hier_id, IL_INSERT_AFTER, $a_pc_id);
67  $this->plug_node = $this->dom->create_element("Plugged");
68  $this->plug_node = $this->node->append_child($this->plug_node);
69  $this->plug_node->set_attribute("PluginName", $a_plugin_name);
70  $this->plug_node->set_attribute("PluginVersion", $a_plugin_version);
71  }
72 
78  public function setProperties($a_properties)
79  {
80  if (!is_object($this->plug_node)) {
81  return;
82  }
83 
84  // delete properties
85  $children = $this->plug_node->child_nodes();
86  for ($i = 0; $i < count($children); $i++) {
87  $this->plug_node->remove_child($children[$i]);
88  }
89  // set properties
90  foreach ($a_properties as $key => $value) {
91  $prop_node = $this->dom->create_element("PluggedProperty");
92  $prop_node = $this->plug_node->append_child($prop_node);
93  $prop_node->set_attribute("Name", $key);
94  if ($value != "") {
95  $prop_node->set_content($value);
96  }
97  }
98  }
99 
105  public function getProperties()
106  {
107  $properties = array();
108 
109  if (is_object($this->plug_node)) {
110  // delete properties
111  $children = $this->plug_node->child_nodes();
112  for ($i = 0; $i < count($children); $i++) {
113  if ($children[$i]->node_name() == "PluggedProperty") {
114  $properties[$children[$i]->get_attribute("Name")] =
115  $children[$i]->get_content();
116  }
117  }
118  }
119 
120  return $properties;
121  }
122 
128  public function setPluginVersion($a_version)
129  {
130  if (!empty($a_version)) {
131  $this->plug_node->set_attribute("PluginVersion", $a_version);
132  } else {
133  if ($this->plug_node->has_attribute("PluginVersion")) {
134  $this->plug_node->remove_attribute("PluginVersion");
135  }
136  }
137  }
138 
144  public function getPluginVersion()
145  {
146  if (is_object($this->plug_node)) {
147  return $this->plug_node->get_attribute("PluginVersion");
148  }
149  }
150 
156  public function setPluginName($a_name)
157  {
158  if (!empty($a_name)) {
159  $this->plug_node->set_attribute("PluginName", $a_name);
160  } else {
161  if ($this->plug_node->has_attribute("PluginName")) {
162  $this->plug_node->remove_attribute("PluginName");
163  }
164  }
165  }
166 
172  public function getPluginName()
173  {
174  if (is_object($this->plug_node)) {
175  return $this->plug_node->get_attribute("PluginName");
176  }
177  }
178 
186  public static function handleCopiedPluggedContent(ilPageObject $a_page, DOMDocument $a_domdoc)
187  {
188  global $DIC;
189  $ilPluginAdmin = $DIC['ilPluginAdmin'];
190 
191  $xpath = new DOMXPath($a_domdoc);
192  $nodes = $xpath->query("//Plugged");
193 
195  foreach ($nodes as $node) {
196  $plugin_name = $node->getAttribute('PluginName');
197  $plugin_version = $node->getAttribute('PluginVersion');
198 
199  if ($ilPluginAdmin->isActive(IL_COMP_SERVICE, "COPage", "pgcp", $plugin_name)) {
201  $plugin_obj = $ilPluginAdmin->getPluginObject(IL_COMP_SERVICE, "COPage", "pgcp", $plugin_name);
202  $plugin_obj->setPageObj($a_page);
203 
204  $properties = array();
206  foreach ($node->childNodes as $child) {
207  $properties[$child->getAttribute('Name')] = $child->nodeValue;
208  }
209 
210  // let the plugin copy additional content
211  // and allow it to modify the saved parameters
212  $plugin_obj->onClone($properties, $plugin_version);
213 
214  foreach ($node->childNodes as $child) {
215  $node->removeChild($child);
216  }
217  foreach ($properties as $name => $value) {
218  $child = new DOMElement('PluggedProperty',
219  str_replace("&", "&amp;", $value)
220  );
221  $node->appendChild($child);
222  $child->setAttribute('Name', $name);
223  }
224  }
225  }
226  }
227 
235  public static function handleDeletedPluggedNode(ilPageObject $a_page, DOMNode $a_node)
236  {
237  global $DIC;
238  $ilPluginAdmin = $DIC['ilPluginAdmin'];
239 
240  $plugin_name = $a_node->getAttribute('PluginName');
241  $plugin_version = $a_node->getAttribute('PluginVersion');
242 
243  if ($ilPluginAdmin->isActive(IL_COMP_SERVICE, "COPage", "pgcp", $plugin_name)) {
245  $plugin_obj = $ilPluginAdmin->getPluginObject(IL_COMP_SERVICE, "COPage", "pgcp", $plugin_name);
246  $plugin_obj->setPageObj($a_page);
247 
248  $properties = array();
250  foreach ($a_node->childNodes as $child) {
251  $properties[$child->getAttribute('Name')] = $child->nodeValue;
252  }
253 
254  // let the plugin delete additional content
255  $plugin_obj->onDelete($properties, $plugin_version);
256  }
257  }
258 
259 
263  public function modifyPageContentPostXsl($a_html, $a_mode, $a_abstract_only = false)
264  {
265  $lng = $this->lng;
266  $ilPluginAdmin = $this->plugin_admin;
267 
268  $c_pos = 0;
269  $start = strpos($a_html, "{{{{{Plugged<pl");
270  //echo htmlentities($a_html)."-";
271  if (is_int($start)) {
272  $end = strpos($a_html, "}}}}}", $start);
273  }
274  $i = 1;
275 
276  while ($end > 0) {
277  $param = substr($a_html, $start + 5, $end - $start - 5);
278  $param = str_replace(' xmlns:xhtml="http://www.w3.org/1999/xhtml"', "", $param);
279  $param = explode("<pl/>", $param);
280  //var_dump($param); exit;
281  $plugin_name = $param[1];
282  $plugin_version = $param[2];
283  $properties = array();
284 
285  for ($i = 3; $i < count($param); $i += 2) {
286  $properties[$param[$i]] = $param[$i + 1];
287  }
288 
289  // get html from plugin
290  if ($a_mode == "edit") {
291  $plugin_html = '<div class="ilBox">' . $lng->txt("content_plugin_not_activated") . " (" . $plugin_name . ")</div>";
292  }
293  if ($ilPluginAdmin->isActive(IL_COMP_SERVICE, "COPage", "pgcp", $plugin_name)) {
294  $plugin_obj = $ilPluginAdmin->getPluginObject(
296  "COPage",
297  "pgcp",
298  $plugin_name
299  );
300  $plugin_obj->setPageObj($this->getPage());
301  $gui_obj = $plugin_obj->getUIClassInstance();
302  $plugin_html = $gui_obj->getElementHTML($a_mode, $properties, $plugin_version);
303  }
304 
305  $a_html = substr($a_html, 0, $start) .
306  $plugin_html .
307  substr($a_html, $end + 5);
308 
309  if (strlen($a_html) > $start + 5) {
310  $start = strpos($a_html, "{{{{{Plugged<pl", $start + 5);
311  } else {
312  $start = false;
313  }
314  $end = 0;
315  if (is_int($start)) {
316  $end = strpos($a_html, "}}}}}", $start);
317  }
318  }
319 
320  return $a_html;
321  }
322 
326  public function getJavascriptFiles($a_mode)
327  {
328  $ilPluginAdmin = $this->plugin_admin;
329 
330  $js_files = array();
331 
332  $pl_names = $ilPluginAdmin->getActivePluginsForSlot(
334  "COPage",
335  "pgcp"
336  );
337  foreach ($pl_names as $pl_name) {
338  $plugin = $ilPluginAdmin->getPluginObject(
340  "COPage",
341  "pgcp",
342  $pl_name
343  );
344  $plugin->setPageObj($this->getPage());
345  $pl_dir = $plugin->getDirectory();
346 
347  $pl_js_files = $plugin->getJavascriptFiles($a_mode);
348  foreach ($pl_js_files as $pl_js_file) {
349  if (!is_int(strpos($pl_js_file, "//"))) {
350  $pl_js_file = $pl_dir . "/" . $pl_js_file;
351  }
352  if (!in_array($pl_js_file, $js_files)) {
353  $js_files[] = $pl_js_file;
354  }
355  }
356  }
357  //var_dump($js_files);
358  return $js_files;
359  }
360 
364  public function getCssFiles($a_mode)
365  {
366  $ilPluginAdmin = $this->plugin_admin;
367 
368  $css_files = array();
369 
370  $pl_names = $ilPluginAdmin->getActivePluginsForSlot(
372  "COPage",
373  "pgcp"
374  );
375  foreach ($pl_names as $pl_name) {
376  $plugin = $ilPluginAdmin->getPluginObject(
378  "COPage",
379  "pgcp",
380  $pl_name
381  );
382  $plugin->setPageObj($this->getPage());
383  $pl_dir = $plugin->getDirectory();
384 
385  $pl_css_files = $plugin->getCssFiles($a_mode);
386  foreach ($pl_css_files as $pl_css_file) {
387  if (!is_int(strpos($pl_css_file, "//"))) {
388  $pl_css_file = $pl_dir . "/" . $pl_css_file;
389  }
390  if (!in_array($pl_css_file, $css_files)) {
391  $css_files[] = $pl_css_file;
392  }
393  }
394  }
395 
396  return $css_files;
397  }
398 }
setProperties($a_properties)
Set properties of plugged component.
getCssFiles($a_mode)
Get css files.
create( $a_pg_obj, $a_hier_id, $a_pc_id, $a_plugin_name, $a_plugin_version)
Create plugged node in xml.
init()
Init page content component.
getProperties()
Get properties of plugged component.
Class ilPCPlugged Plugged content object (see ILIAS DTD)
setType($a_type)
Set Type.
getPluginVersion()
Get version of plugged component.
Class ilPageContent.
setPluginVersion($a_version)
Set version of plugged component.
if($format !==null) $name
Definition: metadata.php:230
getPluginName()
Get name of plugged component.
setPluginName($a_name)
Set name of plugged component.
$param
Definition: xapitoken.php:29
Class ilPageObject Handles PageObjects of ILIAS Learning Modules (see ILIAS DTD)
global $DIC
Definition: goto.php:24
const IL_INSERT_AFTER
modifyPageContentPostXsl($a_html, $a_mode, $a_abstract_only=false)
createPageContentNode($a_set_this_node=true)
Create page content node (always use this method first when adding a new element) ...
getJavascriptFiles($a_mode)
Get javascript files.
setNode($a_node)
Set node.
const IL_COMP_SERVICE
$i
Definition: metadata.php:24