функция
since 3.0.0
wp_delete_nav_menu()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
wp_delete_nav_menu( int|string|WP_Term $menu ): bool|WP_Error
Описание
Удаляет меню навигации.
Параметры
$menu
int|string|WP_Term
обязательный
ID меню, слаг, имя или объект.
Возвращаемое значение
bool|WP_Error
WP_Error
Исходный код
wp-includes/nav-menu.php:262
function wp_delete_nav_menu( $menu ) {
$menu = wp_get_nav_menu_object( $menu );
if ( ! $menu ) {
return false;
}
$menu_objects = get_objects_in_term( $menu->term_id, 'nav_menu' );
if ( ! empty( $menu_objects ) ) {
foreach ( $menu_objects as $item ) {
wp_delete_post( $item );
}
}
$result = wp_delete_term( $menu->term_id, 'nav_menu' );
// Remove this menu from any locations.
$locations = get_nav_menu_locations();
foreach ( $locations as $location => $menu_id ) {
if ( $menu_id === $menu->term_id ) {
$locations[ $location ] = 0;
}
}
set_theme_mod( 'nav_menu_locations', $locations );
if ( $result && ! is_wp_error( $result ) ) {
/**
* Fires after a navigation menu has been successfully deleted.
*
* @since 3.0.0
*
* @param int $term_id ID of the deleted menu.
*/
do_action( 'wp_delete_nav_menu', $menu->term_id );
}
return $result;
}
История изменений
| Версия | Описание |
|---|---|
| 3.0.0 | Introduced. |

