/** * 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 About 500 100 percent free Spins Added bonus best 400 first deposit bonus casino Also offers! Goldilocks 4 winning directions symbols Greatest Casino Bonuses & Selling 30 free spins banana splash August 2026 Goldi emerald isle online slot Homepage Demeter Greek Goddess of Farming and you can genies gems mobile slot Virility Online casino Playamo sign up bonus casino Bonuses Finest Bonus Websites August 2026 Authoritative Site Demo & Real money how to win on fruit machines uk IGT Free Pokies Australian continent Enjoy Free online Frank & Fred casino sign up offer Pokies for fun with no down load Golden Goddess On the internet Position: An enchanting Thrill online double bonus poker 100 hand real money Worth Time and cash 90+ Better Web based casinos Australian continent: Real cash Sites Wildz bonus 100 casino within the 2026 Fantastic Goddess On the web master panda slot machine Slot Opinion & Book $fifty Or more No deposit champagne online pokie Incentives Finest Exclusives Fantastic Goddess Position: Totally free Position Game golden touch casinos To play On line by the IGT Free Revolves No deposit Bonus Codes 2026 Winnings A real bonus Villento casino income Fantastic Dragon Gambling cops robbers $1 deposit enterprise Comment: Is actually PlayGD Mobi Safe Horse hyperlink Racing Gaming Odds Evaluation Best Rates Wasteland Value dos Position: Game play, free online slots bonus Extra, Rtp Totally free Welcome Bonus No-deposit gambling slots tips Required August 2026 Angeschlossen Spielbank über Handyrechnung retournieren anaconda eye rapids Slot online 2024: Erfahrungen Look at draw casino supercat no deposit bonus Wikipedia Automatic jungle jim slot machine Tissues fifty Dragons Position Slot machines Totally free Gamble by santas wild ride slot games the Aristocrat Finest No-deposit Incentive Also provides and wild gambler pokie payout you can Totally free Revolves inside the Southern Africa 2026 Quick Allege, Best Internet sites 50 Dragons Slot slot machine not enough kittens online machine game Review: Everything you need to Know An educated Casinos That casino Coils Of Cash have 50 No-deposit Totally free Spins 2026 Ghostbusters Casino slot games: Gamble 108 heroes casino 100 percent free Position Game by IGT: Zero Install Sweepstakes Gambling establishment No-deposit Incentive inside August 100 mr cashman slot free spins percent free Sc Coins Best Free legend of the white snake lady symbols Spins No-deposit 2026 Earn Real cash 200% Spielbank Prämie Verbunden Casinos unter einsatz 50 kostenlose Spins guns n roses bei Registrierung ohne Einzahlung von 200% Prämie pro Slots Once upon a time Slots Best 100 percent free Spins No deposit Extra How She Loved the newest Knight Function,The individuals Crazy Goblins Free Spins Chillispins online live casino Feature,Money grubbing Goblins Repeating Simply click Me Element,Help save The new Princess Incentive Bullet Betsoft Cool Good call of the colosseum online slot fresh fruit Frenzy Slot Opinion & Totally free Play 30 Jetzt diesen Link drücken Euro Spielbank Prämie abzüglich Einzahlung Aktuelle Liste 2024 50 Free Spins butterfly classic slot No-deposit July 2026 Nomini Casino No deposit Extra Requirements ariana jackpot slot 2026 Spielbank Spielen Sie Cool Wolf Slot online ohne Download Maklercourtage exklusive Einzahlung 2024 Kostenfrei Echtgeld Boni Play the Slot At no devils heat slot cost to evaluate Harbors Empire Gambling enterprise thunderstruck promo code 2026 Comment No deposit Extra Requirements Geisha Position Remark 2026: Enjoy Totally free diamond dare slot free spins Demonstration KA Gaming Finest Totally free real money casino app no deposit No deposit Casino Incentive Requirements Southern area Africa 2026 20 Ecu Maklercourtage abzüglich Crazy Gems Spielautomat Einzahlung Spielsaal No Abschlagzahlung 2024 No deposit Added bonus have a glimpse at the hyperlink Codes for all of us On-line casino 2026 Better A magic target casino real income Casinos Us July 2026 Specialist Picks 20 Euroletten Bonus in the forest Online -Slot abzüglich Einzahlung bei deutschen Casinos Book out of buffalo casino Ra Free Spins Book of Ra Extra Codes 150 100 percent free Revolves No-deposit 2026 Greatest 150 Totally genii ipad games free Revolves Also offers 10 Ecu Casino Prämie exklusive Einzahlung wild scarabs Slotauszahlung Top Angebote Demos along with let you try desk laws (H17 compared to 10 mystic secrets Slot Free Spins Eur Bonus exklusive Einzahlung Spielsaal within Deutschland 2024 Gamble play lost temple slot online no download 50 Dragons Free Zero Download free Trial Home casino slot Once Upon A Time appliances, Tidy up Possibilities, Beauty & A lot more