Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Deprecate 'Post author' block #55352

Open
wants to merge 14 commits into
base: trunk
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/reference-guides/core-blocks.md
Original file line number Diff line number Diff line change
Expand Up @@ -543,13 +543,13 @@ Show a block pattern. ([Source](https://github.com/WordPress/gutenberg/tree/trun
- **Supports:** interactivity (clientNavigation), ~~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), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), ~~html~~
- **Supports:** color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), ~~html~~, ~~inserter~~
- **Attributes:** avatarSize, byline, isLink, linkTarget, showAvatar, showBio, textAlign

## Author Biography
Expand Down
45 changes: 39 additions & 6 deletions packages/block-editor/src/components/block-inspector/index.js
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ import AdvancedControls from '../inspector-controls-tabs/advanced-controls-panel
import PositionControls from '../inspector-controls-tabs/position-controls-panel';
import useBlockInspectorAnimationSettings from './useBlockInspectorAnimationSettings';
import BlockInfo from '../block-info-slot-fill';
import InspectorControlsLastItem from '../inspector-controls-last-item-slot-fill';
import BlockQuickNavigation from '../block-quick-navigation';
import { useBorderPanelLabel } from '../../hooks/border';

Expand Down Expand Up @@ -255,12 +256,15 @@ const BlockInspectorSingleBlock = ( {
<BlockVariationTransforms blockClientId={ clientId } />
<BlockInfo.Slot />
{ showTabs && (
<InspectorControlsTabs
hasBlockStyles={ hasBlockStyles }
clientId={ clientId }
blockName={ blockName }
tabs={ availableTabs }
/>
<>
<InspectorControlsTabs
hasBlockStyles={ hasBlockStyles }
clientId={ clientId }
blockName={ blockName }
tabs={ availableTabs }
/>
<InspectorControlsLastItem.Slot />
</>
) }
{ ! showTabs && (
<>
Expand Down Expand Up @@ -309,6 +313,35 @@ const BlockInspectorSingleBlock = ( {
</div>
</>
) }
<InspectorControls.Slot />
<InspectorControls.Slot group="list" />
<InspectorControls.Slot
group="color"
label={ __( 'Color' ) }
className="color-block-support-panel__inner-wrapper"
/>
<InspectorControls.Slot
group="background"
label={ __( 'Background image' ) }
/>
<InspectorControls.Slot
group="typography"
label={ __( 'Typography' ) }
/>
<InspectorControls.Slot
group="dimensions"
label={ __( 'Dimensions' ) }
/>
<InspectorControls.Slot
group="border"
label={ borderPanelLabel }
/>
<InspectorControls.Slot group="styles" />
<PositionControls />
<div>
<AdvancedControls />
</div>
<InspectorControlsLastItem.Slot />
</>
) }
<SkipToSelectedBlock key="back" />
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
/**
* WordPress dependencies
*/
import { privateApis as componentsPrivateApis } from '@wordpress/components';

/**
* Internal dependencies
*/
import { unlock } from '../../lock-unlock';
import {
useBlockEditContext,
mayDisplayControlsKey,
} from '../block-edit/context';

const { createPrivateSlotFill } = unlock( componentsPrivateApis );
const { Fill, Slot } = createPrivateSlotFill( 'InspectorControlsLastItem' );

const InspectorControlsLastItem = ( props ) => {
const context = useBlockEditContext();
if ( ! context[ mayDisplayControlsKey ] ) {
return null;
}
return <Fill { ...props } />;
};
InspectorControlsLastItem.Slot = ( props ) => <Slot { ...props } />;

export default InspectorControlsLastItem;
2 changes: 2 additions & 0 deletions packages/block-editor/src/private-apis.js
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ import {
} from './components/inserter/search-items';
import { PrivateListView } from './components/list-view';
import BlockInfo from './components/block-info-slot-fill';
import InspectorControlsLastItem from './components/inspector-controls-last-item-slot-fill';
import { useHasBlockToolbar } from './components/block-toolbar/use-has-block-toolbar';
import { cleanEmptyObject } from './hooks/utils';
import BlockQuickNavigation from './components/block-quick-navigation';
Expand Down Expand Up @@ -65,6 +66,7 @@ lock( privateApis, {
PrivateListView,
ResizableBoxPopover,
BlockInfo,
InspectorControlsLastItem,
useHasBlockToolbar,
cleanEmptyObject,
BlockQuickNavigation,
Expand Down
5 changes: 3 additions & 2 deletions packages/block-library/src/post-author/block.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": {
Expand Down Expand Up @@ -35,6 +35,7 @@
},
"usesContext": [ "postType", "postId", "queryId" ],
"supports": {
"inserter": false,
"html": false,
"spacing": {
"margin": true,
Expand Down
38 changes: 38 additions & 0 deletions packages/block-library/src/post-author/edit.js
Original file line number Diff line number Diff line change
Expand Up @@ -12,18 +12,30 @@ import {
InspectorControls,
RichText,
useBlockProps,
store as blockEditorStore,
privateApis as blockEditorPrivateApis,
} from '@wordpress/block-editor';
import {
Button,
ComboboxControl,
PanelBody,
SelectControl,
ToggleControl,
__experimentalText as Text,
__experimentalVStack as VStack,
} from '@wordpress/components';
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 { InspectorControlsLastItem } = unlock( blockEditorPrivateApis );

const minimumUsersForCombobox = 25;

const AUTHORS_QUERY = {
Expand All @@ -36,6 +48,7 @@ function PostAuthorEdit( {
context: { postType, postId, queryId },
attributes,
setAttributes,
clientId,
} ) {
const isDescendentOfQueryLoop = Number.isFinite( queryId );
const { authorId, authorDetails, authors } = useSelect(
Expand All @@ -58,6 +71,7 @@ function PostAuthorEdit( {
);

const { editEntityRecord } = useDispatch( coreStore );
const { replaceBlock } = useDispatch( blockEditorStore );

const { textAlign, showAvatar, showBio, byline, isLink, linkTarget } =
attributes;
Expand Down Expand Up @@ -97,6 +111,10 @@ function PostAuthorEdit( {
const showAuthorControl =
!! postId && ! isDescendentOfQueryLoop && authorOptions.length > 0;

function transformBlock() {
replaceBlock( clientId, migrateToRecommendedBlocks( attributes ) );
}

return (
<>
<InspectorControls>
Expand Down Expand Up @@ -179,6 +197,26 @@ function PostAuthorEdit( {
</VStack>
</PanelBody>
</InspectorControls>
<InspectorControlsLastItem>
<VStack
className="wp-block-post-author__transform"
alignment="left"
spacing={ 4 }
>
<Text as="p">
{ __(
'This block is no longer supported. Please migrate to the Author Name, Avatar, and Biography blocks to design youor content as needed.'
) }
</Text>
<Button
variant="primary"
onClick={ transformBlock }
__next40pxDefaultSize
>
{ __( 'Migrate' ) }
</Button>
</VStack>
</InspectorControlsLastItem>

<BlockControls group="block">
<AlignmentControl
Expand Down
7 changes: 7 additions & 0 deletions packages/block-library/src/post-author/editor.scss
Original file line number Diff line number Diff line change
@@ -1,3 +1,10 @@
.wp-block-post-author__transform {
background: $gray-100;
border-radius: $radius-block-ui;
margin: $grid-unit-20;
padding: $grid-unit-20;
}

.wp-block-post-author__inspector-settings {
// Counteract the margin added by the block inspector.
.components-base-control,
Expand Down
2 changes: 2 additions & 0 deletions packages/block-library/src/post-author/index.js
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,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,
example: {
viewportWidth: 350,
attributes: {
Expand Down
17 changes: 17 additions & 0 deletions packages/block-library/src/post-author/transforms.js
Original file line number Diff line number Diff line change
@@ -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;
115 changes: 115 additions & 0 deletions packages/block-library/src/post-author/utils.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
/**
* WordPress dependencies
*/
import { createBlock } from '@wordpress/blocks';
import { __ } from '@wordpress/i18n';
import { privateApis as blockEditorPrivateApis } from '@wordpress/block-editor';

/**
* Internal dependencies
*/
import { unlock } from '../lock-unlock';

const { cleanEmptyObject } = unlock( blockEditorPrivateApis );

/**
* 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,
showAvatar,
showBio,
isLink,
linkTarget,
textAlign,
style,
...restAttributes
} = attributes;

return createBlock(
'core/group',
{
...restAttributes,
style: cleanEmptyObject( {
...style,
spacing: {
blockGap: '1em',
},
color: {
...style?.color,
// Duotone must be applied to the avatar block.
duotone: undefined,
},
} ),
layout: {
type: 'flex',
flexWrap: 'nowrap',
verticalAlignment: 'top',
},
Comment on lines +50 to +54
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The layout and spacing changes are a bit unexpected when migrating the block. Can we apply some sensible defaults to match the previous spacing?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Post Author block also has a Flex layout, but seems to have a 1em right margin between the avatar and the content. Therefore, in a8173e3, this is used as the styles.spacing.blockGap value.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for iterating on this. The block gap spacing is only one aspect of the issue. In the video I shared you'll notice that the overall width of the block change. That is unexpected and could further break themes.

Before

Screenshot 2023-10-17 at 12 50 24 pm

After

Screenshot 2023-10-17 at 12 50 32 pm

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Regarding the width of the block, I think the Post Author block does not have box-sizing:border-box, so the width change will occur if left and right padding is applied.

This spacing support for this block was added in #35963, but this PR was before #43243 that recommends adding box-sizing:border-box at the same time as supporting spacing controls.

Originally, I think the Post Author block should also have box-sizing:border-box, but what approach do you think is best to prevent breaking changes as much as possible? Personally, I think that increasing the width of the Post Author block by padding is not originally intended, and that changing the width may be acceptable for migration purposes.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update: Post Author block now supports borders, as of #64599. At the same time, box-sizing: border-box was added, so there should be no width change when migrating.

},
[
showAvatar &&
createBlock( 'core/avatar', {
size: avatarSize,
style: cleanEmptyObject( {
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',
},
},
} ),
showBio &&
createBlock( 'core/post-author-biography', {
style: {
typography: {
fontSize: '0.7em',
},
},
} ),
].filter( Boolean )
),
].filter( Boolean )
);
}
Loading