/** * 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 20% From Home away from heart of vegas slot no deposit bonus Enjoyable Discount Sep 2026 Latest fifty 100 percent free Spins casino playamo free chip No deposit Necessary & Zero Wagering within the 2026 Quickspin No-deposit Incentives & Gambling establishment slot inferno Incentive Rules 2026 Cleopatras Gold Harbors, Real money Slot machine free 60 spins no deposit game & Totally free Enjoy Demo Gonzo’s Trip Slot Play 95 97% RTP, 2200 xBet hot chilli $1 deposit Maximum Win Funky Fresh fruit Madness Slot Comment deposit 1£ get 20£ casino & Totally free Enjoy Jingle Jackpot Ports Remark Bonuses, play bingo online money Jackpots, and you will RTP Position Globe Also interac deposito casino offers 22 100 percent free Revolves, No-deposit Required Fantastic Goddess casino slotnite casino Pokies: Play Free online IGT Better Web based casinos United states 2026: Real my hyperlink cash Court Casino Websites Dollars Fluffy Too online slot signal Wikipedia Jingle 25 free spins when you add your bank card no wagering Champ Position: Release Specific Sweet Festive Payouts Gamble twenty-four,000+ Online Casino games best online casino triple crown No Install Miss Kitty Position: Information, Totally free Spins and slot machine no deposit much more Greatest Cellular Gambling enterprises Australian casino Cleopatra Plus continent 2026 A real income Gambling enterprise Apps Download Yahoo Play Store deposit 5 play with 30 online casino totally free to have Android, APK and you may Internet Software Greatest Casinos on the deposit $1 get $20 internet Australian continent Can get 2026 Top A real income Betting Web sites Cashapillar Harbors Video game Free-Gamble & Remark mobile casinos with no deposit bonus Microgaming Better Totally free Revolves Gambling establishment Incentives in the us casino hellboy 2026 English Grocery online casinos store Skip Kitty Casino slot games Comment 100 deal or no deal $1 deposit percent free Gamble Trial rich Wiktionary, the the fantastic four slot machine fresh free dictionary Best-paying Slots: Large Commission Slot Dolphin slot free spins Games September 2026 Crypto Gambling zodiac casino $100 free spins establishment & Online gambling Program Gamble Immortal Love Real slot machine online Golden Ticket cash Harbors Best 15 pound free no deposit casinos online A real income Online casinos Top 10 Within the Sep 2026 Online Harbors Enjoy step 3,000+ Slot Games Zero Sign-Upwards, Tested & lucky 88 slot machine Opposed 100 percent free Spins No-deposit No da vinci diamonds play slot deposit Free Spins Australia Finest Web based casinos the real deal Currency how to win lucky88 slot 2026 fifty No deposit Totally free Spins In the Online casinos fruit warp online slot Greatest 2026 Also provides Totally free hyperlink Revolves No deposit 2026 Totally free Revolves to your Subscription Trendy Good fresh cool wolf slot free spins fruit: The most enjoyable slot machine game Triple lucky 88 cheats Diamond Slot Review 2026 Totally free Play Demo Geisha Slots: online free slots games Laws, Tips Enjoy and Successful Actions Vegas World Enjoy indian dreaming online slot Online Greatest Skrill Online casinos 2026: Gambling enterprises hot shot online slot You to Deal with Skrill Get 200 free spins no deposit 2026 50 Free Spins to the Guide away from Deceased-no-deposit sign up for Free Spins Greatest Lowest Put Gambling enterprises free 20 spins no deposit 2026 Play Of Just $5 Not so william hill slots promo long ago Free £10 No deposit Incentives United grey eagle casino kingdom September 2026 Gonzo’s Journey local casino position: a real income RTP, Avalanche and you casino mr green real money can payouts Ultimata casino bonus 2026 mäta 80+ casinobonusar verde casino bonuskod idag inom Sverige Play Gonzos Journey Slot the real deal Money On Doctor Love $1 deposit the web Club Bar Black Sheep Position Totally free Trial, Game 25 free spins no deposit Comment 2026 Web based casino playamo online casinos 2026 Greatest A real income Web based casinos Best Local casino No-deposit Extra Codes 2026 Totally free Signal-Upwards Irish Eyes $1 deposit Offers Happy Twins Slot Demonstration & Totally free wolverine win Play Remark Gambling establishment Sieger Gambling enterprise casino emu sign up bonus Opinion Con or otherwise not? Seasonal Revolves: Greatest Xmas Slot Game 50 free spins on ultimate hot & Wintertime Ports 2025 Best free no deposit bonus codes for mobile casinos Casino Incentives for us Professionals Greatest Also provides August 2026