You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
397 lines
12 KiB
PHTML
397 lines
12 KiB
PHTML
7 months ago
|
<?php
|
||
|
/**
|
||
|
* Class Jetpack
|
||
|
*
|
||
|
* @link https://github.com/googleforcreators/web-stories-wp
|
||
|
*
|
||
|
* @copyright 2020 Google LLC
|
||
|
* @license https://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0
|
||
|
*/
|
||
|
|
||
|
/**
|
||
|
* Copyright 2020 Google LLC
|
||
|
*
|
||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
* you may not use this file except in compliance with the License.
|
||
|
* You may obtain a copy of the License at
|
||
|
*
|
||
|
* https://www.apache.org/licenses/LICENSE-2.0
|
||
|
*
|
||
|
* Unless required by applicable law or agreed to in writing, software
|
||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
* See the License for the specific language governing permissions and
|
||
|
* limitations under the License.
|
||
|
*/
|
||
|
|
||
|
declare(strict_types = 1);
|
||
|
|
||
|
namespace Google\Web_Stories\Integrations;
|
||
|
|
||
|
use Google\Web_Stories\Context;
|
||
|
use Google\Web_Stories\Media\Media_Source_Taxonomy;
|
||
|
use Google\Web_Stories\Service_Base;
|
||
|
use Google\Web_Stories\Story_Post_Type;
|
||
|
use WP_Post;
|
||
|
use WP_REST_Response;
|
||
|
|
||
|
/**
|
||
|
* Class Jetpack.
|
||
|
*
|
||
|
* @SuppressWarnings(PHPMD.ExcessiveClassComplexity)
|
||
|
*
|
||
|
* @phpstan-type AttachmentData array{
|
||
|
* media_details?: array{
|
||
|
* length?: int,
|
||
|
* length_formatted?: string
|
||
|
* },
|
||
|
* url?: string,
|
||
|
* featured_media_src?: string
|
||
|
* }
|
||
|
*
|
||
|
* @phpstan-type EnhancedAttachmentMetadata array{
|
||
|
* width: int,
|
||
|
* height: int,
|
||
|
* file: string,
|
||
|
* sizes: mixed,
|
||
|
* image_meta: mixed,
|
||
|
* videopress?: array{
|
||
|
* duration: int,
|
||
|
* poster: string,
|
||
|
* width: int,
|
||
|
* height: int,
|
||
|
* file_url_base?: array{
|
||
|
* https: string
|
||
|
* },
|
||
|
* files?: array{
|
||
|
* hd?: array{
|
||
|
* mp4?: string
|
||
|
* }
|
||
|
* }
|
||
|
* }
|
||
|
* }
|
||
|
*/
|
||
|
class Jetpack extends Service_Base {
|
||
|
|
||
|
/**
|
||
|
* VideoPress Mime type.
|
||
|
*
|
||
|
* @since 1.7.2
|
||
|
*/
|
||
|
public const VIDEOPRESS_MIME_TYPE = 'video/videopress';
|
||
|
|
||
|
/**
|
||
|
* VideoPress poster meta key.
|
||
|
*
|
||
|
* @since 1.7.2
|
||
|
*/
|
||
|
public const VIDEOPRESS_POSTER_META_KEY = 'videopress_poster_image';
|
||
|
|
||
|
/**
|
||
|
* Media_Source_Taxonomy instance.
|
||
|
*
|
||
|
* @var Media_Source_Taxonomy Experiments instance.
|
||
|
*/
|
||
|
protected Media_Source_Taxonomy $media_source_taxonomy;
|
||
|
|
||
|
/**
|
||
|
* Context instance.
|
||
|
*
|
||
|
* @var Context Context instance.
|
||
|
*/
|
||
|
private Context $context;
|
||
|
|
||
|
/**
|
||
|
* Jetpack constructor.
|
||
|
*
|
||
|
* @since 1.12.0
|
||
|
*
|
||
|
* @param Media_Source_Taxonomy $media_source_taxonomy Media_Source_Taxonomy instance.
|
||
|
* @param Context $context Context instance.
|
||
|
*/
|
||
|
public function __construct( Media_Source_Taxonomy $media_source_taxonomy, Context $context ) {
|
||
|
$this->media_source_taxonomy = $media_source_taxonomy;
|
||
|
$this->context = $context;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Initializes all hooks.
|
||
|
*
|
||
|
* @since 1.2.0
|
||
|
*/
|
||
|
public function register(): void {
|
||
|
// See https://github.com/Automattic/jetpack/blob/4b85be883b3c584c64eeb2fb0f3fcc15dabe2d30/modules/custom-post-types/portfolios.php#L80.
|
||
|
if ( \defined( 'IS_WPCOM' ) && IS_WPCOM ) {
|
||
|
add_filter( 'wpcom_sitemap_post_types', [ $this, 'add_to_jetpack_sitemap' ] );
|
||
|
} else {
|
||
|
add_filter( 'jetpack_sitemap_post_types', [ $this, 'add_to_jetpack_sitemap' ] );
|
||
|
}
|
||
|
|
||
|
add_filter( 'jetpack_is_amp_request', [ $this, 'force_amp_request' ] );
|
||
|
add_filter( 'web_stories_allowed_mime_types', [ $this, 'add_videopress' ] );
|
||
|
add_filter( 'web_stories_rest_prepare_attachment', [ $this, 'filter_rest_api_response' ], 10, 2 );
|
||
|
add_filter( 'ajax_query_attachments_args', [ $this, 'filter_ajax_query_attachments_args' ] );
|
||
|
add_action( 'added_post_meta', [ $this, 'add_term' ], 10, 3 );
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Adds the web-story post type to Jetpack / WordPress.com sitemaps.
|
||
|
*
|
||
|
* @since 1.2.0
|
||
|
*
|
||
|
* @see https://github.com/Automattic/jetpack/blob/4b85be883b3c584c64eeb2fb0f3fcc15dabe2d30/modules/custom-post-types/portfolios.php#L80
|
||
|
*
|
||
|
* @param array|mixed $post_types Array of post types.
|
||
|
* @return array|mixed Modified list of post types.
|
||
|
*
|
||
|
* @template T
|
||
|
*
|
||
|
* @phpstan-return ($post_types is array<T> ? array<T> : mixed)
|
||
|
*/
|
||
|
public function add_to_jetpack_sitemap( $post_types ) {
|
||
|
if ( ! \is_array( $post_types ) ) {
|
||
|
return $post_types;
|
||
|
}
|
||
|
$post_types[] = Story_Post_Type::POST_TYPE_SLUG;
|
||
|
|
||
|
return $post_types;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Add VideoPress to allowed mime types.
|
||
|
*
|
||
|
* If the site does not support VideoPress, this will be filtered out.
|
||
|
*
|
||
|
* @since 1.7.2
|
||
|
*
|
||
|
* @param array{video?: string[]}|mixed $mime_types Associative array of allowed mime types per media type (image, audio, video).
|
||
|
* @return array{video?: string[]}|mixed
|
||
|
*
|
||
|
* @template T
|
||
|
*
|
||
|
* @phpstan-return ($mime_types is array<T> ? array<T> : mixed)
|
||
|
*/
|
||
|
public function add_videopress( $mime_types ) {
|
||
|
if ( ! \is_array( $mime_types ) ) {
|
||
|
return $mime_types;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Mime types config.
|
||
|
*
|
||
|
* @var array{video?: string[]} $mime_types
|
||
|
*/
|
||
|
$mime_types['video'][] = self::VIDEOPRESS_MIME_TYPE;
|
||
|
|
||
|
return $mime_types;
|
||
|
}
|
||
|
|
||
|
|
||
|
/**
|
||
|
* Filter ajax query attachments args when accessed from the Web Stories editor.
|
||
|
*
|
||
|
* Only filters the response if the mime type matches exactly what Web Stories is looking for.
|
||
|
*
|
||
|
* @since 1.7.2
|
||
|
*
|
||
|
* @param array|mixed $args Query args.
|
||
|
* @return array|mixed Filtered query args.
|
||
|
*
|
||
|
* @template T
|
||
|
*
|
||
|
* @phpstan-return ($args is array<T> ? array<T> : mixed)
|
||
|
*/
|
||
|
public function filter_ajax_query_attachments_args( $args ) {
|
||
|
if ( ! \is_array( $args ) || ! isset( $args['post_mime_type'] ) || ! \is_array( $args['post_mime_type'] ) ) {
|
||
|
return $args;
|
||
|
}
|
||
|
|
||
|
if ( \in_array( self::VIDEOPRESS_MIME_TYPE, $args['post_mime_type'], true ) ) {
|
||
|
add_filter( 'wp_prepare_attachment_for_js', [ $this, 'filter_admin_ajax_response' ], 15, 2 );
|
||
|
}
|
||
|
|
||
|
return $args;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Filter admin ajax responses for VideoPress videos.
|
||
|
*
|
||
|
* Changes the video/videopress type back to mp4
|
||
|
* and ensures MP4 source URLs are returned.
|
||
|
*
|
||
|
* @since 1.7.2
|
||
|
*
|
||
|
* @param array|mixed $data Array of prepared attachment data. @see wp_prepare_attachment_for_js().
|
||
|
* @param WP_Post $attachment Attachment object.
|
||
|
* @return array|mixed
|
||
|
*
|
||
|
* @phpstan-param AttachmentData $data
|
||
|
* @phpstan-return AttachmentData|mixed
|
||
|
*
|
||
|
* @template T
|
||
|
*
|
||
|
* @phpstan-return ($data is array<T> ? array<T> : mixed)
|
||
|
*/
|
||
|
public function filter_admin_ajax_response( $data, WP_Post $attachment ) {
|
||
|
if ( self::VIDEOPRESS_MIME_TYPE !== $attachment->post_mime_type ) {
|
||
|
return $data;
|
||
|
}
|
||
|
|
||
|
if ( ! \is_array( $data ) ) {
|
||
|
return $data;
|
||
|
}
|
||
|
|
||
|
// Reset mime type back to mp4, as this is the correct value.
|
||
|
$data['mime'] = 'video/mp4';
|
||
|
$data['subtype'] = 'mp4';
|
||
|
|
||
|
// Mark video as optimized.
|
||
|
$data[ $this->media_source_taxonomy::MEDIA_SOURCE_KEY ] = 'video-optimization';
|
||
|
|
||
|
/**
|
||
|
* Jetpack adds an additional field to regular attachment metadata.
|
||
|
*
|
||
|
* @var array $metadata
|
||
|
* @phpstan-var EnhancedAttachmentMetadata|false $metadata
|
||
|
*/
|
||
|
$metadata = wp_get_attachment_metadata( $attachment->ID );
|
||
|
|
||
|
if ( $metadata && isset( $metadata['videopress']['duration'], $data['media_details'] ) && \is_array( $data['media_details'] ) ) {
|
||
|
$data['media_details']['length_formatted'] = $this->format_milliseconds( $metadata['videopress']['duration'] );
|
||
|
$data['media_details']['length'] = (int) floor( $metadata['videopress']['duration'] / 1000 );
|
||
|
}
|
||
|
|
||
|
if ( $metadata && isset( $data['url'], $metadata['videopress']['file_url_base']['https'], $metadata['videopress']['files']['hd']['mp4'] ) ) {
|
||
|
$data['url'] = $metadata['videopress']['file_url_base']['https'] . $metadata['videopress']['files']['hd']['mp4'];
|
||
|
}
|
||
|
|
||
|
// Get the correct poster with matching dimensions from VideoPress.
|
||
|
if ( $metadata && isset( $data['featured_media_src'], $metadata['videopress']['poster'], $metadata['videopress']['width'], $metadata['videopress']['height'] ) ) {
|
||
|
$data['featured_media_src'] = [
|
||
|
'src' => $metadata['videopress']['poster'],
|
||
|
'width' => $metadata['videopress']['width'],
|
||
|
'height' => $metadata['videopress']['height'],
|
||
|
'generated' => true,
|
||
|
];
|
||
|
}
|
||
|
|
||
|
return $data;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Filter REST API responses for VideoPress videos.
|
||
|
*
|
||
|
* Changes the video/videopress type back to mp4
|
||
|
* and ensures MP4 source URLs are returned.
|
||
|
*
|
||
|
* @since 1.7.2
|
||
|
*
|
||
|
* @param WP_REST_Response $response The response object.
|
||
|
* @param WP_Post $post The original attachment post.
|
||
|
*/
|
||
|
public function filter_rest_api_response( WP_REST_Response $response, WP_Post $post ): WP_REST_Response {
|
||
|
if ( self::VIDEOPRESS_MIME_TYPE !== $post->post_mime_type ) {
|
||
|
return $response;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Response data.
|
||
|
*
|
||
|
* @var array<string, string|array<string, int|string>|bool> $data
|
||
|
*/
|
||
|
$data = $response->get_data();
|
||
|
|
||
|
// Reset mime type back to mp4, as this is the correct value.
|
||
|
$data['mime_type'] = 'video/mp4';
|
||
|
|
||
|
// Mark video as optimized.
|
||
|
$data[ $this->media_source_taxonomy::MEDIA_SOURCE_KEY ] = 'video-optimization';
|
||
|
|
||
|
/**
|
||
|
* Jetpack adds an additional field to regular attachment metadata.
|
||
|
*
|
||
|
* @var EnhancedAttachmentMetadata|false $metadata
|
||
|
*/
|
||
|
$metadata = wp_get_attachment_metadata( $post->ID );
|
||
|
|
||
|
if ( $metadata && isset( $metadata['videopress']['duration'], $data['media_details'] ) && \is_array( $data['media_details'] ) ) {
|
||
|
$data['media_details']['length_formatted'] = $this->format_milliseconds( $metadata['videopress']['duration'] );
|
||
|
$data['media_details']['length'] = (int) floor( $metadata['videopress']['duration'] / 1000 );
|
||
|
}
|
||
|
|
||
|
if ( $metadata && isset( $data['source_url'], $metadata['videopress']['file_url_base']['https'], $metadata['videopress']['files']['hd']['mp4'] ) ) {
|
||
|
$data['source_url'] = $metadata['videopress']['file_url_base']['https'] . $metadata['videopress']['files']['hd']['mp4'];
|
||
|
}
|
||
|
|
||
|
// Get the correct poster with matching dimensions from VideoPress.
|
||
|
if ( $metadata && isset( $data['featured_media_src'], $metadata['videopress']['poster'], $metadata['videopress']['width'], $metadata['videopress']['height'] ) ) {
|
||
|
$data['featured_media_src'] = [
|
||
|
'src' => $metadata['videopress']['poster'],
|
||
|
'width' => $metadata['videopress']['width'],
|
||
|
'height' => $metadata['videopress']['height'],
|
||
|
'generated' => true,
|
||
|
];
|
||
|
}
|
||
|
|
||
|
$response->set_data( $data );
|
||
|
|
||
|
return $response;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Hook into added_post_meta.
|
||
|
*
|
||
|
* @since 1.7.2
|
||
|
*
|
||
|
* @param int $mid The meta ID after successful update.
|
||
|
* @param int $object_id ID of the object metadata is for.
|
||
|
* @param string $meta_key Metadata key.
|
||
|
*/
|
||
|
public function add_term( int $mid, int $object_id, string $meta_key ): void {
|
||
|
if ( self::VIDEOPRESS_POSTER_META_KEY !== $meta_key ) {
|
||
|
return;
|
||
|
}
|
||
|
if ( 'attachment' !== get_post_type( $object_id ) ) {
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
wp_set_object_terms( (int) $object_id, $this->media_source_taxonomy::TERM_POSTER_GENERATION, $this->media_source_taxonomy->get_taxonomy_slug() );
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Force Jetpack to see Web Stories as AMP.
|
||
|
*
|
||
|
* @since 1.2.0
|
||
|
*
|
||
|
* @param bool $is_amp_request Is the request supposed to return valid AMP content.
|
||
|
* @return bool Whether the current request is an AMP request.
|
||
|
*/
|
||
|
public function force_amp_request( bool $is_amp_request ): bool {
|
||
|
if ( ! $this->context->is_web_story() ) {
|
||
|
return (bool) $is_amp_request;
|
||
|
}
|
||
|
return true;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Format milliseconds into seconds.
|
||
|
*
|
||
|
* @since 1.7.2
|
||
|
*
|
||
|
* @param int $milliseconds Milliseconds to converted to minutes and seconds.
|
||
|
*/
|
||
|
protected function format_milliseconds( int $milliseconds ): string {
|
||
|
$seconds = floor( $milliseconds / 1000 );
|
||
|
|
||
|
if ( $seconds >= 1 ) {
|
||
|
$minutes = floor( $seconds / 60 );
|
||
|
$seconds %= 60;
|
||
|
} else {
|
||
|
$seconds = 0;
|
||
|
$minutes = 0;
|
||
|
}
|
||
|
|
||
|
return sprintf( '%d:%02u', $minutes, $seconds );
|
||
|
}
|
||
|
}
|