この記事は最終更新日から2年以上経過しています。

a-blog cms 管理画面の記事一覧ページで絞り込み条件を追加する

公開日:

更新日:

スタッフブログ

a-blog cmsは管理画面もa-blog cmsのテンプレート記述で作られていますので比較的簡単にカスタマイズが可能です。
themes/system以下のファイルを自身のテーマの同階層へコピーして修正すると修正内容が反映されます。

しかし、管理画面のカスタマイズはアップデート時の新機能や修正パッチの反映漏れなどに繋がりますのでカスタマイズの際はメンテナンスの注意が必要です。

カスタマイズ例

例えば管理画面の記事一覧ページにカスタムフィールドの値で絞り込み条件を追加したい場合は該当箇所にField_Searchモジュールを追加すると可能です。

URLでいうとこちらのページ&画面

http://localhost/bid/1/admin/entry_index/

では次の画像のような「値:my_valueフィールド」を検索に追加してみたいと思います

修正するファイルはこちらです。
次のファイルを自分のテーマにコピーして修正してださい。

themes/system/admin/_lauyput/entry/index.html
↓(コピー)
themes/my_themes/admin/_lauyput/entry/index.html

今回は46行目あたりにある.acms-admin-filter-groupに追加したいと思います。
次のコードを.acms-admin-filter-groupの中の一番上に追加してみてください。

<div class="acms-admin-filter-group">
  <p class="acms-admin-filter-label">分類</p>
  <div class="acms-admin-filter-content">
    <!-- BEGIN_MODULE Field_Search -->
    <div class="acms-admin-filter-item">
      <select name="my_value">
        <option value=""<!-- BEGIN_IF [{my_value}}/em] --> selected="selected"<!-- END_IF -->>値</option>
        <option value="item1"{my_value:selected#item1}>値1</option>
        <option value="item2"{my_value:selected#item2}>値2</option>
        <option value="item3"{my_value:selected#item3}>値3</option>
      </select>
      <input type="hidden" name="field[]" value="my_value">
    </div>
    <!-- END_MODULE Field_Search -->
  </div>
</div>

いかがでしょう。カスタムフィールドの絞り込みが追加可能になったと思います。

冒頭でも触れましたが、systemテーマの上書きの仕組みを利用すれば管理画面のカスタマイズ可能です。 しかしこの仕組みは強力ですので手を入れすぎるとアップデートが出来ないなどの問題が発生します。
とはいえカスタマイズしないといけない場合もあると思いますので最小限に抑えるのが良いと思います。

管理画面をカスタマイズしたい場合に参考にしてみてください。

この記事をシェアする

関連記事

この記事のハッシュタグ #a-blog cms から関連する記事を表示しています。

a-blog cmsで使えるTwigフィルター

この記事はa-blog cms Advent Calendar 2025&nbsp;の2日目の記事です。11月の a-blog cms Training Camp 2025お疲れ様でした!今回、Twigのフィルターと a-blog cms の校正オプションについて発表させていただきました。Twig が使えるようになったことで、フィルターを校正オプションのように扱うことも可能になりました。Twig 側で公式に用意されているフィルターは全部で58種類あり、そのうち a-blog cmsで使用できるのは約39種類です。登壇資料ではすべての詳細をお伝えしきれなかったため、a-blog cmsで利用可能なTwigフィルターの使い方と使用例を、あらためてまとめてみました。公式では58種用意されている実際にa-blog cmsで使えるのは39種(既存の校正オプションとの重複を含む)Twigのフィルターはこちらから参照できます。まずは概要a-blog cm v3.2からテンプレートエンジンTwigが利用可能になりました。a-blog cmsには校正オプションというTwigのフィルターと同様の機能があります。Twigが利用可能になったことでTwigフィルターの機能も使えるようになります。従来の校正オプションも引き続き利用できますが、同名のフィルターはTwig側が優先されます。既存の校正オプションを使いたい場合は、acms_ プレフィックスを付けて明示的に使用しましょう。一方で、twig/string-extraパッケージなどTwig本体を拡張して追加するフィルターは利用できないようです。もし拡張フィルターに近い機能が必要な場合は、校正オプションの拡張として同様の処理を実装するのが良さそうです。拡張も今まで通り校正オプションの拡張でいけるそうです。

スタッフブログ

Training Camp後、セッションを振り返る

こんにちは。今年もAdvent Calendarの時期がやってきました。 この記事は a-blog cms Advent Calendar 2024 の9日目の記事です。 よろしくお願いします! 先月、ベースキャンプ名古屋にて「a-blog cms Training Camp 2024」が開催されました。久々のリアルでお会いできた人も多く懐かし楽しかったです! 僕は事例紹介のセッションで構築したサイトで使用したカスタマイズ方法をご紹介しました。 本記事では、a-blog cms Training Camp 2024で次のバージョンの機能を聞いた内容を取り込みつつ、事例紹介のセッション一部を振り返ってみたいと思います。 1.カスタムユニットフィールドグループを開閉させる カスタムユニットフィールドグループは繰り返しの情報が登録できて便利ですが 情報が多くなってくるとどうしても長くなってしまい順番の入れ替えが大変だったりします。 そこで、管理画面をスッキリさせ、編集がしやすいカスタムフィールドの実装方法を紹介しました。 カスタムフィールドメーカーで作成した場合、tr.sortable-item の td にある table に「details と summary」を追加します。 2箇所追加する必要があり、最初の箇所にはタイトルなどを入れておくと、閉じた状態でも内容がわかりやすくなります。 ← 追加 {titleのカスタムフィールド名} ← 追加 ← 追加 ... ← 追加 保存されていません ← 追加 ← 追加 ... 2.ユニットグループで画像のサイズを揃える ユニットは画像を一括で登録できて便利なのですが、画像のサイズがバラバラの場合は、デコボコになってしまいます。 アップロードする画像やユニットのサイズで調整したできますが、少し手間がかかってしまいます。 そこで、簡単に画像サイズを揃える方法を紹介しました。 管理画面の「編集設定」から、ユニットグループにクラスとラベルを追加します。 例えば次のように設定します。 クラス: acms-col-md-4 is-acms-col-gallery ラベル: 画像ギャラリー 次に、CSSに以下のクラスを追加します。 その後、エントリーのユニットグループで「画像ギャラリー」を選択すればOKです。 .is-acms-col-gallery [class*=column-media] { margin-bottom: var(--var-scale-1); } .is-acms-col-gallery img { aspect-ratio: 3/2; object-fit: cover; } 3.管理画面のカスタムーフィールド選択項目をわかりやすくする 管理画面で選択する際にテキストだけだと変更した場合の表示イメージが想像しづらいです。 その場合、変更後をイメージできる画像を設置するだけでもグッとわかりやすくなります。 ← 追加 背景画像 ← 追加 ... まずカスタムフィールドでチェックボックスを準備します。 その後、親に`.custom-radio-box`というクラスを追加して装飾をしています。 4.同じコードを繰り返し書くのが大変な時は「includeで変数を渡す」 大部分が同じコードはinclude文を使用して変数を渡すことで効率的に再利用できます。 例えば、次のような「○△×」など選択するフィールドを作成したい場合、そのまま書くと1月から12月までパターンを3つ書く必要があり大変な作業となります。 しかし、コードの中身を見るとカスタムフィールドの値が違うだけで大部分のコードは同じとなっていました。 この場合、インクルード文を使用してデータを受け渡すことで作成可能です。 このように重複したコードは、データを表示するテンプレートと値を渡すテンプレートに分けることで簡潔にまとめることができます。 ですが、これも今のバージョンの話、バージョン3.2からはテンプレートエンジンとしてTwigが導入予定ですのでよりプログラム風にコードを書くことができます。 Twigで書き直すとこのようになります。かなり省略できますね。 ソースコードも短くなりファイル間のデータ受け渡しも不要になりました。 今回Twigに書き直したコードは少し複雑ですが、もっと簡単に気軽に使えますので、ぜひ導入してみてください。 以上、「a-blog cms Training Camp 2024」の内容を含め発表した内容をまとめてみました。 また来年キャンプでお会いしましょう!

スタッフブログ