Docs: Add a reference to `WP_Customize_Panel::__construct()` for information on accepted arguments in `WP_Customize_Manager::add_panel()`.

Synchronize the documentation between two places, use `WP_Customize_Panel::__construct()` as the canonical source.

Props iaaxpage, marekdedic.
Fixes #48344.
Built from https://develop.svn.wordpress.org/trunk@47387


git-svn-id: http://core.svn.wordpress.org/trunk@47174 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2020-02-27 20:36:07 +00:00
parent 9043b9833f
commit 50afd0aa1b
3 changed files with 20 additions and 16 deletions

View File

@ -3801,20 +3801,12 @@ final class WP_Customize_Manager {
* @since 4.0.0 * @since 4.0.0
* @since 4.5.0 Return added WP_Customize_Panel instance. * @since 4.5.0 Return added WP_Customize_Panel instance.
* *
* @param WP_Customize_Panel|string $id Customize Panel object, or Panel ID. * @see WP_Customize_Panel::__construct()
* @param array $args {
* Optional. Array of properties for the new Panel object. Default empty array.
* *
* @type int $priority Priority of the panel, defining the display order * @param WP_Customize_Panel|string $id Customize Panel object, or ID.
* of panels and sections. Default 160. * @param array $args Optional. Array of properties for the new Panel object.
* @type string $capability Capability required for the panel. * See WP_Customize_Panel::__construct() for information
* Default `edit_theme_options`. * on accepted arguments. Default empty array.
* @type string|string[] $theme_supports Theme features required to support the panel.
* @type string $title Title of the panel to show in UI.
* @type string $description Description to show in the UI.
* @type string $type Type of the panel.
* @type callable $active_callback Active callback.
* }
* @return WP_Customize_Panel The instance of the panel that was added. * @return WP_Customize_Panel The instance of the panel that was added.
*/ */
public function add_panel( $id, $args = array() ) { public function add_panel( $id, $args = array() ) {
@ -3901,7 +3893,7 @@ final class WP_Customize_Manager {
* *
* @see WP_Customize_Section::__construct() * @see WP_Customize_Section::__construct()
* *
* @param WP_Customize_Section|string $id Customize Section object, or Section ID. * @param WP_Customize_Section|string $id Customize Section object, or ID.
* @param array $args Optional. Array of properties for the new Section object. * @param array $args Optional. Array of properties for the new Section object.
* See WP_Customize_Section::__construct() for information * See WP_Customize_Section::__construct() for information
* on accepted arguments. Default empty array. * on accepted arguments. Default empty array.

View File

@ -139,7 +139,19 @@ class WP_Customize_Panel {
* *
* @param WP_Customize_Manager $manager Customizer bootstrap instance. * @param WP_Customize_Manager $manager Customizer bootstrap instance.
* @param string $id A specific ID for the panel. * @param string $id A specific ID for the panel.
* @param array $args Panel arguments. * @param array $args {
* Optional. Array of properties for the new Panel object. Default empty array.
*
* @type int $priority Priority of the panel, defining the display order
* of panels and sections. Default 160.
* @type string $capability Capability required for the panel.
* Default `edit_theme_options`.
* @type string|string[] $theme_supports Theme features required to support the panel.
* @type string $title Title of the panel to show in UI.
* @type string $description Description to show in the UI.
* @type string $type Type of the panel.
* @type callable $active_callback Active callback.
* }
*/ */
public function __construct( $manager, $id, $args = array() ) { public function __construct( $manager, $id, $args = array() ) {
$keys = array_keys( get_object_vars( $this ) ); $keys = array_keys( get_object_vars( $this ) );

View File

@ -13,7 +13,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '5.4-beta3-47386'; $wp_version = '5.4-beta3-47387';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.