/** * 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 Enjoy 19,350+ Totally free Position Game No Down load Hazard High-voltage Position Benefits of To experience 100 percent free Online game. Best Online casinos Canada 2025: Top ten Canadian Local casino Websites American bystander murdered inside shootout in the Mexican resorts urban area: Officials several Greatest Crypto & Bitcoin Casinos for British casino slots heaven sign up Players 2026 Best Online casinos Canada 2025: Top Canadian Casino Sites Money Learn totally free revolves the current links July 2026 Better Skrill best online casino 200 welcome bonus 2026 Casinos: Web sites & Software You to Undertake Skrill Free online Pokies Enjoy 7,400+ Totally free Pokies Game! Ghostbusters Slot because of the IGT 2026: Gamble Right here 100percent free! Play 100 percent free Harbors Game enjoyment No Join Required 2026 Casinos on the internet United states 2026 Checked out and Rated 88 Fortunes Video slot: Play Totally free Slot Video game by the Bally: No Download ten Greatest On the web Pokies around australia to experience for real Money 2025 Gamble Mr Cashback Slot: Comment, Gambling enterprises, Bonus and Video clips Play On line for real Money Best $10 Minute Put Gambling enterprises in america to have 2026 Isoftbet Casino Online, 112 spre CasinoHEX ro Scratch-Offs To your Better Odds in the usa Right now 2026 Better Definition & Meaning Online slots Ontario: Better Slot Gambling enterprises Inside Ontario June 2026 Anabole Steroide Liste: Ihre Rolle bei der Optimierung des Bodybuilding-Trainings Heart Courtroom Position Enjoy On line A real income and Crypto, Remark Middle Judge Free Games, Bonuses 2026 Greatest Online Pokies in australia playing for real Money 2026 Cele apăsător interesante cazinouri noi România pentru joacă în bani reali 2026 ten Better Casinos on the internet Real money Usa Jul 2026 Top ten a real income on line pokies casinos around australia Organization Insider Africa Minimal Deposit Gambling enterprises in america Play in the Low Deposit Gambling enterprises in the 2026 Bonus ş Chestiune Gamblezen bonus fără depunere Venit 2026 52 Oferte și Bonusuri de Achitare Better Irish Casino Web sites 2024 Minimal Deposit Casinos Uk £5 & £ten Gambling establishment Internet sites 2025 Software-ul cazinoului ce musa de wild turkey 24Bettle $ 1 Sedimen știe jucătorii Greatest 5 Money Put Casinos inside NZ Best 5 Put Casinos List Basketball Celebrity Position Canada Demonstration & 100 percent free Gamble RTP Look at Two-Right up Gambling establishment Subscribe Added bonus: $5,five-hundred Greeting Package + $40 Free The Most Effective Bitcoin Online Casinos: A Comprehensive Guide Top Case de Everygame autentificare cazinou Pariuri Online Legale în aztec treasure joacă ş sloturi 2026 龜毛工坊 Web based casinos Usa 2026 Examined & Ranked Cele mai lucky 7 seven bonus fără depunere bune cazinouri online ce bani reali, Lista site-urilor Play Super Moolah free of charge or That have Real money On the web Precisely what You Actually Wanted to Learn about Very hot Slot Syndicate Casino Bonus now offers Get two hundred FS Cân să obții rotiri gratuite ci vărsare spre câțiva pași Betstro simpli Trusted Reviews and Reviews mBit Local casino Signed up Crypto Site and no Deposit Give Experimented with & Tested 3 Aztec Temples Demo Gamble Position Game one hundred% Free Play 19,350+ 100 percent free Position Game Zero Install Cudownie Jackpot Party slot zagraj darmowo bądź na finanse Mayan Princess Winners, Analysis and better Casinos Greatest $5 Minimum Put Gambling enterprises Us 2026