[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-includes/SimplePie/src/ -> Enclosure.php (summary)

(no description)

File Size: 1217 lines (32 kb)
Included or required:0 times
Referenced: 0 times
Includes or requires: 0 files

Defines 1 class

Enclosure:: (41 methods):
  __construct()
  __toString()
  get_bitrate()
  get_caption()
  get_captions()
  get_category()
  get_categories()
  get_channels()
  get_copyright()
  get_credit()
  get_credits()
  get_description()
  get_duration()
  get_expression()
  get_extension()
  get_framerate()
  get_handler()
  get_hash()
  get_hashes()
  get_height()
  get_language()
  get_keyword()
  get_keywords()
  get_length()
  get_link()
  get_medium()
  get_player()
  get_rating()
  get_ratings()
  get_restriction()
  get_restrictions()
  get_sampling_rate()
  get_size()
  get_thumbnail()
  get_thumbnails()
  get_title()
  get_type()
  get_width()
  native_embed()
  embed()
  get_real_type()


Class: Enclosure  - X-Ref

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()}
__construct(?string $link = null,?string $type = null,?int $length = null,$javascript = null,?string $bitrate = null,?array $captions = null,?array $categories = null,?int $channels = null,?Copyright $copyright = null,?array $credits = null,?string $description = null,?int $duration = null,?string $expression = null,?string $framerate = null,?array $hashes = null,?string $height = null,?array $keywords = null,?string $lang = null,?string $medium = null,?string $player = null,?array $ratings = null,?array $restrictions = null,?string $samplingrate = null,?array $thumbnails = null,?string $title = null,?string $width = null)   X-Ref
Constructor, used to input the data

For documentation on all the parameters, see the corresponding
properties and their accessors

param: null $javascript
param: Caption[]|null $captions
param: Category[]|null $categories
param: Credit[]|null $credits
param: string[]|null $hashes
param: string[]|null $keywords
param: Rating[]|null $ratings
param: Restriction[]|null $restrictions
param: string[]|null $thumbnails

__toString()   X-Ref
String-ified version

return: string

get_bitrate()   X-Ref
Get the bitrate

return: string|null

get_caption(int $key = 0)   X-Ref
Get a single caption

return: \SimplePie\Caption|null
param: int $key

get_captions()   X-Ref
Get all captions

return: Caption[]|null

get_category(int $key = 0)   X-Ref
Get a single category

return: \SimplePie\Category|null
param: int $key

get_categories()   X-Ref
Get all categories

return: \SimplePie\Category[]|null

get_channels()   X-Ref
Get the number of audio channels

return: int|null

get_copyright()   X-Ref
Get the copyright information

return: \SimplePie\Copyright|null

get_credit(int $key = 0)   X-Ref
Get a single credit

return: \SimplePie\Credit|null
param: int $key

get_credits()   X-Ref
Get all credits

return: Credit[]|null

get_description()   X-Ref
Get the description of the enclosure

return: string|null

get_duration(bool $convert = false)   X-Ref
Get the duration of the enclosure

return: string|int|null 'hh:mm:ss' string if `$convert` was specified, otherwise integer (or null if none found)
param: bool $convert Convert seconds into hh:mm:ss

get_expression()   X-Ref
Get the expression

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

get_extension()   X-Ref
Get the file extension

return: string|null

get_framerate()   X-Ref
Get the framerate (in frames-per-second)

return: string|null

get_handler()   X-Ref
Get the preferred handler

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

get_hash(int $key = 0)   X-Ref
Get a single hash

return: string|null Hash as per `media:hash`, prefixed with "$algo:"
param: int $key

get_hashes()   X-Ref
Get all credits

return: string[]|null Array of strings, see {@see get_hash()}

get_height()   X-Ref
Get the height

return: string|null

get_language()   X-Ref
Get the language

return: string|null Language code as per RFC 3066

get_keyword(int $key = 0)   X-Ref
Get a single keyword

return: string|null
param: int $key

get_keywords()   X-Ref
Get all keywords

return: string[]|null

get_length()   X-Ref
Get length

return: ?int Length in bytes

get_link()   X-Ref
Get the URL

return: string|null

get_medium()   X-Ref
Get the medium

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

get_player()   X-Ref
Get the player URL

Typically the same as {@see get_permalink()}
return: string|null Player URL

get_rating(int $key = 0)   X-Ref
Get a single rating

return: \SimplePie\Rating|null
param: int $key

get_ratings()   X-Ref
Get all ratings

return: Rating[]|null

get_restriction(int $key = 0)   X-Ref
Get a single restriction

return: \SimplePie\Restriction|null
param: int $key

get_restrictions()   X-Ref
Get all restrictions

return: Restriction[]|null

get_sampling_rate()   X-Ref
Get the sampling rate (in kHz)

return: string|null

get_size()   X-Ref
Get the file size (in MiB)

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

get_thumbnail(int $key = 0)   X-Ref
Get a single thumbnail

return: string|null Thumbnail URL
param: int $key

get_thumbnails()   X-Ref
Get all thumbnails

return: string[]|null Array of thumbnail URLs

get_title()   X-Ref
Get the title

return: string|null

get_type()   X-Ref
Get mimetype of the enclosure

return: string|null MIME type

get_width()   X-Ref
Get the width

return: string|null

native_embed($options = '')   X-Ref
Embed the enclosure using `<embed>`

return: string HTML string to output
param: array<string, mixed>|string $options See first parameter to {@see embed}

embed($options = '', bool $native = false)   X-Ref
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.

return: string HTML string to output
param: array<string, mixed>|string $options Comma-separated key:value list, or array
param: bool $native Use `<embed>`

get_real_type(bool $find_handler = false)   X-Ref
Get the real media type

Often, feeds lie to us, necessitating a bit of deeper inspection. This
converts types to their canonical representations based on the file
extension

return: string|null MIME type
param: bool $find_handler Internal use only, use {@see get_handler()} instead



Generated : Thu Sep 18 08:20:05 2025 Cross-referenced by PHPXref