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 );
        }
    }
}