@wordpress/block-library 9.27.0 → 9.28.0

package/src/post-date/index.php

@@ -9,6 +9,7 @@
  * Renders the `core/post-date` block on the server.
  *
  * @since 5.8.0
+ * @since 6.9.0 Added `datetime` attribute and Block Bindings support.
  *
  * @param array    $attributes Block attributes.
  * @param string   $content    Block default content.
@@ -16,14 +17,57 @@
  * @return string Returns the filtered post date for the current post wrapped inside "time" tags.
  */
 function render_block_core_post_date( $attributes, $content, $block ) {
-	if ( ! isset( $block->context['postId'] ) ) {
-		return '';
+	$classes = array();
+
+	if (
+		isset( $attributes['metadata']['bindings']['datetime']['source'] ) &&
+		isset( $attributes['metadata']['bindings']['datetime']['args'] )
+	) {
+		/*
+		 * We might be running on a version of WordPress that doesn't support binding the block's `datetime` attribute
+		 * to a Block Bindings source. In this case, we need to manually set the `datetime` attribute to its correct value.
+		 * This branch can be removed once the minimum required WordPress version is 6.9 or newer.
+		 */
+		$source      = get_block_bindings_source( $attributes['metadata']['bindings']['datetime']['source'] );
+		$source_args = $attributes['metadata']['bindings']['datetime']['args'];
+
+		$attributes['datetime'] = $source->get_value( $source_args, $block, 'datetime' );
+	} elseif ( ! isset( $attributes['datetime'] ) ) {
+		/*
+		 * This is the legacy version of the block that didn't have the `datetime` attribute.
+		 * This branch needs to be kept for backward compatibility.
+		 */
+		$source = get_block_bindings_source( 'core/post-data' );
+		if ( isset( $attributes['displayType'] ) && 'modified' === $attributes['displayType'] ) {
+			$source_args = array(
+				'key' => 'modified',
+			);
+		} else {
+			$source_args = array(
+				'key' => 'date',
+			);
+		}
+		$attributes['datetime'] = $source->get_value( $source_args, $block, 'datetime' );
+	}
+
+	if ( isset( $source_args['key'] ) && 'modified' === $source_args['key'] ) {
+		$classes[] = 'wp-block-post-date__modified-date';
 	}
 
-	$post_ID = $block->context['postId'];
+	if ( empty( $attributes['datetime'] ) ) {
+		// If the `datetime` attribute is set but empty, it could be because Block Bindings
+		// set it that way. This can happen e.g. if the block is bound to the
+		// post's last modified date, and the latter lies before the publish date.
+		// (See https://github.com/WordPress/gutenberg/pull/46839 where this logic was originally
+		// implemented.)
+		// In this case, we have to respect and return the empty value.
+		return $attributes['datetime'];
+	}
+
+	$unformatted_date = $attributes['datetime'];
+	$post_timestamp   = strtotime( $unformatted_date );
 
 	if ( isset( $attributes['format'] ) && 'human-diff' === $attributes['format'] ) {
-		$post_timestamp = get_post_timestamp( $post_ID );
 		if ( $post_timestamp > time() ) {
 			// translators: %s: human-readable time difference.
 			$formatted_date = sprintf( __( '%s from now' ), human_time_diff( $post_timestamp ) );
@@ -32,10 +76,8 @@ function render_block_core_post_date( $attributes, $content, $block ) {
 			$formatted_date = sprintf( __( '%s ago' ), human_time_diff( $post_timestamp ) );
 		}
 	} else {
-		$formatted_date = get_the_date( empty( $attributes['format'] ) ? '' : $attributes['format'], $post_ID );
+		$formatted_date = gmdate( empty( $attributes['format'] ) ? get_option( 'date_format' ) : $attributes['format'], $post_timestamp );
 	}
-	$unformatted_date = esc_attr( get_the_date( 'c', $post_ID ) );
-	$classes          = array();
 
 	if ( isset( $attributes['textAlign'] ) ) {
 		$classes[] = 'has-text-align-' . $attributes['textAlign'];
@@ -44,29 +86,10 @@ function render_block_core_post_date( $attributes, $content, $block ) {
 		$classes[] = 'has-link-color';
 	}
 
-	/*
-	 * If the "Display last modified date" setting is enabled,
-	 * only display the modified date if it is later than the publishing date.
-	 */
-	if ( isset( $attributes['displayType'] ) && 'modified' === $attributes['displayType'] ) {
-		if ( get_the_modified_date( 'Ymdhi', $post_ID ) > get_the_date( 'Ymdhi', $post_ID ) ) {
-			if ( isset( $attributes['format'] ) && 'human-diff' === $attributes['format'] ) {
-				// translators: %s: human-readable time difference.
-				$formatted_date = sprintf( __( '%s ago' ), human_time_diff( get_post_timestamp( $post_ID, 'modified' ) ) );
-			} else {
-				$formatted_date = get_the_modified_date( empty( $attributes['format'] ) ? '' : $attributes['format'], $post_ID );
-			}
-			$unformatted_date = esc_attr( get_the_modified_date( 'c', $post_ID ) );
-			$classes[]        = 'wp-block-post-date__modified-date';
-		} else {
-			return '';
-		}
-	}
-
 	$wrapper_attributes = get_block_wrapper_attributes( array( 'class' => implode( ' ', $classes ) ) );
 
-	if ( isset( $attributes['isLink'] ) && $attributes['isLink'] ) {
-		$formatted_date = sprintf( '<a href="%1s">%2s</a>', get_the_permalink( $post_ID ), $formatted_date );
+	if ( isset( $attributes['isLink'] ) && $attributes['isLink'] && isset( $block->context['postId'] ) ) {
+		$formatted_date = sprintf( '<a href="%1s">%2s</a>', get_the_permalink( $block->context['postId'] ), $formatted_date );
 	}
 
 	return sprintf(

package/src/post-date/variations.js

@@ -5,14 +5,48 @@ import { __ } from '@wordpress/i18n';
 import { postDate } from '@wordpress/icons';
 
 const variations = [
+	{
+		name: 'post-date',
+		title: __( 'Post Date' ),
+		description: __( "Display a post's publish date." ),
+		attributes: {
+			metadata: {
+				bindings: {
+					datetime: {
+						source: 'core/post-data',
+						args: { key: 'date' },
+					},
+				},
+			},
+		},
+		scope: [ 'block', 'inserter', 'transform' ],
+		isActive: ( blockAttributes ) =>
+			blockAttributes?.metadata?.bindings?.datetime?.source ===
+				'core/post-data' &&
+			blockAttributes?.metadata?.bindings?.datetime?.args?.key === 'date',
+		icon: postDate,
+	},
 	{
 		name: 'post-date-modified',
 		title: __( 'Modified Date' ),
 		description: __( "Display a post's last updated date." ),
-		attributes: { displayType: 'modified' },
-		scope: [ 'block', 'inserter' ],
+		attributes: {
+			metadata: {
+				bindings: {
+					datetime: {
+						source: 'core/post-data',
+						args: { key: 'modified' },
+					},
+				},
+			},
+			className: 'wp-block-post-date__modified-date',
+		},
+		scope: [ 'block', 'inserter', 'transform' ],
 		isActive: ( blockAttributes ) =>
-			blockAttributes.displayType === 'modified',
+			blockAttributes?.metadata?.bindings?.datetime?.source ===
+				'core/post-data' &&
+			blockAttributes?.metadata?.bindings?.datetime?.args?.key ===
+				'modified',
 		icon: postDate,
 	},
 ];

package/src/post-featured-image/edit.js

@@ -133,12 +133,12 @@ export default function PostFeaturedImageEdit( {
 
 	const { media, postType, postPermalink } = useSelect(
 		( select ) => {
-			const { getMedia, getPostType, getEditedEntityRecord } =
+			const { getEntityRecord, getPostType, getEditedEntityRecord } =
 				select( coreStore );
 			return {
 				media:
 					featuredImage &&
-					getMedia( featuredImage, {
+					getEntityRecord( 'postType', 'attachment', featuredImage, {
 						context: 'view',
 					} ),
 				postType: postTypeSlug && getPostType( postTypeSlug ),

package/src/site-logo/edit.js

@@ -454,12 +454,19 @@ export default function LogoEdit( {
 		const _siteIconId = siteSettings?.site_icon;
 		const mediaItem =
 			_siteLogoId &&
-			select( coreStore ).getMedia( _siteLogoId, {
-				context: 'view',
-			} );
+			select( coreStore ).getEntityRecord(
+				'postType',
+				'attachment',
+				_siteLogoId,
+				{
+					context: 'view',
+				}
+			);
 		const _isRequestingMediaItem =
 			!! _siteLogoId &&
-			! select( coreStore ).hasFinishedResolution( 'getMedia', [
+			! select( coreStore ).hasFinishedResolution( 'getEntityRecord', [
+				'postType',
+				'attachment',
 				_siteLogoId,
 				{ context: 'view' },
 			] );

package/src/social-link/README.md

@@ -0,0 +1,21 @@
+# Social Icon block
+
+The Social Icon is a foundational block that displays various icons linking to different social profiles or sites. Each social service is registered as a variation of this block.
+
+
+## Adding new social icons
+
+The core maintains certain standards for adding new social icons. To add a new variation to WordPress, it must be well-established and popular.
+
+To evaluate if a social service should be added, contributors will consider the following factors:
+
+* Is the service popular enough for core developers to have heard of it before? Is it "mainstream?"
+* How long has the service been online?
+* Does it have a Wikipedia article?
+* Is there a plugin adding social icons in the repository that includes the services in question and has a considerable number of active installations?
+* Is this social service frequently requested?
+
+
+## Adding custom social icons
+
+Starting from WordPress 6.9, it's possible to add custom social icons to your site. See: [#70261](https://github.com/WordPress/gutenberg/pull/70261).

package/src/social-link/icons/tiktok.js

@@ -4,7 +4,7 @@
 import { Path, SVG } from '@wordpress/primitives';
 
 export const TiktokIcon = () => (
-	<SVG width="24" height="24" viewBox="0 0 32 32" version="1.1">
-		<Path d="M16.708 0.027c1.745-0.027 3.48-0.011 5.213-0.027 0.105 2.041 0.839 4.12 2.333 5.563 1.491 1.479 3.6 2.156 5.652 2.385v5.369c-1.923-0.063-3.855-0.463-5.6-1.291-0.76-0.344-1.468-0.787-2.161-1.24-0.009 3.896 0.016 7.787-0.025 11.667-0.104 1.864-0.719 3.719-1.803 5.255-1.744 2.557-4.771 4.224-7.88 4.276-1.907 0.109-3.812-0.411-5.437-1.369-2.693-1.588-4.588-4.495-4.864-7.615-0.032-0.667-0.043-1.333-0.016-1.984 0.24-2.537 1.495-4.964 3.443-6.615 2.208-1.923 5.301-2.839 8.197-2.297 0.027 1.975-0.052 3.948-0.052 5.923-1.323-0.428-2.869-0.308-4.025 0.495-0.844 0.547-1.485 1.385-1.819 2.333-0.276 0.676-0.197 1.427-0.181 2.145 0.317 2.188 2.421 4.027 4.667 3.828 1.489-0.016 2.916-0.88 3.692-2.145 0.251-0.443 0.532-0.896 0.547-1.417 0.131-2.385 0.079-4.76 0.095-7.145 0.011-5.375-0.016-10.735 0.025-16.093z" />
+	<SVG width="24" height="24" viewBox="0 0 24 24" version="1.1">
+		<Path d="M12.4044 3.01519C13.4086 3 14.4072 3.009 15.4045 3C15.465 4.14812 15.8874 5.31762 16.7472 6.12935C17.6053 6.96134 18.819 7.34217 20 7.47099V10.4912C18.8933 10.4558 17.7814 10.2308 16.7771 9.76499C16.3397 9.57148 15.9323 9.32227 15.5334 9.06745C15.5283 11.2591 15.5426 13.4479 15.5191 15.6305C15.4592 16.679 15.1053 17.7225 14.4814 18.5866C13.4777 20.025 11.7356 20.9627 9.94635 20.992C8.84885 21.0533 7.7525 20.7608 6.81729 20.2219C5.26743 19.3286 4.17683 17.6933 4.01799 15.9382C3.99957 15.563 3.99324 15.1883 4.00878 14.8221C4.14691 13.395 4.86917 12.0297 5.99027 11.101C7.26101 10.0192 9.04107 9.50397 10.7078 9.80886C10.7233 10.9199 10.6778 12.0297 10.6778 13.1407C9.91643 12.9 9.02668 12.9675 8.36139 13.4192C7.87566 13.7269 7.50675 14.1983 7.31453 14.7316C7.15569 15.1118 7.20116 15.5343 7.21036 15.9382C7.3928 17.169 8.60368 18.2035 9.89628 18.0916C10.7532 18.0826 11.5745 17.5965 12.0211 16.8849C12.1655 16.6357 12.3273 16.3809 12.3359 16.0878C12.4113 14.7462 12.3814 13.4102 12.3906 12.0685C12.3969 9.04495 12.3814 6.02979 12.4049 3.01575L12.4044 3.01519Z" />
 	</SVG>
 );