サイト内検索
Cocoonフォーラム
書き込みの前に以下の3点をご確認ください。
何を書き込んだら良いか分からない場合は、以下のテンプレートをコピペしてご利用ください。
不具合・カスタマイズ対象ページのURL:
相談内容:
不具合の発生手順:
解決のために試したこと:
※文字だけでは正しく伝わらない可能性があるため、スクショ画像の添付もお願いします。
※高速化設定をしている場合は無効にしてください。
環境情報:※↑こちらに「Cocoon設定 → テーマ情報」にある「環境情報」を貼り付けてください。
環境情報の取得方法はこちら。
→ https://wp-cocoon.com/theme-report/
高速化設定を無効にするにはこちら。
→ https://wp-cocoon.com/theme-trouble/
フォーラム利用ガイドリンク
- フォーラムガイドライン
- よくある質問と答え(FAQ)
- サポート対象外のケース
- 原因不明の不具合用トラブルシューティング
- トピックにHTMLを貼り付ける方法(推奨ツール:notepad.pw)
- 真っ白画面でのエラーメッセージの確認方法
- ブラウザ環境チェックツール
- Cocoonカスタマイズ依頼
フォーラム質問後、問題等が解決した場合は結果を書き込んでいただけると幸いです。同様の問題で調べている方には、結果が一番気になる部分となります。
このフォーラムには初心者の方も多く参加されています。質問に不慣れな方も安心して相談できるよう、できるだけ穏やかな言葉でご案内いただけますと幸いです。
通知
すべてクリア
トピックスターター 2026年3月21日 13:23
----------------------------------------------
テーマ名:Cocoon
バージョン:2.9.0.11
カテゴリー数:18
タグ数:123
投稿数:1748
固定ページ数:12
ユーザー数:1
----------------------------------------------
処理が重複し複雑な動作をしており、流れを理解するのに一苦労かと思います。
●設定
- 投稿にアイキャッチを設定しない。投稿の該当カテゴリーにアイキャッチを設定。
- カスタム投稿にアイキャッチを設定しない。
●現象
ナビカードにカスタム投稿を設定した。
本来、ナビカードはNO IMAGEとなるが、以下の場合、投稿が属するカテゴリーのアイキャッチが表示される。
- 投稿一覧の1番目に上記設定の投稿がある場合
- その投稿ページを開いた場合
●発生のアルゴリズム
ナビカードのサムネイルはget_navi_card_image_url_attributesで設定される。
カスタム投稿にアイキャッチがないので画像URLにNO IMAGEが設定される。
ナビカードはget_widget_entry_card_link_tagでカードが作成される。
このとき、アイキャッチがないため、get_widget_entry_card_no_image_tagが呼ばれる。
ここでNO IMAGE画像URLが再設定しようとする。
このとき、フルターフックget_sized_no_image_urlでカテゴリーに画像があるか処理される。
ここで、$id = null、$is_singular = falseとなり、一覧の場合は先頭の投稿(アイヤッチがない投稿)のアイキャッチ画像が再設定されてしまう。
●対策
ナビカードの場合、以下でサムネイル画像を組み立てている。
そのため、以下の処理が不要???????
わいひら reacted
トピックスターター 2026年3月21日 13:37
●追記
上記でfalse固定ではなく、投稿・固定ページ、カスタム投稿の時はtrueにし、get_categorized_no_image_urlでタクソノミーのアイキャッチを反映させる。
わいひら reacted
2026年3月21日 23:03
内容が結構複雑で僕が間違った捉え方をしていたら申し訳ありません。
こんな感じの修正ということであっていますでしょうか。
https://github.com/xserver-inc/cocoon/commit/137cc766d7043a3a527be751878c84e8a912f87a
そのため、以下の処理が不要???????
こちらに関しては、全削除するとアイキャッチ設定済みの正常な記事までWordPress標準の画像最適化(srcset等)が外れてしまい、表示パフォーマンスが悪化する可能性があるため残しました。
トピックスターター 2026年3月22日 01:03
@yhira さん
----------------------------------------------
テーマ名:Cocoon
バージョン:2.9.0.12
カテゴリー数:18
タグ数:123
投稿数:1748
固定ページ数:12
ユーザー数:1
----------------------------------------------
投稿・固定ページ、カスタム投稿の場合
- アイキャッチがある場合
imgタグの組み立てをget_the_post_thumbnailに任せserect属性などを付与する。 - アイキャッチがない場合
既にget_navi_card_image_url_attributesでサムネイル(NO IMAHGEを含め)の組み立てができているため、get_navi_entry_card_thumbnail_tagでimgタグを出力する。
get_widget_entry_card_no_image_tagを止めたことで上記指摘の問題は解決しています。
●クラスno-mageで仕様の不一致
以下でカテゴリーのとき、クラスcategory-imageが付与され、またアイキャッチがない場合、クラスno-imageが付与される。
しかし、タグ、カスタムリンク(カテゴリー、タグ)でアイキャッチがない場合、no-imageが付与されない。
ナビカード、おすすめカードは多くの情報をカード表示するため、複雑であり上記は不要では?
トピックスターター 2026年3月22日 01:09
●ナビカードのメニューの仕様
以下に仕様を纏めます。
[外観]→[メニュー]でメニューを作成する。
マニュアルには以下の注記がある。
現在のところ、「投稿」と「固定ページ」と「カテゴリー」と「タグ」ページにしか対応していません。
https://wp-cocoon.com/navi-card-shortcode/#toc2
ナビカード(メニュー項目)の画像出力は以下となっている。
固定ページ / 投稿
設定されているアイキャッチ画像を表示。
未登録時は、所属する「カテゴリー」や「タグ」のアイキャッチを補完。
カテゴリー / タグ
ページに設定されたアイキャッチ画像を表示。
カスタムリンク
特定のURLのみ対応。
- 対応
カテゴリーURL
タグURL - 未対応
投稿、固定ページ、カスタム投稿URL
カスタムタクソノミーURL
外部リンクURL
カスタム投稿
設定されているアイキャッチ画像を表示。
未登録時は、所属する「カテゴリー」や「タグ」のアイキャッチを補完。
カスタムタクソノミー
未対応。
トピックスターター 2026年3月22日 10:12
●クラスno-mageの付与の削除
投稿でアイヤッチがない場合、no-imageクラスを付与している。
しかし投稿の場合、カテゴリー、タグのアイキャッチを補完する機能があるため、NO IMAGE画像が表示されるとは限らない。
同じことが新着記事にも言えるが、no-imageクラスが付与することはない。
結果、不要と思います。
トピックスターター 2026年3月22日 10:22
●カスタムリンク改善案
以下のコードでカスタムリンクでも正しくサイムネイル表示されるかと思います。
カスタム投稿についても、get_categorized_no_image_urlで補完されるため、カスタムリンクURLをIDに変換し渡せばよく。
カテゴリー、タグで区別していましたが、これを止め、タクソノミーとして扱います。
https://notepad.pw/share/bc03kljoc
2026年3月23日 00:05
ご指摘ありがとうございます。
●クラスno-mageで仕様の不一致
こちらは不要と考え、削除させていただきました。
https://github.com/xserver-inc/cocoon/commit/c23e84f2759609ec84337de13ba622f321ae19d8
今回提案いただいた内容をもとに、とりあえず以下の部分だけ変更させていただきました。
https://github.com/xserver-inc/cocoon/commit/c23e84f2759609ec84337de13ba622f321ae19d8
カテゴリー、タグで区別していましたが、これを止め、タクソノミーとして扱います。
上記に関しては次のような懸念点があったので、一旦見送らせていただきました。
- 子カテゴリなどの階層URLが解決できなくなる問題
提案いただいた url_to_taxonomy_object の正規表現と get_term_by('slug', ...) の組み合わせでは、URLの末尾スラッグのみでの判定となるため、例えば /category/parent/child/ のような「階層構造を持つカテゴリーURL」が正しく解決できなくなる恐れ - タクソノミー取得処理の負荷(url_to_taxonomy_object)
提案していただいた関数では、get_taxonomiesで全公開タクソノミーを取得し、それぞれに対して正規表現でマッチングを行う仕組みでした。ナビカードにカスタムリンクが多数配置されていた場合、「メニュー項目数 × カスタムタクソノミー数」分の正規表現ループが毎回実行されるため、負荷的観点
上記の理由で、今回は既存関数の統合による影響のない範囲での対応に留めさせていただきました。
トピックスターター 2026年3月23日 01:08
カスタムタクソノミー保留の件、了解しました。
しかし、カスタムリンクの場合、以下に投稿・固定ページ、カスタム投稿ページは追加しましょう(笑)。
// 投稿・固定ページ・カスタム投稿ページ
$object_id = url_to_postid($url);
if ($object_id > 0) {
$thumbnail_id = get_post_thumbnail_id($object_id);
$image_attributes = wp_get_attachment_image_src($thumbnail_id, $thumb_size);
$object = get_post_type($object_id);
$is_singular = true;
}
if (!$image_attributes) {
//カテゴリーページのアイキャッチを取得
}
}
●ナビカードの制約
上記の追加により、「カスタムリンクにカスタムタクソノミーのみ入力してもサムネイルは表示されません。」だけとなります。
2026年3月23日 23:48
しかし、カスタムリンクの場合、以下に投稿・固定ページ、カスタム投稿ページは追加しましょう(笑)。
これは僕も見てはいたのですが今回色々調べていて、使用されている url_to_postid() という関数は、WordPressの仕組み上、URLを内部で総当たり解析してデータベースに問い合わせるため、結構システム負荷がかかる関数のようです。
ナビカードは多くの方がすべてのページに表示されることが多いため、もしカスタムリンクが複数並んでいた場合に、記事を見るたびに重い処理が連続で走ってサイト全体の表示速度が落ちてしまうリスクがあり、どうしようかと考えていました。
で結局、キャッシュを使うことにしました。キャッシュのほうがはるかに負荷が少ないので。
https://github.com/xserver-inc/cocoon/commit/9cde24a35402304792a689e76abcbd78db69a38b
ちなみに、url_to_postid()は、Cocoonのブログカード機能でも使用しており、そっちもキャッシュ対応させることにしました。今回、良い気づきになりました。
トピックスターター 2026年3月24日 00:19
----------------------------------------------
テーマ名:Cocoon
バージョン:2.9.0.12
カテゴリー数:18
タグ数:123
投稿数:1748
固定ページ数:12
ユーザー数:1
----------------------------------------------
カスタムリンクで、カスタムタクソノイミー以外サポートされていることを確認しました。
本件をクローズとします。
カスタムリンクで投稿・固定ページ、カテゴリー・タグを設定することはまずないと思います。
しかし既存で、カテゴリー・タグでのカスタムリンクがサポートされており。
投稿・固定ページが未サポートなのは中途半端と思いいたので、提案させていただきました。
マニュアルに制約とし記し、仕様として割り切りも必要かと思います。
わいひら reacted
2026年3月24日 22:03
ご確認いただきありがとうございます!
カスタムリンクの仕様に関する検証結果も感謝いたします。マニュアルへの追記など、今後の参考にさせていただきます。
問題の解決に至った場合には、トピック冒頭の「解決済み」をクリックしていただけますと幸いです。
また、有用な回答があった場合は返信右下にある「いいね!」もご活用ください。回答者の励みになります。
(CC BY-ND 2.1)準じていれば(リンクを貼っていただければ)転載も自由です。カスタマイズ記事を書く際にコード等をコピペ利用していただいて構いません。
フォーラムの使い方がよくわからない場合は、テストトピックで自由にテストしていただいて構いません。
最近の書き込みはこちら。
詳細なカスタマイズ依頼をするならこちら。





