/** * 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 Treasures from Christmas time Slot Comment 2026 Totally free + A real income Play! 100 percent free Slots & Online Social Gambling establishment Softer Harry Reid Airport terminal vacationer wins substantial $3 3M slot jackpot Harry Reid Airport terminal traveler victories huge $3 3M position jackpot La Mejor Tienda de Esteroides: Tu Fuente de Confianza Casino uden ROFUS En Guide til at Spille Ansvarligt Konami Ports Gamble Konami Slot machines On the web 100percent free Possess Guide away from Dead demonstration online game-100 percent free slot and you may demonstration play Indian Fantasizing Casino slot games 100 percent free Play for Fun No Down load Required Queen of your Nile dos Free Aristocrat Harbors 100 percent free Harbors 39,000+ On the web Position Online game No Down load MegaBonanza Promo Password 2026 As much as 303 Sc Enjoy Best Online keep what you win casino games Anywhere Free online Slots: Play Gambling enterprise Slot machines For fun Blackjack Competition Means: How to Gamble and Win within the 2026? Cash Splash 5 Reel Ports Grand Bucks $$ Jackpots Await! Swimsuit Group Harbors: 15 100 percent free Spins, 3x Multiplier, Respin Element Play Free Position Online game Zero Down load, Only Enjoyable! When is the best time for you play on the internet pokies? mBit Gambling online casino games for real money establishment No-deposit Incentive & Totally free Spins Discount coupons 2025 Better Totally free Spins No Betting Now offers July 2026 Finest Online Pokies in australia 2026: Best Real cash Slot Games Aussie Players Love 10 Best On the web Pokies around australia playing for real Money 2025 Trendy Good fresh fruit Slot Opinion 2026 Find a very good On the web Pokies in australia 2026 Detroit Free Drive Family Free Revolves Bonuses how does a slot tournament work 2026 Spin & Victory Scorching Deluxe Demonstration & Review Free Greentube Harbors Slots Paradise On-line casino: Play Online game The real deal Money FaFaFa Slot away from Cool Online game Top Web based casinos the real deal Profit 2026, Checked Slovenské Online Kasína v Roku 2026 Budúcnosť Hrania a Zábavy Great Bluish Trial Gamble Position Video game a hundred% 100 percent free Optimisez Vos Performances Sportives avec Test C 250 Le pouvoir de la testostérone pour les athlètes Large Trout Bonanza Splash A no cost Slot Comment for Informal Professionals 17 Better Quick Withdrawal Crypto & Bitcoin Casinos within the 2026 Slovenské Online Kasína Všetko, čo Potrebujete Poznať Slovenské online kasína v roku 2026 Trendy, bonusy a regulácie Siberian Violent storm Slots Server Wager Free otherwise Real cash Upload & express your website Internet sites Assist The new Web based casinos for all of us People in the 2026- Most recent Casinos Ranked Slovenské online kasína v roku 2026 Budúcnosť hazardného hrania na Slovensku Top Casinos on the internet in australia: Greatest On line Pokies the real deal Money The trick Provide out of Xmas Center Legal Slots Online Slots Slovenské online kasína 2026 Budúcnosť zábavy a hier Online casinos Us 2026 Checked & mobile casino new Ranked No-deposit 100 percent free Revolves to have Santas Farm from the GameArt