BLOGS
この記事はa-blog cms Advent Calendar 2025 の23日目の記事です。
https://adventar.org/calendars/11394
a-blog cms を Ver.3.1 から 3.2 にアップデートしたら、なぜかサムネイルが表示されなくなりました。
しばらくハマってしまったので、その解決方法をまとめます。
- OGPをサムネイルとして表示していた
- 特別カスタマイズしていない
- 3.1では問題なくサムネイルが表示されていたが、3.2にアップデートしたら表示されなくなった
公式ドキュメント「下位互換性のない変更点」
Ogpモジュールの画像のエントリーのカスタムフィールド名のデフォルト値を ogp_image から entry_main_image に変更しました。
https://developer.a-blogcms.jp/document/migration/302x/incompatible.html
公式ドキュメント「下位互換性のない変更点」より
どうやらVer.3.2.x にアップデートするとOGP の画像フィールド名が entry_main_image に変わってしまい結果としてサムネイルが表示されなくなるということらしいです。
解決メモ
従来使用していたフィールド名 ogp_image を前提とした挙動に戻す
ポイントは、テーマではなく js/config.js に書かれている setMainImageMark の設定です。
config.js に書かれている setMainImageMark の設定
ここで指定されているクラス名 js-block-editor-set-main-image を、テーマ内の admin/entry/field-seo.html にあるOGP画像の値を保持するための input 要素のクラスに付与します。
js-block-editor-set-main-imageを記載する場所
さらに、モジュールの表示設定でメインイメージをカスタムフィールドに変更し、ogp_image を指定すれば、サムネイルが表示されるようになります。
モジュールの表示設定
今回の解決方法は、実は勉強会で教えてもらいました。
「ちょっと分からない」「ここで詰まった」という方は、ぜひ一度 a-blog cms の勉強会に参加してみてください。