ILIAS  release_7 Revision v7.30-3-g800a261c036
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
5require_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 {
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}
An exception for terminatinating execution or to throw for unit testing.
const IL_COMP_SERVICE
const IL_INSERT_AFTER
Class ilPCPlugged Plugged content object (see ILIAS DTD)
create( $a_pg_obj, $a_hier_id, $a_pc_id, $a_plugin_name, $a_plugin_version)
Create plugged node in xml.
setNode($a_node)
Set node.
getPluginName()
Get name of plugged component.
modifyPageContentPostXsl($a_html, $a_mode, $a_abstract_only=false)
@inheritDoc
getJavascriptFiles($a_mode)
Get javascript files.
init()
Init page content component.
setPluginName($a_name)
Set name of plugged component.
setProperties($a_properties)
Set properties of plugged component.
getCssFiles($a_mode)
Get css files.
getProperties()
Get properties of plugged component.
setPluginVersion($a_version)
Set version of plugged component.
getPluginVersion()
Get version of plugged component.
Class ilPageContent.
createPageContentNode($a_set_this_node=true)
Create page content node (always use this method first when adding a new element)
setType($a_type)
Set Type.
Class ilPageObject Handles PageObjects of ILIAS Learning Modules (see ILIAS DTD)
global $DIC
Definition: goto.php:24
if($format !==null) $name
Definition: metadata.php:230
$i
Definition: metadata.php:24
$param
Definition: xapitoken.php:29