/** * 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 No-deposit Added bonus Requirements 2026 mermaids millions slot free spins Actual-Currency Online casinos Hexbreaker Slot: Enjoy Playtech Totally slot fat santa free Position Zero Down load Dazzle Local casino Added bonus Code » Free Local casino Columbus casino No deposit Incentives 2026 The newest 100 percent free Revolves 2026: Newest $1 deposit real play casinos No deposit Also offers Claim Your own casino yako 25 free spins LuckyBird No deposit Bonus 2026 Best Online Casino casino online idebit Incentive Applications Best No deposit free slots Casino Incentives 2026 No Purchase Necessary No-deposit Incentives grace of cleopatra slot machine & Free Revolves Best Now offers 2026 Descubre el emocionante mundo de Sugar Rush 1000 Casino -17417484 Esplora il Big Bass Bonanza Bonus Guida Completa Giros Gratis en Sweet Bonanza 2500 ¡Aprovecha y Gana! 100 50 free spins owl eyes percent free Spins No deposit Southern Africa Greatest No deposit Incentive Gambling enterprises 2026 Kazino o'yinlariga yangi boshlovchilar uchun muhim maslahatlar List of book of dead slot free spins an informed Spend by the Mobile Casinos in the 2026 Sensible Medical insurance Preparations The new Casinos on the internet United kingdom: Finest Web sites treasures of egypt slot Analyzed to have August Descubre el Fascinante Mundo de Book of Ra Casino -12502734 100 percent deposit 1£ play with 20£ casino free Revolves Gambling establishment Offers for people Players Best INSTADEBIT Gambling enterprises for European Professionals 2026 Greatest European union Web miss red slot machine sites The newest Web based casinos free bonus slot game August 2026 Greatest 100 percent free slot no deposit bonus Spins Casinos 2026 Mr Bet Gambling establishment Comment: Analysis, casino rise of ra Games, Incentives Big Bamboo Casino Un’avventura Esotica nel Mondo dei Casinò Online Safer Online casinos in america to possess 2026 casino vikings go to hell Greatest Safe Local casino Web sites Non-GamStop Spend From the Mobile el torero slot free spins Websites 2026 Most recent Monkey Revolves No min deposit online casino deposit Bonuses Up-to-date 2026 Sensible Medical insurance Preparations Enjoy 19,750+ 100 percent free Slot Video gambling tips slots game Zero Down load Descubre la Aventura de Jugar Pirots 4 Diversión y Ganancias Best Position snap the link now Software 2026 Better Mobile Slot machine game Programs Greatest Mobile 20 free no deposit spins phone Gambling enterprises And you will Bonuses 100 percent free Revolves And winward free spins on sign up no Deposit & Zero Wagering Standards 2026 Finest Internet casino Bonuses and you can Discount coupons for top Casino real money baccarat Applications Top casino titan free chip Android os Casinos & Software 2026 Real money Game pięćdziesięciu darmowych spinów dzięki stu zł Wyjąwszy Depozytu przy Ice Casino Urzędowe kasyno internetowego Finest online casino no deposit incentive casino winter wonders codes 2026 Best No deposit Casino 40 free spins no deposit 2026 Bonuses Seemed to own August 2026 Hotline Casino Polska: urzędowe kasyno, nadprogram 150%, BLIK 2026 tiki tumble casino slot Lowest Deposit Casinos 2026 An informed casino titan sign up bonus Reduced Deposit Gambling enterprises Better Pay By the £1 deposit casinos Mobile phone Gambling enterprises 2026 Put by Cellular Statement Better Minimal Put Casinos the godfather casino August 2026 Put as low as $1 Affordable Gambling online slots real money on line Super Moolah Slot lucky hot $1 deposit Gambling establishment Bonuses, Free Demonstration, & Remark Real cash Online have a peek at the hyperlink slots games Gamble Online Butterfly Staxx $1 deposit Ports Greatest Middle 100percent free Ports No Install Sicurezza nei Casinò non AAMS in Italia: cosa sapere prima di giocare Deluxe Casino Canada: casino Donuts A look at Has and Bonuses Lucky Tree Game Review 2026 RTP, Incentives iphone casino games + Demonstration