/** * 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 Exploring the World of Casinos A Global Perspective Fairy Entrance Video slot Absolve to Enjoy On the web Demonstration Game 777 Slots: Listing of 100 percent free Ports 777 playing enjoyment without Down load 20 100 percent free Spins No-deposit Added bonus from the Ripper Casino July 2026 FRIV COM : An informed 100 percent free Games Jogos Juegos Determining Things One Influence Online gambling Experience Free Ports: Enjoy twenty-eight,779+ Demo Position Video game Zero Install, No Sign-Upwards Dragon Shrine Trial from the Quickspin Enjoy Free Slots Dr Bet Sign on Uk Are an informed Gambling establishment inside the 2026 No-deposit Bonus Casinos Canada Totally free Processor chip & Free Spins 2026 Exploring Sportsbooks Not on GamStop Your Guide to Alternative Betting Options Vernons gambling enterprise No deposit Incentive Rules 2026 #1 Fire Joker Position Review 96% RTP Enjoy Letter Wade 2026 Gamble Wasteland Appreciate On the web from the Vegas Aces Local casino Great 4 On the internet Modern Slots Exploring Sportsbooks Not on GamStop 1997901890 35+ Type of Fairies From around the world Complete An excellent-Z Self-help guide to the brand new Fae Finest Internet casino No-Deposit Incentives six 29: Rating $35 Today Progression Pipeline Explains Eye away from Horus Slot Prospects within the Uk Best Non-UK Online Casinos Discover Your Next Gaming Adventure Dragon Shrine Position Comment Quickspin Free Demonstration & Have Forklift Rental Philippines Better £10 Put Casinos United kingdom Bonuses of Merely ten Pound Dragon Dance Ports【15】Totally free Revolves 100x Multiplier DaVinci Expensive diamonds Position Opinion & 100 percent free Demonstration by the IGT BetOnline Gambling establishment Bonuses ️ Newest Offers & Coupon codes Danger plan gambling harbors Higher-current Position Demo Comment, 95 67% RTP Top Gold coins Promo Password 2026 Claim To 75 Sc! Udenlandske Casinoer Uden MitID i 2026 Hvad Du Skal Vide Choy Sun Doa Slot Opinion 2026 Totally free Play Trial Dr Bet Opinion: A whole British Gambling enterprise Sense for all Red-colored Mansions Position Comment & The casino BetVictor casino best places to Enjoy On line Appeal & Clovers Position Remark Gamble Free online Video game Canada put bonus new member three hundred Wikipedia No-deposit Totally free Revolves 2026 UKGC Signed up Internet sites Just Clear Guide to the Zodiac Gambling enterprise Put Limitations and Detachment Regulations Finest £step 1 Put Gambling enterprises United kingdom 2026 Wager step 1 Lb Dead otherwise Live franchise Wikipedia Best Gambling games On the web 2026 Play Real cash Casino games DaVinci Expensive diamonds Local casino: Totally free Slot machine On the web Jackbit Local casino one hundred Free Revolves No deposit 2026: Code & Terms Steroidi e il Loro Ruolo nell’Aumento delle Prestazioni di Resistenza ten Greatest Casinos on the internet A real income United states Jul 2026 $one hundred best payout online casinos Free Chip No deposit Canada Cleopatra Slots Play Free Casino slot games Demonstration IGT Finest On-line casino Bonuses Objevte vzrušení online kasin Jak hrát a vyhrávat Christmas time Reactors: Have fun with Totally free Enjoy Xmas Reactors Casino slot games Very hot Luxury Slot Programs on the internet Enjoy Choy Sunlight Doa Slot Review 2026 Free Gamble Demo The Harbors Out of Las vegas Gambling enterprise No-deposit Bonus Requirements The brand new & Established People June 2026