案件管理、物件情報、会員名簿、備品の貸出記録。こういうものをWordPressで扱おうとすると、まず出てくるのが「専用の管理画面を作りますか」という話です。ところが実際の現場で必要なのは、たいてい一覧で全件を見て、絞り込んで、並べ替えて、担当を書き込むことだけです。それなら投稿一覧の画面を作り替えるほうが早く、安く、壊れにくい。標準の一覧画面はタイトルと日付しか出ませんが、この列は差し替えられます。ここでは、投稿一覧を業務の台帳として使えるところまで作り替える手順と、そのあとの運用で効いてくる注意点を書きます。
専用画面を作る前に、一覧でどこまで届くか
独自のテーブルを用意して、メニューを追加して、一覧表示のクラスを継承して、検索と並べ替えとページ送りを自分で書く。これが専用画面を作る場合の最小構成です。動くものはできますが、作るものが増えるほど、WordPress本体の更新に追随する範囲も増えます。
一方、投稿一覧を使う場合は、検索もページ送りも一括操作もWordPressが最初から持っています。差し替えるのは表示する列だけです。データはカスタム投稿タイプとカスタムフィールドで持ちます。この構成なら、担当者が普段見ている管理画面の中に台帳が増えるだけなので、使い方の説明もほとんど要りません。
専用画面が要るのは、データの件数が数万件を超えて投稿テーブルに入れたくない場合、あるいは投稿という単位に馴染まない構造を持つ場合です。この線引きは権限ごとに見える画面を変える、WordPressの管理画面の作り込みのほうでも触れています。
差し替えるのは3か所
列の作り替えは、フィルタとアクションを3つ書くだけで終わります。列の見出しを定義する場所、各行の中身を描く場所、並べ替えを有効にする場所。この3つです。
add_filter('manage_bukken_posts_columns', function ($columns) {
unset($columns['date']);
$columns['status'] = '進行状況';
$columns['tantou'] = '担当';
$columns['kigen'] = '期限';
return $columns;
});
add_action('manage_bukken_posts_custom_column', function ($column, $post_id) {
if ($column === 'kigen') {
echo esc_html(get_post_meta($post_id, 'kigen', true));
}
}, 10, 2);1つめの関数名に含まれる bukken の部分が、カスタム投稿タイプのスラッグです。ここを間違えると何も起きません。列の並び順は返す配列の順番そのままなので、チェックボックスとタイトルを先頭に残したいなら、その2つを消さずに後ろへ足していきます。unset で日付列を消しているのは、業務台帳では投稿日より期限のほうが重要になることが多いためです。
3つめが並べ替えです。manage_edit-bukken_sortable_columns で列を並べ替え可能として宣言し、実際の並び順は pre_get_posts で決めます。カスタムフィールドで並べ替えるときは meta_key の指定に加えて、日付や数値なら meta_type も指定しないと文字列として並びます。「10」が「9」より前に来るのはここが原因です。
絞り込みが付いて、ようやく台帳になります
列を足しただけでは一覧が横に広くなっただけです。実務で使えるようになるのは、絞り込みを付けたときです。一覧の上部にプルダウンを置くには restrict_manage_posts を使い、選択された値を受けて pre_get_posts で条件を足します。
ここで一手間かけておくと後が楽になります。絞り込みの選択肢をコードに直接書かず、配列として一箇所にまとめておくことです。運用が始まると「進行状況にもう1つ足したい」という要望が必ず出ます。定義が一箇所にまとまっていれば、追記だけで終わります。同じ考え方で、管理画面のダッシュボードから消したいウィジェットを扱った案件がありました。非表示にする対象をIDのリストとして定義する形にしておいたところ、後から7項目の追加要望が来てもリストに追記するだけで済んでいます。最初にリスト化しておくかどうかで、その後の改修が数分か数時間かに分かれます。
| やりたいこと | 使うもの | 注意点 |
|---|---|---|
| 列を足す・消す | manage_{投稿タイプ}_posts_columns | 投稿タイプのスラッグを間違えると無反応。エラーも出ない |
| 列の中身を描く | manage_{投稿タイプ}_posts_custom_column | 出力前に必ずエスケープする。ここは管理画面でもHTMLがそのまま出る |
| 並べ替えを有効にする | manage_edit-{投稿タイプ}_sortable_columns と pre_get_posts | 数値・日付は meta_type を指定しないと文字列順になる |
| 絞り込みを付ける | restrict_manage_posts と pre_get_posts | 管理画面かつ本体クエリのときだけ動くよう条件を付ける |
| 行ごとの操作を足す | post_row_actions | 更新を伴う操作はリンクではなく、確認を挟む形にする |
| 権限で出し分ける | current_user_can() | 表示を消すだけでは制御にならない。処理側でも判定する |
pre_get_posts は管理画面と公開側の両方で走ります。条件を付けずに書くと、サイトのトップページの記事一覧まで巻き添えで並び替わります。管理画面であること、そのページの本体クエリであることの2つを確認してから中身を実行してください。
見せる相手ごとに、見えるものを変える
台帳として使い始めると、次に出てくるのが「この人にはこの列を見せたくない」という話です。金額、原価、個人情報の項目がそれに当たります。
列の定義を返す関数の中で権限を判定して、条件に合わなければその列を配列に足さない。これが基本です。ただし、一覧から列を消しても、編集画面を直接開けば値は見えます。表示を消すことと、アクセスを止めることは別の作業です。編集画面側の項目も同時に閉じるか、そもそもその権限では編集画面を開けないようにする必要があります。
アクセス解析系のプラグインが管理画面に出す表示を、特定の権限のユーザーには見せないようにした案件がありました。このときは管理画面の表示を制御するプラグインを使っています。そのプラグインの設定画面には対象の項目が選択肢として出てこなかったのですが、ブラウザの検証ツールで対象要素のidを調べて直接指定したところ、非表示にできました。設定画面の一覧に出てこないから無理、とは限りません。結果としてコードを1行も書かずに終わっています。
ただしこの方法には弱点があります。プラグイン側が更新されて要素のidが変わると、指定が効かなくなって表示が復活します。プラグインを更新したあとは、管理画面の見え方を確認してください。コードを書かない解決は速い代わりに、他人のマークアップに依存します。
実際に作った台帳と、そこで起きたこと
不動産の物件情報を扱っているサイトで、各物件に「情報更新日」と「次回更新予定日」を出したいという相談を受けたことがあります。条件は、担当者が管理画面を触らずに日付が自動で進むことでした。
実装の要点は日付の計算方法です。「投稿日に一定日数を足す」では、公開から数か月経った物件で必ず過去の日付になります。使ったのは、投稿日から現在までを一定間隔で進めて、直近で到来した分を採る方法です。get_post_time() で起点を取り、strtotime() で刻んでいきます。これなら何か月前の記事でも、常に直近の更新日として表示されます。
作業のなかで効いたのが、間隔の日数を変数として切り出し、その変数名を伝えておいたことでした。あとから「間隔を変えたい」となったときに、依頼せずに数字を書き換えるだけで済みます。台帳系の作り込みでは、運用が始まってから必ず調整が入ります。変わりそうな値をコードの奥に埋め込まず、上のほうにまとめて名前を伝えておくと、その調整が有償の往復になりません。
失敗もしています。変更後のファイルをFTPで上げたつもりで実際には転送に失敗しており、案内した変数がソースに無いと指摘されました。それ以来、案内を送る前にFTPで再接続してファイルのタイムスタンプと該当行を目で見る手順を入れています。もうひとつ、この案件は子テーマの single.php を直接編集する形でした。親テーマが更新されて構造が変わると、追従が必要になります。テーマの更新を止めない運用にするなら、テンプレートの直接編集は最小限にして、フック経由で足せるものはそちらへ寄せたほうが後が楽です。
どのフックに書いたか、その1行を残していなかった案件
作り込みの記録を残してください。どのファイルの、どのフックに書いたか。この1行があるかないかで、次の改修の初動が変わります。管理画面の作り込みは見た目に残らないため、半年後に「どこで制御しているか分からない」となりがちです。実際、ウィジェットの表示制御を実装した案件で記録が残っておらず、同種の追加依頼が来たときに調査からやり直しになったことがあります。
それと、複数のアカウントが使う台帳では、確認は必ずアカウントごとに行ってください。権限の設定は反映のタイミングやキャッシュの影響で、アカウントによって見え方がずれることがあります。片方のアカウントで確認して終わりにすると、別のアカウントでだけ列が出ていない、という報告が後から来ます。確認したアカウントを明示して、他のアカウントでも見てもらう形にすると、ずれが出たときの切り分けが1往復で済みます。
データの入り口をどう作るかも早めに決めておく価値があります。管理画面から入力するのか、外部から取り込むのか、公開側のフォームから受けるのか。フォームから受ける場合の作りは確認画面つきの問い合わせフォームを自作するか、プラグインか、ログインを伴う場合はWordPress標準ユーザーを使わずに会員認証を作った理由のほうに書いています。
よくある質問
件数はどのくらいまで耐えられますか
数千件までは、標準の一覧のままで実用に耐えます。問題になるのは件数そのものより、カスタムフィールドで並べ替えや絞り込みをかけたときの負荷です。メタ情報のテーブルを結合することになるため、条件が増えるほど一覧の表示が重くなります。数万件を扱う予定があるなら、最初から独自テーブルを検討したほうがよく、判断が難しければ、扱う件数と検索したい項目の数を出してもらえれば見当をつけられます。
プラグインで似たことができませんか
できます。列の追加や管理画面の要素の制御を設定画面から行えるプラグインは複数あります。設定で足りるならそちらが先です。コードを書かなければテーマ更新時の互換性を気にする必要も、レビューの手間もありません。切り替える基準は、条件分岐が必要になったときです。権限や状態によって表示を変える、値を計算して出す、といった要件が入った時点で、設定画面では届かなくなります。
作り込んだ管理画面は、WordPressの更新で壊れませんか
一覧のフックは長く維持されている部分なので、更新で急に無くなる可能性は低いほうです。壊れやすいのはむしろ、他のプラグインのマークアップに依存した指定や、テーマのテンプレートを直接書き換えた部分です。更新のたびに全部を確認するのは現実的ではないので、台帳として使っている一覧を1画面だけ開いて、列が出ているか、絞り込みが効くかを見る。この程度の確認を定期作業に入れておけば十分です。保守プランではこの種の確認を更新作業と一緒に行っています。
専用画面を作るか、一覧を作り替えるかは、扱う件数と検索したい項目で決まります。今どんな情報を何で管理しているかを教えていただければ、どちらで組むのが妥当かをお伝えできます。