Cocoonフォーラム

サイト内検索
書き込みの前に以下の3点をご確認ください。
  1. 1つのトピックにつき1つの質問を書き込んでください
  2. 不具合・カスタマイズ対象ページのURLを提示高速化を無効にしてください
  3. 該当部分のキャプチャ・環境情報とともに書き込んでいただけると助かります

何を書き込んだら良いか分からない場合は、以下のテンプレートをコピペしてご利用ください。

不具合・カスタマイズ対象ページのURL:

相談内容:

不具合の発生手順:

解決のために試したこと:

※文字だけでは正しく伝わらない可能性があるため、スクショ画像の添付もお願いします。
※高速化設定をしている場合は無効にしてください。
環境情報:

※↑こちらに「Cocoon設定 → テーマ情報」にある「環境情報」を貼り付けてください。

環境情報の取得方法はこちら。
https://wp-cocoon.com/theme-report/
高速化設定を無効にするにはこちら。
https://wp-cocoon.com/theme-trouble/

フォーラム利用ガイドリンク

  1. フォーラムガイドライン
  2. よくある質問と答え(FAQ)
  3. サポート対象外のケース
  4. 原因不明の不具合用トラブルシューティング
  5. トピックにHTMLを貼り付ける方法(推奨ツール:notepad.pw
  6. 真っ白画面でのエラーメッセージの確認方法
  7. ブラウザ環境チェックツール
  8. Cocoonカスタマイズ依頼

フォーラム質問後、問題等が解決した場合は結果を書き込んでいただけると幸いです。同様の問題で調べている方には、結果が一番気になる部分となります。

このフォーラムには初心者の方も多く参加されています。質問に不慣れな方も安心して相談できるよう、できるだけ穏やかな言葉でご案内いただけますと幸いです。

RSSショートコードのHTML出力部の...
 
通知
すべてクリア

[解決済] RSSショートコードのHTML出力部のテンプレート化

3 投稿
2 ユーザー
1 Reactions
48 表示
大門未知子
(@chu-ya)
Illustrious Member Registered
結合: 4年前
投稿: 4544
トピックスターター  

----------------------------------------------
テーマ名:Cocoon
バージョン:2.9.3.7
カテゴリー数:16
タグ数:13
投稿数:723
固定ページ数:16
ユーザー数:1
----------------------------------------------

●要望

rss ショートコード内のカード出力部分(get_rss_feed_tag 関数内)を、テンプレート(例: tmp/rss-card.php)として切り出してほしい。

https://github.com/xserver-inc/cocoon/blob/f251b7da2774dd986a8cfa9657c35677cdeb1950/lib/shortcodes.php#L814-L938

get_rss_feed_tagの修正コード

https://notepad.pw/share/3t8fic2xd

tmp/rss-card.phpの追加カード

https://notepad.pw/share/8b29w1hje


●カスタマイズする際の課題

既存のrss情報のみで完結する仕様であること理解している。
その上で、以下のカスタマイズを考えたとき、テンプレート化が有効と思え。

1.サムネイル画像の不整合

rss情報には、ogpのようなアイキャッチに該当する情報がない。
そのため、rss ショートコードは、フィード(各item)の本文中(content)にある最初の画像をサムネイルとして抽出している。
結果、該当URLが本来設定しており、 og:image と異なる画像が表示される場合がある。

2.まとめサイト等でのサイト名表示の不整合

「はてなブックマーク」などのまとめサイトのフィードにおいて、オプション site=1 を指定した際、一律でフィード全体のタイトル(channel の title)が出力される。
各記事(item)にはサイト名がないため、og:site_name を反映したい。

https://wp-cocoon.com/community/postid/86109/


●現状の対応方法

現在は get_rss_feed_tag フィルター、またはショートコード属性のキャッシュ時間を引き継ぐために do_shortcode_tag フィルターを利用している。

出力されたHTMLから PHP の DOMDocument を用いて a タグを抽出し、該当URLの OGP 情報を取得した上で、その結果をHTMLへ書き換えて反映している。


●要望の目的

rssカードが出力テンプレート化されれば、子テーマ側から cocoon_part_args__tmp/rss-card と引数フックは利用できるようになる。
これにより、フック経由で OGP 情報(サムネイルや個別のサイト名)を上書きし、カードに結果を反映させることが可能となる。

※DOMDocumentの場合、全HTMLが対象だが、フックの場合、カード単位に必要な情報だけを変更できる。


このトピックは2日前 6回から大門未知子に変更されました

   
わいひら reacted
引用
わいひら
(@yhira)
Illustrious Memberサイト Admin
結合: 8年前
投稿: 18545
 

ご提案いただきありがとうございます。
今回のテンプレート化は大きなリスクもないので早速コードを参考にさせていただき、実装させていただきました。
こんな感じで問題ないでしょうか。
https://github.com/xserver-inc/cocoon/commit/acd56cfecb6cb2dad6e4144571705e79f8f01eb7



   
返信引用
大門未知子
(@chu-ya)
Illustrious Member Registered
結合: 4年前
投稿: 4544
トピックスターター  

----------------------------------------------
テーマ名:Cocoon
バージョン:2.9.3.7
カテゴリー数:18
タグ数:123
投稿数:1753
固定ページ数:13
ユーザー数:1
----------------------------------------------

テンプレート化されていることを確認しました。
本件をクローズとします。


●余談

ネット上にあるCocoonのカスタマイズ記事では、古い手法である「tmp ディレクトリ下のテンプレートファイルを子テーマにコピーして修正する方法」が多く紹介されています。
しかし、Cocoon 2.6.8(2023年10月)で cocoon_template_part フックが組み込まれたため、現在ではわざわざテンプレートファイルをコピーする必要はなくなりました。

また、code_minify_call_back(Cocoonの高速化関数)などを用いて、ページ出力直前のHTML全体を無理やり操作するような必要もないかと思います。

例えば、WordPress標準の do_shortcode_tag フックを使えば、ショートコードが出力する直前のHTMLをピンポイントで操作できます。

同様に script_loader_tag フックを使えば、出力直前のJavaScriptの記述を変更できるため、カルーセル(スライダー)を1枚ごとにスライドさせるような細かなカスタマイズも可能になります。

テンプレートファイルを直接書き換えなくても、このように豊富な「フック」を利用するだけで、現在は随分とスマートにカスタマイズしやすくなっています。



   
返信引用
共有:

問題の解決に至った場合には、トピック冒頭の「解決済み」をクリックしていただけますと幸いです。

また、有用な回答があった場合は返信右下にある「いいね!」もご活用ください。回答者の励みになります。

「いいね!」機能はフォーラム登録者のみが利用できる機能です。

CC BY-ND 2.1)準じていれば(リンクを貼っていただければ)転載も自由です。カスタマイズ記事を書く際にコード等をコピペ利用していただいて構いません。

フォーラムの使い方がよくわからない場合は、テストトピックで自由にテストしていただいて構いません。

最近の書き込みはこちら。

詳細なカスタマイズ依頼をするならこちら。

タイトルとURLをコピーしました