story.php
512 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Story Block. |
| 4 | * |
| 5 | * @since 8.6.1 |
| 6 | * |
| 7 | * @package automattic/jetpack |
| 8 | */ |
| 9 | |
| 10 | namespace Automattic\Jetpack\Extensions\Story; |
| 11 | |
| 12 | use Automattic\Jetpack\Blocks; |
| 13 | use Automattic\Jetpack\Connection\Connection_Assets; |
| 14 | use Jetpack; |
| 15 | use Jetpack_Gutenberg; |
| 16 | use Jetpack_PostImages; |
| 17 | |
| 18 | const EMBED_SIZE = array( 360, 640 ); // twice as many pixels for retina displays. |
| 19 | const CROP_UP_TO = 0.2; |
| 20 | const MAX_BULLETS = 7; |
| 21 | const IMAGE_BREAKPOINTS = '(max-width: 460px) 576w, (max-width: 614px) 768w, 120vw'; // 120vw to match the 20% CROP_UP_TO ratio |
| 22 | |
| 23 | /** |
| 24 | * Registers the block for use in Gutenberg |
| 25 | * This is done via an action so that we can disable |
| 26 | * registration if we need to. |
| 27 | */ |
| 28 | function register_block() { |
| 29 | Blocks::jetpack_register_block( |
| 30 | __DIR__, |
| 31 | array( 'render_callback' => __NAMESPACE__ . '\render_block' ) |
| 32 | ); |
| 33 | } |
| 34 | add_action( 'init', __NAMESPACE__ . '\register_block' ); |
| 35 | |
| 36 | /** |
| 37 | * Compare 2 urls and return true if they likely correspond to the same resource. |
| 38 | * Ignore scheme, ports, query params and hashes and only compare hostname and pathname. |
| 39 | * |
| 40 | * @param string $url1 - First url used in comparison. |
| 41 | * @param string $url2 - Second url used in comparison. |
| 42 | * |
| 43 | * @return boolean |
| 44 | */ |
| 45 | function is_same_resource( $url1, $url2 ) { |
| 46 | $url1_parsed = wp_parse_url( $url1 ); |
| 47 | $url2_parsed = wp_parse_url( $url2 ); |
| 48 | return isset( $url1_parsed['host'] ) && |
| 49 | isset( $url2_parsed['host'] ) && |
| 50 | isset( $url1_parsed['path'] ) && |
| 51 | isset( $url2_parsed['path'] ) && |
| 52 | $url1_parsed['host'] === $url2_parsed['host'] && |
| 53 | $url1_parsed['path'] === $url2_parsed['path']; |
| 54 | } |
| 55 | |
| 56 | /** |
| 57 | * Enrich media files retrieved from the story block attributes |
| 58 | * with extra information we can retrieve from the media library. |
| 59 | * |
| 60 | * @param array $media_files - List of media, each as an array containing the media attributes. |
| 61 | * |
| 62 | * @return array $media_files |
| 63 | */ |
| 64 | function enrich_media_files( $media_files ) { |
| 65 | return array_filter( |
| 66 | array_map( |
| 67 | function ( $media_file ) { |
| 68 | if ( ! is_array( $media_file ) || ! isset( $media_file['type'] ) ) { |
| 69 | return null; |
| 70 | } |
| 71 | if ( 'image' === $media_file['type'] ) { |
| 72 | return enrich_image_meta( $media_file ); |
| 73 | } |
| 74 | // VideoPress videos can sometimes have type 'file', and mime 'video/videopress' or 'video/mp4'. |
| 75 | // Let's fix `type` for those. |
| 76 | if ( |
| 77 | 'file' === $media_file['type'] |
| 78 | && isset( $media_file['mime'] ) |
| 79 | && str_starts_with( $media_file['mime'], 'video' ) |
| 80 | ) { |
| 81 | $media_file['type'] = 'video'; |
| 82 | } |
| 83 | if ( 'video' !== $media_file['type'] ) { // we only support images and videos at this point. |
| 84 | return null; |
| 85 | } |
| 86 | return enrich_video_meta( $media_file ); |
| 87 | }, |
| 88 | $media_files |
| 89 | ) |
| 90 | ); |
| 91 | } |
| 92 | |
| 93 | /** |
| 94 | * Enrich image information with extra data we can retrieve from the media library. |
| 95 | * Add missing `width`, `height`, `srcset`, `sizes`, `title`, `alt` and `caption` properties to the image. |
| 96 | * |
| 97 | * @param array $media_file - An array containing the media attributes for a specific image. |
| 98 | * |
| 99 | * @return array $media_file_enriched |
| 100 | */ |
| 101 | function enrich_image_meta( $media_file ) { |
| 102 | $attachment_id = isset( $media_file['id'] ) ? $media_file['id'] : null; |
| 103 | $image = wp_get_attachment_image_src( $attachment_id, 'full', false ); |
| 104 | if ( ! $image ) { |
| 105 | return $media_file; |
| 106 | } |
| 107 | list( $src, $width, $height ) = $image; |
| 108 | // Bail if url stored in block attributes is different than the media library one for that id. |
| 109 | if ( isset( $media_file['url'] ) && ! is_same_resource( $media_file['url'], $src ) ) { |
| 110 | return $media_file; |
| 111 | } |
| 112 | $image_meta = wp_get_attachment_metadata( $attachment_id ); |
| 113 | if ( ! is_array( $image_meta ) ) { |
| 114 | return $media_file; |
| 115 | } |
| 116 | $size_array = array( absint( $width ), absint( $height ) ); |
| 117 | return array_merge( |
| 118 | $media_file, |
| 119 | array( |
| 120 | 'width' => absint( $width ), |
| 121 | 'height' => absint( $height ), |
| 122 | 'srcset' => wp_calculate_image_srcset( $size_array, $src, $image_meta, $attachment_id ), |
| 123 | 'sizes' => IMAGE_BREAKPOINTS, |
| 124 | 'title' => get_the_title( $attachment_id ), |
| 125 | 'alt' => get_post_meta( $attachment_id, '_wp_attachment_image_alt', true ), |
| 126 | 'caption' => wp_get_attachment_caption( $attachment_id ), |
| 127 | ) |
| 128 | ); |
| 129 | } |
| 130 | |
| 131 | /** |
| 132 | * Enrich video information with extra data we can retrieve from the media library. |
| 133 | * Add missing `width`, `height`, `alt`, `url`, `title`, `caption` and `poster` properties to the image. |
| 134 | * |
| 135 | * @param array $media_file - An array containing the media attributes for a specific video. |
| 136 | * |
| 137 | * @return array $media_file_enriched |
| 138 | */ |
| 139 | function enrich_video_meta( $media_file ) { |
| 140 | $attachment_id = isset( $media_file['id'] ) ? $media_file['id'] : null; |
| 141 | $video_meta = wp_get_attachment_metadata( $attachment_id ); |
| 142 | if ( ! $video_meta ) { |
| 143 | return $media_file; |
| 144 | } |
| 145 | |
| 146 | $video_url = ! empty( $video_meta['original']['url'] ) ? $video_meta['original']['url'] : wp_get_attachment_url( $attachment_id ); |
| 147 | |
| 148 | // Set the poster attribute for the video tag if a poster image is available. |
| 149 | $poster_url = null; |
| 150 | if ( ! empty( $video_meta['videopress']['poster'] ) ) { |
| 151 | $poster_url = $video_meta['videopress']['poster']; |
| 152 | } elseif ( ! empty( $video_meta['thumb'] ) ) { |
| 153 | $poster_url = str_replace( wp_basename( $video_url ), $video_meta['thumb'], $video_url ); |
| 154 | } |
| 155 | |
| 156 | if ( $poster_url ) { |
| 157 | // Use the global content width for thumbnail resize so we match the `w=` query parameter |
| 158 | // that jetpack is going to add when "Enable site accelerator" is enabled for images. |
| 159 | $content_width = (int) Jetpack::get_content_width(); |
| 160 | $new_width = $content_width > 0 ? $content_width : EMBED_SIZE[0]; |
| 161 | $poster_url = add_query_arg( 'w', $new_width, $poster_url ); |
| 162 | } |
| 163 | |
| 164 | return array_merge( |
| 165 | $media_file, |
| 166 | array( |
| 167 | 'width' => absint( ! empty( $video_meta['width'] ) ? $video_meta['width'] : $media_file['width'] ), |
| 168 | 'height' => absint( ! empty( $video_meta['height'] ) ? $video_meta['height'] : $media_file['height'] ), |
| 169 | 'alt' => ! empty( $video_meta['videopress']['description'] ) ? $video_meta['videopress']['description'] : $media_file['alt'], |
| 170 | 'url' => $video_url, |
| 171 | 'title' => get_the_title( $attachment_id ), |
| 172 | 'caption' => wp_get_attachment_caption( $attachment_id ), |
| 173 | 'poster' => $poster_url, |
| 174 | ) |
| 175 | ); |
| 176 | } |
| 177 | |
| 178 | /** |
| 179 | * Render an image inside a slide |
| 180 | * |
| 181 | * @param array $media - Image information. |
| 182 | * |
| 183 | * @return string |
| 184 | */ |
| 185 | function render_image( $media ) { |
| 186 | if ( empty( $media['id'] ) || empty( $media['url'] ) ) { |
| 187 | return __( 'Error retrieving media', 'jetpack' ); |
| 188 | } |
| 189 | $image = wp_get_attachment_image_src( $media['id'], 'full', false ); |
| 190 | if ( $image ) { |
| 191 | list( $src, $width, $height ) = $image; |
| 192 | } |
| 193 | |
| 194 | // if image does not match. |
| 195 | if ( ! $image || isset( $media['url'] ) && ! is_same_resource( $media['url'], $src ) ) { |
| 196 | $width = isset( $media['width'] ) ? $media['width'] : null; |
| 197 | $height = isset( $media['height'] ) ? $media['height'] : null; |
| 198 | $title = isset( $media['title'] ) ? $media['title'] : ''; |
| 199 | $alt = isset( $media['alt'] ) ? $media['alt'] : ''; |
| 200 | return sprintf( |
| 201 | '<img |
| 202 | title="%1$s" |
| 203 | alt="%2$s" |
| 204 | class="wp-block-jetpack-story_image wp-story-image %3$s" |
| 205 | src="%4$s" |
| 206 | />', |
| 207 | esc_attr( $title ), |
| 208 | esc_attr( $alt ), |
| 209 | $width && $height ? get_image_crop_class( $width, $height ) : '', |
| 210 | esc_attr( $media['url'] ) |
| 211 | ); |
| 212 | } |
| 213 | |
| 214 | $crop_class = get_image_crop_class( $width, $height ); |
| 215 | // need to specify the size of the embed so it picks an image that is large enough for the `src` attribute |
| 216 | // `sizes` is optimized for 1080x1920 (9:16) images |
| 217 | // Note that the Story block does not have thumbnail support, it will load the right |
| 218 | // image based on the viewport size only. |
| 219 | return wp_get_attachment_image( |
| 220 | $media['id'], |
| 221 | EMBED_SIZE, |
| 222 | false, |
| 223 | array( |
| 224 | 'class' => sprintf( 'wp-story-image wp-image-%d %s', $media['id'], $crop_class ), |
| 225 | 'sizes' => IMAGE_BREAKPOINTS, |
| 226 | 'title' => get_the_title( $media['id'] ), |
| 227 | ) |
| 228 | ); |
| 229 | } |
| 230 | |
| 231 | /** |
| 232 | * Return the css crop class if image width and height requires it |
| 233 | * |
| 234 | * @param int $width - Image width. |
| 235 | * @param int $height - Image height. |
| 236 | * |
| 237 | * @return string The CSS class which will display a cropped image |
| 238 | */ |
| 239 | function get_image_crop_class( $width, $height ) { |
| 240 | $crop_class = ''; |
| 241 | $width = (int) $width; |
| 242 | $height = (int) $height; |
| 243 | if ( ! $width || ! $height ) { |
| 244 | return $crop_class; |
| 245 | } |
| 246 | $media_aspect_ratio = $width / $height; |
| 247 | $target_aspect_ratio = EMBED_SIZE[0] / EMBED_SIZE[1]; |
| 248 | if ( $media_aspect_ratio >= $target_aspect_ratio ) { |
| 249 | // image wider than canvas. |
| 250 | $media_too_wide_to_crop = $media_aspect_ratio > $target_aspect_ratio / ( 1 - CROP_UP_TO ); |
| 251 | if ( ! $media_too_wide_to_crop ) { |
| 252 | $crop_class = 'wp-story-crop-wide'; |
| 253 | } |
| 254 | } else { |
| 255 | // image narrower than canvas. |
| 256 | $media_too_narrow_to_crop = $media_aspect_ratio < $target_aspect_ratio * ( 1 - CROP_UP_TO ); |
| 257 | if ( ! $media_too_narrow_to_crop ) { |
| 258 | $crop_class = 'wp-story-crop-narrow'; |
| 259 | } |
| 260 | } |
| 261 | return $crop_class; |
| 262 | } |
| 263 | |
| 264 | /** |
| 265 | * Returns a URL for the site icon. |
| 266 | * |
| 267 | * @param int $size - Size for (square) sitei icon. |
| 268 | * @param string $fallback - Fallback URL to use if no site icon is found. |
| 269 | * |
| 270 | * @return string |
| 271 | */ |
| 272 | function get_blavatar_or_site_icon_url( $size, $fallback ) { |
| 273 | $image_array = Jetpack_PostImages::from_blavatar( get_the_ID(), $size ); |
| 274 | if ( ! empty( $image_array ) ) { |
| 275 | return $image_array[0]['src']; |
| 276 | } else { |
| 277 | return $fallback; |
| 278 | } |
| 279 | } |
| 280 | |
| 281 | /** |
| 282 | * Render a video inside a slide |
| 283 | * |
| 284 | * @param array $media - Video information. |
| 285 | * |
| 286 | * @return string |
| 287 | */ |
| 288 | function render_video( $media ) { |
| 289 | if ( empty( $media['id'] ) || empty( $media['mime'] ) || empty( $media['url'] ) ) { |
| 290 | return __( 'Error retrieving media', 'jetpack' ); |
| 291 | } |
| 292 | |
| 293 | if ( ! empty( $media['poster'] ) ) { |
| 294 | return render_image( |
| 295 | array_merge( |
| 296 | $media, |
| 297 | array( |
| 298 | 'type' => 'image', |
| 299 | 'url' => $media['poster'], |
| 300 | ) |
| 301 | ) |
| 302 | ); |
| 303 | } |
| 304 | |
| 305 | return sprintf( |
| 306 | '<video |
| 307 | title="%1$s" |
| 308 | type="%2$s" |
| 309 | class="wp-story-video intrinsic-ignore wp-video-%3$s" |
| 310 | data-id="%3$d" |
| 311 | src="%4$s"> |
| 312 | </video>', |
| 313 | esc_attr( get_the_title( $media['id'] ) ), |
| 314 | esc_attr( $media['mime'] ), |
| 315 | absint( $media['id'] ), |
| 316 | esc_attr( $media['url'] ) |
| 317 | ); |
| 318 | } |
| 319 | |
| 320 | /** |
| 321 | * Pick a thumbnail to render a static/embedded story |
| 322 | * |
| 323 | * @param array $media_files - list of Media files. |
| 324 | * |
| 325 | * @return string |
| 326 | */ |
| 327 | function render_static_slide( $media_files ) { |
| 328 | $media_template = ''; |
| 329 | if ( empty( $media_files ) ) { |
| 330 | return ''; |
| 331 | } |
| 332 | |
| 333 | // find an image to showcase. |
| 334 | foreach ( $media_files as $media ) { |
| 335 | switch ( $media['type'] ) { |
| 336 | case 'image': |
| 337 | $media_template = render_image( $media ); |
| 338 | break 2; |
| 339 | case 'video': |
| 340 | // ignore videos without a poster image. |
| 341 | if ( empty( $media['poster'] ) ) { |
| 342 | continue 2; |
| 343 | } |
| 344 | $media_template = render_video( $media ); |
| 345 | break 2; |
| 346 | } |
| 347 | } |
| 348 | |
| 349 | // if no "static" media was found for the thumbnail try to render a video tag without poster. |
| 350 | if ( empty( $media_template ) && ! empty( $media_files ) ) { |
| 351 | $media_template = render_video( $media_files[0] ); |
| 352 | } |
| 353 | |
| 354 | return sprintf( |
| 355 | '<div class="wp-story-slide" style="display: block;"> |
| 356 | <figure>%s</figure> |
| 357 | </div>', |
| 358 | $media_template |
| 359 | ); |
| 360 | } |
| 361 | |
| 362 | /** |
| 363 | * Render the top right icon on top of the story embed |
| 364 | * |
| 365 | * @param array $settings - The block settings. |
| 366 | * |
| 367 | * @return string |
| 368 | */ |
| 369 | function render_top_right_icon( $settings ) { |
| 370 | $show_slide_count = isset( $settings['showSlideCount'] ) ? $settings['showSlideCount'] : false; |
| 371 | $slide_count = isset( $settings['slides'] ) ? count( $settings['slides'] ) : 0; |
| 372 | if ( $show_slide_count ) { |
| 373 | // Render the story block icon along with the slide count. |
| 374 | return sprintf( |
| 375 | '<div class="wp-story-embed-icon"> |
| 376 | <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" role="img" aria-hidden="true" focusable="false"> |
| 377 | <path d="M0 0h24v24H0z" fill="none"></path> |
| 378 | <path fill-rule="evenodd" clip-rule="evenodd" d="M6 3H14V17H6L6 3ZM4 3C4 1.89543 4.89543 1 6 1H14C15.1046 1 16 1.89543 16 3V17C16 18.1046 15.1046 19 14 19H6C4.89543 19 4 18.1046 4 17V3ZM18 5C19.1046 5 20 5.89543 20 7V21C20 22.1046 19.1046 23 18 23H10C8.89543 23 8 22.1046 8 21H18V5Z"></path> |
| 379 | </svg> |
| 380 | <span>%d</span> |
| 381 | </div>', |
| 382 | $slide_count |
| 383 | ); |
| 384 | } else { |
| 385 | // Render the Fullscreen Gridicon. |
| 386 | return ( |
| 387 | '<div class="wp-story-embed-icon-expand"> |
| 388 | <svg class="gridicon gridicons-fullscreen" role="img" height="24" width="24" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"> |
| 389 | <g> |
| 390 | <path d="M21 3v6h-2V6.41l-3.29 3.3-1.42-1.42L17.59 5H15V3zM3 3v6h2V6.41l3.29 3.3 1.42-1.42L6.41 5H9V3zm18 18v-6h-2v2.59l-3.29-3.29-1.41 1.41L17.59 19H15v2zM9 21v-2H6.41l3.29-3.29-1.41-1.42L5 17.59V15H3v6z"></path> |
| 391 | </g> |
| 392 | </svg> |
| 393 | </div>' |
| 394 | ); |
| 395 | } |
| 396 | } |
| 397 | |
| 398 | /** |
| 399 | * Render a pagination bullet |
| 400 | * |
| 401 | * @param int $slide_index - The slide index it corresponds to. |
| 402 | * @param string $class_name - Optional css class name(s) to customize the bullet element. |
| 403 | * |
| 404 | * @return string |
| 405 | */ |
| 406 | function render_pagination_bullet( $slide_index, $class_name = '' ) { |
| 407 | return sprintf( |
| 408 | '<div class="wp-story-pagination-bullet %s" aria-label="%s"> |
| 409 | <div class="wp-story-pagination-bullet-bar"></div> |
| 410 | </div>', |
| 411 | esc_attr( $class_name ), |
| 412 | /* translators: %d is the slide number (1, 2, 3...) */ |
| 413 | sprintf( __( 'Go to slide %d', 'jetpack' ), $slide_index ) |
| 414 | ); |
| 415 | } |
| 416 | |
| 417 | /** |
| 418 | * Render pagination on top of the story embed |
| 419 | * |
| 420 | * @param array $settings - The block settings. |
| 421 | * |
| 422 | * @return string |
| 423 | */ |
| 424 | function render_pagination( $settings ) { |
| 425 | $show_slide_count = isset( $settings['showSlideCount'] ) ? $settings['showSlideCount'] : false; |
| 426 | if ( $show_slide_count ) { |
| 427 | return ''; |
| 428 | } |
| 429 | $slide_count = isset( $settings['slides'] ) ? count( $settings['slides'] ) : 0; |
| 430 | $bullet_count = min( $slide_count, MAX_BULLETS ); |
| 431 | $bullet_ellipsis = $slide_count > $bullet_count |
| 432 | ? render_pagination_bullet( $bullet_count + 1, 'wp-story-pagination-ellipsis' ) |
| 433 | : ''; |
| 434 | return sprintf( |
| 435 | '<div class="wp-story-pagination wp-story-pagination-bullets"> |
| 436 | %s |
| 437 | </div>', |
| 438 | implode( "\n", array_map( __NAMESPACE__ . '\render_pagination_bullet', range( 1, $bullet_count ) ) ) . $bullet_ellipsis |
| 439 | ); |
| 440 | } |
| 441 | |
| 442 | /** |
| 443 | * Render story block |
| 444 | * |
| 445 | * @param array $attributes - Block attributes. |
| 446 | * |
| 447 | * @return string |
| 448 | */ |
| 449 | function render_block( $attributes ) { |
| 450 | // Let's use a counter to have a different id for each story rendered in the same context. |
| 451 | static $story_block_counter = 0; |
| 452 | |
| 453 | if ( 0 === $story_block_counter ) { |
| 454 | // @todo Fix the webpack tree shaking so the block's view.js no longer depends on jetpack-connection, then remove this. |
| 455 | Connection_Assets::register_assets(); |
| 456 | } |
| 457 | |
| 458 | Jetpack_Gutenberg::load_assets_as_required( __DIR__ ); |
| 459 | |
| 460 | $media_files = isset( $attributes['mediaFiles'] ) ? enrich_media_files( $attributes['mediaFiles'] ) : array(); |
| 461 | $settings_from_attributes = isset( $attributes['settings'] ) ? $attributes['settings'] : array(); |
| 462 | |
| 463 | $settings = array_merge( |
| 464 | $settings_from_attributes, |
| 465 | array( |
| 466 | 'slides' => $media_files, |
| 467 | ) |
| 468 | ); |
| 469 | |
| 470 | /* translators: Placehodlder if the Story block can't find a post title to use. */ |
| 471 | $story_title = in_the_loop() ? get_the_title() : __( 'Story', 'jetpack' ); |
| 472 | |
| 473 | return sprintf( |
| 474 | '<div class="%1$s" data-id="%2$s" data-settings="%3$s"> |
| 475 | <div class="wp-story-app"> |
| 476 | <div class="wp-story-display-contents" style="display: contents;"> |
| 477 | <a class="wp-story-container" href="%4$s" title="%5$s"> |
| 478 | <div class="wp-story-meta"> |
| 479 | <div class="wp-story-icon"> |
| 480 | <img alt="%6$s" src="%7$s" width="40" height="40"> |
| 481 | </div> |
| 482 | <div> |
| 483 | <div class="wp-story-title"> |
| 484 | %8$s |
| 485 | </div> |
| 486 | </div> |
| 487 | </div> |
| 488 | <div class="wp-story-wrapper"> |
| 489 | %9$s |
| 490 | </div> |
| 491 | <div class="wp-story-overlay"> |
| 492 | %10$s |
| 493 | </div> |
| 494 | %11$s |
| 495 | </a> |
| 496 | </div> |
| 497 | </div> |
| 498 | </div>', |
| 499 | esc_attr( Blocks::classes( Blocks::get_block_feature( __DIR__ ), $attributes, array( 'wp-story', 'aligncenter' ) ) ), |
| 500 | esc_attr( 'wp-story-' . get_the_ID() . '-' . strval( ++$story_block_counter ) ), |
| 501 | filter_var( wp_json_encode( $settings ), FILTER_SANITIZE_SPECIAL_CHARS ), |
| 502 | get_permalink() . '?wp-story-load-in-fullscreen=true&wp-story-play-on-load=true', |
| 503 | __( 'Play story in new tab', 'jetpack' ), |
| 504 | __( 'Site icon', 'jetpack' ), |
| 505 | esc_attr( get_blavatar_or_site_icon_url( 80, includes_url( 'images/w-logo-blue.png' ) ) ), |
| 506 | esc_html( $story_title ), |
| 507 | render_static_slide( $media_files ), |
| 508 | render_top_right_icon( $settings ), |
| 509 | render_pagination( $settings ) |
| 510 | ); |
| 511 | } |
| 512 |