Lab Achievements Manager

研究室の業績（論文・発表）をカスタムDBテーブルで管理し，年度・種別フィルタ付きで表示する WordPress プラグイン．

機能一覧

管理画面

フロントエンド（ショートコード）

[lab_achievements] の属性

[lab_awards] の属性

フロントエンドのインタラクティブ機能

• 年度フィルタ: プルダウンで年度を選択して絞り込み
• 種別フィルタ: プルダウンで業績種別を選択して絞り込み
• 受賞のみ表示: チェックボックスで受賞業績だけに絞り込み
• 年度区切りなし表示: チェックボックスで種別のみのフラットなグループ表示に切替
• 年度ページ内リンク: 年度ナビゲーションバーから各年度セクションへジャンプ
• 折りたたみ: 各年度セクションは <details> タグで開閉可能

業績種別とキー

lam_achievement_types() 関数で定義される．配列の順序がそのまま表示順序になる．

カスタマイズ

業績種別の追加・変更

lam_achievement_types() 関数（lab-achievements-manager.php 冒頭）の配列を編集する．

function lam_achievement_types() {
    return array(
        'journal'       => '学術論文',
        'letter'        => 'レター論文',
        'review'        => '解説論文',
        'book'          => '書籍',
        'international' => '国際会議',
        'sig'           => '研究会',
        'others'        => '全国大会・その他',
        'misc'          => '寄稿',
    );
}

• 種別を追加: 配列に '新キー' => '表示ラベル' を追加
• 表示ラベルを変更: 値（日本語部分）を書き換える
• 種別を削除: 対応する行を削除（既存データの achievement_type が残るため注意）

表示順序の変更

表示順序は 2箇所 を揃えて変更する必要がある．

1. lam_achievement_types() の配列順

この配列の定義順がフィルタ UI のプルダウン順序，およびグループ表示時のセクション順序に反映される．

2. SQL の FIELD() 句

ショートコード内の SQL クエリにある FIELD(achievement_type, ...) の引数順を，lam_achievement_types() と同じ順序に揃える． 該当箇所はファイル内に 2箇所ある．

• [lab_achievements] 用: lam_shortcode() 関数内
• [lab_awards] 用: lam_awards_shortcode() 関数内

ORDER BY fiscal_year DESC,
         FIELD(achievement_type,'journal','letter','review','book','international','sig','others','misc'),
         pub_month ASC, sort_order DESC

FIELD() の引数順を変えると，データベースからの取得順が変わる．

各業績のソート順（sort_order フィールド）

同一年度・同一種別内での細かい並び替えには sort_order フィールドを使う．管理画面の「表示順」で設定する．[lab_achievements] では sort_order DESC（大きい値が上），[lab_awards] では sort_order ASC（小さい値が上）で並ぶ．

年度の計算ルール

出版月が 1〜3月の場合，年度は 出版年 - 1 として自動計算される（4月始まりの日本の年度制度に準拠）．管理画面で年度を手動入力した場合はそちらが優先される．

スタイルのカスタマイズ

CSS はプラグイン内の lam_enqueue_frontend() 関数でインラインスタイルとして出力される．主要な CSS クラス：

データベース

プラグイン有効化時にカスタムテーブル {prefix}_lab_achievements が作成される．

CSV フォーマット

インポート時の CSV 列順（ヘッダー行必須）:

achievement_type, authors, title, venue, journal_name, volume, number, pages,
pub_year, pub_month, fiscal_year, is_awarded, award_name, awardee, doi, url, notes, sort_order

• achievement_type は英語キー（journal, book 等）でも日本語ラベル（学術論文, 書籍 等）でも可
• fiscal_year が空の場合，pub_year と pub_month から自動計算される
• エクスポート CSV には id 列が含まれるが，インポート時は無視される

自動アップデート

GitHub Releases を利用した自動アップデートに対応している．WordPress 管理画面の「更新」やプラグイン一覧から，通常のプラグインと同様にワンクリックで更新できる．

仕組み

• GitHub API (/repos/dbym4820/wp_lab_achievement/releases/latest) で最新リリースを12時間ごとにチェック
• リリースタグのバージョンがインストール済みバージョンより新しい場合，WordPress に更新通知が表示される
• アップデーターは管理画面でのみ読み込まれる（フロントエンドには影響なし）

新バージョンのリリース手順

1. lab-achievements-manager.php の 2箇所 のバージョンを更新する
   • LAM_VERSION 定数（例: '1.1.0'）
   • プラグインヘッダーの Version: 行（例: Version: 1.1.0）
2. 変更をコミット & プッシュ
3. GitHub で Release を作成し，タグを付ける（例: v1.1.0）
   • タグは v + セマンティックバージョニング形式（v1.0.0, v1.1.0, v2.0.0 等）
   • Release の本文に変更内容を記載すると，WordPress の「詳細を表示」に changelog として表示される
4. WordPress 管理画面 > 更新 で自動検知される

設定の変更

GitHub リポジトリの情報は lab-achievements-manager.php 冒頭の定数で管理される：

define( 'LAM_GITHUB_OWNER', 'dbym4820' );        // GitHub オーナー名
define( 'LAM_GITHUB_REPO',  'wp_lab_achievement' ); // GitHub リポジトリ名

リポジトリを移行した場合はこれらを変更する．

動作要件

• WordPress 5.0 以上
• PHP 7.0 以上

ライセンス

GPL-2.0+