ILIAS  release_5-3 Revision v5.3.23-19-g915713cf615
ilWebLinkXmlParser Class Reference

XML parser for weblink xml. More...

+ Inheritance diagram for ilWebLinkXmlParser:
+ Collaboration diagram for ilWebLinkXmlParser:

Public Member Functions

 __construct ($webr, $xml)
 Constructor. More...
 
 setWebLink (ilObject $webl)
 set weblink More...
 
 getWebLink ()
 Get weblink object. More...
 
 setMode ($a_mode)
 Set parsing mode. More...
 
 getMode ()
 Return parsing mode. More...
 
 start ()
 
 setHandlers ($a_xml_parser)
 set event handlers More...
 
 handlerBeginTag ($a_xml_parser, $a_name, $a_attribs)
 handler for begin of element More...
 
 handlerEndTag ($a_xml_parser, $a_name)
 handler for end of element More...
 
 handlerCharacterData ($a_xml_parser, $a_data)
 handler for character data More...
 
- Public Member Functions inherited from ilMDSaxParser
 __construct ($a_xml_file='')
 Constructor. More...
 
 enableMDParsing ($a_status)
 
 getMDParsingStatus ()
 
 setMDObject (&$md)
 
getMDObject ()
 
 inMetaData ()
 
 setHandlers ($a_xml_parser)
 set event handlers More...
 
 handlerBeginTag ($a_xml_parser, $a_name, $a_attribs)
 handler for begin of element More...
 
 handlerEndTag ($a_xml_parser, $a_name)
 handler for end of element More...
 
 handlerCharacterData ($a_xml_parser, $a_data)
 handler for character data More...
 
 __getCharacterData ()
 
 __pushParent (&$md_obj)
 
__popParent ()
 
__getParent ()
 
 __construct ($a_xml_file='')
 Constructor. More...
 
 setMDObject (&$md)
 
 inMetaData ()
 
 handlerBeginTag ($a_xml_parser, $a_name, $a_attribs)
 handler for begin of element More...
 
 handlerEndTag ($a_xml_parser, $a_name)
 handler for end of element More...
 
 handlerCharacterData ($a_xml_parser, $a_data)
 handler for character data More...
 
 __getCharacterData ()
 
 __pushParent (&$md_obj)
 
__popParent ()
 
__getParent ()
 
- Public Member Functions inherited from ilSaxParser
 __construct ($a_xml_file='', $throwException=false)
 Constructor setup ILIAS global object public. More...
 
 setXMLContent ($a_xml_content)
 
 getXMLContent ()
 
 getInputType ()
 
 startParsing ()
 stores xml data in array More...
 
 createParser ()
 create parser More...
 
 setOptions ($a_xml_parser)
 set parser options More...
 
 setHandlers ($a_xml_parser)
 set event handler should be overwritten by inherited class private More...
 
 openXMLFile ()
 open xml file More...
 
 parse ($a_xml_parser, $a_fp=null)
 parse xml file More...
 
 freeParser ($a_xml_parser)
 free xml parser handle More...
 
 setThrowException ($throwException)
 set error handling More...
 
- Public Member Functions inherited from PEAR
 __construct ($error_class=null)
 Constructor. More...
 
 _PEAR ()
 Destructor (the emulated type of...). More...
 
 registerShutdownFunc ($func, $args=array())
 Use this function to register a shutdown method for static classes. More...
 
 isError ($data, $code=null)
 Tell whether a value is a PEAR error. More...
 
 expectError ($code=' *')
 This method is used to tell which errors you expect to get. More...
 
 popExpect ()
 This method pops one element off the expected error codes stack. More...
 
 _checkDelExpect ($error_code)
 This method checks unsets an error code if available. More...
 
 delExpect ($error_code)
 This method deletes all occurences of the specified element from the expected error codes stack. More...
 
raiseError ($message=null, $code=null, $mode=null, $options=null, $userinfo=null, $error_class=null, $skipmsg=false)
 This method is a wrapper that returns an instance of the configured error class with this object's default error handling applied. More...
 
throwError ($message=null, $code=null, $userinfo=null)
 Simpler form of raiseError with fewer options. More...
 
 staticPushErrorHandling ($mode, $options=null)
 
 staticPopErrorHandling ()
 
 pushErrorHandling ($mode, $options=null)
 Push a new error handler on top of the error handler options stack. More...
 
 popErrorHandling ()
 Pop the last error handler used. More...
 
 loadExtension ($ext)
 OS independant PHP extension load. More...
 

Data Fields

const MODE_UNDEFINED = 0
 
const MODE_UPDATE = 1
 
const MODE_CREATE = 2
 
- Data Fields inherited from ilMDSaxParser
 $md_in_md = false
 
 $md_chr_data = ''
 
 $md_cur_el = null
 
 $md_parsing_enabled = null
 
 $md = null
 
 $md_gen
 
- Data Fields inherited from ilSaxParser
 $input_type = null
 
 $xml_content = ''
 
 $ilias
 
 $lng
 
 $xml_file
 
 $throwException = false
 
- Data Fields inherited from PEAR
 $_debug = false
 
 $_default_error_mode = null
 
 $_default_error_options = null
 
 $_default_error_handler = ''
 
 $_error_class = 'PEAR_Error'
 
 $_expected_errors = array()
 

Private Attributes

 $webl
 
 $mode = self::MODE_UNDEFINED
 
 $in_metadata = false
 
 $sorting_positions = array()
 
 $current_sorting_position = 0
 

Additional Inherited Members

- Static Public Member Functions inherited from PEAR
static & getStaticProperty ($class, $var)
 If you have a class that's mostly/entirely static, and you need static properties, you can use this method to simulate them. More...
 
static setErrorHandling ($mode=null, $options=null)
 Sets how errors generated by this object should be handled. More...
 
- Protected Member Functions inherited from ilSaxParser
 handleError ($message, $code)
 use given error handler to handle error message or internal ilias error message handle More...
 
- Protected Attributes inherited from ilMDSaxParser
 $meta_log
 

Detailed Description

XML parser for weblink xml.

Author
Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e
Version
$Id$

Definition at line 20 of file class.ilWebLinkXmlParser.php.

Constructor & Destructor Documentation

◆ __construct()

ilWebLinkXmlParser::__construct (   $webr,
  $xml 
)

Constructor.

Definition at line 37 of file class.ilWebLinkXmlParser.php.

References $xml, getWebLink(), ilMDSaxParser\setMDObject(), ilSaxParser\setThrowException(), setWebLink(), and ilSaxParser\setXMLContent().

38  {
39  parent::__construct();
40  $this->setXMLContent($xml);
41  $this->setWebLink($webr);
42 
43  $this->setMDObject(new ilMD($this->getWebLink()->getId(), $this->getWebLink()->getId(), 'webr'));
44  $this->setThrowException(true);
45  }
setThrowException($throwException)
set error handling
$xml
Definition: metadata.php:240
getWebLink()
Get weblink object.
setWebLink(ilObject $webl)
set weblink
setXMLContent($a_xml_content)
+ Here is the call graph for this function:

Member Function Documentation

◆ getMode()

ilWebLinkXmlParser::getMode ( )

Return parsing mode.

Returns

Definition at line 80 of file class.ilWebLinkXmlParser.php.

References $mode.

Referenced by handlerBeginTag().

81  {
82  return $this->mode;
83  }
+ Here is the caller graph for this function:

◆ getWebLink()

ilWebLinkXmlParser::getWebLink ( )

Get weblink object.

Returns
ilObject

Definition at line 61 of file class.ilWebLinkXmlParser.php.

References $webl.

Referenced by __construct(), handlerBeginTag(), and handlerEndTag().

62  {
63  return $this->webl;
64  }
+ Here is the caller graph for this function:

◆ handlerBeginTag()

ilWebLinkXmlParser::handlerBeginTag (   $a_xml_parser,
  $a_name,
  $a_attribs 
)

handler for begin of element

Parameters
resource$a_xml_parserxml parser
string$a_nameelement name
array$a_attribselement attributes array

Definition at line 117 of file class.ilWebLinkXmlParser.php.

References $ilErr, ilMDSaxParser\$md, $valid, array, getMode(), ilParameterAppender\getParameterIds(), getWebLink(), LINKS_LOGIN, LINKS_MATRICULATION, LINKS_USER_ID, ilContainer\SORT_MANUAL, and ilContainer\SORT_TITLE.

118  {
119  global $ilErr;
120 
121  if ($this->in_metadata) {
122  parent::handlerBeginTag($a_xml_parser, $a_name, $a_attribs);
123  return;
124  }
125 
126  switch ($a_name) {
127  case "MetaData":
128  $this->in_metadata = true;
129 
130  // Delete old meta data
131  $md = new ilMD($this->getWebLink()->getId(), 0, 'webr');
132  $md->deleteAll();
133 
134  parent::handlerBeginTag($a_xml_parser, $a_name, $a_attribs);
135  break;
136 
137  case 'WebLink':
138 
139  $this->current_sorting_position = ($a_attribs['position'] ? $a_attribs['position'] : 0);
140  $this->current_link_update = false;
141  $this->current_link_delete = false;
142  $this->current_parameters = array();
143 
144  if ($this->getMode() == self::MODE_CREATE or (isset($a_attribs['action']) and $a_attribs['action'] == 'Create')) {
145  // New weblink
146  $this->current_link = new ilLinkResourceItems($this->getWebLink()->getId());
147  } elseif ($this->getMode() == self::MODE_UPDATE and $a_attribs['action'] == 'Delete') {
148  $this->current_link_delete = true;
149  $this->current_link = new ilLinkResourceItems($this->getWebLink()->getId());
150  $this->current_link->delete($a_attribs['id']);
151  break;
152  } elseif ($this->getMode() == self::MODE_UPDATE and ($a_attribs['action'] == 'Update' or !isset($a_attribs['action']))) {
153  $this->current_link = new ilLinkResourceItems($this->getWebLink()->getId());
154  $this->current_link->readItem($a_attribs['id']);
155  $this->current_link_update = true;
156 
157  // Delete all dynamic parameter
158  include_once './Modules/WebResource/classes/class.ilParameterAppender.php';
159  foreach (ilParameterAppender::getParameterIds($this->getWebLink()->getId(), $a_attribs['id']) as $param_id) {
160  $param = new ilParameterAppender($this->getWebLink()->getId());
161  $param->delete($param_id);
162  }
163  } else {
164  throw new ilWebLinkXmlParserException('Invalid action given for element "Weblink"');
165  }
166 
167  // Active
168  $this->current_link->setActiveStatus($a_attribs['active'] ? 1 : 0);
169 
170  // Valid
171  if (!isset($a_attribs['valid'])) {
172  $valid = 1;
173  } else {
174  $valid = $a_attribs['valid'] ? 1 : 0;
175  }
176  $this->current_link->setValidStatus($valid);
177 
178  // Disable check
179  $this->current_link->setDisableCheckStatus($a_attribs['disableValidation'] ? 1 : 0);
180 
181  // internal
182  if (isset($a_attribs['internal'])) {
183  $this->current_link->setInternal($a_attribs['internal']);
184  }
185  break;
186 
187 
188  case 'Sorting':
189 
190  include_once './Services/Container/classes/class.ilContainerSortingSettings.php';
191  $sort = new ilContainerSortingSettings($this->getWebLink()->getId());
192  $sort->delete();
193 
194  switch ($a_attribs['type']) {
195  case 'Manual':
196  $sort->setSortMode(ilContainer::SORT_MANUAL);
197  break;
198 
199  case 'Title':
200  default:
201  $sort->setSortMode(ilContainer::SORT_TITLE);
202  }
203  $sort->save();
204  break;
205 
206  case 'WebLinks':
207  $this->sorting_positions = array();
208  // no break
209  case 'Title':
210  case 'Description':
211  case 'Target':
212  // Nothing to do
213  break;
214 
215  case 'DynamicParameter':
216 
217  $param = new ilParameterAppender($this->getWebLink()->getId());
218  $param->setName($a_attribs['name']);
219 
220  switch ($a_attribs['type']) {
221  case 'userName':
222 # $GLOBALS['ilLog']->write("VALUE: ".LINKS_LOGIN);
223  $param->setValue(LINKS_LOGIN);
224  break;
225 
226  case 'userId':
227 # $GLOBALS['ilLog']->write("VALUE: ".LINKS_USER_ID);
228  $param->setValue(LINKS_USER_ID);
229  break;
230 
231  case 'matriculation':
232 # $GLOBALS['ilLog']->write("VALUE: ".LINKS_MATRICULATION);
233  $param->setValue(LINKS_MATRICULATION);
234  break;
235 
236  default:
237  throw new ilWebLinkXmlParserException('Invalid attribute "type" given for element "Dynamic parameter". Aborting');
238  break;
239  }
240 
241  $this->current_parameters[] = $param;
242  break;
243  }
244  }
global $ilErr
Definition: raiseError.php:16
static getParameterIds($a_webr_id, $a_link_id)
Get Parameter ids of link.
$valid
const LINKS_MATRICULATION
const LINKS_LOGIN
getMode()
Return parsing mode.
getWebLink()
Get weblink object.
Create styles array
The data for the language used.
Class ilObjLinkResourceGUI.
Class ilParameterAppender.
const LINKS_USER_ID
+ Here is the call graph for this function:

◆ handlerCharacterData()

ilWebLinkXmlParser::handlerCharacterData (   $a_xml_parser,
  $a_data 
)

handler for character data

Parameters
resource$a_xml_parserxml parser
string$a_datacharacter data

Definition at line 340 of file class.ilWebLinkXmlParser.php.

341  {
342  if ($this->in_metadata) {
343  parent::handlerCharacterData($a_xml_parser, $a_data);
344  }
345 
346  if ($a_data != "\n") {
347  // Replace multiple tabs with one space
348  $a_data = preg_replace("/\t+/", " ", $a_data);
349  $this->cdata .= $a_data;
350  }
351  }

◆ handlerEndTag()

ilWebLinkXmlParser::handlerEndTag (   $a_xml_parser,
  $a_name 
)

handler for end of element

Parameters
resource$a_xml_parserxml parser
string$a_nameelement name
Exceptions
ilSaxParserExceptionif invalid xml structure is given
ilWebLinkXMLParserExceptionmissing elements

Definition at line 254 of file class.ilWebLinkXmlParser.php.

References $GLOBALS, ilContainerSorting\_getInstance(), ilLoggerFactory\getLogger(), and getWebLink().

255  {
256  if ($this->in_metadata) {
257  parent::handlerEndTag($a_xml_parser, $a_name);
258  }
259 
260  $GLOBALS['ilLog']->write(__METHOD__ . ': Called ' . $a_name);
261 
262  switch ($a_name) {
263  case 'MetaData':
264  $this->in_metadata = false;
265  parent::handlerEndTag($a_xml_parser, $a_name);
266  break;
267 
268  case 'WebLinks':
269  $this->getWebLink()->MDUpdateListener('General');
270  $this->getWebLink()->update();
271 
272  // save sorting
273  include_once './Services/Container/classes/class.ilContainerSorting.php';
274  $sorting = ilContainerSorting::_getInstance($this->getWebLink()->getId());
275  $sorting->savePost($this->sorting_positions);
276  ilLoggerFactory::getLogger('webr')->dump($this->sorting_positions);
277  break;
278 
279  case 'WebLink':
280 
281  if ($this->current_link_delete) {
282  break;
283  }
284  if (!$this->current_link) {
285  throw new ilSaxParserException('Invalid xml structure given. Missing start tag "WebLink"');
286  }
287  if (!$this->current_link->validate()) {
288  throw new ilWebLinkXmlParserException('Missing required elements "Title, Target"');
289  }
290 
291  if ($this->current_link_update) {
292  $this->current_link->update();
293  } else {
294  $this->current_link->add();
295  }
296 
297  // Save dynamic parameters
298  foreach ($this->current_parameters as $param) {
299  $param->add($this->current_link->getLinkId());
300  }
301 
302 
303  // store positions
304  $this->sorting_positions[$this->current_link->getLinkId()] = (int) $this->current_sorting_position;
305 
306  unset($this->current_link);
307  break;
308 
309  case 'Title':
310  if ($this->current_link) {
311  $this->current_link->setTitle(trim($this->cdata));
312  }
313  break;
314 
315  case 'Description':
316  if ($this->current_link) {
317  $this->current_link->setDescription(trim($this->cdata));
318  }
319  break;
320 
321  case 'Target':
322  if ($this->current_link) {
323  $this->current_link->setTarget(trim($this->cdata));
324  }
325  break;
326  }
327 
328  // Reset cdata
329  $this->cdata = '';
330  }
$GLOBALS['loaded']
Global hash that tracks already loaded includes.
SaxParserException thrown by ilSaxParser if property throwException is set.
getWebLink()
Get weblink object.
static getLogger($a_component_id)
Get component logger.
static _getInstance($a_obj_id)
get instance by obj_id
+ Here is the call graph for this function:

◆ setHandlers()

ilWebLinkXmlParser::setHandlers (   $a_xml_parser)

set event handlers

Parameters
resourcereference to the xml parser private

Definition at line 103 of file class.ilWebLinkXmlParser.php.

104  {
105  xml_set_object($a_xml_parser, $this);
106  xml_set_element_handler($a_xml_parser, 'handlerBeginTag', 'handlerEndTag');
107  xml_set_character_data_handler($a_xml_parser, 'handlerCharacterData');
108  }

◆ setMode()

ilWebLinkXmlParser::setMode (   $a_mode)

Set parsing mode.

Parameters
int$a_mode
Returns

Definition at line 71 of file class.ilWebLinkXmlParser.php.

72  {
73  $this->mode = $a_mode;
74  }

◆ setWebLink()

ilWebLinkXmlParser::setWebLink ( ilObject  $webl)

set weblink

Parameters
ilObject$webl
Returns

Definition at line 52 of file class.ilWebLinkXmlParser.php.

References $webl.

Referenced by __construct().

53  {
54  $this->webl = $webl;
55  }
+ Here is the caller graph for this function:

◆ start()

ilWebLinkXmlParser::start ( )
Returns
Exceptions
ilSaxParserExceptionif invalid xml structure is given
ilWebLinkXMLParserExceptionmissing elements

Definition at line 92 of file class.ilWebLinkXmlParser.php.

References ilSaxParser\startParsing().

93  {
94  return $this->startParsing();
95  }
startParsing()
stores xml data in array
+ Here is the call graph for this function:

Field Documentation

◆ $current_sorting_position

ilWebLinkXmlParser::$current_sorting_position = 0
private

Definition at line 32 of file class.ilWebLinkXmlParser.php.

◆ $in_metadata

ilWebLinkXmlParser::$in_metadata = false
private

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

◆ $mode

ilWebLinkXmlParser::$mode = self::MODE_UNDEFINED
private

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

Referenced by getMode().

◆ $sorting_positions

ilWebLinkXmlParser::$sorting_positions = array()
private

Definition at line 31 of file class.ilWebLinkXmlParser.php.

◆ $webl

ilWebLinkXmlParser::$webl
private

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

Referenced by getWebLink(), and setWebLink().

◆ MODE_CREATE

const ilWebLinkXmlParser::MODE_CREATE = 2

◆ MODE_UNDEFINED

const ilWebLinkXmlParser::MODE_UNDEFINED = 0

Definition at line 22 of file class.ilWebLinkXmlParser.php.

◆ MODE_UPDATE

const ilWebLinkXmlParser::MODE_UPDATE = 1

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