WordPressの投稿一覧画面をカスタマイズして本文やサムネイルなどのカラムを追加する方法

WordPressの投稿一覧にサムネイルや本文の抜粋などを表示できたらもっと使いやすくなるのに・・・と思う人もいるかと思います。

今回はWordPressの投稿一覧画面をカスタマイズして本文の抜粋やサムネイルなどのカラムを追加する方法をご紹介します。

また、Advanced Custom Fieldsを使って追加した値も表示することが可能です。

必要スキルレベルはPHPを必要になってきます。

と言ってもサンプルコードを用意しますので、それを参考にすれば対応は可能です。

投稿一覧画面にカラムを追加する手順

投稿の一覧や、自分で追加したカスタム投稿タイプの一覧に新たにカラムを追加する場合には function.php というPHPファイルを編集する必要があります。

function.php は、お使いのWordPressテーマのディレクトリ内にあります。

カラムを追加する

まず、何のカラムを追加するかを定義します。

引数の $columns には表示するカラムのリストが入っており、これに新たに表示するカラムを追加して戻り値として return で返す処理になります。

function manage_posttype_columns($columns) {
	$columns['column_name'] = "カラム名";
	return $columns;
}
add_filter( 'manage_edit-posttype_columns', 'manage_posttype_columns' );

function manage_posttype_columns($columns) {

$columns['column_name'] = "カラム名";

return $columns;

}

add_filter( 'manage_edit-posttype_columns', 'manage_posttype_columns' );

3行目の $columns[‘column_name’] = “カラム名”; の column_name は追加するカラム名の英語名を入れます。

正確な英語である必要はないですが、なんのカラムか分かり、他のカラムと重複しないようにしてください。

カラム名 には実際に一覧に表示するカラム名を書きます。

関数名の manage_posttype_columns は別の名前でもいいですが、posttype部分をどのポストタイプの一覧に追加するか書き換えて同様の関数名を作成すると後で分かりやすいです。

例えば「投稿」の場合は投稿タイプが「post」になるので manage_post_columns() のようにします。

新着情報(news)というカスタム投稿を作成した場合は、 manage_news_columns() のようにしておけば後で分かりやすいですね？

そして最後の行の manage_edit-posttype_columns の、posttype は正確な投稿タイプに書き換えてください。

例えば「投稿」の場合は manage_edit-post_columns で、新着情報(news)の場合は manage_edit-news_columns になります。

この対応は必須になります。

カラムのコンテンツを追加する

次に、実際に表示する値を取得し出力する処理です。

値の取得には manage_posts_custom_column というアクションフックを使います。

これは、不明なカラムがあった場合に実行されるフックです。

自前でカラムを追加しているのでこれに当てはまりますね。

function add_posttype_column($column_name, $post_id) {
	if ($column_name == 'column_name') {
		$v = get_post_meta($post_id, 'meta_name', true);
	}
 
	if (isset($v) && $v) {
		echo attribute_escape($v);
	} else {
		echo __('None');
	}
}
add_action( 'manage_posts_custom_column', 'add_posttype_column', 10, 2 );