タクソノミーの一覧をショートコードで編集・ソート機能付き・wp_list_categories

2016/02/09 2016/03/11

カスタムタクソノミーのターム一覧の作成方法

カスタムタクソノミーのターム一覧をショートコードで編集・まえがき

　
カスタムタクソノミーのターム一覧をウィジェットにショートコードで編集するプログラムを「カスタムタクソノミーのターム一覧をウィジェットにショートコードで編集」で紹介しました。
　
これを書いた時にはまだローカルで実験をしている段階でしたので、これでよかったのですが、実際に運用するにあたってはタクソノミーを任意の順番に並び替える必要に迫られましたので、並び順を自由に変えられる方法を採ることにしました。
「カスタムタクソノミーのターム一覧をウィジェットにショートコードで編集」に追記をしようかと思いましたが、多様な方法があるために別記事にしました。
　
　

カスタムタクソノミーを並び替える・Category Order and Taxonomy Terms Order

　
カスタムタクソノミーを自由に並び替えて表示する前提として、カスタムタクソノミーのタームを管理側で並び順を指定する方法として、プラグインの Category Order and Taxonomy Terms Orderを利用しています。
　
この Category Order and Taxonomy Terms Orderで並び替えたカテゴリやタクソノミーのタームを一覧表示します。
Category Order and Taxonomy Terms Orderの使い方については「Category Order and Taxonomy Terms Orderでカテゴリ・タクソノミーのタームの順番を並び替える」に記事を書いていますので参照してください。
　
　

カスタムタクソノミーのターム一覧を表示するショートコード

カスタムタクソノミーの一覧表示するソースコード

　
カスタムタクソノミーのターム一覧をウィジェットに編集するために必要なショートコードのソースコードは以下の通りです。
これを functions.phpにコピペします。
　
functions.phpの詳しい解説ついては「WordPressの functions.phpがある場所」を参照してください。
　

add_filter('widget_text', 'do_shortcode' );

// サイドバーに指定のタクソノミーを表示するショートカット２
function shortcodeFunc ( $arg ) {
  extract ( shortcode_atts ( array (
        'text' => 'category',
  ), $arg ) ); 

  $html  = "";
  $html .= '<div id="mybox">';
  $html .= wp_list_categories ( array ( 'title_li' => '', 'taxonomy' => $text, 'show_count' => 1, 'style' => false, 'depth' => 0, 'echo' => false, 'orderby' => 'term_order', 'order' => 'ASC' ));
  $html .= '</div>';

  return $html;
}
add_shortcode('get_taxonomy_term_list', 'shortcodeFunc');

add_filter('widget_text', 'do_shortcode' );

// サイドバーに指定のタクソノミーを表示するショートカット２

function shortcodeFunc ( $arg ) {

extract ( shortcode_atts ( array (

'text' => 'category',

), $arg ) );

$html = "";

$html .= '<div id="mybox">';

$html .= wp_list_categories ( array ( 'title_li' => '', 'taxonomy' => $text, 'show_count' => 1, 'style' => false, 'depth' => 0, 'echo' => false, 'orderby' => 'term_order', 'order' => 'ASC' ));

$html .= '</div>';

return $html;

}

add_shortcode('get_taxonomy_term_list', 'shortcodeFunc');

　
　
また、ウィジェットに編集するショートコードは、下記の様になります。
　

[get_taxonomy_list text=s_taxonomy]

1	[get_taxonomy_list text=s_taxonomy]

　
引数として「text」でカスタムタクソノミーの「slug」を指定します。
「text」の指定がない場合は、「category」が指定されたものとして処理されます（カスタムタクソノミーではなく、デフォルトのカテゴリーの一覧が表示されます）。
　
　

カスタムタクソノミーの一覧・wp_list_categories()関数の解説

　
wp_list_categories()関数の解説に関しては、「カスタムタクソノミーのターム一覧をウィジェットにショートコードで編集」に詳しく書いていますので参考にしてください。
　
今回はソート順を指定するという処理を追加していますので、wp_list_categories()関数に指定する配列に下記の項目を追加しています。

　　'orderby' => 'term_order'
　　'order' => 'ASC'

1 2	'orderby' => 'term_order' 　　'order' => 'ASC'

　
このうち「term_order」が、プラグイン「Category Order and Taxonomy Terms Order」で設定される並び順の項目です。
この「term_order」をキーとして設定すれば OKです。
　
また、「Category Order and Taxonomy Terms Orderでカテゴリ・タクソノミーのタームの順番を並び替える」の設定画面の「自動ソート」という項目を「オン」にしておくと、この「term_order」をソートキーとして指定しなくても常に「term_order」でソートされた状態で取得されます。
　
逆に「オン」になっていても、orderby、order項目でソート条件を指定することで指定したソート条件でソートすることができます。
　
　

カスタムタクソノミーのタームを取得する関数

　
カテゴリやカスタムタクソノミーのターム一覧を作成する場合は、今回の記事で紹介した wp_list_categories()関数が便利です。
ですが、wp_list_categories()関数は、一覧表示するためにレイアウトを整えた形式で取得できますので、自由な編集が行いにくいのも事実です。
　
そんなときは、値だけを取得するget_categories()関数、get_terms()関数などがあります。
　
こちらの関数に関しては「get_categories、get_termsでカテゴリとタクソノミーのターム一覧の編集方法」に記事をまとめましたので参考にしてください。

- WordPress

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: Smart Update PingerでWordPressのPing・更新情報サービスを拡張する

WordPressの Ping機能、更新情報サービスのプラグイン Smart Update Pingerの使い方と問題点。

: Better Delete Revisionを使って WordPressのリビジョンを削除する方法

自動的に溜まるリビジョンは Better Delete Revisionを使うことで簡単に削除することが出来ます。表示の重さを軽減したり、バックアップファイルのスリム化に貢献します。

: WordPressで WPtouchを入れてモバイルテーマを「OFF」にしたら元に戻れなくなった

WPtouchを入れてモバイルテーマを「OFF」にしたら元に戻れなくなった。これは「wp_footer」の設定に問題があるからだった。

: WordPress　プラグインのアップデート失敗でデータが消える事態が！

プラグインのアップデート失敗でデータが消失。不具合が起こる原因はあちこちにありますので常に慎重にバックアップをしましょう。

: CSV Importerで WordPressにcsvを取込む

WordPressに csvファイルを取り込む CSV Importerの使い方の解説です。

: WordPress csvインポート、エクスポートのプラグイン

WordPressから csvファイルをエクスポート、インポートする方法を紹介しています。

: BizVektor環境の引越しでメニュー、バナーが消える不具合の対応方法解説

BizVektor環境の引越し方法と不具合が発生しやすい箇所の解説です。引っ越し作業をする際にURLやファイルのパスを置換する際の手順解説と対応方法についての解説です。

: WordPressの一覧ページのテンプレートの種類とファイルの設定

ファイル名に従って一覧ページのテンプレートは選択される。ルールに従ってファイル名を付けることで任意のカテゴリ、タクソノミーごとのテンプレートを指定可能。

: P3（Plugin Performance Profiler）で負荷が高いプラグインを調査し表示スピードアップ！

まずは正確に現状把握を！P3（Plugin Performance Profiler）を使ってプラグインの処理時間を確認！簡単操作で対応すべきプラグインが一目瞭然になります！