Data Views: Add action for pages to set site homepage

docs/reference-guides/data/data-core.md

@@ -786,7 +786,7 @@ _Parameters_
 
 -   _kind_ `string`: Kind of the edited entity record.
 -   _name_ `string`: Name of the edited entity record.
--   _recordId_ `number|string`: Record ID of the edited entity record.
+-   _recordId_ `number|string=`: Record ID of the edited entity record.
 -   _edits_ `Object`: The edits.
 -   _options_ `Object`: Options for the edit.
 -   _options.undoIgnore_ `[boolean]`: Whether to ignore the edit in undo history or not.
@@ -888,7 +888,7 @@ _Parameters_
 
 -   _kind_ `string`: Kind of the entity.
 -   _name_ `string`: Name of the entity.
--   _recordId_ `Object`: ID of the record.
+-   _recordId_ `Object=`: ID of the record.
 -   _options_ `Object=`: Saving options.
 
 ### saveEntityRecord

packages/core-data/README.md

@@ -196,7 +196,7 @@ _Parameters_
 
 -   _kind_ `string`: Kind of the edited entity record.
 -   _name_ `string`: Name of the edited entity record.
--   _recordId_ `number|string`: Record ID of the edited entity record.
+-   _recordId_ `number|string=`: Record ID of the edited entity record.
 -   _edits_ `Object`: The edits.
 -   _options_ `Object`: Options for the edit.
 -   _options.undoIgnore_ `[boolean]`: Whether to ignore the edit in undo history or not.
@@ -298,7 +298,7 @@ _Parameters_
 
 -   _kind_ `string`: Kind of the entity.
 -   _name_ `string`: Name of the entity.
--   _recordId_ `Object`: ID of the record.
+-   _recordId_ `Object=`: ID of the record.
 -   _options_ `Object=`: Saving options.
 
 ### saveEntityRecord

packages/core-data/src/actions.js

@@ -351,12 +351,12 @@ export const deleteEntityRecord =
  * Returns an action object that triggers an
  * edit to an entity record.
  *
- * @param {string}        kind                 Kind of the edited entity record.
- * @param {string}        name                 Name of the edited entity record.
- * @param {number|string} recordId             Record ID of the edited entity record.
- * @param {Object}        edits                The edits.
- * @param {Object}        options              Options for the edit.
- * @param {boolean}       [options.undoIgnore] Whether to ignore the edit in undo history or not.
+ * @param {string}         kind                 Kind of the edited entity record.
+ * @param {string}         name                 Name of the edited entity record.
+ * @param {number|string=} recordId             Record ID of the edited entity record.
+ * @param {Object}         edits                The edits.
+ * @param {Object}         options              Options for the edit.
+ * @param {boolean}        [options.undoIgnore] Whether to ignore the edit in undo history or not.
  *
  * @return {Object} Action object.
  */
@@ -775,7 +775,7 @@ export const __experimentalBatch =
  *
  * @param {string}  kind     Kind of the entity.
  * @param {string}  name     Name of the entity.
- * @param {Object}  recordId ID of the record.
+ * @param {Object=} recordId ID of the record.
  * @param {Object=} options  Saving options.
  */
 export const saveEditedEntityRecord =

packages/core-data/src/entity-types/settings.ts

@@ -90,6 +90,10 @@ declare module './base-entity-records' {
 			 * Site icon.
 			 */
 			site_icon: number;
+			/**
+			 * The ID of the page that should display posts.
+			 */
+			page_for_posts: number;
 		}
 	}
 }

packages/core-data/src/selectors.ts

@@ -310,7 +310,7 @@ export interface GetEntityRecord {
 		state: State,
 		kind: string,
 		name: string,
-		key: EntityRecordKey,
+		key?: EntityRecordKey,
 		query?: GetRecordsHttpQuery
 	): EntityRecord | undefined;
 
@@ -321,7 +321,7 @@ export interface GetEntityRecord {
 	>(
 		kind: string,
 		name: string,
-		key: EntityRecordKey,
+		key?: EntityRecordKey,
 		query?: GetRecordsHttpQuery
 	) => EntityRecord | undefined;
 	__unstableNormalizeArgs?: ( args: EntityRecordArgs ) => EntityRecordArgs;

packages/data/README.md

@@ -851,7 +851,7 @@ function Paste( { children } ) {
 _Parameters_
 
 -   _mapSelect_ `T`: Function called on every state change. The returned value is exposed to the component implementing this hook. The function receives the `registry.select` method on the first argument and the `registry` on the second argument. When a store key is passed, all selectors for the store will be returned. This is only meant for usage of these selectors in event callbacks, not for data needed to create the element tree.
--   _deps_ `unknown[]`: If provided, this memoizes the mapSelect so the same `mapSelect` is invoked on every state change unless the dependencies change.
+-   _deps_ `[unknown[]]`: If provided, this memoizes the mapSelect so the same `mapSelect` is invoked on every state change unless the dependencies change.
 
 _Returns_
 

packages/data/src/components/use-select/index.js

@@ -244,7 +244,7 @@ function _useMappingSelect( suspense, mapSelect, deps ) {
  *                              When a store key is passed, all selectors for the store will be
  *                              returned. This is only meant for usage of these selectors in event
  *                              callbacks, not for data needed to create the element tree.
- * @param {unknown[]} deps      If provided, this memoizes the mapSelect so the same `mapSelect` is
+ * @param {unknown[]} [deps]    If provided, this memoizes the mapSelect so the same `mapSelect` is
  *                              invoked on every state change unless the dependencies change.
  *
  * @example

packages/dataviews/src/components/dataviews-item-actions/index.tsx

@@ -107,7 +107,7 @@ export function ActionModal< Item >( {
 			__experimentalHideHeader={ !! action.hideModalHeader }
 			onRequestClose={ closeModal ?? ( () => {} ) }
 			focusOnMount="firstContentElement"
-			size="small"
+			size="medium"
 			overlayClassName={ `dataviews-action-modal dataviews-action-modal__${ kebabCase(
 				action.id
 			) }` }

packages/edit-site/src/components/post-list/index.js

@@ -295,7 +295,7 @@ export default function PostList( { postType } ) {
 	} = useEntityRecordsWithPermissions( 'postType', postType, queryArgs );
 
 	// The REST API sort the authors by ID, but we want to sort them by name.
-	const data = useMemo( () => {
+	let data = useMemo( () => {
 		if ( ! isLoadingFields && view?.sort?.field === 'author' ) {
 			return filterSortAndPaginate(
 				records,
@@ -353,6 +353,36 @@ export default function PostList( { postType } ) {
 		[ postTypeActions, editAction ]
 	);
 
+	const additionalContext = useSelect( ( select ) => {
+		const site = select( coreStore ).getEntityRecord( 'root', 'site' );
+		const themeTemplates = select( coreStore ).getEntityRecords(
+			'postType',
+			'wp_template',
+			{
+				per_page: -1,
+			}
+		);
+		const hasFrontPageTemplate = !! themeTemplates?.find(
+			( template ) => 'slug' in template && template.slug === 'front-page'
+		);
+		return {
+			siteSettings: {
+				pageOnFront: site?.page_on_front,
+				pageForPosts: site?.page_for_posts,
+			},
+			themeInfo: { hasFrontPageTemplate },
+		};
+	} );
+
+	if ( additionalContext ) {
+		data = data.map( ( item ) => {
+			return {
+				...item,
+				additionalContext,
+			};
+		} );
+	}
+
 	const [ showAddPostModal, setShowAddPostModal ] = useState( false );
 
 	const openModal = () => setShowAddPostModal( true );

packages/editor/src/components/post-actions/index.js

@@ -22,17 +22,39 @@ const { Menu, kebabCase } = unlock( componentsPrivateApis );
 
 export default function PostActions( { postType, postId, onActionPerformed } ) {
 	const [ isActionsMenuOpen, setIsActionsMenuOpen ] = useState( false );
-	const { item, permissions } = useSelect(
+	const { item, permissions, additionalContext } = useSelect(
 		( select ) => {
-			const { getEditedEntityRecord, getEntityRecordPermissions } =
-				unlock( select( coreStore ) );
+			const {
+				getEditedEntityRecord,
+				getEntityRecordPermissions,
+				getEntityRecord,
+				getEntityRecords,
+			} = unlock( select( coreStore ) );
+			const site = getEntityRecord( 'root', 'site' );
+			const pageOnFront = site?.page_on_front;
+			const pageForPosts = site?.page_for_posts;
+			const themeTemplates = getEntityRecords(
+				'postType',
+				'wp_template',
+				{
+					per_page: -1,
+				}
+			);
+			const hasFrontPageTemplate = !! themeTemplates?.find(
+				( template ) =>
+					'slug' in template && template.slug === 'front-page'
+			);
 			return {
 				item: getEditedEntityRecord( 'postType', postType, postId ),
 				permissions: getEntityRecordPermissions(
 					'postType',
 					postType,
 					postId
 				),
+				additionalContext: {
+					siteSettings: { pageOnFront, pageForPosts },
+					themeInfo: { hasFrontPageTemplate },
+				},
 			};
 		},
 		[ postId, postType ]
@@ -41,8 +63,9 @@ export default function PostActions( { postType, postId, onActionPerformed } ) {
 		return {
 			...item,
 			permissions,
+			additionalContext,
 		};
-	}, [ item, permissions ] );
+	}, [ item, permissions, additionalContext ] );
 	const allActions = usePostActions( { postType, onActionPerformed } );
 
 	const actions = useMemo( () => {
@@ -123,7 +146,7 @@ function ActionWithModal( { action, item, ActionTrigger, onClose } ) {
 						action.id
 					) }` }
 					focusOnMount="firstContentElement"
-					size="small"
+					size="medium"
 				>
 					<RenderModal
 						items={ [ item ] }

packages/editor/src/dataviews/store/private-actions.ts

@@ -20,6 +20,7 @@ import {
 	exportPattern,
 	permanentlyDeletePost,
 	restorePost,
+	setAsHomepage,
 	trashPost,
 	renamePost,
 	resetPost,
@@ -87,6 +88,14 @@ export const registerPostTypeActions =
 				kind: 'postType',
 				name: postType,
 			} );
+
+		const canManageOptions = await registry
+			.resolveSelect( coreStore )
+			.canUser( 'update', {
+				kind: 'root',
+				name: 'site',
+			} );
+
 		const currentTheme = await registry
 			.resolveSelect( coreStore )
 			.getCurrentTheme();
@@ -113,6 +122,9 @@ export const registerPostTypeActions =
 				? duplicatePattern
 				: undefined,
 			postTypeConfig.supports?.title ? renamePost : undefined,
+			canManageOptions && postTypeConfig.slug === 'page'
+				? setAsHomepage
+				: undefined,
 			postTypeConfig?.supports?.[ 'page-attributes' ]
 				? reorderPage
 				: undefined,

packages/editor/src/dataviews/types.ts

@@ -1,5 +1,5 @@
 type PostStatus =
-	| 'published'
+	| 'publish'
 	| 'draft'
 	| 'pending'
 	| 'private'

packages/fields/README.md

@@ -78,6 +78,10 @@ Undocumented declaration.
 
 Undocumented declaration.
 
+### setAsHomepage
+
+Undocumented declaration.
+
 ### slugField
 
 Undocumented declaration.

packages/fields/src/actions/index.ts

@@ -13,3 +13,4 @@ export { default as permanentlyDeletePost } from './permanently-delete-post';
 export { default as restorePost } from './restore-post';
 export { default as trashPost } from './trash-post';
 export { default as deletePost } from './delete-post';
+export { default as setAsHomepage } from './set-as-homepage';