WordPressの外観メニュー情報を取得する方法

外観→メニューのプルダウンの実装を見てみる

外観→メニューを表示しているPHPファイル（/wp-admin/nav-menus.php）を見ていたら発見。wp_get_nav_menus関数で、wp_termとwp_term_taxonomyテーブル内にあるメニュー情報を取得してくれるようです。

// Get all nav menus.
$nav_menus = wp_get_nav_menus();

取得した内容をダンプしてみると以下のようなデータを返してくれます。

array (size=8)
  0 =>
    object(WP_Term)[11575]
      public 'term_id' => int 132
      public 'name' => string 'All Pages' (length=9)
      public 'slug' => string 'all-pages' (length=9)
      public 'term_group' => int 0
      public 'term_taxonomy_id' => int 132
      public 'taxonomy' => string 'nav_menu' (length=8)
      public 'description' => string '' (length=0)
      public 'parent' => int 0
      public 'count' => int 40
      public 'filter' => string 'raw' (length=3)
  1 =>
      （以下省略）

欲しいデータは、nameプロパティの値（5行目）なので、この値を使用してselect要素を作成します。

プルダウンの作成

wp_get_nav_menus関数はコールすると配列でデータを返してくれるので、まず配列に値が入っているかチェック。それから1件以上存在すれば、select要素を出力して、ループでoption要素を出力する仕組み。とてもシンプル。

$nav_menus = wp_get_nav_menus();

if ( count( $nav_menus ) > 0 ) {
  echo '<select>';

  foreach ( (array) $nav_menus as $menu ) {
    echo '<option value="' . esc_attr( $menu->name ) . '">';
    echo esc_html( $menu->name );
    echo '</option>';
  }

  echo '</select>';
}

プラグインへの実装

属性の追加

サンプルを元にプラグインに実装します。select要素にname属性をセットしたり、登録している名前とマッチしたらoption要素にselected属性を設定して選択状態にする処理などを追加しました。

private function page_render ( array $option ) {
  $html  = '<table class="schema-admin-table">';
  $html .= '<caption>Basic Setting</caption>';
  $html .= '<tr><th class="require"><label for="menu_name">Menu Name :</label></th><td>';

  $nav_menus = wp_get_nav_menus();

  if ( count( $nav_menus ) > 0 ) {
    $html .= '<select name="option[' . "menu_name" . ']" id="menu_name">';

    foreach ( (array) $nav_menus as $menu ) {
      if ( $option['menu_name'] === $menu->name ) {
        $html .= '<option value="' . esc_attr( $menu->name ) . '" selected>';
      } else {
        $html .= '<option value="' . esc_attr( $menu->name ) . '">';
      }
      $html .= esc_html( $menu->name );
      $html .= '</option>';
    }

    $html .= '</select>';
  }

  $html .= '</td></tr>';
  $html .= '</table>';
  echo $html;

  echo '<p>Setting Knowledge : <a href="https://schema.org/SiteNavigationElement" target="_blank">https://schema.org/SiteNavigationElement</a></p>';
  submit_button();
}

いい感じでできた！＼(^o^)／

/**
  * Setting schema.org Site Navigation
  *
  * @version 3.2.3
  * @since   3.1.0
  * @param   array $options
  */
private function set_schema_site_navigation ( array $options ) {
  if ( isset( $options['menu_name'] ) && wp_get_nav_menu_items( $options['menu_name'] ) ) {
    $items_array = wp_get_nav_menu_items( $options['menu_name'] );
    $name_array  = array();
    $url_array   = array();

    foreach ( (array) $items_array as $key => $menu_item ) {
      $url_array[]  = $menu_item->url;
      $name_array[] = $menu_item->title;
    }

    if ( count( $items_array ) > 0 ) {
      $args = array(
        "@context" => "http://schema.org",
        "@type"    => "SiteNavigationElement",
        "name"     => $name_array,
        "url"      => $url_array
      );
      $this->set_schema_json ( $args );
    }
  }
}