wp_get_nav_menus

（3.0.0以降）
wp_get_nav_menus - すべてのナビゲーションメニュー情報を取得する

説明

array wp_get_nav_menus( [ array $args = array() ] )
すべてのナビゲーションメニュー情報を取得する。

パラメータ

  • $args
    パラメータを連想配列で指定（省略時はarray()）。主なキーは次の通り。
    キー意味省略時の値
    'hide_empty'投稿記事がないものを取得しない場合はtrueを指定false
    'orderby'ソート対象を指定[4.1.0]'name'。それより前は'none'

返り値

ナビゲーションメニュー情報（オブジェクト）の配列を返す。

注意

パラメータ$argsは get_terms関数に引き継がれ、連想配列のキーは共通である。なおソート対象の$args['orderby']の省略時の値は、4.1.0から'name'に変更されている。

使用例

  • すべてのナビゲーションメニュー情報を取得する。
    <?php $menus = wp_get_nav_menus(); ?>
  • すべてのナビゲーションメニュー情報をスラッグ順で取得する。
    <?php $menus = wp_get_nav_menus( array( 'orderby'=>'slug' ) ); ?>

フィルター

[3.0.0]ナビゲーションメニュー情報を返す前に'wp_get_nav_menus'フィルターを呼び出す。パラメータ$menusにはナビゲーションメニュー情報の配列が、$argsは本関数が受け取った内容が格納される。
return apply_filters( 'wp_get_nav_menus', $menus, $args );

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/nav-menu.php

最終更新 : 2018年05月27日 10:46

関連

参考

Code Reference: wp_get_nav_menus

お勧め

5.7の新機能：AJAXでパスワードを取得（2021年2月17日 更新）

日本時間の今朝「WordPress 5.7 Beta 3（以降Beta 3）」が予定通り公開されました。今回は、ソースコードを眺めていた時に気になったパスワードを取得できるAJAXについて確認した。

5.4.1でパーマリンクの仕様が一部変更された件（2020年5月12日 更新）

先月末にリリースされたバージョン5.4.1のアップデートにより、一部のサイトで投稿ページが従来通りに表示されなくなる不具合が発生し、サポートサイトにレポートが上がりました。この件について、ちょっとモヤモヤしたので自分なりに考えてみました。

使っていないか確認しないとね！（2022年6月7日 更新）

2003年に誕生したWordPress。その歴史の中には、廃止予定（deprecated）となっている関数がいくつも存在する。それらの関数をテーマやプラグインで使用するべきではないし、使用しているなら代替の関数に書き換えるべきである。ここでは3.25.9.0現在、廃止予定となっている関数をまとめて紹介する。

HTML編集モードに定型文ボタンを追加する（2011年6月1日 更新）

投稿編集ページにはビジュアル編集モードとHTML編集モードがあり、それらを拡張するプラグインも多数存在している。そういったプラグインを利用するのもいいのだが、仕組みを理解するのも悪くないはず。というわけで、ここではHTML編集モードのボタンの仕組みと定型文を挿入するボタンを追加する方法を紹介する。

テーブルの1列目をth要素にしてみる（2021年12月21日 更新）

標準の「テーブル」ブロックでは、tbody要素内のセルはすべてtd要素になっている。テーブルの1列目についてはth要素を使いたいケースがあり、「トグル」コントロールを使って切り替え可能にできないか調べてみた。