admin-pages
1 year ago
core-api
1 year ago
debugger
1 year ago
markdown
1 year ago
class-jetpack-ai-helper.php
1 year ago
class-jetpack-blog-stats-helper.php
1 year ago
class-jetpack-currencies.php
2 years ago
class-jetpack-instagram-gallery-helper.php
2 years ago
class-jetpack-mapbox-helper.php
3 years ago
class-jetpack-podcast-feed-locator.php
1 year ago
class-jetpack-podcast-helper.php
1 year ago
class-jetpack-recommendations.php
2 years ago
class-jetpack-top-posts-helper.php
1 year ago
class.color.php
2 years ago
class.core-rest-api-endpoints.php
1 year ago
class.jetpack-automatic-install-skin.php
2 years ago
class.jetpack-iframe-embed.php
3 years ago
class.jetpack-password-checker.php
2 years ago
class.jetpack-search-performance-logger.php
4 years ago
class.media-extractor.php
2 years ago
class.media-summary.php
1 year ago
class.media.php
2 years ago
components.php
1 year ago
debugger.php
2 years ago
icalendar-reader.php
1 year ago
markdown.php
3 years ago
plans.php
4 years ago
plugins.php
4 years ago
tonesque.php
2 years ago
widgets.php
2 years ago
class-jetpack-podcast-feed-locator.php
108 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Extension of the SimplePie\Locator class, to detect podcast feeds |
| 4 | * |
| 5 | * @package automattic/jetpack |
| 6 | */ |
| 7 | |
| 8 | /** |
| 9 | * Class Jetpack_Podcast_Feed_Locator |
| 10 | */ |
| 11 | class Jetpack_Podcast_Feed_Locator extends SimplePie\Locator { |
| 12 | /** |
| 13 | * Overrides the locator is_feed function to check for |
| 14 | * appropriate podcast elements. |
| 15 | * |
| 16 | * @param SimplePie\File $file The file being checked. |
| 17 | * @param boolean $check_html Adds text/html to the mimetypes checked. |
| 18 | */ |
| 19 | public function is_feed( $file, $check_html = false ) { |
| 20 | return parent::is_feed( $file, $check_html ) && $this->is_podcast_feed( $file ); |
| 21 | } |
| 22 | |
| 23 | /** |
| 24 | * Checks the contents of the file for elements that make |
| 25 | * it a podcast feed. |
| 26 | * |
| 27 | * @param SimplePie\File $file The file being checked. |
| 28 | */ |
| 29 | private function is_podcast_feed( $file ) { |
| 30 | // If we can't read the DOM assume it's a podcast feed, we'll work |
| 31 | // it out later. |
| 32 | if ( ! class_exists( 'DOMDocument' ) ) { |
| 33 | return true; |
| 34 | } |
| 35 | |
| 36 | $feed_dom = $this->safely_load_xml( $file->body ); |
| 37 | |
| 38 | // Do this as either/or but prioritise the itunes namespace. It's pretty likely |
| 39 | // that it's a podcast feed we've found if that namespace is present. |
| 40 | return $feed_dom && $this->has_itunes_ns( $feed_dom ) && $this->has_audio_enclosures( $feed_dom ); |
| 41 | } |
| 42 | |
| 43 | /** |
| 44 | * Safely loads an XML file |
| 45 | * |
| 46 | * @param string $xml A string of XML to load. |
| 47 | * @return DOMDocument|false A restulting DOM document or `false` if there is an error. |
| 48 | */ |
| 49 | private function safely_load_xml( $xml ) { |
| 50 | $disable_entity_loader = PHP_VERSION_ID < 80000; |
| 51 | |
| 52 | if ( $disable_entity_loader ) { |
| 53 | // This function has been deprecated in PHP 8.0 because in libxml 2.9.0, external entity loading |
| 54 | // is disabled by default, so this function is no longer needed to protect against XXE attacks. |
| 55 | // phpcs:ignore Generic.PHP.DeprecatedFunctions.Deprecated, PHPCompatibility.FunctionUse.RemovedFunctions.libxml_disable_entity_loaderDeprecated |
| 56 | $loader = libxml_disable_entity_loader( true ); |
| 57 | } |
| 58 | |
| 59 | $errors = libxml_use_internal_errors( true ); |
| 60 | |
| 61 | $return = new DOMDocument(); |
| 62 | if ( ! $return->loadXML( $xml ) ) { |
| 63 | return false; |
| 64 | } |
| 65 | |
| 66 | libxml_use_internal_errors( $errors ); |
| 67 | |
| 68 | if ( $disable_entity_loader && isset( $loader ) ) { |
| 69 | // phpcs:ignore Generic.PHP.DeprecatedFunctions.Deprecated, PHPCompatibility.FunctionUse.RemovedFunctions.libxml_disable_entity_loaderDeprecated |
| 70 | libxml_disable_entity_loader( $loader ); |
| 71 | } |
| 72 | |
| 73 | return $return; |
| 74 | } |
| 75 | |
| 76 | /** |
| 77 | * Checks the RSS feed for the presence of the itunes podcast namespace. |
| 78 | * It's pretty loose and just checks the URI for itunes.com |
| 79 | * |
| 80 | * @param DOMDocument $dom The XML document to check. |
| 81 | * @return boolean Whether the itunes namespace is defined. |
| 82 | */ |
| 83 | private function has_itunes_ns( $dom ) { |
| 84 | $xpath = new DOMXPath( $dom ); |
| 85 | foreach ( $xpath->query( 'namespace::*' ) as $node ) { |
| 86 | // phpcs:disable WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase |
| 87 | // nodeValue is not valid, but it's part of the DOM API that we don't control. |
| 88 | if ( strstr( $node->nodeValue, 'itunes.com' ) ) { |
| 89 | return true; |
| 90 | } |
| 91 | // phpcs:enable |
| 92 | } |
| 93 | return false; |
| 94 | } |
| 95 | |
| 96 | /** |
| 97 | * Checks the RSS feed for the presence of enclosures with an audio mimetype. |
| 98 | * |
| 99 | * @param DOMDocument $dom The XML document to check. |
| 100 | * @return boolean Whether enclosures were found. |
| 101 | */ |
| 102 | private function has_audio_enclosures( $dom ) { |
| 103 | $xpath = new DOMXPath( $dom ); |
| 104 | $enclosures = $xpath->query( "//enclosure[starts-with(@type,'audio/')]" ); |
| 105 | return ! $enclosures ? false : $enclosures->length > 0; |
| 106 | } |
| 107 | } |
| 108 |