/** * 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 Easiest Online casinos 2025: Better Casinos on the internet One to Shell out Real cash Knowledge Betting Criteria 2026 Casino Extra Laws Said The fresh Ho Ho Ho Slot machine game Totally free Right here No Membership Melbet Local casino Jackpot City online casino Opinion one hundred% 150 Play RTG Harbors to your Cellular Latest 50 Free Revolves No deposit Required & Zero Wagering inside 2026 10 Euro Casino Insättning Fördelar och Tips Buffalo Casino slot games: Free Position Video game to try out by Aristocrat On the web Demo Put $step one Get $20: Greatest Gambling enterprise Bonuses & How they Works! fifty No deposit Totally free Revolves 2025 Gambling establishment Extra Sites Best £10 Deposit Casinos British Bonuses of Merely 10 Lb Triple Diamond Slot machine by the IGT Gamble On line free of charge Finest Western european Web based casinos 2026 Safer Euro Sites Greatest Wagering Websites inside Thailand 2026 Lord of one’s Ocean Position Review Have fun with the Game for free 100 Free Spins Uden Indbetaling – Din Guide til Gratisspins Web based casinos Real cash 10 deposit 5$ get 25$ casino 2023 Finest Usa Local casino Sites for 2026 Online Casino Canadian Repayment Techniques PlayAmo Local casino Comment 2026 Online casino in australia A real income slots On-line casino Recommendations Greatest Trusted Internet casino Sites 2026 from the Getb8 Bikini People by Online game Around the world Demo Enjoy Slot Video game a hundredpercent Free Top ten A real income Cellular Casinos 2026 Internet casino A real income PA: Leading Web sites It Summer Very hot Luxury Position Applications on google Play The brand new Online slots Most recent Real cash Game Finest Instant Withdrawal Casinos Australian continent 2026 Prompt Payout Websites Greatest Web based casinos United states 2025 Real money, Bonuses & The newest SitesBest All of us Casinos on the internet 2026 Front side-by-Front side Evaluation Online casino Analysis Greatest Respected Internet 50 free spins no deposit miss kitty casino Websites 2026 by Getb8 Pay by the Cell phone Casino Payments for Android Users in the 2026 Get 100 K Totally free Coins Greatest $5 Deposit Gambling enterprises in america 2026 7 Finest Casino Applications 2026 Greatest Mobile Casinos the real deal Currency Gamble 19,350+ Totally free Slot Game Zero Obtain OG Casino 2026 Log in & Get no deposit extra code Lucky Emperor Local casino online casino sugar rush Comment 2025, Around $a hundred 100 percent free Bonus Silver Pine Gambling establishment embraces: $twenty five No-deposit Incentive + 55 totally free revolves no-deposit extra for new and you may current people fifty Totally free Spins No deposit Bonus Also provides on the Registration Best Bitcoin & Crypto Casinos to experience On the web inside the 2026 Claim £20 Inside the 100 percent free Bets & twenty five Free Spins At the Netbet Insane Orient Slot: Info, Free Spins and more Casinos on the internet United states 2026 Examined and Rated Better United states Web based casinos 2026 casino deposit paypal Checked out, Rated & Examined Free Spins Bonuses Finest Totally free Revolves Gambling enterprises in the 2026 Local casino Put Procedures Put Publication to have Online casinos Their Ultimate Playing Feel Bettors beast Fraud All you have to Understand Greatest Spend from the Mobile Casino Sites in the united kingdom 2025 Minnesota Crazy, Huge Local casino Stadium Switch to The new Solution Spouse Top ten Casinos on the internet The real deal Currency July 2026