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