apply_filters( 'pre_oembed_result', null|string $result, string $url, array $args )

Filters the oEmbed result before any HTTP requests are made.


Description Description

This allows one to short-circuit the default logic, perhaps by replacing it with a routine that is more optimal for your setup.

Passing a non-null value to the filter will effectively short-circuit retrieval, returning the passed value instead.


Parameters Parameters

$result

(null|string) The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Default null.

$url

(string) The URL to the content that should be attempted to be embedded.

$args

(array) Arguments, usually passed from a shortcode. Default empty.


Top ↑

Source Source

File: wp-includes/class-wp-oembed.php

View on Trac


Top ↑

Changelog Changelog

Changelog
Version Description
4.5.3 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.