/** * WP_oEmbed_Controller class, used to provide an oEmbed endpoint. * * @package WordPress * @subpackage Embeds * @since 4.4.0 */ /** * oEmbed API endpoint controller. * * Registers the REST API route and delivers the response data. * The output format (XML or JSON) is handled by the REST API. * * @since 4.4.0 */ #[AllowDynamicProperties] final class WP_oEmbed_Controller { /** * Register the oEmbed REST API route. * * @since 4.4.0 */ public function register_routes() { /** * Filters the maxwidth oEmbed parameter. * * @since 4.4.0 * * @param int $maxwidth Maximum allowed width. Default 600. */ $maxwidth = apply_filters( 'oembed_default_width', 600 ); register_rest_route( 'oembed/1.0', '/embed', array( array( 'methods' => WP_REST_Server::READABLE, 'callback' => array( $this, 'get_item' ), 'permission_callback' => '__return_true', 'args' => array( 'url' => array( 'description' => __( 'The URL of the resource for which to fetch oEmbed data.' ), 'required' => true, 'type' => 'string', 'format' => 'uri', ), 'format' => array( 'default' => 'json', 'sanitize_callback' => 'wp_oembed_ensure_format', ), 'maxwidth' => array( 'default' => $maxwidth, 'sanitize_callback' => 'absint', ), ), ), ) ); register_rest_route( 'oembed/1.0', '/proxy', array( array( 'methods' => WP_REST_Server::READABLE, 'callback' => array( $this, 'get_proxy_item' ), 'permission_callback' => array( $this, 'get_proxy_item_permissions_check' ), 'args' => array( 'url' => array( 'description' => __( 'The URL of the resource for which to fetch oEmbed data.' ), 'required' => true, 'type' => 'string', 'format' => 'uri', ), 'format' => array( 'description' => __( 'The oEmbed format to use.' ), 'type' => 'string', 'default' => 'json', 'enum' => array( 'json', 'xml', ), ), 'maxwidth' => array( 'description' => __( 'The maximum width of the embed frame in pixels.' ), 'type' => 'integer', 'default' => $maxwidth, 'sanitize_callback' => 'absint', ), 'maxheight' => array( 'description' => __( 'The maximum height of the embed frame in pixels.' ), 'type' => 'integer', 'sanitize_callback' => 'absint', ), 'discover' => array( 'description' => __( 'Whether to perform an oEmbed discovery request for unsanctioned providers.' ), 'type' => 'boolean', 'default' => true, ), ), ), ) ); } /** * Callback for the embed API endpoint. * * Returns the JSON object for the post. * * @since 4.4.0 * * @param WP_REST_Request $request Full data about the request. * @return array|WP_Error oEmbed response data or WP_Error on failure. */ public function get_item( $request ) { $post_id = url_to_postid( $request['url'] ); /** * Filters the determined post ID. * * @since 4.4.0 * * @param int $post_id The post ID. * @param string $url The requested URL. */ $post_id = apply_filters( 'oembed_request_post_id', $post_id, $request['url'] ); $data = get_oembed_response_data( $post_id, $request['maxwidth'] ); if ( ! $data ) { return new WP_Error( 'oembed_invalid_url', get_status_header_desc( 404 ), array( 'status' => 404 ) ); } return $data; } /** * Checks if current user can make a proxy oEmbed request. * * @since 4.8.0 * * @return true|WP_Error True if the request has read access, WP_Error object otherwise. */ public function get_proxy_item_permissions_check() { if ( ! current_user_can( 'edit_posts' ) ) { return new WP_Error( 'rest_forbidden', __( 'Sorry, you are not allowed to make proxied oEmbed requests.' ), array( 'status' => rest_authorization_required_code() ) ); } return true; } /** * Callback for the proxy API endpoint. * * Returns the JSON object for the proxied item. * * @since 4.8.0 * * @see WP_oEmbed::get_html() * @global WP_Embed $wp_embed WordPress Embed object. * @global WP_Scripts $wp_scripts * * @param WP_REST_Request $request Full data about the request. * @return object|WP_Error oEmbed response data or WP_Error on failure. */ public function get_proxy_item( $request ) { global $wp_embed, $wp_scripts; $args = $request->get_params(); // Serve oEmbed data from cache if set. unset( $args['_wpnonce'] ); $cache_key = 'oembed_' . md5( serialize( $args ) ); $data = get_transient( $cache_key ); if ( ! empty( $data ) ) { return $data; } $url = $request['url']; unset( $args['url'] ); // Copy maxwidth/maxheight to width/height since WP_oEmbed::fetch() uses these arg names. if ( isset( $args['maxwidth'] ) ) { $args['width'] = $args['maxwidth']; } if ( isset( $args['maxheight'] ) ) { $args['height'] = $args['maxheight']; } // Short-circuit process for URLs belonging to the current site. $data = get_oembed_response_data_for_url( $url, $args ); if ( $data ) { return $data; } $data = _wp_oembed_get_object()->get_data( $url, $args ); if ( false === $data ) { // Try using a classic embed, instead. /* @var WP_Embed $wp_embed */ $html = $wp_embed->get_embed_handler_html( $args, $url ); if ( $html ) { // Check if any scripts were enqueued by the shortcode, and include them in the response. $enqueued_scripts = array(); foreach ( $wp_scripts->queue as $script ) { $enqueued_scripts[] = $wp_scripts->registered[ $script ]->src; } return (object) array( 'provider_name' => __( 'Embed Handler' ), 'html' => $html, 'scripts' => $enqueued_scripts, ); } return new WP_Error( 'oembed_invalid_url', get_status_header_desc( 404 ), array( 'status' => 404 ) ); } /** This filter is documented in wp-includes/class-wp-oembed.php */ $data->html = apply_filters( 'oembed_result', _wp_oembed_get_object()->data2html( (object) $data, $url ), $url, $args ); /** * Filters the oEmbed TTL value (time to live). * * Similar to the {@see 'oembed_ttl'} filter, but for the REST API * oEmbed proxy endpoint. * * @since 4.8.0 * * @param int $time Time to live (in seconds). * @param string $url The attempted embed URL. * @param array $args An array of embed request arguments. */ $ttl = apply_filters( 'rest_oembed_ttl', DAY_IN_SECONDS, $url, $args ); set_transient( $cache_key, $data, $ttl ); return $data; } } https://validator.w3.org/feed/docs/rss2.html twenty-five 100 percent free Revolves No-deposit Bonuses 2026 Offers In the Finest Gambling enterprises Pharaoh’s Chance Reputation Advice N1 Gambling establishment Coupons July 2026: 300% Up to super fruit 7 slot machine 4,100000, 2 hundred 100 percent free Revolves Spin Pug Gambling enterprise » Extra, Requirements & fifty 100 percent free Revolves Opinion N1 Gambling enterprise Spinzwin slot free spins Opinion 2026 Neteller Gambling Establishments: A Comprehensive Guide for Athletes Online Port Reviews: A Comprehensive Guide Greatest Commission Casinos What’s twenty-five All the For example sphinx-doctor sphinx: The brand new Sphinx documents creator 25 Totally free Revolves No-deposit Bonus from the Head Jack Gambling establishment 2026 Multiple Diamond Slots, A real income Casino slot games & Totally free Play Demonstration Listing of Social Gambling enterprises in the Us Real cash Prizes July 2026 Online Slots: Play Casino Slots For fun Spiderman Harbors brings blockbuster time and you may anticipates the brand new reels to keep right up Slots Angels Position Gamble Demonstration or Rating Extra Up to 9500 mBit Casino No deposit Incentive & Free Revolves Coupon codes 2025 PayPal Wikipedia Web based the rift slot free spins casinos United states of america 2026 Checked out & Rated Online Casino Spil, Strategier og Underholdning Just what are Wagering Conditions? Wagering Conditions Informed me Crazy Panda Position: The newest Highest-Fulfilling Slot Comment Gamble Online Slots Wild Local casino Totally free Spins 50 Totally free Spins for the Gonzos Journey The fresh Grand Journey Slots: Adventure-Packed 5-Reel Incentive Online game Thunderstruck Insane Super Review RTP, Signs featuring ⭐ Nuts Panda Pokie Play for Free & Understand Review Sizzling hot Deluxe Slot Online game Demonstration Play & Totally free Revolves Greatest wildfruits slot play for money Low Deposit Casinos $5 and you can $10 Minimal Deposits Gamble Online Harbors Greatest Heart for free Harbors Zero Down load 2026 Spin Gambling establishment Opinion Games, Incentives & Far more Dual Twist Demonstration Play and Gambling enterprise Bonus ZA 2026 $step 1 Deposit Casinos 2026 Greatest surprising 7 offers $1 Minimum Deposit Casinos Raging Rhino Slot machine game Play for 100 percent free with no Put 10 Greatest Online slot online tigers claw casinos A real income United states Jul 2026 Large Bad Wolf Demonstration Position because of the Quickspin bee in love hd position View and Free Play Shazam No-deposit Bonus $thirty five Totally free Chip Shapeways & Thangs Market for three dimensional Creators Online casinos Real money ten Best United states Gambling enterprise Sites to have 2026 Thunderstruck On line Trial Enjoy Ports Free of charge Funky Fresh fruit from the Playtech Demonstration Gamble Slot Game one hundred% Totally free Better Online casinos for real dolphin reef casino Money 2026 Lapland Slots Test it On line at no cost otherwise A real income Royal Vegas Casino: Sign up and you may Allege a £step one,200 Added bonus 5 Dragons Pokie Demo Gamble & Totally free Revolves Easiest Online casinos 2025: Better Casinos on the internet One to Shell out Real cash Knowledge Betting Criteria 2026 Casino Extra Laws Said The fresh Ho Ho Ho Slot machine game Totally free Right here No Membership Melbet Local casino Jackpot City online casino Opinion one hundred% 150 Play RTG Harbors to your Cellular Latest 50 Free Revolves No deposit Required & Zero Wagering inside 2026