/** * 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 Jintropin: Gli Effetti Positivi della Somatotropina The Very Best Online Casinos That Approve Neteller: A Comprehensive Guide Efectos de la Gonadotropina: Un Análisis Integral L’univers captivant de Starzino en ligne et ses expériences innovantes Fedezd fel a Spinstar bónusz varázsát és nyerj hihetetlent! The Benefits of No Wagering Deposit Bonus Offers Casinolo Casino English Unleashed A Destiny of Wagering Wonders Energiegeladenes Zusammenspiel von Tieren und Münzen entblößt Geheimnisse Verken de spannende wereld van betwarts en ligne met flair Unleashing Brilliance at the 2026 Monopoly Big Baller JUCO Jamboree Zanurz się w eksplozję emocji z 4 pots riches hold and win demo Estrellas fugaces de starzino iluminando tus sueños más audaces Unlock Exceptional Savings with Winbay’s Latest Promotions Today Casinolo l’évasion mystique au cœur des jeux envoûtants Betwarts Casino Unleashes a New Era of Thrilling Gameplay Adventures Unlock Your Adventure Beyond the Casinolo Login Portal A Revolução da Streaming com o Aplicativo Starzino Lépésről lépésre hogyan nyerjünk a kaszinóban Unlock Your Fortune with Casinobuck’s Irresistible No Deposit Treasure slotuna 3 открива безкрайни печалби и играе мечти Unveiling Starzino Casino A Comprehensive Review Objavte magické víťazstvo vo svete WinBay Casino online Harmonijny świat Współczynnika RTP Burning Wins i jego tajemnice Η μαγεία του Coin Strike Hold and Win σε περιμένει στον κόσμο των καζίνο Unlock Thrilling Wins in the Enchanting World of Twin Spin Deluxe Slot Magische energie uit dieren en munten voor een vrije toekomst The Surge of Mobile Gambling Enterprises: A Revolution in Gambling PayPal Down Payment Gambling Enterprises: The Convenient Method to Delight In Online Betting Unleash Your Winning Spirit at Total Casino UK’s Daring Playground Unlocking the Electric Thrills of Betwarts En Ligne Experience Nameless Online Chat 24 7, Talk To Strangers Instantly Chathub Review 2026: Features, Pricing & Tips On How To Use Wettquoten Formel 1 Entschlüsselt die Geheimnisse der Rennstrategien Jaké jsou tajemství úspěšných hazardních hráčů mezi celebritami Comprehending Online Casino Site Payouts: A Comprehensive Overview Online Online Casino No Deposit Reward: An Overview for Players Złote szanse z kasyno online bonus na wygrane pełne emocji Mastercard Casino Sites Online Settlement: A Secure and Hassle-free Alternative for Casino Players Bate-papo Por Vídeo: A Nova Forma De Namoro? Conocer Gente De Todo El Mundo Chat Omegle: Quello Che Devi Sapere Su Omegle Com Omegle Alternative 2026: Beste Seiten + Videos Aufnehmen Free Video Conferencing: Reliable & Simple To Use Peptid Ghrp 6: Jak se to má užívat Navigating Roulette Casinos with Ease: What Newcomers Notice First Free Roulette Darmowa uciecha nv casino i opinie 2025 Mastering your bankroll Essential financial management tips for gamblers Home