wpseek.com
A WordPress-centric search engine for devs and theme authors



render_block_core_post_date › WordPress Function

Since5.8.0
Deprecatedn/a
render_block_core_post_date ( $attributes, $content, $block )
Parameters: (3)
  • (array) $attributes Block attributes.
    Required: Yes
  • (string) $content Block default content.
    Required: Yes
  • (WP_Block) $block Block instance.
    Required: Yes
Returns:
  • (string) Returns the filtered post date for the current post wrapped inside "time" tags.
Defined at:
Codex:
Change Log:
  • 6.9.0

Renders the `core/post-date` block on the server.



Source

function render_block_core_post_date( $attributes, $content, $block ) {
	$classes = array();

	if (
		! isset( $attributes['datetime'] ) && ! (
			isset( $attributes['metadata']['bindings']['datetime']['source'] ) &&
			isset( $attributes['metadata']['bindings']['datetime']['args'] )
		)
	) {
		/*
		 * 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(
				'field' => 'modified',
			);
		} else {
			$source_args = array(
				'field' => 'date',
			);
		}
		$attributes['datetime'] = $source->get_value( $source_args, $block, 'datetime' );
	}

	if ( isset( $source_args['field'] ) && 'modified' === $source_args['field'] ) {
		$classes[] = 'wp-block-post-date__modified-date';
	}

	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 '';
	}

	$unformatted_date = $attributes['datetime'];
	$post_timestamp   = strtotime( $unformatted_date );

	if ( isset( $attributes['format'] ) && 'human-diff' === $attributes['format'] ) {
		if ( $post_timestamp > time() ) {
			// translators: %s: human-readable time difference.
			$formatted_date = sprintf( __( '%s from now' ), human_time_diff( $post_timestamp ) );
		} else {
			// translators: %s: human-readable time difference.
			$formatted_date = sprintf( __( '%s ago' ), human_time_diff( $post_timestamp ) );
		}
	} else {
		$format         = empty( $attributes['format'] ) ? get_option( 'date_format' ) : $attributes['format'];
		$formatted_date = wp_date( $format, $post_timestamp );
	}

	if ( isset( $attributes['textAlign'] ) ) {
		$classes[] = 'has-text-align-' . $attributes['textAlign'];
	}
	if ( isset( $attributes['style']['elements']['link']['color']['text'] ) ) {
		$classes[] = 'has-link-color';
	}

	$wrapper_attributes = get_block_wrapper_attributes( array( 'class' => implode( ' ', $classes ) ) );

	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(
		'<div %1$s><time datetime="%2$s">%3$s</time></div>',
		$wrapper_attributes,
		$unformatted_date,
		$formatted_date
	);
}