1 <?php

     2 

     3 /**

     4  * SimplePie

     5  *

     6  * A PHP-Based RSS and Atom Feed Framework.

     7  * Takes the hard work out of managing a complete RSS/Atom solution.

     8  *

     9  * Copyright (c) 2004-2022, Ryan Parman, Sam Sneddon, Ryan McCue, and contributors

    10  * All rights reserved.

    11  *

    12  * Redistribution and use in source and binary forms, with or without modification, are

    13  * permitted provided that the following conditions are met:

    14  *

    15  * 	* Redistributions of source code must retain the above copyright notice, this list of

    16  * 	  conditions and the following disclaimer.

    17  *

    18  * 	* Redistributions in binary form must reproduce the above copyright notice, this list

    19  * 	  of conditions and the following disclaimer in the documentation and/or other materials

    20  * 	  provided with the distribution.

    21  *

    22  * 	* Neither the name of the SimplePie Team nor the names of its contributors may be used

    23  * 	  to endorse or promote products derived from this software without specific prior

    24  * 	  written permission.

    25  *

    26  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS

    27  * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY

    28  * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS

    29  * AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR

    30  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR

    31  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

    32  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR

    33  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

    34  * POSSIBILITY OF SUCH DAMAGE.

    35  *

    36  * @package SimplePie

    37  * @copyright 2004-2016 Ryan Parman, Sam Sneddon, Ryan McCue

    38  * @author Ryan Parman

    39  * @author Sam Sneddon

    40  * @author Ryan McCue

    41  * @link http://simplepie.org/ SimplePie

    42  * @license http://www.opensource.org/licenses/bsd-license.php BSD License

    43  */

    44 

    45 namespace SimplePie;

    46 

    47 /**

    48  * Manages all item-related data

    49  *

    50  * Used by {@see \SimplePie\SimplePie::get_item()} and {@see \SimplePie\SimplePie::get_items()}

    51  *

    52  * This class can be overloaded with {@see \SimplePie\SimplePie::set_item_class()}

    53  *

    54  * @package \SimplePie\SimplePie

    55  * @subpackage API

    56  */

    57 class Item implements RegistryAware

    58 {

    59     /**

    60      * Parent feed

    61      *

    62      * @access private

    63      * @var \SimplePie\SimplePie

    64      */

    65     public $feed;

    66 

    67     /**

    68      * Raw data

    69      *

    70      * @access private

    71      * @var array

    72      */

    73     public $data = [];

    74 

    75     /**

    76      * Registry object

    77      *

    78      * @see set_registry

    79      * @var \SimplePie\Registry

    80      */

    81     protected $registry;

    82 

    83     /**

    84      * Create a new item object

    85      *

    86      * This is usually used by {@see \SimplePie\SimplePie::get_items} and

    87      * {@see \SimplePie\SimplePie::get_item}. Avoid creating this manually.

    88      *

    89      * @param \SimplePie\SimplePie $feed Parent feed

    90      * @param array $data Raw data

    91      */

    92     public function __construct($feed, $data)

    93     {

    94         $this->feed = $feed;

    95         $this->data = $data;

    96     }

    97 

    98     /**

    99      * Set the registry handler

   100      *

   101      * This is usually used by {@see \SimplePie\Registry::create}

   102      *

   103      * @since 1.3

   104      * @param \SimplePie\Registry $registry

   105      */

   106     public function set_registry(\SimplePie\Registry $registry)/* : void */

   107     {

   108         $this->registry = $registry;

   109     }

   110 

   111     /**

   112      * Get a string representation of the item

   113      *

   114      * @return string

   115      */

   116     public function __toString()

   117     {

   118         return md5(serialize($this->data));

   119     }

   120 

   121     /**

   122      * Remove items that link back to this before destroying this object

   123      */

   124     public function __destruct()

   125     {

   126         if (!gc_enabled()) {

   127             unset($this->feed);

   128         }

   129     }

   130 

   131     /**

   132      * Get data for an item-level element

   133      *

   134      * This method allows you to get access to ANY element/attribute that is a

   135      * sub-element of the item/entry tag.

   136      *

   137      * See {@see \SimplePie\SimplePie::get_feed_tags()} for a description of the return value

   138      *

   139      * @since 1.0

   140      * @see http://simplepie.org/wiki/faq/supported_xml_namespaces

   141      * @param string $namespace The URL of the XML namespace of the elements you're trying to access

   142      * @param string $tag Tag name

   143      * @return array

   144      */

   145     public function get_item_tags($namespace, $tag)

   146     {

   147         if (isset($this->data['child'][$namespace][$tag])) {

   148             return $this->data['child'][$namespace][$tag];

   149         }

   150 

   151         return null;

   152     }

   153 

   154     /**

   155      * Get the base URL value.

   156      * Uses `<xml:base>`, or item link, or feed base URL.

   157      *

   158      * @param array $element

   159      * @return string

   160      */

   161     public function get_base($element = [])

   162     {

   163         if (!empty($element['xml_base_explicit']) && isset($element['xml_base'])) {

   164             return $element['xml_base'];

   165         }

   166         $link = $this->get_permalink();

   167         if ($link != null) {

   168             return $link;

   169         }

   170         return $this->feed->get_base($element);

   171     }

   172 

   173     /**

   174      * Sanitize feed data

   175      *

   176      * @access private

   177      * @see \SimplePie\SimplePie::sanitize()

   178      * @param string $data Data to sanitize

   179      * @param int $type One of the \SimplePie\SimplePie::CONSTRUCT_* constants

   180      * @param string $base Base URL to resolve URLs against

   181      * @return string Sanitized data

   182      */

   183     public function sanitize($data, $type, $base = '')

   184     {

   185         return $this->feed->sanitize($data, $type, $base);

   186     }

   187 

   188     /**

   189      * Get the parent feed

   190      *

   191      * Note: this may not work as you think for multifeeds!

   192      *

   193      * @link http://simplepie.org/faq/typical_multifeed_gotchas#missing_data_from_feed

   194      * @since 1.0

   195      * @return \SimplePie\SimplePie

   196      */

   197     public function get_feed()

   198     {

   199         return $this->feed;

   200     }

   201 

   202     /**

   203      * Get the unique identifier for the item

   204      *

   205      * This is usually used when writing code to check for new items in a feed.

   206      *

   207      * Uses `<atom:id>`, `<guid>`, `<dc:identifier>` or the `about` attribute

   208      * for RDF. If none of these are supplied (or `$hash` is true), creates an

   209      * MD5 hash based on the permalink, title and content.

   210      *

   211      * @since Beta 2

   212      * @param boolean $hash Should we force using a hash instead of the supplied ID?

   213      * @param string|false $fn User-supplied function to generate an hash

   214      * @return string|null

   215      */

   216     public function get_id($hash = false, $fn = 'md5')

   217     {

   218         if (!$hash) {

   219             if ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_10, 'id')) {

   220                 return $this->sanitize($return[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   221             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_03, 'id')) {

   222                 return $this->sanitize($return[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   223             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_20, 'guid')) {

   224                 return $this->sanitize($return[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   225             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_11, 'identifier')) {

   226                 return $this->sanitize($return[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   227             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_10, 'identifier')) {

   228                 return $this->sanitize($return[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   229             } elseif (isset($this->data['attribs'][\SimplePie\SimplePie::NAMESPACE_RDF]['about'])) {

   230                 return $this->sanitize($this->data['attribs'][\SimplePie\SimplePie::NAMESPACE_RDF]['about'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   231             }

   232         }

   233         if ($fn === false) {

   234             return null;

   235         } elseif (!is_callable($fn)) {

   236             trigger_error('User-supplied function $fn must be callable', E_USER_WARNING);

   237             $fn = 'md5';

   238         }

   239         return call_user_func(

   240             $fn,

   241             $this->get_permalink().$this->get_title().$this->get_content()

   242         );

   243     }

   244 

   245     /**

   246      * Get the title of the item

   247      *

   248      * Uses `<atom:title>`, `<title>` or `<dc:title>`

   249      *

   250      * @since Beta 2 (previously called `get_item_title` since 0.8)

   251      * @return string|null

   252      */

   253     public function get_title()

   254     {

   255         if (!isset($this->data['title'])) {

   256             if ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_10, 'title')) {

   257                 $this->data['title'] = $this->sanitize($return[0]['data'], $this->registry->call(Misc::class, 'atom_10_construct_type', [$return[0]['attribs']]), $this->get_base($return[0]));

   258             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_03, 'title')) {

   259                 $this->data['title'] = $this->sanitize($return[0]['data'], $this->registry->call(Misc::class, 'atom_03_construct_type', [$return[0]['attribs']]), $this->get_base($return[0]));

   260             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_10, 'title')) {

   261                 $this->data['title'] = $this->sanitize($return[0]['data'], \SimplePie\SimplePie::CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));

   262             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_090, 'title')) {

   263                 $this->data['title'] = $this->sanitize($return[0]['data'], \SimplePie\SimplePie::CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));

   264             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_20, 'title')) {

   265                 $this->data['title'] = $this->sanitize($return[0]['data'], \SimplePie\SimplePie::CONSTRUCT_MAYBE_HTML, $this->get_base($return[0]));

   266             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_11, 'title')) {

   267                 $this->data['title'] = $this->sanitize($return[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   268             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_10, 'title')) {

   269                 $this->data['title'] = $this->sanitize($return[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   270             } else {

   271                 $this->data['title'] = null;

   272             }

   273         }

   274         return $this->data['title'];

   275     }

   276 

   277     /**

   278      * Get the content for the item

   279      *

   280      * Prefers summaries over full content , but will return full content if a

   281      * summary does not exist.

   282      *

   283      * To prefer full content instead, use {@see get_content}

   284      *

   285      * Uses `<atom:summary>`, `<description>`, `<dc:description>` or

   286      * `<itunes:subtitle>`

   287      *

   288      * @since 0.8

   289      * @param boolean $description_only Should we avoid falling back to the content?

   290      * @return string|null

   291      */

   292     public function get_description($description_only = false)

   293     {

   294         if (($tags = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_10, 'summary')) &&

   295             ($return = $this->sanitize($tags[0]['data'], $this->registry->call(Misc::class, 'atom_10_construct_type', [$tags[0]['attribs']]), $this->get_base($tags[0])))) {

   296             return $return;

   297         } elseif (($tags = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_03, 'summary')) &&

   298                 ($return = $this->sanitize($tags[0]['data'], $this->registry->call(Misc::class, 'atom_03_construct_type', [$tags[0]['attribs']]), $this->get_base($tags[0])))) {

   299             return $return;

   300         } elseif (($tags = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_10, 'description')) &&

   301                 ($return = $this->sanitize($tags[0]['data'], \SimplePie\SimplePie::CONSTRUCT_MAYBE_HTML, $this->get_base($tags[0])))) {

   302             return $return;

   303         } elseif (($tags = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_20, 'description')) &&

   304                 ($return = $this->sanitize($tags[0]['data'], \SimplePie\SimplePie::CONSTRUCT_HTML, $this->get_base($tags[0])))) {

   305             return $return;

   306         } elseif (($tags = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_11, 'description')) &&

   307                 ($return = $this->sanitize($tags[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT))) {

   308             return $return;

   309         } elseif (($tags = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_10, 'description')) &&

   310                 ($return = $this->sanitize($tags[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT))) {

   311             return $return;

   312         } elseif (($tags = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ITUNES, 'summary')) &&

   313                 ($return = $this->sanitize($tags[0]['data'], \SimplePie\SimplePie::CONSTRUCT_HTML, $this->get_base($tags[0])))) {

   314             return $return;

   315         } elseif (($tags = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ITUNES, 'subtitle')) &&

   316                 ($return = $this->sanitize($tags[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT))) {

   317             return $return;

   318         } elseif (($tags = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_090, 'description')) &&

   319                 ($return = $this->sanitize($tags[0]['data'], \SimplePie\SimplePie::CONSTRUCT_HTML))) {

   320             return $return;

   321         } elseif (!$description_only) {

   322             return $this->get_content(true);

   323         }

   324 

   325         return null;

   326     }

   327 

   328     /**

   329      * Get the content for the item

   330      *

   331      * Prefers full content over summaries, but will return a summary if full

   332      * content does not exist.

   333      *

   334      * To prefer summaries instead, use {@see get_description}

   335      *

   336      * Uses `<atom:content>` or `<content:encoded>` (RSS 1.0 Content Module)

   337      *

   338      * @since 1.0

   339      * @param boolean $content_only Should we avoid falling back to the description?

   340      * @return string|null

   341      */

   342     public function get_content($content_only = false)

   343     {

   344         if (($tags = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_10, 'content')) &&

   345             ($return = $this->sanitize($tags[0]['data'], $this->registry->call(Misc::class, 'atom_10_content_construct_type', [$tags[0]['attribs']]), $this->get_base($tags[0])))) {

   346             return $return;

   347         } elseif (($tags = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_03, 'content')) &&

   348                 ($return = $this->sanitize($tags[0]['data'], $this->registry->call(Misc::class, 'atom_03_construct_type', [$tags[0]['attribs']]), $this->get_base($tags[0])))) {

   349             return $return;

   350         } elseif (($tags = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_10_MODULES_CONTENT, 'encoded')) &&

   351                 ($return = $this->sanitize($tags[0]['data'], \SimplePie\SimplePie::CONSTRUCT_HTML, $this->get_base($tags[0])))) {

   352             return $return;

   353         } elseif (!$content_only) {

   354             return $this->get_description(true);

   355         }

   356 

   357         return null;

   358     }

   359 

   360     /**

   361      * Get the media:thumbnail of the item

   362      *

   363      * Uses `<media:thumbnail>`

   364      *

   365      *

   366      * @return array|null

   367      */

   368     public function get_thumbnail()

   369     {

   370         if (!isset($this->data['thumbnail'])) {

   371             if ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_MEDIARSS, 'thumbnail')) {

   372                 $thumbnail = $return[0]['attribs'][''];

   373                 if (empty($thumbnail['url'])) {

   374                     $this->data['thumbnail'] = null;

   375                 } else {

   376                     $thumbnail['url'] = $this->sanitize($thumbnail['url'], \SimplePie\SimplePie::CONSTRUCT_IRI, $this->get_base($return[0]));

   377                     $this->data['thumbnail'] = $thumbnail;

   378                 }

   379             } else {

   380                 $this->data['thumbnail'] = null;

   381             }

   382         }

   383         return $this->data['thumbnail'];

   384     }

   385 

   386     /**

   387      * Get a category for the item

   388      *

   389      * @since Beta 3 (previously called `get_categories()` since Beta 2)

   390      * @param int $key The category that you want to return.  Remember that arrays begin with 0, not 1

   391      * @return \SimplePie\Category|null

   392      */

   393     public function get_category($key = 0)

   394     {

   395         $categories = $this->get_categories();

   396         if (isset($categories[$key])) {

   397             return $categories[$key];

   398         }

   399 

   400         return null;

   401     }

   402 

   403     /**

   404      * Get all categories for the item

   405      *

   406      * Uses `<atom:category>`, `<category>` or `<dc:subject>`

   407      *

   408      * @since Beta 3

   409      * @return \SimplePie\Category[]|null List of {@see \SimplePie\Category} objects

   410      */

   411     public function get_categories()

   412     {

   413         $categories = [];

   414 

   415         $type = 'category';

   416         foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_10, $type) as $category) {

   417             $term = null;

   418             $scheme = null;

   419             $label = null;

   420             if (isset($category['attribs']['']['term'])) {

   421                 $term = $this->sanitize($category['attribs']['']['term'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   422             }

   423             if (isset($category['attribs']['']['scheme'])) {

   424                 $scheme = $this->sanitize($category['attribs']['']['scheme'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   425             }

   426             if (isset($category['attribs']['']['label'])) {

   427                 $label = $this->sanitize($category['attribs']['']['label'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   428             }

   429             $categories[] = $this->registry->create(Category::class, [$term, $scheme, $label, $type]);

   430         }

   431         foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_20, $type) as $category) {

   432             // This is really the label, but keep this as the term also for BC.

   433             // Label will also work on retrieving because that falls back to term.

   434             $term = $this->sanitize($category['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   435             if (isset($category['attribs']['']['domain'])) {

   436                 $scheme = $this->sanitize($category['attribs']['']['domain'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   437             } else {

   438                 $scheme = null;

   439             }

   440             $categories[] = $this->registry->create(Category::class, [$term, $scheme, null, $type]);

   441         }

   442 

   443         $type = 'subject';

   444         foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_11, $type) as $category) {

   445             $categories[] = $this->registry->create(Category::class, [$this->sanitize($category['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT), null, null, $type]);

   446         }

   447         foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_10, $type) as $category) {

   448             $categories[] = $this->registry->create(Category::class, [$this->sanitize($category['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT), null, null, $type]);

   449         }

   450 

   451         if (!empty($categories)) {

   452             return array_unique($categories);

   453         }

   454 

   455         return null;

   456     }

   457 

   458     /**

   459      * Get an author for the item

   460      *

   461      * @since Beta 2

   462      * @param int $key The author that you want to return.  Remember that arrays begin with 0, not 1

   463      * @return \SimplePie\Author|null

   464      */

   465     public function get_author($key = 0)

   466     {

   467         $authors = $this->get_authors();

   468         if (isset($authors[$key])) {

   469             return $authors[$key];

   470         }

   471 

   472         return null;

   473     }

   474 

   475     /**

   476      * Get a contributor for the item

   477      *

   478      * @since 1.1

   479      * @param int $key The contrbutor that you want to return.  Remember that arrays begin with 0, not 1

   480      * @return \SimplePie\Author|null

   481      */

   482     public function get_contributor($key = 0)

   483     {

   484         $contributors = $this->get_contributors();

   485         if (isset($contributors[$key])) {

   486             return $contributors[$key];

   487         }

   488 

   489         return null;

   490     }

   491 

   492     /**

   493      * Get all contributors for the item

   494      *

   495      * Uses `<atom:contributor>`

   496      *

   497      * @since 1.1

   498      * @return \SimplePie\Author[]|null List of {@see \SimplePie\Author} objects

   499      */

   500     public function get_contributors()

   501     {

   502         $contributors = [];

   503         foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_10, 'contributor') as $contributor) {

   504             $name = null;

   505             $uri = null;

   506             $email = null;

   507             if (isset($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['name'][0]['data'])) {

   508                 $name = $this->sanitize($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['name'][0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   509             }

   510             if (isset($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['uri'][0]['data'])) {

   511                 $uri = $this->sanitize($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['uri'][0]['data'], \SimplePie\SimplePie::CONSTRUCT_IRI, $this->get_base($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['uri'][0]));

   512             }

   513             if (isset($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['email'][0]['data'])) {

   514                 $email = $this->sanitize($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['email'][0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   515             }

   516             if ($name !== null || $email !== null || $uri !== null) {

   517                 $contributors[] = $this->registry->create(Author::class, [$name, $uri, $email]);

   518             }

   519         }

   520         foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_03, 'contributor') as $contributor) {

   521             $name = null;

   522             $url = null;

   523             $email = null;

   524             if (isset($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['name'][0]['data'])) {

   525                 $name = $this->sanitize($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['name'][0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   526             }

   527             if (isset($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['url'][0]['data'])) {

   528                 $url = $this->sanitize($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['url'][0]['data'], \SimplePie\SimplePie::CONSTRUCT_IRI, $this->get_base($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['url'][0]));

   529             }

   530             if (isset($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['email'][0]['data'])) {

   531                 $email = $this->sanitize($contributor['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['email'][0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   532             }

   533             if ($name !== null || $email !== null || $url !== null) {

   534                 $contributors[] = $this->registry->create(Author::class, [$name, $url, $email]);

   535             }

   536         }

   537 

   538         if (!empty($contributors)) {

   539             return array_unique($contributors);

   540         }

   541 

   542         return null;

   543     }

   544 

   545     /**

   546      * Get all authors for the item

   547      *

   548      * Uses `<atom:author>`, `<author>`, `<dc:creator>` or `<itunes:author>`

   549      *

   550      * @since Beta 2

   551      * @return \SimplePie\Author[]|null List of {@see \SimplePie\Author} objects

   552      */

   553     public function get_authors()

   554     {

   555         $authors = [];

   556         foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_10, 'author') as $author) {

   557             $name = null;

   558             $uri = null;

   559             $email = null;

   560             if (isset($author['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['name'][0]['data'])) {

   561                 $name = $this->sanitize($author['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['name'][0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   562             }

   563             if (isset($author['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['uri'][0]['data'])) {

   564                 $uri = $this->sanitize($author['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['uri'][0]['data'], \SimplePie\SimplePie::CONSTRUCT_IRI, $this->get_base($author['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['uri'][0]));

   565             }

   566             if (isset($author['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['email'][0]['data'])) {

   567                 $email = $this->sanitize($author['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_10]['email'][0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   568             }

   569             if ($name !== null || $email !== null || $uri !== null) {

   570                 $authors[] = $this->registry->create(Author::class, [$name, $uri, $email]);

   571             }

   572         }

   573         if ($author = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_03, 'author')) {

   574             $name = null;

   575             $url = null;

   576             $email = null;

   577             if (isset($author[0]['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['name'][0]['data'])) {

   578                 $name = $this->sanitize($author[0]['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['name'][0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   579             }

   580             if (isset($author[0]['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['url'][0]['data'])) {

   581                 $url = $this->sanitize($author[0]['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['url'][0]['data'], \SimplePie\SimplePie::CONSTRUCT_IRI, $this->get_base($author[0]['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['url'][0]));

   582             }

   583             if (isset($author[0]['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['email'][0]['data'])) {

   584                 $email = $this->sanitize($author[0]['child'][\SimplePie\SimplePie::NAMESPACE_ATOM_03]['email'][0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   585             }

   586             if ($name !== null || $email !== null || $url !== null) {

   587                 $authors[] = $this->registry->create(Author::class, [$name, $url, $email]);

   588             }

   589         }

   590         if ($author = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_20, 'author')) {

   591             $authors[] = $this->registry->create(Author::class, [null, null, $this->sanitize($author[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT)]);

   592         }

   593         foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_11, 'creator') as $author) {

   594             $authors[] = $this->registry->create(Author::class, [$this->sanitize($author['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT), null, null]);

   595         }

   596         foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_10, 'creator') as $author) {

   597             $authors[] = $this->registry->create(Author::class, [$this->sanitize($author['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT), null, null]);

   598         }

   599         foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ITUNES, 'author') as $author) {

   600             $authors[] = $this->registry->create(Author::class, [$this->sanitize($author['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT), null, null]);

   601         }

   602 

   603         if (!empty($authors)) {

   604             return array_unique($authors);

   605         } elseif (($source = $this->get_source()) && ($authors = $source->get_authors())) {

   606             return $authors;

   607         } elseif ($authors = $this->feed->get_authors()) {

   608             return $authors;

   609         }

   610 

   611         return null;

   612     }

   613 

   614     /**

   615      * Get the copyright info for the item

   616      *

   617      * Uses `<atom:rights>` or `<dc:rights>`

   618      *

   619      * @since 1.1

   620      * @return string

   621      */

   622     public function get_copyright()

   623     {

   624         if ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_10, 'rights')) {

   625             return $this->sanitize($return[0]['data'], $this->registry->call(Misc::class, 'atom_10_construct_type', [$return[0]['attribs']]), $this->get_base($return[0]));

   626         } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_11, 'rights')) {

   627             return $this->sanitize($return[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   628         } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_10, 'rights')) {

   629             return $this->sanitize($return[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   630         }

   631 

   632         return null;

   633     }

   634 

   635     /**

   636      * Get the posting date/time for the item

   637      *

   638      * Uses `<atom:published>`, `<atom:updated>`, `<atom:issued>`,

   639      * `<atom:modified>`, `<pubDate>` or `<dc:date>`

   640      *

   641      * Note: obeys PHP's timezone setting. To get a UTC date/time, use

   642      * {@see get_gmdate}

   643      *

   644      * @since Beta 2 (previously called `get_item_date` since 0.8)

   645      *

   646      * @param string $date_format Supports any PHP date format from {@see http://php.net/date} (empty for the raw data)

   647      * @return int|string|null

   648      */

   649     public function get_date($date_format = 'j F Y, g:i a')

   650     {

   651         if (!isset($this->data['date'])) {

   652             if ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_10, 'published')) {

   653                 $this->data['date']['raw'] = $return[0]['data'];

   654             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_20, 'pubDate')) {

   655                 $this->data['date']['raw'] = $return[0]['data'];

   656             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_11, 'date')) {

   657                 $this->data['date']['raw'] = $return[0]['data'];

   658             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_DC_10, 'date')) {

   659                 $this->data['date']['raw'] = $return[0]['data'];

   660             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_10, 'updated')) {

   661                 $this->data['date']['raw'] = $return[0]['data'];

   662             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_03, 'issued')) {

   663                 $this->data['date']['raw'] = $return[0]['data'];

   664             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_03, 'created')) {

   665                 $this->data['date']['raw'] = $return[0]['data'];

   666             } elseif ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_03, 'modified')) {

   667                 $this->data['date']['raw'] = $return[0]['data'];

   668             }

   669 

   670             if (!empty($this->data['date']['raw'])) {

   671                 $parser = $this->registry->call(Parse\Date::class, 'get');

   672                 $this->data['date']['parsed'] = $parser->parse($this->data['date']['raw']) ?: null;

   673             } else {

   674                 $this->data['date'] = null;

   675             }

   676         }

   677         if ($this->data['date']) {

   678             $date_format = (string) $date_format;

   679             switch ($date_format) {

   680                 case '':

   681                     return $this->sanitize($this->data['date']['raw'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   682 

   683                 case 'U':

   684                     return $this->data['date']['parsed'];

   685 

   686                 default:

   687                     return date($date_format, $this->data['date']['parsed']);

   688             }

   689         }

   690 

   691         return null;

   692     }

   693 

   694     /**

   695      * Get the update date/time for the item

   696      *

   697      * Uses `<atom:updated>`

   698      *

   699      * Note: obeys PHP's timezone setting. To get a UTC date/time, use

   700      * {@see get_gmdate}

   701      *

   702      * @param string $date_format Supports any PHP date format from {@see http://php.net/date} (empty for the raw data)

   703      * @return int|string|null

   704      */

   705     public function get_updated_date($date_format = 'j F Y, g:i a')

   706     {

   707         if (!isset($this->data['updated'])) {

   708             if ($return = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_10, 'updated')) {

   709                 $this->data['updated']['raw'] = $return[0]['data'];

   710             }

   711 

   712             if (!empty($this->data['updated']['raw'])) {

   713                 $parser = $this->registry->call(Parse\Date::class, 'get');

   714                 $this->data['updated']['parsed'] = $parser->parse($this->data['updated']['raw']) ?: null;

   715             } else {

   716                 $this->data['updated'] = null;

   717             }

   718         }

   719         if ($this->data['updated']) {

   720             $date_format = (string) $date_format;

   721             switch ($date_format) {

   722                 case '':

   723                     return $this->sanitize($this->data['updated']['raw'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   724 

   725                 case 'U':

   726                     return $this->data['updated']['parsed'];

   727 

   728                 default:

   729                     return date($date_format, $this->data['updated']['parsed']);

   730             }

   731         }

   732 

   733         return null;

   734     }

   735 

   736     /**

   737      * Get the localized posting date/time for the item

   738      *

   739      * Returns the date formatted in the localized language. To display in

   740      * languages other than the server's default, you need to change the locale

   741      * with {@link http://php.net/setlocale setlocale()}. The available

   742      * localizations depend on which ones are installed on your web server.

   743      *

   744      * @since 1.0

   745      *

   746      * @param string $date_format Supports any PHP date format from {@see http://php.net/strftime} (empty for the raw data)

   747      * @return int|string|null

   748      */

   749     public function get_local_date($date_format = '%c')

   750     {

   751         if (!$date_format) {

   752             return $this->sanitize($this->get_date(''), \SimplePie\SimplePie::CONSTRUCT_TEXT);

   753         } elseif (($date = $this->get_date('U')) !== null && $date !== false) {

   754             return strftime($date_format, $date);

   755         }

   756 

   757         return null;

   758     }

   759 

   760     /**

   761      * Get the posting date/time for the item (UTC time)

   762      *

   763      * @see get_date

   764      * @param string $date_format Supports any PHP date format from {@see http://php.net/date}

   765      * @return int|string|null

   766      */

   767     public function get_gmdate($date_format = 'j F Y, g:i a')

   768     {

   769         $date = $this->get_date('U');

   770         if ($date === null) {

   771             return null;

   772         }

   773 

   774         return gmdate($date_format, $date);

   775     }

   776 

   777     /**

   778      * Get the update date/time for the item (UTC time)

   779      *

   780      * @see get_updated_date

   781      * @param string $date_format Supports any PHP date format from {@see http://php.net/date}

   782      * @return int|string|null

   783      */

   784     public function get_updated_gmdate($date_format = 'j F Y, g:i a')

   785     {

   786         $date = $this->get_updated_date('U');

   787         if ($date === null) {

   788             return null;

   789         }

   790 

   791         return gmdate($date_format, $date);

   792     }

   793 

   794     /**

   795      * Get the permalink for the item

   796      *

   797      * Returns the first link available with a relationship of "alternate".

   798      * Identical to {@see get_link()} with key 0

   799      *

   800      * @see get_link

   801      * @since 0.8

   802      * @return string|null Permalink URL

   803      */

   804     public function get_permalink()

   805     {

   806         $link = $this->get_link();

   807         $enclosure = $this->get_enclosure(0);

   808         if ($link !== null) {

   809             return $link;

   810         } elseif ($enclosure !== null) {

   811             return $enclosure->get_link();

   812         }

   813 

   814         return null;

   815     }

   816 

   817     /**

   818      * Get a single link for the item

   819      *

   820      * @since Beta 3

   821      * @param int $key The link that you want to return.  Remember that arrays begin with 0, not 1

   822      * @param string $rel The relationship of the link to return

   823      * @return string|null Link URL

   824      */

   825     public function get_link($key = 0, $rel = 'alternate')

   826     {

   827         $links = $this->get_links($rel);

   828         if ($links && $links[$key] !== null) {

   829             return $links[$key];

   830         }

   831 

   832         return null;

   833     }

   834 

   835     /**

   836      * Get all links for the item

   837      *

   838      * Uses `<atom:link>`, `<link>` or `<guid>`

   839      *

   840      * @since Beta 2

   841      * @param string $rel The relationship of links to return

   842      * @return array|null Links found for the item (strings)

   843      */

   844     public function get_links($rel = 'alternate')

   845     {

   846         if (!isset($this->data['links'])) {

   847             $this->data['links'] = [];

   848             foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_10, 'link') as $link) {

   849                 if (isset($link['attribs']['']['href'])) {

   850                     $link_rel = (isset($link['attribs']['']['rel'])) ? $link['attribs']['']['rel'] : 'alternate';

   851                     $this->data['links'][$link_rel][] = $this->sanitize($link['attribs']['']['href'], \SimplePie\SimplePie::CONSTRUCT_IRI, $this->get_base($link));

   852                 }

   853             }

   854             foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_ATOM_03, 'link') as $link) {

   855                 if (isset($link['attribs']['']['href'])) {

   856                     $link_rel = (isset($link['attribs']['']['rel'])) ? $link['attribs']['']['rel'] : 'alternate';

   857                     $this->data['links'][$link_rel][] = $this->sanitize($link['attribs']['']['href'], \SimplePie\SimplePie::CONSTRUCT_IRI, $this->get_base($link));

   858                 }

   859             }

   860             if ($links = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_10, 'link')) {

   861                 $this->data['links']['alternate'][] = $this->sanitize($links[0]['data'], \SimplePie\SimplePie::CONSTRUCT_IRI, $this->get_base($links[0]));

   862             }

   863             if ($links = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_090, 'link')) {

   864                 $this->data['links']['alternate'][] = $this->sanitize($links[0]['data'], \SimplePie\SimplePie::CONSTRUCT_IRI, $this->get_base($links[0]));

   865             }

   866             if ($links = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_20, 'link')) {

   867                 $this->data['links']['alternate'][] = $this->sanitize($links[0]['data'], \SimplePie\SimplePie::CONSTRUCT_IRI, $this->get_base($links[0]));

   868             }

   869             if ($links = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_RSS_20, 'guid')) {

   870                 if (!isset($links[0]['attribs']['']['isPermaLink']) || strtolower(trim($links[0]['attribs']['']['isPermaLink'])) === 'true') {

   871                     $this->data['links']['alternate'][] = $this->sanitize($links[0]['data'], \SimplePie\SimplePie::CONSTRUCT_IRI, $this->get_base($links[0]));

   872                 }

   873             }

   874 

   875             $keys = array_keys($this->data['links']);

   876             foreach ($keys as $key) {

   877                 if ($this->registry->call(Misc::class, 'is_isegment_nz_nc', [$key])) {

   878                     if (isset($this->data['links'][\SimplePie\SimplePie::IANA_LINK_RELATIONS_REGISTRY . $key])) {

   879                         $this->data['links'][\SimplePie\SimplePie::IANA_LINK_RELATIONS_REGISTRY . $key] = array_merge($this->data['links'][$key], $this->data['links'][\SimplePie\SimplePie::IANA_LINK_RELATIONS_REGISTRY . $key]);

   880                         $this->data['links'][$key] = &$this->data['links'][\SimplePie\SimplePie::IANA_LINK_RELATIONS_REGISTRY . $key];

   881                     } else {

   882                         $this->data['links'][\SimplePie\SimplePie::IANA_LINK_RELATIONS_REGISTRY . $key] = &$this->data['links'][$key];

   883                     }

   884                 } elseif (substr($key, 0, 41) === \SimplePie\SimplePie::IANA_LINK_RELATIONS_REGISTRY) {

   885                     $this->data['links'][substr($key, 41)] = &$this->data['links'][$key];

   886                 }

   887                 $this->data['links'][$key] = array_unique($this->data['links'][$key]);

   888             }

   889         }

   890         if (isset($this->data['links'][$rel])) {

   891             return $this->data['links'][$rel];

   892         }

   893 

   894         return null;

   895     }

   896 

   897     /**

   898      * Get an enclosure from the item

   899      *

   900      * Supports the <enclosure> RSS tag, as well as Media RSS and iTunes RSS.

   901      *

   902      * @since Beta 2

   903      * @todo Add ability to prefer one type of content over another (in a media group).

   904      * @param int $key The enclosure that you want to return.  Remember that arrays begin with 0, not 1

   905      * @return \SimplePie\Enclosure|null

   906      */

   907     public function get_enclosure($key = 0, $prefer = null)

   908     {

   909         $enclosures = $this->get_enclosures();

   910         if (isset($enclosures[$key])) {

   911             return $enclosures[$key];

   912         }

   913 

   914         return null;

   915     }

   916 

   917     /**

   918      * Get all available enclosures (podcasts, etc.)

   919      *

   920      * Supports the <enclosure> RSS tag, as well as Media RSS and iTunes RSS.

   921      *

   922      * At this point, we're pretty much assuming that all enclosures for an item

   923      * are the same content.  Anything else is too complicated to

   924      * properly support.

   925      *

   926      * @since Beta 2

   927      * @todo Add support for end-user defined sorting of enclosures by type/handler (so we can prefer the faster-loading FLV over MP4).

   928      * @todo If an element exists at a level, but its value is empty, we should fall back to the value from the parent (if it exists).

   929      * @return \SimplePie\Enclosure[]|null List of \SimplePie\Enclosure items

   930      */

   931     public function get_enclosures()

   932     {

   933         if (!isset($this->data['enclosures'])) {

   934             $this->data['enclosures'] = [];

   935 

   936             // Elements

   937             $captions_parent = null;

   938             $categories_parent = null;

   939             $copyrights_parent = null;

   940             $credits_parent = null;

   941             $description_parent = null;

   942             $duration_parent = null;

   943             $hashes_parent = null;

   944             $keywords_parent = null;

   945             $player_parent = null;

   946             $ratings_parent = null;

   947             $restrictions_parent = null;

   948             $thumbnails_parent = null;

   949             $title_parent = null;

   950 

   951             // Let's do the channel and item-level ones first, and just re-use them if we need to.

   952             $parent = $this->get_feed();

   953 

   954             // CAPTIONS

   955             if ($captions = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_MEDIARSS, 'text')) {

   956                 foreach ($captions as $caption) {

   957                     $caption_type = null;

   958                     $caption_lang = null;

   959                     $caption_startTime = null;

   960                     $caption_endTime = null;

   961                     $caption_text = null;

   962                     if (isset($caption['attribs']['']['type'])) {

   963                         $caption_type = $this->sanitize($caption['attribs']['']['type'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   964                     }

   965                     if (isset($caption['attribs']['']['lang'])) {

   966                         $caption_lang = $this->sanitize($caption['attribs']['']['lang'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   967                     }

   968                     if (isset($caption['attribs']['']['start'])) {

   969                         $caption_startTime = $this->sanitize($caption['attribs']['']['start'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   970                     }

   971                     if (isset($caption['attribs']['']['end'])) {

   972                         $caption_endTime = $this->sanitize($caption['attribs']['']['end'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   973                     }

   974                     if (isset($caption['data'])) {

   975                         $caption_text = $this->sanitize($caption['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   976                     }

   977                     $captions_parent[] = $this->registry->create(Caption::class, [$caption_type, $caption_lang, $caption_startTime, $caption_endTime, $caption_text]);

   978                 }

   979             } elseif ($captions = $parent->get_channel_tags(\SimplePie\SimplePie::NAMESPACE_MEDIARSS, 'text')) {

   980                 foreach ($captions as $caption) {

   981                     $caption_type = null;

   982                     $caption_lang = null;

   983                     $caption_startTime = null;

   984                     $caption_endTime = null;

   985                     $caption_text = null;

   986                     if (isset($caption['attribs']['']['type'])) {

   987                         $caption_type = $this->sanitize($caption['attribs']['']['type'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   988                     }

   989                     if (isset($caption['attribs']['']['lang'])) {

   990                         $caption_lang = $this->sanitize($caption['attribs']['']['lang'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   991                     }

   992                     if (isset($caption['attribs']['']['start'])) {

   993                         $caption_startTime = $this->sanitize($caption['attribs']['']['start'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   994                     }

   995                     if (isset($caption['attribs']['']['end'])) {

   996                         $caption_endTime = $this->sanitize($caption['attribs']['']['end'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

   997                     }

   998                     if (isset($caption['data'])) {

   999                         $caption_text = $this->sanitize($caption['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1000                     }

  1001                     $captions_parent[] = $this->registry->create(Caption::class, [$caption_type, $caption_lang, $caption_startTime, $caption_endTime, $caption_text]);

  1002                 }

  1003             }

  1004             if (is_array($captions_parent)) {

  1005                 $captions_parent = array_values(array_unique($captions_parent));

  1006             }

  1007 

  1008             // CATEGORIES

  1009             foreach ((array) $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_MEDIARSS, 'category') as $category) {

  1010                 $term = null;

  1011                 $scheme = null;

  1012                 $label = null;

  1013                 if (isset($category['data'])) {

  1014                     $term = $this->sanitize($category['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1015                 }

  1016                 if (isset($category['attribs']['']['scheme'])) {

  1017                     $scheme = $this->sanitize($category['attribs']['']['scheme'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1018                 } else {

  1019                     $scheme = 'http://search.yahoo.com/mrss/category_schema';

  1020                 }

  1021                 if (isset($category['attribs']['']['label'])) {

  1022                     $label = $this->sanitize($category['attribs']['']['label'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1023                 }

  1024                 $categories_parent[] = $this->registry->create(Category::class, [$term, $scheme, $label]);

  1025             }

  1026             foreach ((array) $parent->get_channel_tags(\SimplePie\SimplePie::NAMESPACE_MEDIARSS, 'category') as $category) {

  1027                 $term = null;

  1028                 $scheme = null;

  1029                 $label = null;

  1030                 if (isset($category['data'])) {

  1031                     $term = $this->sanitize($category['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1032                 }

  1033                 if (isset($category['attribs']['']['scheme'])) {

  1034                     $scheme = $this->sanitize($category['attribs']['']['scheme'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1035                 } else {

  1036                     $scheme = 'http://search.yahoo.com/mrss/category_schema';

  1037                 }

  1038                 if (isset($category['attribs']['']['label'])) {

  1039                     $label = $this->sanitize($category['attribs']['']['label'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1040                 }

  1041                 $categories_parent[] = $this->registry->create(Category::class, [$term, $scheme, $label]);

  1042             }

  1043             foreach ((array) $parent->get_channel_tags(\SimplePie\SimplePie::NAMESPACE_ITUNES, 'category') as $category) {

  1044                 $term = null;

  1045                 $scheme = 'http://www.itunes.com/dtds/podcast-1.0.dtd';

  1046                 $label = null;

  1047                 if (isset($category['attribs']['']['text'])) {

  1048                     $label = $this->sanitize($category['attribs']['']['text'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1049                 }

  1050                 $categories_parent[] = $this->registry->create(Category::class, [$term, $scheme, $label]);

  1051 

  1052                 if (isset($category['child'][\SimplePie\SimplePie::NAMESPACE_ITUNES]['category'])) {

  1053                     foreach ((array) $category['child'][\SimplePie\SimplePie::NAMESPACE_ITUNES]['category'] as $subcategory) {

  1054                         if (isset($subcategory['attribs']['']['text'])) {

  1055                             $label = $this->sanitize($subcategory['attribs']['']['text'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1056                         }

  1057                         $categories_parent[] = $this->registry->create(Category::class, [$term, $scheme, $label]);

  1058                     }

  1059                 }

  1060             }

  1061             if (is_array($categories_parent)) {

  1062                 $categories_parent = array_values(array_unique($categories_parent));

  1063             }

  1064 

  1065             // COPYRIGHT

  1066             if ($copyright = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_MEDIARSS, 'copyright')) {

  1067                 $copyright_url = null;

  1068                 $copyright_label = null;

  1069                 if (isset($copyright[0]['attribs']['']['url'])) {

  1070                     $copyright_url = $this->sanitize($copyright[0]['attribs']['']['url'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1071                 }

  1072                 if (isset($copyright[0]['data'])) {

  1073                     $copyright_label = $this->sanitize($copyright[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1074                 }

  1075                 $copyrights_parent = $this->registry->create(Copyright::class, [$copyright_url, $copyright_label]);

  1076             } elseif ($copyright = $parent->get_channel_tags(\SimplePie\SimplePie::NAMESPACE_MEDIARSS, 'copyright')) {

  1077                 $copyright_url = null;

  1078                 $copyright_label = null;

  1079                 if (isset($copyright[0]['attribs']['']['url'])) {

  1080                     $copyright_url = $this->sanitize($copyright[0]['attribs']['']['url'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1081                 }

  1082                 if (isset($copyright[0]['data'])) {

  1083                     $copyright_label = $this->sanitize($copyright[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1084                 }

  1085                 $copyrights_parent = $this->registry->create(Copyright::class, [$copyright_url, $copyright_label]);

  1086             }

  1087 

  1088             // CREDITS

  1089             if ($credits = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_MEDIARSS, 'credit')) {

  1090                 foreach ($credits as $credit) {

  1091                     $credit_role = null;

  1092                     $credit_scheme = null;

  1093                     $credit_name = null;

  1094                     if (isset($credit['attribs']['']['role'])) {

  1095                         $credit_role = $this->sanitize($credit['attribs']['']['role'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1096                     }

  1097                     if (isset($credit['attribs']['']['scheme'])) {

  1098                         $credit_scheme = $this->sanitize($credit['attribs']['']['scheme'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1099                     } else {

  1100                         $credit_scheme = 'urn:ebu';

  1101                     }

  1102                     if (isset($credit['data'])) {

  1103                         $credit_name = $this->sanitize($credit['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1104                     }

  1105                     $credits_parent[] = $this->registry->create(Credit::class, [$credit_role, $credit_scheme, $credit_name]);

  1106                 }

  1107             } elseif ($credits = $parent->get_channel_tags(\SimplePie\SimplePie::NAMESPACE_MEDIARSS, 'credit')) {

  1108                 foreach ($credits as $credit) {

  1109                     $credit_role = null;

  1110                     $credit_scheme = null;

  1111                     $credit_name = null;

  1112                     if (isset($credit['attribs']['']['role'])) {

  1113                         $credit_role = $this->sanitize($credit['attribs']['']['role'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1114                     }

  1115                     if (isset($credit['attribs']['']['scheme'])) {

  1116                         $credit_scheme = $this->sanitize($credit['attribs']['']['scheme'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1117                     } else {

  1118                         $credit_scheme = 'urn:ebu';

  1119                     }

  1120                     if (isset($credit['data'])) {

  1121                         $credit_name = $this->sanitize($credit['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1122                     }

  1123                     $credits_parent[] = $this->registry->create(Credit::class, [$credit_role, $credit_scheme, $credit_name]);

  1124                 }

  1125             }

  1126             if (is_array($credits_parent)) {

  1127                 $credits_parent = array_values(array_unique($credits_parent));

  1128             }

  1129 

  1130             // DESCRIPTION

  1131             if ($description_parent = $this->get_item_tags(\SimplePie\SimplePie::NAMESPACE_MEDIARSS, 'description')) {

  1132                 if (isset($description_parent[0]['data'])) {

  1133                     $description_parent = $this->sanitize($description_parent[0]['data'], \SimplePie\SimplePie::CONSTRUCT_TEXT);

  1134                 }

  1135             } elseif ($description_parent = $parent->get_channel_tags(\SimplePie\SimplePie::NAMESPACE_MEDIARSS, 'description')) {

  1136                 if (isset($description_parent[0]['data'])) {