Fix/plugin document setting panel name (#22763)

* Cleaner logic to determine which name to use

* Adding trailing comma

* Adding a warning to the slotfill and update docs.

* Adding missing period.

* Update docs/designers-developers/developers/slotfills/plugin-document-setting-panel.md

Co-authored-by: Greg Ziółkowski <grzegorz@gziolo.pl>

* Update docs/designers-developers/developers/slotfills/plugin-document-setting-panel.md

Co-authored-by: Greg Ziółkowski <grzegorz@gziolo.pl>

* Re-add file removed in error

* Correct logic checking for missing name prop.

* Update docs to use correct function name.

Co-authored-by: Greg Ziółkowski <grzegorz@gziolo.pl>

docs/designers-developers/developers/slotfills/plugin-document-setting-panel.md

@@ -30,3 +30,13 @@ registerPlugin( 'plugin-document-setting-panel-demo', {
 	icon: 'palmtree',
 } );
 ```
+## Accessing a panel programmatically
+
+Custom panels are namespaced with the plugin name that was passed to `registerPlugin`.
+In order to access the panels using function such as `wp.data.dispatch( 'core/edit-post' ).toggleEditorPanelOpened` or `wp.data.dispatch( 'core/edit-post' ).toggleEditorPanelEnabled` be sure to prepend the namepace.
+
+To programmatically toggle the custom panel added in the example above, use the following:
+
+```js
+wp.data.dispatch( 'core/edit-post' ).toggleEditorPanelOpened( 'plugin-document-setting-panel-demo/custom-panel' );
+```

packages/edit-post/package.json

@@ -52,6 +52,7 @@
 		"@wordpress/primitives": "file:../primitives",
 		"@wordpress/url": "file:../url",
 		"@wordpress/viewport": "file:../viewport",
+		"@wordpress/warning": "file:../warning",
 		"classnames": "^2.2.5",
 		"lodash": "^4.17.15",
 		"memize": "^1.1.0",

packages/edit-post/src/components/sidebar/plugin-document-setting-panel/index.js

@@ -9,6 +9,7 @@ import { createSlotFill, PanelBody } from '@wordpress/components';
 import { compose } from '@wordpress/compose';
 import { withPluginContext } from '@wordpress/plugins';
 import { withDispatch, withSelect } from '@wordpress/data';
+import warning from '@wordpress/warning';
 
 /**
  * Internal dependencies
@@ -104,6 +105,9 @@ const PluginDocumentSettingFill = ( {
  */
 const PluginDocumentSettingPanel = compose(
 	withPluginContext( ( context, ownProps ) => {
+		if ( undefined === ownProps.name ) {
+			warning( 'PluginDocumentSettingPanel requires a name property.' );
+		}
 		return {
 			icon: ownProps.icon || context.icon,
 			panelName: `${ context.name }/${ ownProps.name }`,