WordPress：「WordPress Popular Posts」にオリジナルのコンテンツタグを追加する方法

コンテンツタグについて

「WordPress Popular Posts」には情報を容易に出力できるコンテンツタグが用意されており、主にプラグインが出力するHTMLをカスタマイズする際に利用するpost_htmlオプションで使用します。
使用する際は{}とパラメータを組み合わせて{xxx}のように記述し、パラメータ部分ではtitleやurlなどあらかじめ用意されているものを記述することでその情報を出力することができます。
例えば<li>{thumb}{title}</li>と記述すれば、リンク付きサムネイルイメージとリンク付きタイトルがli要素で括られて出力されます。

どのようなパラメータが用意されているかはプラグイン有効化後に追加されるページの「パラメーター」最下部にある「post_html」で確認でき、一部紹介すると以下のようなものがあります。

このように頻繁に利用しそうなものはある程度用意されてはいますが、デフォルトでは用意されていないコンテンツタグがほしい場合は、以下で紹介する方法でオリジナルのコンテンツタグを追加することができます。

タグ情報を表示するコンテンツタグを作成

記事に設定されているタグ情報を出力するコンテンツタグを作成してみます。
オリジナルのコンテンツタグを作成する際はwpp_parse_custom_content_tagsというフックを利用して、functions.phpへ下記のように記述します。

functions.php

add_filter( 'wpp_parse_custom_content_tags', 'add_wpp_content_tags', 10, 2 );
function add_wpp_content_tags( $html, $post_id ) {
  if ( false !== strpos( $html, '{tags}' ) ) {
    $tags_html = '';
    $terms = get_the_terms( $post_id, 'post_tag' );
    if ( $terms ) {
      $tags_html = '<span class="post-tags">';
      foreach ( $terms as $term ) {
        $tags_html .= $term->name . ', ';
      }
      $tags_html = rtrim( $tags_html, ', ');
      $tags_html .= '</span>';
    }
    $html = str_replace( '{tags}', $tags_html, $html );
  }
  return $html;
}

上記を記述することで{tags}というオリジナルのコンテンツタグが利用可能になり、これを「WordPress Popular Posts」を呼び出している箇所に記述すれば、各記事のタグ情報が出力されるようになります。
複数のタグが設定されている場合は「タグ1, タグ2, タグ3」という感じでカンマ区切りで出力されるようになっているので、他の区切り文字にしたい場合は該当箇所を任意のものに差し替えてください。
また、ここではget_the_terms()を利用した方法で紹介しましたが、普通にget_the_tags()を利用してget_the_tags( $post_id )とするのでも実装できます。

カスタムフィールドの情報を表示するコンテンツタグを作成

記事に設定されているカスタムフィールドの情報を出力するコンテンツタグを作成する場合は、functions.phpへ下記のように記述します。

functions.php

add_filter( 'wpp_parse_custom_content_tags', 'add_wpp_content_tags', 10, 2 );
function add_wpp_content_tags( $html, $post_id ) {
  if ( false !== strpos( $html, '{cf}' ) ) {
    $cf_html = '';
    $cf = get_post_meta( $post_id, 'example', true );
    if ( $cf ) {
      $cf_html = 'Example Value: ' . $cf;
    }
    $html = str_replace( '{cf}', $cf_html, $html );
  }
  return $html;
}

上記を記述することで{cf}というオリジナルのコンテンツタグが利用可能になり、これを「WordPress Popular Posts」を呼び出している箇所に記述すれば、「example」というカスタムフィールドに登録された情報が出力されるようになります。