Proyectos de Subversion Moodle

<?php

declare(strict_types=1);

/**

 * SimplePie

 *

 * A PHP-Based RSS and Atom Feed Framework.

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

 *

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

 * All rights reserved.

 *

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

 * permitted provided that the following conditions are met:

 *

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

 * 	  conditions and the following disclaimer.

 *

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

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

 * 	  provided with the distribution.

 *

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

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

 * 	  written permission.

 *

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

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

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

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

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

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

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

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

 * POSSIBILITY OF SUCH DAMAGE.

 *

 * @package SimplePie

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

 * @author Ryan Parman

 * @author Sam Sneddon

 * @author Ryan McCue

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

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

 */

namespace SimplePie;

/**

 * Handles everything related to enclosures (including Media RSS and iTunes RSS)

 *

 * Used by {@see \SimplePie\Item::get_enclosure()} and {@see \SimplePie\Item::get_enclosures()}

 *

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

 *

 * @package SimplePie

 * @subpackage API

 */

class Enclosure

{

    /**

     * @var string

     * @see get_bitrate()

     */

    public $bitrate;

    /**

     * @var array

     * @see get_captions()

     */

    public $captions;

    /**

     * @var array

     * @see get_categories()

     */

    public $categories;

    /**

     * @var int

     * @see get_channels()

     */

    public $channels;

    /**

     * @var \SimplePie\Copyright

     * @see get_copyright()

     */

    public $copyright;

    /**

     * @var array

     * @see get_credits()

     */

    public $credits;

    /**

     * @var string

     * @see get_description()

     */

    public $description;

    /**

     * @var int

     * @see get_duration()

     */

    public $duration;

    /**

     * @var string

     * @see get_expression()

     */

    public $expression;

    /**

     * @var string

     * @see get_framerate()

     */

    public $framerate;

    /**

     * @var string

     * @see get_handler()

     */

    public $handler;

    /**

     * @var array

     * @see get_hashes()

     */

    public $hashes;

    /**

     * @var string

     * @see get_height()

     */

    public $height;

    /**

     * @deprecated

     * @var null

     */

    public $javascript;

    /**

     * @var array

     * @see get_keywords()

     */

    public $keywords;

    /**

     * @var string

     * @see get_language()

     */

    public $lang;

    /**

     * @var string

     * @see get_length()

     */

    public $length;

    /**

     * @var string

     * @see get_link()

     */

    public $link;

    /**

     * @var string

     * @see get_medium()

     */

    public $medium;

    /**

     * @var string

     * @see get_player()

     */

    public $player;

    /**

     * @var array

     * @see get_ratings()

     */

    public $ratings;

    /**

     * @var array

     * @see get_restrictions()

     */

    public $restrictions;

    /**

     * @var string

     * @see get_sampling_rate()

     */

    public $samplingrate;

    /**

     * @var array

     * @see get_thumbnails()

     */

    public $thumbnails;

    /**

     * @var string

     * @see get_title()

     */

    public $title;

    /**

     * @var string

     * @see get_type()

     */

    public $type;

    /**

     * @var string

     * @see get_width()

     */

    public $width;

    /**

     * Constructor, used to input the data

     *

     * For documentation on all the parameters, see the corresponding

     * properties and their accessors

     *

     * @uses idna_convert If available, this will convert an IDN

     */

    public function __construct($link = null, $type = null, $length = null, $javascript = null, $bitrate = null, $captions = null, $categories = null, $channels = null, $copyright = null, $credits = null, $description = null, $duration = null, $expression = null, $framerate = null, $hashes = null, $height = null, $keywords = null, $lang = null, $medium = null, $player = null, $ratings = null, $restrictions = null, $samplingrate = null, $thumbnails = null, $title = null, $width = null)

    {

        $this->bitrate = $bitrate;

        $this->captions = $captions;

        $this->categories = $categories;

        $this->channels = $channels;

        $this->copyright = $copyright;

        $this->credits = $credits;

        $this->description = $description;

        $this->duration = $duration;

        $this->expression = $expression;

        $this->framerate = $framerate;

        $this->hashes = $hashes;

        $this->height = $height;

        $this->keywords = $keywords;

        $this->lang = $lang;

        $this->length = $length;

        $this->link = $link;

        $this->medium = $medium;

        $this->player = $player;

        $this->ratings = $ratings;

        $this->restrictions = $restrictions;

        $this->samplingrate = $samplingrate;

        $this->thumbnails = $thumbnails;

        $this->title = $title;

        $this->type = $type;

        $this->width = $width;

        if (class_exists('idna_convert')) {

            $idn = new \idna_convert();

            $parsed = \SimplePie\Misc::parse_url($link);

            $this->link = \SimplePie\Misc::compress_parse_url($parsed['scheme'], $idn->encode($parsed['authority']), $parsed['path'], $parsed['query'], $parsed['fragment']);

        }

        $this->handler = $this->get_handler(); // Needs to load last

    }

    /**

     * String-ified version

     *

     * @return string

     */

    public function __toString()

    {

        // There is no $this->data here

        return md5(serialize($this));

    }

    /**

     * Get the bitrate

     *

     * @return string|null

     */

    public function get_bitrate()

    {

        if ($this->bitrate !== null) {

            return $this->bitrate;

        }

        return null;

    }

    /**

     * Get a single caption

     *

     * @param int $key

     * @return \SimplePie\Caption|null

     */

    public function get_caption($key = 0)

    {

        $captions = $this->get_captions();

        if (isset($captions[$key])) {

            return $captions[$key];

        }

        return null;

    }

    /**

     * Get all captions

     *

     * @return array|null Array of {@see \SimplePie\Caption} objects

     */

    public function get_captions()

    {

        if ($this->captions !== null) {

            return $this->captions;

        }

        return null;

    }

    /**

     * Get a single category

     *

     * @param int $key

     * @return \SimplePie\Category|null

     */

    public function get_category($key = 0)

    {

        $categories = $this->get_categories();

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

            return $categories[$key];

        }

        return null;

    }

    /**

     * Get all categories

     *

     * @return array|null Array of {@see \SimplePie\Category} objects

     */

    public function get_categories()

    {

        if ($this->categories !== null) {

            return $this->categories;

        }

        return null;

    }

    /**

     * Get the number of audio channels

     *

     * @return int|null

     */

    public function get_channels()

    {

        if ($this->channels !== null) {

            return $this->channels;

        }

        return null;

    }

    /**

     * Get the copyright information

     *

     * @return \SimplePie\Copyright|null

     */

    public function get_copyright()

    {

        if ($this->copyright !== null) {

            return $this->copyright;

        }

        return null;

    }

    /**

     * Get a single credit

     *

     * @param int $key

     * @return \SimplePie\Credit|null

     */

    public function get_credit($key = 0)

    {

        $credits = $this->get_credits();

        if (isset($credits[$key])) {

            return $credits[$key];

        }

        return null;

    }

    /**

     * Get all credits

     *

     * @return array|null Array of {@see \SimplePie\Credit} objects

     */

    public function get_credits()

    {

        if ($this->credits !== null) {

            return $this->credits;

        }

        return null;

    }

    /**

     * Get the description of the enclosure

     *

     * @return string|null

     */

    public function get_description()

    {

        if ($this->description !== null) {

            return $this->description;

        }

        return null;

    }

    /**

     * Get the duration of the enclosure

     *

     * @param bool $convert Convert seconds into hh:mm:ss

     * @return string|int|null 'hh:mm:ss' string if `$convert` was specified, otherwise integer (or null if none found)

     */

    public function get_duration($convert = false)

    {

        if ($this->duration !== null) {

            if ($convert) {

                $time = \SimplePie\Misc::time_hms($this->duration);

                return $time;

            }

            return $this->duration;

        }

        return null;

    }

    /**

     * Get the expression

     *

     * @return string Probably one of 'sample', 'full', 'nonstop', 'clip'. Defaults to 'full'

     */

    public function get_expression()

    {

        if ($this->expression !== null) {

            return $this->expression;

        }

        return 'full';

    }

    /**

     * Get the file extension

     *

     * @return string|null

     */

    public function get_extension()

    {

        if ($this->link !== null) {

            $url = \SimplePie\Misc::parse_url($this->link);

            if ($url['path'] !== '') {

                return pathinfo($url['path'], PATHINFO_EXTENSION);

            }

        }

        return null;

    }

    /**

     * Get the framerate (in frames-per-second)

     *

     * @return string|null

     */

    public function get_framerate()

    {

        if ($this->framerate !== null) {

            return $this->framerate;

        }

        return null;

    }

    /**

     * Get the preferred handler

     *

     * @return string|null One of 'flash', 'fmedia', 'quicktime', 'wmedia', 'mp3'

     */

    public function get_handler()

    {

        return $this->get_real_type(true);

    }

    /**

     * Get a single hash

     *

     * @link http://www.rssboard.org/media-rss#media-hash

     * @param int $key

     * @return string|null Hash as per `media:hash`, prefixed with "$algo:"

     */

    public function get_hash($key = 0)

    {

        $hashes = $this->get_hashes();

        if (isset($hashes[$key])) {

            return $hashes[$key];

        }

        return null;

    }

    /**

     * Get all credits

     *

     * @return array|null Array of strings, see {@see get_hash()}

     */

    public function get_hashes()

    {

        if ($this->hashes !== null) {

            return $this->hashes;

        }

        return null;

    }

    /**

     * Get the height

     *

     * @return string|null

     */

    public function get_height()

    {

        if ($this->height !== null) {

            return $this->height;

        }

        return null;

    }

    /**

     * Get the language

     *

     * @link http://tools.ietf.org/html/rfc3066

     * @return string|null Language code as per RFC 3066

     */

    public function get_language()

    {

        if ($this->lang !== null) {

            return $this->lang;

        }

        return null;

    }

    /**

     * Get a single keyword

     *

     * @param int $key

     * @return string|null

     */

    public function get_keyword($key = 0)

    {

        $keywords = $this->get_keywords();

        if (isset($keywords[$key])) {

            return $keywords[$key];

        }

        return null;

    }

    /**

     * Get all keywords

     *

     * @return array|null Array of strings

     */

    public function get_keywords()

    {

        if ($this->keywords !== null) {

            return $this->keywords;

        }

        return null;

    }

    /**

     * Get length

     *

     * @return float Length in bytes

     */

    public function get_length()

    {

        if ($this->length !== null) {

            return $this->length;

        }

        return null;

    }

    /**

     * Get the URL

     *

     * @return string|null

     */

    public function get_link()

    {

        if ($this->link !== null) {

            return $this->link;

        }

        return null;

    }

    /**

     * Get the medium

     *

     * @link http://www.rssboard.org/media-rss#media-content

     * @return string|null Should be one of 'image', 'audio', 'video', 'document', 'executable'

     */

    public function get_medium()

    {

        if ($this->medium !== null) {

            return $this->medium;

        }

        return null;

    }

    /**

     * Get the player URL

     *

     * Typically the same as {@see get_permalink()}

     * @return string|null Player URL

     */

    public function get_player()

    {

        if ($this->player !== null) {

            return $this->player;

        }

        return null;

    }

    /**

     * Get a single rating

     *

     * @param int $key

     * @return \SimplePie\Rating|null

     */

    public function get_rating($key = 0)

    {

        $ratings = $this->get_ratings();

        if (isset($ratings[$key])) {

            return $ratings[$key];

        }

        return null;

    }

    /**

     * Get all ratings

     *

     * @return array|null Array of {@see \SimplePie\Rating} objects

     */

    public function get_ratings()

    {

        if ($this->ratings !== null) {

            return $this->ratings;

        }

        return null;

    }

    /**

     * Get a single restriction

     *

     * @param int $key

     * @return \SimplePie\Restriction|null

     */

    public function get_restriction($key = 0)

    {

        $restrictions = $this->get_restrictions();

        if (isset($restrictions[$key])) {

            return $restrictions[$key];

        }

        return null;

    }

    /**

     * Get all restrictions

     *

     * @return array|null Array of {@see \SimplePie\Restriction} objects

     */

    public function get_restrictions()

    {

        if ($this->restrictions !== null) {

            return $this->restrictions;

        }

        return null;

    }

    /**

     * Get the sampling rate (in kHz)

     *

     * @return string|null

     */

    public function get_sampling_rate()

    {

        if ($this->samplingrate !== null) {

            return $this->samplingrate;

        }

        return null;

    }

    /**

     * Get the file size (in MiB)

     *

     * @return float|null File size in mebibytes (1048 bytes)

     */

    public function get_size()

    {

        $length = $this->get_length();

        if ($length !== null) {

            return round($length/1048576, 2);

        }

        return null;

    }

    /**

     * Get a single thumbnail

     *

     * @param int $key

     * @return string|null Thumbnail URL

     */

    public function get_thumbnail($key = 0)

    {

        $thumbnails = $this->get_thumbnails();

        if (isset($thumbnails[$key])) {

            return $thumbnails[$key];

        }

        return null;

    }

    /**

     * Get all thumbnails

     *

     * @return array|null Array of thumbnail URLs

     */

    public function get_thumbnails()

    {

        if ($this->thumbnails !== null) {

            return $this->thumbnails;

        }

        return null;

    }

    /**

     * Get the title

     *

     * @return string|null

     */

    public function get_title()

    {

        if ($this->title !== null) {

            return $this->title;

        }

        return null;

    }

    /**

     * Get mimetype of the enclosure

     *

     * @see get_real_type()

     * @return string|null MIME type

     */

    public function get_type()

    {

        if ($this->type !== null) {

            return $this->type;

        }

        return null;

    }

    /**

     * Get the width

     *

     * @return string|null

     */

    public function get_width()

    {

        if ($this->width !== null) {

            return $this->width;

        }

        return null;

    }

    /**

     * Embed the enclosure using `<embed>`

     *

     * @deprecated Use the second parameter to {@see embed} instead

     *

     * @param array|string $options See first parameter to {@see embed}

     * @return string HTML string to output

     */

    public function native_embed($options='')

    {

        return $this->embed($options, true);

    }

    /**

     * Embed the enclosure using Javascript

     *

     * `$options` is an array or comma-separated key:value string, with the

     * following properties:

     *

     * - `alt` (string): Alternate content for when an end-user does not have

     *    the appropriate handler installed or when a file type is

     *    unsupported. Can be any text or HTML. Defaults to blank.

     * - `altclass` (string): If a file type is unsupported, the end-user will

     *    see the alt text (above) linked directly to the content. That link

     *    will have this value as its class name. Defaults to blank.

     * - `audio` (string): This is an image that should be used as a

     *    placeholder for audio files before they're loaded (QuickTime-only).

     *    Can be any relative or absolute URL. Defaults to blank.

     * - `bgcolor` (string): The background color for the media, if not

     *    already transparent. Defaults to `#ffffff`.

     * - `height` (integer): The height of the embedded media. Accepts any

     *    numeric pixel value (such as `360`) or `auto`. Defaults to `auto`,

     *    and it is recommended that you use this default.

     * - `loop` (boolean): Do you want the media to loop when it's done?

     *    Defaults to `false`.

     * - `mediaplayer` (string): The location of the included

     *    `mediaplayer.swf` file. This allows for the playback of Flash Video

     *    (`.flv`) files, and is the default handler for non-Odeo MP3's.

     *    Defaults to blank.

     * - `video` (string): This is an image that should be used as a

     *    placeholder for video files before they're loaded (QuickTime-only).

     *    Can be any relative or absolute URL. Defaults to blank.

     * - `width` (integer): The width of the embedded media. Accepts any

     *    numeric pixel value (such as `480`) or `auto`. Defaults to `auto`,

     *    and it is recommended that you use this default.

     * - `widescreen` (boolean): Is the enclosure widescreen or standard?

     *    This applies only to video enclosures, and will automatically resize

     *    the content appropriately.  Defaults to `false`, implying 4:3 mode.

     *

     * Note: Non-widescreen (4:3) mode with `width` and `height` set to `auto`

     * will default to 480x360 video resolution.  Widescreen (16:9) mode with

     * `width` and `height` set to `auto` will default to 480x270 video resolution.

     *

     * @todo If the dimensions for media:content are defined, use them when width/height are set to 'auto'.

     * @param array|string $options Comma-separated key:value list, or array

     * @param bool $native Use `<embed>`

     * @return string HTML string to output

     */

    public function embed($options = '', $native = false)

    {

        // Set up defaults

        $audio = '';

        $video = '';

        $alt = '';

        $altclass = '';

        $loop = 'false';

        $width = 'auto';

        $height = 'auto';

        $bgcolor = '#ffffff';

        $mediaplayer = '';

        $widescreen = false;

        $handler = $this->get_handler();

        $type = $this->get_real_type();

        $placeholder = '';

        // Process options and reassign values as necessary

        if (is_array($options)) {

            extract($options);

        } else {

            $options = explode(',', $options);

            foreach ($options as $option) {

                $opt = explode(':', $option, 2);

                if (isset($opt[0], $opt[1])) {

                    $opt[0] = trim($opt[0]);

                    $opt[1] = trim($opt[1]);

                    switch ($opt[0]) {

                        case 'audio':

                            $audio = $opt[1];

                            break;

                        case 'video':

                            $video = $opt[1];

                            break;

                        case 'alt':

                            $alt = $opt[1];

                            break;

                        case 'altclass':

                            $altclass = $opt[1];

                            break;

                        case 'loop':

                            $loop = $opt[1];

                            break;

                        case 'width':

                            $width = $opt[1];

                            break;

                        case 'height':

                            $height = $opt[1];

                            break;

                        case 'bgcolor':

                            $bgcolor = $opt[1];

                            break;

                        case 'mediaplayer':

                            $mediaplayer = $opt[1];

                            break;

                        case 'widescreen':

                            $widescreen = $opt[1];

                            break;

                    }

                }

            }

        }

        $mime = explode('/', $type, 2);

        $mime = $mime[0];

        // Process values for 'auto'

        if ($width === 'auto') {

            if ($mime === 'video') {

                if ($height === 'auto') {

                    $width = 480;

                } elseif ($widescreen) {

                    $width = round((intval($height)/9)*16);

                } else {

                    $width = round((intval($height)/3)*4);

                }

            } else {

                $width = '100%';

            }

        }

        if ($height === 'auto') {

            if ($mime === 'audio') {

                $height = 0;

            } elseif ($mime === 'video') {

                if ($width === 'auto') {

                    if ($widescreen) {

                        $height = 270;

                    } else {

                        $height = 360;

                    }

                } elseif ($widescreen) {

                    $height = round((intval($width)/16)*9);

                } else {

                    $height = round((intval($width)/4)*3);

                }

            } else {

                $height = 376;

            }

        } elseif ($mime === 'audio') {

            $height = 0;

        }

        // Set proper placeholder value

        if ($mime === 'audio') {

            $placeholder = $audio;

        } elseif ($mime === 'video') {

            $placeholder = $video;

        }

        $embed = '';

        // Flash

        if ($handler === 'flash') {

            if ($native) {

                $embed .= "<embed src=\"" . $this->get_link() . "\" pluginspage=\"http://adobe.com/go/getflashplayer\" type=\"$type\" quality=\"high\" width=\"$width\" height=\"$height\" bgcolor=\"$bgcolor\" loop=\"$loop\"></embed>";

            } else {

                $embed .= "<script type='text/javascript'>embed_flash('$bgcolor', '$width', '$height', '" . $this->get_link() . "', '$loop', '$type');</script>";

            }

        }

        // Flash Media Player file types.

        // Preferred handler for MP3 file types.

        elseif ($handler === 'fmedia' || ($handler === 'mp3' && $mediaplayer !== '')) {

            $height += 20;

            if ($native) {

                $embed .= "<embed src=\"$mediaplayer\" pluginspage=\"http://adobe.com/go/getflashplayer\" type=\"application/x-shockwave-flash\" quality=\"high\" width=\"$width\" height=\"$height\" wmode=\"transparent\" flashvars=\"file=" . rawurlencode($this->get_link().'?file_extension=.'.$this->get_extension()) . "&autostart=false&repeat=$loop&showdigits=true&showfsbutton=false\"></embed>";

            } else {

                $embed .= "<script type='text/javascript'>embed_flv('$width', '$height', '" . rawurlencode($this->get_link().'?file_extension=.'.$this->get_extension()) . "', '$placeholder', '$loop', '$mediaplayer');</script>";

            }