Seditio Source
Root |
./othercms/wordpress-6.0/wp-includes/class-wp-oembed-controller.php
<?php
/**
 * 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
 */
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
     *
     * @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;

       
$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 ) {
                global
$wp_scripts;
               
// 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;
    }
}