/** * 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 Best Online casino Ontario 2025 Register Bonus & Coupon codes Casinos on the internet Real cash ten Better United states of america Local casino Sites to possess 2026 Better $5 Lowest Deposit Gambling enterprises in the 2026 Rated and you will Reviewed Better A real income Us Casinos 2026 Profits Confirmed Very little else Comes Personal Salamanca, New york No-deposit Incentive Gambling enterprises 2026 To NZ$100 Wins + FS Casumo Slots More 2,one hundred thousand Game to experience Better Online casinos for real Currency 2026 FanDuel Gambling establishment PA Promo Password: $40 Added bonus + five hundred Free Spins Better Local casino Software in america 2026 Real Cellular Casino Web sites NetBet Gambling establishment Remark 2026: Centered Uk Brand having Sports betting and you can Gambling enterprise PlayOJO Gambling establishment Comment 2026 Exclusive 50 100 percent free Revolves Bonus SlotMonster Totally free Revolves No deposit Offers William Mountain Cellular Local casino App Best 100 percent free Revolves No Wagering Gambling enterprises United kingdom Summer 2026 Formal Web site Demo & A real income On-line casino Ratings Greatest Leading Online casino Internet sites 2026 because of the Getb8 Live Wagering Possibility, On the web Sportsbook, Gambling enterprise, Racebook, BetPhoenix Web based casinos United states of america 2026 Checked out & Rated Bonus Betting Standards 2026 Ideas on how to Assess Rollover LuckyBird io Gambling enterprise Promo Password: ‘SBRBONUS’ to possess 5K GC + 0.98 South carolina Summer 2026 Lord Lucky Gambling enterprise Opinion: Ports, Games & Extra Offers Gamble King of one’s Nile Zero Free play super hot real money download Trial Details Popular Tiktok Bokep Hijab Indo Hook up Nonton Bogor Complete Hd Widespread 2026 Loki Local casino Official Website ️ Quick Withdrawals & Profits during the Gambling establishment Loki The best PayID Gambling enterprises in australia crystal forest 120 free spins 2026 Gamble Alive Gambling establishment that have Bitcoin & Crypto $2500 Acceptance Plan Cabergoline pour les athlètes et les passionnés de musculation Play 21,750+ Free online Casino games No Install Betsafe Gambling establishment No deposit Added bonus Codes & Offers 2026 a hundred Totally free Revolves No-deposit 2026 Score one hundred FS For the Subscription ten Greatest Online casinos A real income Us Jul 2026 Top 10 United states of america Casinos on the internet for real Currency Playing inside 2026 Indian Dreaming Aristocrat Slot Opinion & Demonstration July 2026 Greatest $100 Free No deposit Gambling enterprise Incentives Claim Your Today ten Better Casinos on the internet A real income United states of america Jul 2026 Greatest Online casinos for real Money 2026 Unlock Fortune with Spinania No Deposit Bonus Extravaganza Avantages de la Methyltestosterone pour les Athlètes Hollywood Casino No-deposit Incentive Password CBCASINO: three hundred Revolves + $500 Straight back Mohegan Sunrays United states Added bonus & Promo Password 2026 Local casino Also offers Trolls Harbors Migliori Casino Online AAMS Italia addirittura Vai, ora Siti Casinò Sicuri nel 2026 Gamble Your path Bitcoin Gambling enterprise which have Instantaneous Withdrawals: Clean com Techniques Payouts in under dos Moments Across the Nine Cryptocurrencies within the 2026 twenty-five 100 percent free Spins No deposit Extra at the Master Jack Local casino 2026 10 Finest Casinos on the internet Real money United states Jul 2026 Alf Gambling enterprise Online casino Comment and you may Incentive $5 Minimal Put Online casinos 2026 Greatest A real income Online casinos within the 2026, Established