@wordpress/block-library 9.33.2 → 9.34.0

package/src/breadcrumbs/index.php

@@ -17,25 +17,14 @@
  * @return string Returns the post breadcrumb for hierarchical post types.
  */
 function render_block_core_breadcrumbs( $attributes, $content, $block ) {
-	// Exclude breadcrumbs from special contexts like archives, search, 404, etc.
+	// Exclude breadcrumbs from special contexts like search, 404, etc.
 	// until they are explicitly supported.
-	if ( is_archive() || is_search() || is_404() || is_home() || is_front_page() ) {
-		return '';
-	}
-	if ( ! isset( $block->context['postId'] ) || ! isset( $block->context['postType'] ) ) {
+	if ( is_search() || is_404() || is_home() || is_front_page() ) {
 		return '';
 	}
 
-	$post_id   = $block->context['postId'];
-	$post_type = $block->context['postType'];
-
-	$post = get_post( $post_id );
-	if ( ! $post ) {
-		return '';
-	}
-
-	$type             = $attributes['type'];
 	$breadcrumb_items = array();
+
 	if ( $attributes['showHomeLink'] ) {
 		$breadcrumb_items[] = sprintf(
 			'<a href="%s">%s</a>',
@@ -43,16 +32,52 @@ function render_block_core_breadcrumbs( $attributes, $content, $block ) {
 			esc_html__( 'Home' )
 		);
 	}
-	$supported_types = array( 'postWithAncestors', 'postWithTerms' );
-	// If `type` is not set to a specific breadcrumb type, determine it based on the block's default heuristics.
-	$breadcrumbs_type = in_array( $type, $supported_types, true ) ? $type : block_core_breadcrumbs_get_breadcrumbs_type( $post_type );
-	if ( 'postWithAncestors' === $breadcrumbs_type ) {
-		$breadcrumb_items = array_merge( $breadcrumb_items, block_core_breadcrumbs_get_hierarchical_post_type_breadcrumbs( $post_id ) );
+
+	// Handle archive pages (taxonomy, post type, date, author archives).
+	if ( is_archive() ) {
+		$archive_breadcrumbs = block_core_breadcrumbs_get_archive_breadcrumbs();
+		if ( ! empty( $archive_breadcrumbs ) ) {
+			$breadcrumb_items = array_merge( $breadcrumb_items, $archive_breadcrumbs );
+		}
 	} else {
-		$breadcrumb_items = array_merge( $breadcrumb_items, block_core_breadcrumbs_get_terms_breadcrumbs( $post_id, $post_type ) );
+		// Handle single post/page breadcrumbs.
+		if ( ! isset( $block->context['postId'] ) || ! isset( $block->context['postType'] ) ) {
+			return '';
+		}
+
+		$post_id   = $block->context['postId'];
+		$post_type = $block->context['postType'];
+
+		$post = get_post( $post_id );
+		if ( ! $post ) {
+			return '';
+		}
+
+		// Determine breadcrumb type for accurate rendering (matching JavaScript logic).
+		$show_terms = false;
+		if ( ! is_post_type_hierarchical( $post_type ) ) {
+			$show_terms = true;
+		} elseif ( empty( get_object_taxonomies( $post_type, 'objects' ) ) ) {
+			// Hierarchical post type without taxonomies can only use ancestors.
+			$show_terms = false;
+		} else {
+			// For hierarchical post types with taxonomies, use the attribute.
+			$show_terms = $attributes['prefersTaxonomy'];
+		}
+
+		if ( ! $show_terms ) {
+			$breadcrumb_items = array_merge( $breadcrumb_items, block_core_breadcrumbs_get_hierarchical_post_type_breadcrumbs( $post_id ) );
+		} else {
+			$breadcrumb_items = array_merge( $breadcrumb_items, block_core_breadcrumbs_get_terms_breadcrumbs( $post_id, $post_type ) );
+		}
+		// Add current post title (not linked).
+		$breadcrumb_items[] = sprintf( '<span aria-current="page">%s</span>', get_the_title( $post ) );
+	}
+
+	if ( empty( $breadcrumb_items ) ) {
+		return '';
 	}
-	// Add current post title (not linked).
-	$breadcrumb_items[] = sprintf( '<span aria-current="page">%s</span>', get_the_title( $post ) );
+
 	$wrapper_attributes = get_block_wrapper_attributes(
 		array(
 			'style'      => '--separator: "' . addcslashes( $attributes['separator'], '\\"' ) . '";',
@@ -77,19 +102,6 @@ function render_block_core_breadcrumbs( $attributes, $content, $block ) {
 	return $breadcrumb_html;
 }
 
-/**
- * Determines the breadcrumb type based on the block's default heuristics.
- *
- * @since 6.9.0
- *
- * @param string $post_type The post type name.
- *
- * @return string The breadcrumb type.
- */
-function block_core_breadcrumbs_get_breadcrumbs_type( $post_type ) {
-	return is_post_type_hierarchical( $post_type ) ? 'postWithAncestors' : 'postWithTerms';
-}
-
 /**
  * Generates breadcrumb items from hierarchical post type ancestors.
  *
@@ -114,6 +126,157 @@ function block_core_breadcrumbs_get_hierarchical_post_type_breadcrumbs( $post_id
 	return $breadcrumb_items;
 }
 
+/**
+ * Generates breadcrumb items for hierarchical term ancestors.
+ *
+ * For hierarchical taxonomies, retrieves and formats ancestor terms as breadcrumb links.
+ *
+ * @since 6.9.0
+ *
+ * @param int    $term_id  The term ID.
+ * @param string $taxonomy The taxonomy name.
+ *
+ * @return array Array of breadcrumb HTML items for ancestors.
+ */
+function block_core_breadcrumbs_get_term_ancestors_items( $term_id, $taxonomy ) {
+	$breadcrumb_items = array();
+
+	// Check if taxonomy is hierarchical and add ancestor term links.
+	if ( is_taxonomy_hierarchical( $taxonomy ) ) {
+		$term_ancestors = get_ancestors( $term_id, $taxonomy, 'taxonomy' );
+		$term_ancestors = array_reverse( $term_ancestors );
+		foreach ( $term_ancestors as $ancestor_id ) {
+			$ancestor_term = get_term( $ancestor_id, $taxonomy );
+			if ( $ancestor_term && ! is_wp_error( $ancestor_term ) ) {
+				$breadcrumb_items[] = sprintf(
+					'<a href="%s">%s</a>',
+					esc_url( get_term_link( $ancestor_term ) ),
+					esc_html( $ancestor_term->name )
+				);
+			}
+		}
+	}
+
+	return $breadcrumb_items;
+}
+
+/**
+ * Generates breadcrumb items for archive pages.
+ *
+ * Handles taxonomy archives, post type archives, date archives, and author archives.
+ * For hierarchical taxonomies, includes ancestor terms in the breadcrumb trail.
+ *
+ * @since 6.9.0
+ *
+ * @return array Array of breadcrumb HTML items.
+ */
+function block_core_breadcrumbs_get_archive_breadcrumbs() {
+	$breadcrumb_items = array();
+
+	// Date archive (check first since it doesn't have a queried object).
+	if ( is_date() ) {
+		$year  = get_query_var( 'year' );
+		$month = get_query_var( 'monthnum' );
+		$day   = get_query_var( 'day' );
+
+		// Fallback to 'm' query var for plain permalinks.
+		// Plain permalinks use ?m=YYYYMMDD format instead of separate query vars.
+		if ( ! $year ) {
+			$m = get_query_var( 'm' );
+			if ( $m ) {
+				$year  = substr( $m, 0, 4 );
+				$month = substr( $m, 4, 2 );
+				$day   = (int) substr( $m, 6, 2 );
+			}
+		}
+
+		if ( $year ) {
+			if ( $month ) {
+				// Year is linked if we have month.
+				$breadcrumb_items[] = sprintf(
+					'<a href="%s">%s</a>',
+					esc_url( get_year_link( $year ) ),
+					esc_html( $year )
+				);
+
+				if ( $day ) {
+					// Month is linked if we have day.
+					$breadcrumb_items[] = sprintf(
+						'<a href="%s">%s</a>',
+						esc_url( get_month_link( $year, $month ) ),
+						esc_html( date_i18n( 'F', mktime( 0, 0, 0, $month, 1, $year ) ) )
+					);
+					// Current day.
+					$breadcrumb_items[] = sprintf(
+						'<span aria-current="page">%s</span>',
+						esc_html( $day )
+					);
+				} else {
+					// Current month.
+					$breadcrumb_items[] = sprintf(
+						'<span aria-current="page">%s</span>',
+						esc_html( date_i18n( 'F', mktime( 0, 0, 0, $month, 1, $year ) ) )
+					);
+				}
+			} else {
+				// Current year only.
+				$breadcrumb_items[] = sprintf(
+					'<span aria-current="page">%s</span>',
+					esc_html( $year )
+				);
+			}
+		}
+
+		return $breadcrumb_items;
+	}
+
+	// For other archive types, we need a queried object.
+	$queried_object = get_queried_object();
+
+	if ( ! $queried_object ) {
+		return array();
+	}
+
+	// Taxonomy archive (category, tag, custom taxonomy).
+	if ( $queried_object instanceof WP_Term ) {
+		$term     = $queried_object;
+		$taxonomy = $term->taxonomy;
+
+		// Add hierarchical term ancestors if applicable.
+		$breadcrumb_items = array_merge(
+			$breadcrumb_items,
+			block_core_breadcrumbs_get_term_ancestors_items( $term->term_id, $taxonomy )
+		);
+
+		// Add current term.
+		$breadcrumb_items[] = sprintf(
+			'<span aria-current="page">%s</span>',
+			esc_html( $term->name )
+		);
+	} elseif ( is_post_type_archive() ) {
+		// Post type archive.
+		$post_type = get_query_var( 'post_type' );
+		if ( is_array( $post_type ) ) {
+			$post_type = reset( $post_type );
+		}
+		$post_type_object = get_post_type_object( $post_type );
+		if ( $post_type_object ) {
+			$breadcrumb_items[] = sprintf(
+				'<span aria-current="page">%s</span>',
+				esc_html( $post_type_object->labels->name )
+			);
+		}
+	} elseif ( is_author() ) {
+		// Author archive.
+		$author             = $queried_object;
+		$breadcrumb_items[] = sprintf(
+			'<span aria-current="page">%s</span>',
+			esc_html( $author->display_name )
+		);
+	}
+
+	return $breadcrumb_items;
+}
 
 /**
  * Generates breadcrumb items from taxonomy terms.
@@ -158,21 +321,11 @@ function block_core_breadcrumbs_get_terms_breadcrumbs( $post_id, $post_type ) {
 	if ( ! empty( $terms ) ) {
 		// Use the first term (if multiple are assigned).
 		$term = reset( $terms );
-		// Check if taxonomy is hierarchical also add ancestor term links
-		if ( is_taxonomy_hierarchical( $taxonomy_name ) ) {
-			$term_ancestors = get_ancestors( $term->term_id, $taxonomy_name, 'taxonomy' );
-			$term_ancestors = array_reverse( $term_ancestors );
-			foreach ( $term_ancestors as $ancestor_id ) {
-				$ancestor_term = get_term( $ancestor_id, $taxonomy_name );
-				if ( $ancestor_term && ! is_wp_error( $ancestor_term ) ) {
-					$breadcrumb_items[] = sprintf(
-						'<a href="%s">%s</a>',
-						esc_url( get_term_link( $ancestor_term ) ),
-						esc_html( $ancestor_term->name )
-					);
-				}
-			}
-		}
+		// Add hierarchical term ancestors if applicable.
+		$breadcrumb_items   = array_merge(
+			$breadcrumb_items,
+			block_core_breadcrumbs_get_term_ancestors_items( $term->term_id, $taxonomy_name )
+		);
 		$breadcrumb_items[] = sprintf(
 			'<a href="%s">%s</a>',
 			esc_url( get_term_link( $term ) ),

package/src/categories/edit.js

@@ -189,12 +189,16 @@ export default function CategoriesEdit( {
 			? 'ul'
 			: 'div';
 
-	const classes = clsx( className, {
-		'wp-block-categories-list':
-			!! categories?.length && ! displayAsDropdown && ! isResolving,
-		'wp-block-categories-dropdown':
-			!! categories?.length && displayAsDropdown && ! isResolving,
-	} );
+	const classes = clsx(
+		className,
+		`wp-block-categories-taxonomy-${ taxonomySlug }`,
+		{
+			'wp-block-categories-list':
+				!! categories?.length && ! displayAsDropdown && ! isResolving,
+			'wp-block-categories-dropdown':
+				!! categories?.length && displayAsDropdown && ! isResolving,
+		}
+	);
 
 	const blockProps = useBlockProps( {
 		className: classes,

package/src/categories/index.php

@@ -79,7 +79,7 @@ function render_block_core_categories( $attributes, $content, $block ) {
 		}
 	}
 
-	$wrapper_attributes = get_block_wrapper_attributes( array( 'class' => "wp-block-categories-{$type}" ) );
+	$wrapper_attributes = get_block_wrapper_attributes( array( 'class' => "wp-block-categories-{$type} wp-block-categories-taxonomy-{$attributes['taxonomy']}" ) );
 
 	return sprintf(
 		$wrapper_markup,

package/src/latest-comments/block.json

@@ -22,9 +22,10 @@
 			"type": "boolean",
 			"default": true
 		},
-		"displayExcerpt": {
-			"type": "boolean",
-			"default": true
+		"displayContent": {
+			"type": "string",
+			"default": "excerpt",
+			"enum": [ "none", "excerpt", "full" ]
 		}
 	},
 	"supports": {

package/src/latest-comments/deprecated.js

@@ -0,0 +1,37 @@
+/**
+ * WordPress dependencies
+ */
+
+const v1 = {
+	attributes: {
+		commentsToShow: {
+			type: 'number',
+			default: 5,
+			minimum: 1,
+			maximum: 100,
+		},
+		displayAvatar: {
+			type: 'boolean',
+			default: true,
+		},
+		displayDate: {
+			type: 'boolean',
+			default: true,
+		},
+		displayExcerpt: {
+			type: 'boolean',
+			default: true,
+		},
+	},
+	isEligible( attributes ) {
+		return attributes?.displayExcerpt === false;
+	},
+	migrate( attributes ) {
+		return {
+			...attributes,
+			displayContent: attributes.displayExcerpt ? 'excerpt' : 'none',
+		};
+	},
+};
+
+export default [ v1 ];

package/src/latest-comments/edit.js

@@ -5,6 +5,7 @@ import { InspectorControls, useBlockProps } from '@wordpress/block-editor';
 import {
 	Disabled,
 	RangeControl,
+	SelectControl,
 	ToggleControl,
 	__experimentalToolsPanel as ToolsPanel,
 	__experimentalToolsPanelItem as ToolsPanelItem,
@@ -31,7 +32,7 @@ const MIN_COMMENTS = 1;
 const MAX_COMMENTS = 100;
 
 export default function LatestComments( { attributes, setAttributes } ) {
-	const { commentsToShow, displayAvatar, displayDate, displayExcerpt } =
+	const { commentsToShow, displayAvatar, displayDate, displayContent } =
 		attributes;
 
 	const serverSideAttributes = {
@@ -54,7 +55,7 @@ export default function LatestComments( { attributes, setAttributes } ) {
 							commentsToShow: 5,
 							displayAvatar: true,
 							displayDate: true,
-							displayExcerpt: true,
+							displayContent: 'excerpt',
 						} );
 					} }
 					dropdownMenuProps={ dropdownMenuProps }
@@ -98,20 +99,26 @@ export default function LatestComments( { attributes, setAttributes } ) {
 					</ToolsPanelItem>
 
 					<ToolsPanelItem
-						hasValue={ () => ! displayExcerpt }
-						label={ __( 'Display excerpt' ) }
+						hasValue={ () => displayContent !== 'excerpt' }
+						label={ __( 'Display content' ) }
 						onDeselect={ () =>
-							setAttributes( { displayExcerpt: true } )
+							setAttributes( { displayContent: 'excerpt' } )
 						}
 						isShownByDefault
 					>
-						<ToggleControl
+						<SelectControl
 							__nextHasNoMarginBottom
-							label={ __( 'Display excerpt' ) }
-							checked={ displayExcerpt }
-							onChange={ () =>
+							__next40pxDefaultSize
+							label={ __( 'Display content' ) }
+							value={ displayContent }
+							options={ [
+								{ label: __( 'No content' ), value: 'none' },
+								{ label: __( 'Excerpt' ), value: 'excerpt' },
+								{ label: __( 'Full content' ), value: 'full' },
+							] }
+							onChange={ ( value ) =>
 								setAttributes( {
-									displayExcerpt: ! displayExcerpt,
+									displayContent: value,
 								} )
 							}
 						/>

package/src/latest-comments/index.js

@@ -9,6 +9,7 @@ import { comment as icon } from '@wordpress/icons';
 import initBlock from '../utils/init-block';
 import metadata from './block.json';
 import edit from './edit';
+import deprecated from './deprecated';
 
 const { name } = metadata;
 
@@ -18,6 +19,7 @@ export const settings = {
 	icon,
 	example: {},
 	edit,
+	deprecated,
 };
 
 export const init = () => initBlock( { name, metadata, settings } );

package/src/latest-comments/index.php

@@ -43,6 +43,13 @@ function wp_latest_comments_draft_or_post_title( $post = 0 ) {
  * @return string Returns the post content with latest comments added.
  */
 function render_block_core_latest_comments( $attributes ) {
+	// Handle backward compatibility: check for old displayExcerpt attribute
+	if ( isset( $attributes['displayExcerpt'] ) ) {
+		$display_content = $attributes['displayExcerpt'] ? 'excerpt' : 'none';
+	} else {
+		$display_content = isset( $attributes['displayContent'] ) ? $attributes['displayContent'] : 'excerpt';
+	}
+
 	$comments = get_comments(
 		/** This filter is documented in wp-includes/widgets/class-wp-widget-recent-comments.php */
 		apply_filters(
@@ -112,7 +119,9 @@ function render_block_core_latest_comments( $attributes ) {
 				);
 			}
 			$list_items_markup .= '</footer>';
-			if ( $attributes['displayExcerpt'] ) {
+			if ( 'full' === $display_content ) {
+				$list_items_markup .= '<div class="wp-block-latest-comments__comment-excerpt">' . wpautop( get_comment_text( $comment ) ) . '</div>';
+			} elseif ( 'excerpt' === $display_content ) {
 				$list_items_markup .= '<div class="wp-block-latest-comments__comment-excerpt">' . wpautop( get_comment_excerpt( $comment ) ) . '</div>';
 			}
 			$list_items_markup .= '</article></li>';
@@ -126,7 +135,7 @@ function render_block_core_latest_comments( $attributes ) {
 	if ( $attributes['displayDate'] ) {
 		$classnames[] = 'has-dates';
 	}
-	if ( $attributes['displayExcerpt'] ) {
+	if ( 'none' !== $display_content ) {
 		$classnames[] = 'has-excerpts';
 	}
 	if ( empty( $comments ) ) {

package/src/math/deprecated.js

@@ -0,0 +1,44 @@
+/**
+ * WordPress dependencies
+ */
+import { useBlockProps } from '@wordpress/block-editor';
+
+// v1: Add a wrapper div around the math element.
+const v1 = {
+	attributes: {
+		latex: {
+			type: 'string',
+			role: 'content',
+		},
+		mathML: {
+			type: 'string',
+			source: 'html',
+			selector: 'math',
+		},
+	},
+	save( { attributes } ) {
+		const { latex, mathML } = attributes;
+
+		if ( ! latex ) {
+			return null;
+		}
+
+		return (
+			<math
+				{ ...useBlockProps.save() }
+				display="block"
+				dangerouslySetInnerHTML={ { __html: mathML } }
+			/>
+		);
+	},
+};
+
+/**
+ * New deprecations need to be placed first
+ * for them to have higher priority.
+ *
+ * Old deprecations may need to be updated as well.
+ *
+ * See block-deprecation.md
+ */
+export default [ v1 ];

package/src/math/index.js

@@ -10,6 +10,7 @@ import initBlock from '../utils/init-block';
 import edit from './edit';
 import metadata from './block.json';
 import save from './save';
+import deprecated from './deprecated';
 
 const { name } = metadata;
 
@@ -26,6 +27,7 @@ export const settings = {
 	},
 	edit,
 	save,
+	deprecated,
 };
 
 export const init = () => initBlock( { name, metadata, settings } );

package/src/math/save.js

@@ -11,10 +11,11 @@ export default function save( { attributes } ) {
 	}
 
 	return (
-		<math
-			{ ...useBlockProps.save() }
-			display="block"
-			dangerouslySetInnerHTML={ { __html: mathML } }
-		/>
+		<div { ...useBlockProps.save() }>
+			<math
+				display="block"
+				dangerouslySetInnerHTML={ { __html: mathML } }
+			/>
+		</div>
 	);
 }

package/src/math/style.scss

@@ -0,0 +1,4 @@
+.wp-block-math {
+	overflow-x: auto;
+	overflow-y: hidden;
+}

package/src/navigation/edit/menu-inspector-controls.js

@@ -124,7 +124,7 @@ function AdditionalBlockContent( { block, insertedBlock, setInsertedBlock } ) {
 				if ( isEntityLink ) {
 					createBinding( updatedAttributes );
 				} else {
-					clearBinding( updatedAttributes );
+					clearBinding();
 				}
 
 				setInsertedBlock( null );

package/src/navigation-link/edit.js

@@ -558,7 +558,7 @@ export default function NavigationLinkEdit( {
 								if ( isEntityLink ) {
 									createBinding( updatedAttributes );
 								} else {
-									clearBinding( updatedAttributes );
+									clearBinding();
 								}
 							} }
 						/>

package/src/navigation-link/editor.scss

@@ -110,7 +110,7 @@
 .link-control-transform__subheading {
 	font-size: 11px;
 	text-transform: uppercase;
-	font-weight: 500;
+	font-weight: $font-weight-medium;
 	color: $gray-900;
 	margin-bottom: 1.5em;
 }

package/src/navigation-link/link-ui/page-creator.js

@@ -9,9 +9,10 @@ import {
 	__experimentalVStack as VStack,
 	__experimentalHStack as HStack,
 } from '@wordpress/components';
-import { __ } from '@wordpress/i18n';
+import { __, sprintf } from '@wordpress/i18n';
 import { useSelect, useDispatch } from '@wordpress/data';
 import { store as coreStore } from '@wordpress/core-data';
+import { store as noticesStore } from '@wordpress/notices';
 import { decodeEntities } from '@wordpress/html-entities';
 import { useState } from '@wordpress/element';
 
@@ -57,6 +58,8 @@ export function LinkUIPageCreator( {
 	);
 
 	const { saveEntityRecord } = useDispatch( coreStore );
+	const { createSuccessNotice, createErrorNotice } =
+		useDispatch( noticesStore );
 
 	async function createPage( event ) {
 		event.preventDefault();
@@ -85,10 +88,30 @@ export function LinkUIPageCreator( {
 					kind: 'post-type',
 				};
 
+				// Show success notice
+				createSuccessNotice(
+					sprintf(
+						// translators: %s: the name of the new page being created.
+						__( '%s page created successfully.' ),
+						decodeEntities( savedRecord.title.rendered )
+					),
+					{
+						type: 'snackbar',
+						id: 'page-created-success',
+					}
+				);
+
 				onPageCreated( pageLink );
 			}
 		} catch ( error ) {
-			// Error handling is done via the data store selectors
+			// Show error notice
+			createErrorNotice(
+				__( 'Failed to create page. Please try again.' ),
+				{
+					type: 'snackbar',
+					id: 'page-created-error',
+				}
+			);
 		}
 	}