deprecate receiveUploadPermissions (#37508)

* deprecate receiveUploadPermissions * fallback to receiveUserPermission * Update packages/core-data/src/actions.js Co-authored-by: Nik Tsekouras <[email protected]>
WordPress · Dec 27, 2021 · 10f2b17 · 10f2b17
1 parent 51454d4
commit 10f2b17
Show file tree

Hide file tree

Showing 3 changed files with 12 additions and 5 deletions.
diff --git a/docs/reference-guides/data/data-core.md b/docs/reference-guides/data/data-core.md
@@ -636,6 +636,8 @@ _Returns_
 
 ### receiveUploadPermissions
 
+> **Deprecated** since WP 5.9, use receiveUserPermission instead.
+
 Returns an action object used in signalling that Upload permissions have been received.
 
 _Parameters_

diff --git a/packages/core-data/README.md b/packages/core-data/README.md
@@ -170,6 +170,8 @@ _Returns_
 
 ### receiveUploadPermissions
 
+> **Deprecated** since WP 5.9, use receiveUserPermission instead.
+
 Returns an action object used in signalling that Upload permissions have been received.
 
 _Parameters_

diff --git a/packages/core-data/src/actions.js b/packages/core-data/src/actions.js
@@ -696,16 +696,19 @@ export const __experimentalSaveSpecifiedEntityEdits = (
 /**
  * Returns an action object used in signalling that Upload permissions have been received.
  *
+ * @deprecated since WP 5.9, use receiveUserPermission instead.
+ *
  * @param {boolean} hasUploadPermissions Does the user have permission to upload files?
  *
  * @return {Object} Action object.
  */
 export function receiveUploadPermissions( hasUploadPermissions ) {
- return {
- type: 'RECEIVE_USER_PERMISSION',
- key: 'create/media',
- isAllowed: hasUploadPermissions,
- };
+ deprecated( "wp.data.dispatch( 'core' ).receiveUploadPermissions", {
+ since: '5.9',
+ alternative: 'receiveUserPermission',
+ } );
+
+ return receiveUserPermission( 'create/media', hasUploadPermissions );
 }
 
 /**