/** * 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 The new Crawl-Man Mobile Games Today 100 percent free on the internet Gamble Spin Pug Casino No deposit Bonuses 2026 The brand new Wonder Examine Boy Position Games Modern Bonus Slots Spiderman Harbors Spiderman Wonder Slot machine Opinion Spiderman slot machine game online for free sphinx-doc sphinx: The fresh Sphinx files creator Play 100 percent free Sphinx Insane IGT On the internet Slot No Signal-ups Required Southern Park Movements in order to Vital+ That have $step 1 5B USD Bargain No-deposit Gambling enterprise Bonuses Better Also offers Away from 2026 Online Conference Arranging Software Saturday Evening Funkin’ Enjoy Online 100percent free! step three Reel Slots On line Gamble Free & Real cash Slots 2026 Spiderman Slot, Totally free Revolves, Private Slot Bonuses to try out! Is actually Totally free Demo Best Totally free Revolves Also provides within the NZ 2026 To five-hundred No Put Spins Get a hundred K Free Coins No Down load 2026 Wanted Dead Otherwise an untamed Free Slot Demos All of the Facility. Enjoy King of the Nile II Free inside the Demonstration and study Review step 3 Reel Harbors: Gamble Free step three Reels Slots with no Install On the internet Play Totally free Position Games On line Better Gambling establishment Harbors for real Money 2026: Gamble Slot Video game On the web No-deposit Extra Codes Usa Affirmed Now offers July 2026 Jack and also the Beanstalk Demo by NetEnt 100 percent free Slot & Opinion Indian Dreaming Video slot 100 percent free Wager Enjoyable Zero Obtain Necessary Free online Ports: Enjoy Gambling enterprise Slot machine games For fun Greatest Casino Greeting Bonuses July 2026 Allege Better Also provides 100% Casino Put Incentives 2026 Complete Checklist Internet casino Join Bonus: Better Invited Now offers to possess July 2026 100 percent free Slot Demos All Facility. 100 percent free Slots No Install Zero Registration: Free Slots Instant Gamble Free Slot Demonstrations The Business. Crazy Orient Slot machine game Are the Luck about this Gambling enterprise Online game Video slot Opinion Starburst Slot Review 2026: Just how & Where you should Gamble, RTP, More Starburst Slot Enjoy NetEnt’s Iconic Casino slot games On the internet Play the Starburst Position from the NetEnt Progression Games Raging Rhino Trial Position Free Enjoy, RTP: 95 97% Gamble Lord of the Ocean Online Free Game of Thrones Harbors Casino APK Down load for Android os Newest Version Free Slot Demos All Facility. Free Revolves Local casino Also offers for us People United kingdom Totally free Spins No deposit Offers for 2026 Claim for the Subscription Happy Claw Host Play On the internet for free! Mayan Princess Position comment Key Has, RTP, Winnings & Gameplay Book Enjoy 5400+ Totally free Slot Video game On the internet inside the Canada Zero Down load 500 Totally free Revolves No-deposit Incentives July 2026: Finest Totally free Twist Offers in the Web based casinos Now Gamble 100 percent free Slot Games No Down load Zero Membership Certified Webpages Demonstration & Real cash IGT