逆引きゴリラ

News
2021/01/12 設定値の解説記事を 2 件追加しました。
  1. ホーム
  2. フック
  3. snow_monkey_oembed_blog_card_loading_template

snow_monkey_oembed_blog_card_loading_template

フックタイプ

フィルターフック

説明

キャッシュが存在しない、または期限切れの場合に表示されるブログカードの表示を変更します。

補足説明

  • 「ブログカード」とは、URL を記述した際に、該当のページを参照し、参照された情報(タイトル・概要・アイキャッチ画像など)やコンテンツを基に、綺麗なデザインでリンク表示する機能です。
  • Youtube の動画や、twitter のツイートなどはカード表示ではなく埋め込み表示となります。
  • ブログカードは、表示のたびに参照先ページの情報を取得すると速度がおそくなったり、参照先のサーバに負荷を与えることになるので、一定時間、取得した情報をキャッシュされるようになっています。
  • HTML 内に .js-wp-oembed-blog-card .js-wp-oembed-blog-card__link のクラスの記述をされていない場合、ただしく動作しない場合があるので注意してください。

引数

引数名タイプ説明
$template文字列(string)表示される HTML 文字列
$url文字列(string)参照先ページの URL

返却値

変数名タイプ説明
$template文字列(string)表示される HTML 文字列

パラメータについて

パラメータの値説明
%1$sURL
%2$starget 属性の値(_self または _blank

サンプルコード

my-snow-monkey.php
<?php

  … 略 …

  add_filter(
    'snow_monkey_oembed_blog_card_loading_template',
    function( $template, $url ) {
      ob_start();
?>
      <div class="js-wp-oembed-blog-card">
        <a class="js-wp-oembed-blog-card__link" href="%1$s" target="%2$s">%1$s</a>
      </div>
<?php
      return ob_get_clean();
    },
    10,
    2
  );