Deprecate 'Post author' block

docs/reference-guides/core-blocks.md

@@ -533,13 +533,13 @@ Show a block pattern. ([Source](https://github.com/WordPress/gutenberg/tree/trun
 -	**Supports:** ~~html~~, ~~inserter~~, ~~renaming~~
 -	**Attributes:** slug
 
-## Author
+## Author (deprecated)
 
-Display post author details such as name, avatar, and bio. ([Source](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-author))
+This block is deprecated. Please use the Avatar block, the Author Name block, and the Author Biography block instead. ([Source](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-author))
 
 -	**Name:** core/post-author
 -	**Category:** theme
--	**Supports:** color (background, gradients, link, text), spacing (margin, padding), typography (fontSize, lineHeight), ~~html~~
+-	**Supports:** color (background, gradients, link, text), inserter, spacing (margin, padding), typography (fontSize, lineHeight), ~~html~~
 -	**Attributes:** avatarSize, byline, isLink, linkTarget, showAvatar, showBio, textAlign
 
 ## Author Biography

packages/block-library/src/editor.scss

@@ -32,6 +32,7 @@
 @import "./nextpage/editor.scss";
 @import "./page-list/editor.scss";
 @import "./paragraph/editor.scss";
+@import "./post-author/editor.scss";
 @import "./post-excerpt/editor.scss";
 @import "./pullquote/editor.scss";
 @import "./rss/editor.scss";

packages/block-library/src/post-author/block.json

@@ -2,9 +2,9 @@
 	"$schema": "https://schemas.wp.org/trunk/block.json",
 	"apiVersion": 3,
 	"name": "core/post-author",
-	"title": "Author",
+	"title": "Author (deprecated)",
 	"category": "theme",
-	"description": "Display post author details such as name, avatar, and bio.",
+	"description": "This block is deprecated. Please use the Avatar block, the Author Name block, and the Author Biography block instead.",
 	"textdomain": "default",
 	"attributes": {
 		"textAlign": {
@@ -35,6 +35,7 @@
 	},
 	"usesContext": [ "postType", "postId", "queryId" ],
 	"supports": {
+		"inserter": true,
 		"html": false,
 		"spacing": {
 			"margin": true,

packages/block-library/src/post-author/edit.js

@@ -12,8 +12,11 @@ import {
 	InspectorControls,
 	RichText,
 	useBlockProps,
+	store as blockEditorStore,
+	privateApis as blockEditorPrivateApis,
 } from '@wordpress/block-editor';
 import {
+	Button,
 	ComboboxControl,
 	PanelBody,
 	SelectControl,
@@ -23,6 +26,14 @@ import { useSelect, useDispatch } from '@wordpress/data';
 import { __ } from '@wordpress/i18n';
 import { store as coreStore } from '@wordpress/core-data';
 
+/**
+ * Internal dependencies
+ */
+import { migrateToRecommendedBlocks } from './utils';
+import { unlock } from '../lock-unlock';
+
+const { BlockInfo } = unlock( blockEditorPrivateApis );
+
 const minimumUsersForCombobox = 25;
 
 const AUTHORS_QUERY = {
@@ -35,6 +46,7 @@ function PostAuthorEdit( {
 	context: { postType, postId, queryId },
 	attributes,
 	setAttributes,
+	clientId,
 } ) {
 	const isDescendentOfQueryLoop = Number.isFinite( queryId );
 	const { authorId, authorDetails, authors } = useSelect(
@@ -57,6 +69,7 @@ function PostAuthorEdit( {
 	);
 
 	const { editEntityRecord } = useDispatch( coreStore );
+	const { replaceBlock } = useDispatch( blockEditorStore );
 
 	const { textAlign, showAvatar, showBio, byline, isLink, linkTarget } =
 		attributes;
@@ -96,8 +109,19 @@ function PostAuthorEdit( {
 	const showAuthorControl =
 		!! postId && ! isDescendentOfQueryLoop && authorOptions.length > 0;
 
+	function transformBlock() {
+		replaceBlock( clientId, migrateToRecommendedBlocks( attributes ) );
+	}
+
 	return (
 		<>
+			<BlockInfo>
+				<div className="wp-block-post-author__transform-button">
+					<Button variant="primary" onClick={ transformBlock }>
+						{ __( 'Migrate block' ) }
+					</Button>
+				</div>
+			</BlockInfo>
 			<InspectorControls>
 				<PanelBody title={ __( 'Settings' ) }>
 					{ showAuthorControl &&

packages/block-library/src/post-author/editor.scss

@@ -0,0 +1,3 @@
+.wp-block-post-author__transform-button {
+	padding: 0 $grid-unit-20 $grid-unit-20 52px;
+}

packages/block-library/src/post-author/index.js

@@ -9,12 +9,14 @@ import { postAuthor as icon } from '@wordpress/icons';
 import initBlock from '../utils/init-block';
 import metadata from './block.json';
 import edit from './edit';
+import transforms from './transforms';
 
 const { name } = metadata;
 export { metadata, name };
 
 export const settings = {
 	icon,
+	transforms,
 	edit,
 };
 

packages/block-library/src/post-author/transforms.js

@@ -0,0 +1,17 @@
+/**
+ * Internal dependencies
+ */
+import { migrateToRecommendedBlocks } from './utils';
+
+const transforms = {
+	to: [
+		{
+			type: 'block',
+			blocks: [ 'core/group' ],
+			transform: ( attributes ) =>
+				migrateToRecommendedBlocks( attributes ),
+		},
+	],
+};
+
+export default transforms;

packages/block-library/src/post-author/utils.js

@@ -0,0 +1,102 @@
+/**
+ * WordPress dependencies
+ */
+import { createBlock } from '@wordpress/blocks';
+import { __ } from '@wordpress/i18n';
+
+/**
+ * Generate Author-related blocks based on block attributes.
+ *
+ * @param {Object} attributes Block's attributes.
+ *
+ * @return {Object} Generated block.
+ */
+export function migrateToRecommendedBlocks( attributes ) {
+	const {
+		avatarSize,
+		byline,
+		showBio,
+		isLink,
+		linkTarget,
+		textAlign,
+		style,
+		...restAttributes
+	} = attributes;
+
+	return createBlock(
+		'core/group',
+		{
+			...restAttributes,
+			style: {
+				...style,
+				color: {
+					...style?.color,
+					// Duotone must be applied to the avatar block.
+					duotone: undefined,
+				},
+			},
+			layout: {
+				type: 'flex',
+				flexWrap: 'nowrap',
+				verticalAlignment: 'top',
+			},
+		},
+		[
+			showBio &&
+				createBlock( 'core/avatar', {
+					size: avatarSize,
+					style: {
+						border: {
+							radius: '0px',
+						},
+						color: {
+							duotone: style?.color?.duotone,
+						},
+					},
+				} ),
+			createBlock(
+				'core/group',
+				{
+					style: {
+						layout: {
+							selfStretch: 'fill',
+							flexSize: null,
+						},
+					},
+					layout: {
+						type: 'flex',
+						orientation: 'vertical',
+						justifyContent: textAlign,
+					},
+				},
+				[
+					createBlock( 'core/paragraph', {
+						content: byline,
+						placeholder: __( 'Write byline…' ),
+						style: {
+							typography: {
+								fontSize: '0.5em',
+							},
+						},
+					} ),
+					createBlock( 'core/post-author-name', {
+						isLink,
+						linkTarget,
+						style: {
+							typography: {
+								fontSize: '1em',
+							},
+						},
+					} ),
+					createBlock( 'core/post-author-biography', {
+						style: {
+							typography: {
+								fontSize: '0.7em',
+							},
+						},
+					} ),
+				]
+			),
+		].filter( Boolean )
+	);
+}