/** * 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 Totally free Wonderful Dragon Harbors Online game Zero Download Golden Dragon HTML5 Harbors Slotomania Free download Consistently Create No-deposit Added bonus Rules 2026 Working Local no deposit bonus codes casino energy casino Coupons Texas Beverage Demo Play Position Video game a hundred% Totally free 50 Free Revolves No deposit Incentive Also provides to the Registration Merry Christmas Harbors Online Yoyougaming Slot machine game Hot-shot Casino slot games Apps online Enjoy Thunderstruck games: Enjoy Microgaming casino justspin $100 free spins Totally free Slot Games On line Zero Obtain Dead otherwise Live Slot because of the NetEnt: Dive for the Insane Western Thrill! Enjoy King of your Nile free of charge Play Body weight Santa Casino slot games On the web at no cost by Push Gambling Casinos on the internet Us 2026 Examined & Rated Funky Fruits because of the Playtech Demonstration Play Position Games a hundred% 100 percent free 100 percent free Slots 100 percent free Online casino games Online On-line casino Bonuses 2026: Greeting, FS & Free Enjoy Promos 300% Deposit Added bonus Finest 3 hundred% Local casino Incentives of July 2026 Skrill Gambling enterprises 120+ Better Web based casinos Accepting Skrill Troubleshoot sluggish websites on the internet Nest Wi-fi otherwise Yahoo Wifi Google Family and you can Colony Assist 50 No-deposit Totally free Revolves 2025 Gambling enterprise Added bonus Websites Package Record Totally free Genuine-Date Tracking International Siberian Storm Slot On the web Play Totally free & Siberian Storm Approach Finest 100 percent free Revolves No-deposit Incentives From the Online casinos In the 2026 Play Harbors On the internet for real Money 2026 Totally free Spins No-deposit Extra Casinos Us July 2026 fifty Free Spins No-deposit Added bonus Now offers on the Registration fifty Free Revolves on the Membership with no Deposit in the South Africa 2026 Trump Busts Away Wince Valentines Moving since the Melania Attempts to Cover-up All of the Endless Harbors No-deposit Extra Rules The brand new & Present Professionals July 2026 15 All the-Comprehensive Terrarium Set to simply help Needless to say Lighten Your property Landing page Huge Video game Safari Slots Have fun with the Free Gambling establishment Video game Online Wicked Pokies Gambling enterprise Extra Codes Current July 2026 Safari Revolves Slot Comment 2026 Totally free Enjoy Trial Find the Finest Pokies On the web To try out The real deal Money rich Wiktionary, the brand new free dictionary Dating a wealthy Lady: Ideas to Victory The girl Center more 41 Websites that have Higher Design Advice Over 800 Pokies Video game 60+ Casinos Checked out Best Australian Web based casinos for real Profit 2026 Enjoy On the internet Pokies Real cash Finest Real cash Pokies Sites Greatest On the internet Pokies Australian continent for real Money September 2025 Get the Better Pokies Online Playing The real deal Currency Finest Web based casinos Usa 2026: Real cash Sites Checked Trusted Casinos on the internet 2025: Greatest Web based casinos You to Shell out Real cash Best Slots to play On the internet the real deal Currency July twenty five Greatest Australian Web based casinos for real Money in 2026 Best Real cash Gambling enterprises Australian continent July 2026 Picks Actual Madrid CF Wikipedia Real money Web based casinos Us 2026 Judge, Safe & Better Sites Best Cellular Casinos Us 2026 Enjoy Anyplace