Docs: Add missing documentation for add_cssclass() and add_menu_classes().

Follow-up to [9578], [53193].

See #54729.

git-svn-id: https://develop.svn.wordpress.org/trunk@53194 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Sergey Biryukov
2022-04-17 14:28:24 +00:00
parent 9846e1aefc
commit 2a9ca0d823

View File

@@ -187,9 +187,13 @@ foreach ( $menu as $id => $data ) {
unset( $id, $data, $subs, $first_sub );
/**
* @param string $class_to_add
* @param string $classes
* @return string
* Adds a CSS class to a string.
*
* @since 2.7.0
*
* @param string $class_to_add The CSS class to add.
* @param string $classes The string to add the CSS class to.
* @return string The string with the CSS class added.
*/
function add_cssclass( $class_to_add, $classes ) {
if ( empty( $classes ) ) {
@@ -200,8 +204,14 @@ function add_cssclass( $class_to_add, $classes ) {
}
/**
* @param array $menu
* @return array
* Adds CSS classes for top-level administration menu items.
*
* The list of added classes includes `.menu-top-first` and `.menu-top-last`.
*
* @since 2.7.0
*
* @param array $menu The array of administration menu items.
* @return array The array of administration menu items with the CSS classes added.
*/
function add_menu_classes( $menu ) {
$first = false;
@@ -239,7 +249,7 @@ function add_menu_classes( $menu ) {
}
/**
* Filters administration menus array with classes added for top-level items.
* Filters administration menu array with classes added for top-level items.
*
* @since 2.7.0
*
@@ -354,4 +364,3 @@ if ( ! user_can_access_admin_page() ) {
}
$menu = add_menu_classes( $menu );