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