Cocoonでカスタム投稿タイプのパンくずリストをカスタマイズする方法

Cocoonでカスタム投稿タイプのパンくずリストをカスタマイズする方法

Cocoon v2.8.5でついに「カスタム投稿タイプのパンくずリスト」に正式対応しました。

あわせて、カスタムタクソノミーのカテゴリーラベル表示にも対応したようです。

カスタム投稿タイプのパンくずリスト対応は過去の記事で紹介しておりましたが、今回の正式対応によりこのままアップデートするとパンくずリストが2つ表示されてしまうという不具合が生じます。

ありがたいことに過去の記事を参考にしてくださった方も多かったようなので、今回、内容を最新版に合わせて見直しました。

今回のカスタマイズ内容は以下の通り。

  • アーカイブページでもパンくずリストを表示させる
  • パンくずリストに「カスタム投稿タイプの階層」を追加する
  • アーカイブページの「Archive」を任意のタイトルにする

内容自体は以前と変わっていませんが、コードがかなり簡略化されており、限りなく最小限の編集になるように工夫しています。

一部過去の記事と被っている箇所もありますが、よかったら参考にしてください。

目次

完成形がこちら

※CSSで独自のカードタイプにしています。

カスタム投稿タイプのアーカイブページで、パンくずリストが表示されています。

Cocoonでカスタム投稿タイプのパンくずリストとカテゴリ表示
カスタム投稿タイプのアーカイブページ

タクソノミーアーカイブページでは、「カスタム投稿タイプの階層」を追加。

  • デフォルト:ホーム > タクソノミー
  • カスタム後:ホーム > カスタム投稿タイプ > タクソノミー
Cocoonでカスタム投稿タイプのパンくずリストとカテゴリ表示
新規をクリックした状態

同じく、投稿ページのパンくずリストも問題ありません。

Cocoonでカスタム投稿タイプのパンくずリストとカテゴリ表示

設定環境

Cocoonバージョン: 2.9.3.1(2026/7/15時点最新)

カスタム投稿タイプは、Custom Post Type UIを使って以下のように作成。

ラベルスラッグ
カスタム投稿タイプ制作実績works
カスタムタクソノミー制作ジャンルgenre

投稿タイプの追加と編集で「アーカイブあり」がFalseになっているとアーカイブページは表示されないのでTrueにしておきます。

細かい使い方は省略。

「Archives」を任意のタイトルに変更

カスタム投稿タイプを作成すると、アーカイブページのタイトルは「Archives」になっており、タクソノミーアーカイブページでは「ターム名」が表示されています。

任意のタイトル名に変更するためには、get_archive_chapter_title()に対し書き換えを行います。

functions.phpに以下のコードを記述。

// カスタム投稿タイプのアーカイブタイトルを変更
function custom_archive_title( $title ){
  if ( is_post_type_archive() || is_tax()) {
    // スラッグを出力(ラベルを出力する場合->label)
    $title = (get_post_type_object(get_post_type())->name);
  }
return $title;
}
add_filter( 'get_archive_chapter_title', 'custom_archive_title', 10 );

必要に応じて、labelに変更したり、条件分岐してください。

出力した文字列はすべて小文字になるため、CSSで調整します。

/* アーカイブページタイトルの頭文字を大文字に変更 */
.archive-title {
	text-transform: capitalize;
}

パンくずリストのカスタマイズ

本題。

  • アーカイブページにも「パンくずリスト」を表示
  • タクソノミー & 投稿ページで「カスタム投稿タイプの階層」を追加

子テーマにテンプレートファイルを複製

パンくずリストのテンプレートは tmp/breadcrumbs.php にあります。

子テーマ内にtmpフォルダを作成し、親テーマのbreadcrumbs.phpを複製します。

複製したbreadcrumbs.phpを編集

最初の条件分岐にis_post_type_archive()を追加して、アーカイブページにも反映させます。

// パンくずリストの表示条件をチェック
if (is_single_breadcrumbs_visible() && (is_single() || is_tax() || is_category() || is_post_type_archive())) {

この状態でアーカイブページを見ると、エラーが出ますが、パンくずリストは表示されます。

次に$count = 1;の下にコードを追加して、エラーを防ぎつつ、カスタム投稿タイプの階層を追加します。

  $count = 1;
  //カスタム投稿タイプの階層を追加
  if (is_tax() || is_single() && !is_singular('post') || is_post_type_archive()) {
    $post_type = get_post_type();
    $post_type_obj = get_post_type_object($post_type);
    $post_type_label = $post_type_obj->label;
  //   $post_type_label = $post_type_obj->name;
  //   $post_type_label = "任意のカスタム投稿タイプ名";

    if ($post_type_obj) {
      $count++;
      $echo .= '<div class="breadcrumb-item" itemscope itemtype="https://schema.org/ListItem" itemprop="itemListElement"><span class="sp"><span class="fa fa-angle-right" aria-hidden="true"></span></span><span class="fa fa-folder fa-fw" aria-hidden="true"></span><a href="' . esc_url(get_post_type_archive_link($post_type)) . '" itemprop="item"><span itemprop="name" class="breadcrumb-caption">' . esc_html($post_type_label) . '</span></a><meta itemprop="position" content="' . $count . '" /></div>';
    }
    if (is_post_type_archive()) {
      $cat = null;
      echo $echo;
    }
  }

以上で完了です。

解説

「ホーム」が出力されているコードの下に、「カスタム投稿タイプの階層」が出力されるように条件分岐し書き加えた形です。

また、$post_type_labelの値を変更することで、容易に任意の名前を出力することが可能です。

エラーの原因

アーカイブページに「Warning: Undefined property: WP_Post_Type::$parent in…」のようなエラーが出るのは、投稿タイプにカテゴリ情報がないためです。

$cat=nullを定義して、次の条件分岐にアクセスしないようなアプローチにしエラーを回避しています。

if (is_post_type_archive()) {
  $cat = null;
}

if ( $cat && !is_wp_error( $cat ) ) {
    // パンくずルート表示
}

おまけのカスタム

あると便利!
タームナビの作成

ページタイトルの下に、ターム別に表示させるためのナビゲーションを作成します。

例:以下のようなリンクです。

これがあるとワンクリックでターム別に表示することができて便利…!

functions.phpに以下のコードを記述します。

<?php
// ジャンルナビ追加
function genre_nav() {
  // 投稿タイプ名とタクソノミー名
  $post_type = 'works';
  $taxonomy  = 'genre';

  if (! (is_post_type_archive($post_type) || is_tax($taxonomy))) {
    return;
  }

  // 現在表示中のターム情報を取得
  $current_term = is_tax($taxonomy) ? get_queried_object() : null;
  // 親ターム一覧を取得
  $genre_terms = get_terms($taxonomy, array(
    'hide_empty' => false,
    'orderby'    => 'id',
    'parent'     => 0,
  ));
?>
  <div class="genre-nav">
    <a class="genre-nav-link <?php echo is_post_type_archive($post_type) ? 'is-active' : ''; ?>" href="<?php echo esc_url(get_post_type_archive_link($post_type)); ?>">すべて</a>
    <?php foreach ($genre_terms as $genre_term) :
      // タームの存在チェック & 現在表示中のターム自身、またはその子孫(子・孫)ページである場合に true にする
      $is_active = $current_term && (
        $current_term->term_id === $genre_term->term_id ||
        term_is_ancestor_of($genre_term->term_id, $current_term->term_id, $taxonomy)
      );
    ?>
      <a class="genre-nav-link <?php echo $is_active ? 'is-active' : ''; ?>" href="<?php echo esc_url(get_term_link($genre_term, $taxonomy)); ?>">
        <?php echo esc_html($genre_term->name); ?>
      </a>

    <?php endforeach; ?>
  </div>
<?php
}
add_action('get_template_part_tmp/list-index', 'genre_nav');
add_action('get_template_part_tmp/list-tab-index', 'genre_nav');
add_action('get_template_part_tmp/list-category', 'genre_nav');
add_action('get_template_part_tmp/list-category-columns', 'genre_nav');

アーカイブページの判定はis_post_type_archive()で行い、trueだった場合にis-activeを付与しています。

タクソノミーの判定は、get_queried_object()で現在表示中のタームを取得し、get_terms()で取得した親ターム一覧とIDを比較して is-active を付与しています。

// タームの存在をチェックし、以下の条件に一致している場合にtrue
$is_active = $current_term && (
  // ターム自身が一致しているかどうか
  $current_term->term_id === $genre_term->term_id ||
  // 現在のタームが、タクソノミー「genre」の親タームに属しているかどうか
  term_is_ancestor_of($genre_term->term_id, $current_term->term_id, $taxonomy)
);

ここでのポイントは以下の2点です。

  • エラー防止: アーカイブページでタームが空(null)のときにエラーが出ないよう存在チェックを挟むこと。
  • 親子判定: 子孫ページでも親ナビを選択状態にするため、term_is_ancestor_of() を組み合わせること。

このらの処理を関数化し、フックで記事一覧の上に出力させています。

// 記事一覧の上に出力する
add_action( 'get_template_part_tmp/list-index', 'genre_nav' );
add_action( 'get_template_part_tmp/list-tab-index', 'genre_nav' );
add_action( 'get_template_part_tmp/list-category', 'genre_nav' );
add_action( 'get_template_part_tmp/list-category-columns', 'genre_nav' );
cssのカスタマイズ例
/* ジャンルナビ */
.genre-nav {
	display: flex;
	gap: 16px;
	margin-top: 40px;
	margin-bottom: 60px;
	justify-content: safe center;
	white-space: nowrap;
  overflow-x: auto;
}

@media screen and (max-width: 1023px) {
	.genre-nav {
	margin-top: 20px;
	margin-bottom: 30px;
	}
}

.genre-nav::-webkit-scrollbar {
	display: none;
}

.genre-nav-link {
	color: #888;
	font-weight: bold;
	padding: 4px 20px;
	text-decoration: none;
	display: inline-block;
	border-bottom: 2px solid transparent;
	transition: border .3s, color .3s;
}

@media screen and (max-width: 480px) {
	.genre-nav-link {
		font-size: 14px;
		margin-right: 0;
		margin-bottom: 8px;
		padding-left: 0;
		padding-right: 0;
		width: 100%;
		text-align: center;
	}
}

.genre-nav-link:hover,
.genre-nav-link.is-active {
	border-bottom: 2px solid;
	color: #333;
}

タグアーカイブで投稿とカスタム投稿を混ぜる

カスタム投稿タイプにも通常投稿にも東京という同じコアのタグをつけた場合、東京タグ一覧ページには通常の投稿しか表示されません。

functions.phpに以下のコードで、カスタム投稿タイプも混ぜて表示することが可能です。

// タグアーカイブをカスタム投稿タイプとまとめて表示
function my_main_query( $query ) {
  if ( is_admin() || ! $query->is_main_query() )
    return;

  if ( $query->is_category() || $query->is_tag() ) {
    $query->set( 'post_type', array( 'post', 'works' ) );
    return;
  }
}
add_action( 'pre_get_posts', 'my_main_query' );

array( 'post', 'post_type1' )post_type1にはカスタム投稿タイプのスラッグを入力します。

この方法は以下の記事で知りました。
(ありがとうございます)

パンくずリストのカスタマイズまとめ

カスタム投稿タイプのパンくずリストに正式対応したことで、余計な処理が不要になったのは、とても嬉しいですね。

ただ、今回のように大きめの構造変更が行われると、表示崩れや意図しないレイアウトになってしまうため、アップデート前にはバックアップを取るなどの処置をおすすめします。

もし不備や気になる点があれば、ぜひコメントでお知らせください。

カスタマイズに困ったらお気軽にご相談を!

  • 「ちょっとしたCSSの調整だけお願いしたい」
  • 「不具合を直してほしい」

料金は3,000円〜、お支払いは銀行振込・Amazonギフトカードなど柔軟に対応してます🤔

役に立ったら他の方にシェア

お気軽にコメントどうぞ

コメントする

目次