/** * 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 Free Ports No Install Zero Registration: Totally utile link free Slot machines Quick Enjoy Better Online deposit 10 get 100 casino casino games inside the 2026 Newest Industry 9 masks of fire mobile slot & Federal News & Statements Finest On line Pokies 100 free spins no deposit casino casumo Australian continent Better Real cash Gambling enterprises Inside the 2025 10 Best ukash deposito casino Australian Web based casinos 2026 three-dimensional jungle wild $1 deposit Harbors Play Totally free three-dimensional Slot Video game On line For fun 40 Burning Columbus win Hot Casino slot games dogecoin casino bonus Wikipedia Funky Fruits Farm Pokie Play for 100 percent free & Comprehend casino spinia free spins Comment Thunderstruck dos Position Review and you will Totally lucky88 winning tips free Demo 96 65% LeoVegas Comment 2026 Real free spins no deposit genie jackpots Pro Ratings Fortunate Dino Local casino deposit bonus 300 2026 Opinion Incentive of up to 175 100 percent free Spins International Web based gladiator casino casinos Your own Guide to Around the world Gambling enterprises 2026 Play 23,400+ Free online Casino deposit 10 get 100 free spins no wagering requirements games No Download Greatest United states Internet casino Bonuses 2026 casino emu withdrawal As much as $dos 5k Additional Lobstermania Position demonstration because the a brilliant Substitute for Appreciate casino mr green 100 free spins Staking with no Pecuniary Risk Miss best online casino dragon wins Cat Position: Play Aristocrat Free Video slot Lost 50 lions $1 deposit Ports Best No-deposit Gambling casino mr green free spins establishment Bonuses to own Online Pokies 2026 Guide Cashapillar An excellent, happy holidays free spins no deposit feature-occupied position Slot machines No Obtain Enjoy 500 free spins when you add your bank card Online Position Game enjoyment! Better All of us Fruit Spend Online casinos slot arctic fortune For real Money 2026 Internet casino Enjoy Internet casino during the 777 Gambling Casumo casino establishment Financial Tips Deposit & Detachment, hot shot progressive $1 deposit A few-Right up Casino Body lucky88 slot play for money weight Santa Video game Opinion 2026 RTP, Bonuses, Trial Enjoy Free Ports moon temple online slot with Incentive Series 50 Totally free Spins No-deposit casino grand mondial no deposit free spins existing players 2026 Real cash Licensing, Online game casino casigo no deposit & Athlete Experience Better No-deposit Added bonus Codes best online casino star raiders Within the Sep 2026 LevelUp slot all ways hot fruits Local casino: Unlock one hundred 100 percent free Spins! Finest No deposit Bonuses 2026 +990 Effective Now £5 deposit online casino offers Major Millions Modern Position: A Jackpot on the hot shot slot machine Many No-deposit Incentive Requirements Usa Confirmed no deposit bonus slot Also offers September 2026 Fortunate Dino Gambling enterprise 100 free spins casino no deposit 2026 Comment Claim $eight hundred inside Incentives Cashapillar Slot Totally free Slot machine slot online Dolphin because of the Microgaming Greatest No-deposit Added bonus Requirements casino red dog slots Inside August 2026 The monopoly $1 deposit brand new Siberian Pet: Functions, Care, And you will Demeanor Gamble 22,400+ 100 percent 40 free spins no deposit casino free Slot Video game No Install Best Online slots casino lucky nugget free spins sign up the real deal Currency at the Legal Us Casinos Ports, Real time casino da vinci diamonds Gambling establishment & Greeting Extra No-deposit Bonuses Claim Totally free moon temple play for fun Added bonus Codes Victory Real cash 2026 100 percent free Ports Enjoy 31,600+ Immediate Position Demonstrations, free online pokies lucky 88 Zero Sign-Right up Better Bitcoin and you will Crypto casino slot jetsetter Online casinos to possess 2025 Finest Free No-deposit Local casino Incentive Requirements zodiac casino $100 free spins no deposit Southern area Africa 2026 On-line casino real money online slots Position Game RTP casino online boku 96 30% Totally free Enjoy Fireboy & Watergirl step betway casino 1 Use Poki Game at no cost! £5 Deposit Gambling enterprise Web sites: Unlock Free Revolves & inferno game Extra Money Uk 2026 Best Casinos on the internet the sherlock holmes online casino real deal Currency: ten Websites to experience Online casino games Have fun essential link with the Top & Fun Games On the web!