/** * 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 Real cash Roulette Online Book 2026 Gamble On line Roulette The real deal Currency at the Better Us Internet sites No deposit Added bonus Casino No deposit Added bonus Casino Textualize steeped: Steeped try a Python collection to possess rich text message and delightful formatting on the terminal Better Casinos on the internet within the 2026: Best 15 A real income Web sites steeped Wiktionary, the brand new totally free dictionary 5 Reel Ports: Enjoy 5 Reel Slots with no DownloadAug, 2026 Free Blackjack On line: Play 21 Games No deposit Added bonus Rules 2026 Actual-Currency Online casinos Greatest Electronic poker Web based casinos 2026 Finest Real money Gambling enterprises Us July 2026 Pro Selections 100 percent free Gambling games No Obtain Gamble 20,000+ Games Finest Payment Web based casinos 2026: Highest Investing RTP Sites to possess August Best Legit Casinos on the internet: Real cash Web sites in the 2026 Top ten Web based casinos to experience A real income Video game inside United states of america 2026 Play Book away from Ra Online Totally free Best fifty Free Revolves No deposit Incentives On line 2026 Better Web based casinos One Shell out Real cash 2026 Best Real cash Online casinos inside the 2026 Gamble Blackjack On line for free Enjoyable Simulation Video game Finest casinos on the internet for real currency: Picking the top online casino to own 2026 Finest A real income Casinos You July 2026 Professional Selections A real income Casinos to have 2026 Gamble during the Real money Gambling enterprises Black-jack Trial Video game ️ Routine Blackjack Free of charge Right here 8 Online casino Sites for real Currency Playing Ranked August 2026 Finest Web based casinos Usa 2025 Real money, Incentives and The newest SitesBest United states Casinos on the internet 2026 Side-by-Top Evaluation Blackjack Gamble Online Best A real income Web based casinos Top Within the August 2026 No-deposit Bonus Gambling enterprises and Coupons to own August 2026 Greatest Online casinos Canada 2025- List of Safer Real cash Casinos on the internet to own Canadians Rating $33 Free Today in the Entire world Leaders Gambling establishment: No deposit Incentive Give Better Casinos on the internet United states of america 2025 Real money, Incentives and The newest SitesBest You Web based casinos 2026 Side-by-Front Research Greatest Casinos on the internet in the us 2026 Real cash Green Panther Top ten Online casinos playing Real money Games inside the United states of america 2026 No deposit Gambling enterprises 2026 sixty No deposit from the Real cash Casinos Better Casino games to possess 2026: Play and Winnings Real money five hundred Totally free Revolves No-deposit Bonuses August 2026: Greatest 100 percent free Spin Also offers at the Casinos on the internet Today Greatest casino games for real money in the united states Play and earn real cash Greatest No deposit Bonuses in the usa to possess 2026 Best On the internet Blackjack Sites for real Profit 2025 Best Blackjack Internet sites On the internet the real deal Money Upgraded 2026 Gamble 100 percent free Casino games online Cellular phone casino: Online casino games on the smartphone Best Real cash Casinos on the internet within the 2026, Verified Pay Because of the Mobile phone Expenses Casinos 2026 PayForIt Gambling enterprise Deposits five-hundred Free Spins No deposit Incentives August 2026: Finest Totally free Twist Also offers from the Web based casinos Today Real money Casinos to possess 2026 Play from the A real income Casinos Best A real income Casinos on the internet Respected and Legitimate Internet sites