できる！Snow Monkey カスタマイズ – パンくず操作編

この記事は、不定期連載「できる！Snow Monkey カスタマイズ 」の第４回目です。

今回の記事のテーマ

Snow Monkeyのテーマは、プラグインで簡単にパンくずをカスタマイズできるようになっている為、自由にパンくずの構造を書き換える事が可能になっています。
これを機会に、パンくずの操作について解説を行います。

パンくずの構造操作をプラグインでします

My Snow Monkeyプラグインを使用してパンくずの構造を細かく設定する方法を解説します。前回（第３回）の記事までの続きではなく、今回はsnow_monkey_breadcrumbsフックを使用した単独でカスタマイズ可能なフックを使用しています。

パンくずって何だろう？

ヘンゼルは小石の代わりに弁当として与えられたパンをポケットの中で粉々に砕き、道しるべとして道々落としていった。

ヘンゼルとグレーテル – Wikipedia

ヘンゼルは目印となるはずのパンのかけらを探したが、パンのかけらは森の何千もの鳥がついばんでしまったため、見つけることができなかった。
ヘンゼルとグレーテルは野いちごで飢えをしのぎながら3日間森の中をさまよった。

ヘンゼルとグレーテル – Wikipedia

パンくずを操作してみよう

プラグインでパンくず操作を行う方法

パンくずの操作を体験する為に、テスト環境でMy Snow Monkeyプラグインに練習用のコードを書いてみましょう。

まずは、パンくずを操作する為に、Snow Monkeyテーマフックであるsnow_monkey_breadcrumbsのフック処理を定義しましょう。

add_filter(
  'snow_monkey_breadcrumbs',
  function( $items ) {
    print_r( $items );
    return $items;
  }
);

と記述を加えます。

Array (
  [0] => Array (
    [title] => ホーム
    [link] => http://not-wiz.net/
  )
  [1] => Array (
    [title] => 記事
    [link] => https://not-wiz.net/articles/
  )
  [2] => Array (
    [title] => できる！Snow Monkey カスタマイズ – パンくず操作編
    [link] => https://not-wiz.net/articles/snow-monkey/it-can-customize-004/
  )
)

いくつかの操作サンプル例をご紹介

記事一覧ページの「○○」を「○○の書いた記事」にする

add_filter(
	'snow_monkey_breadcrumbs',
	function( $items ) {
		if ( is_author() ) {
			$items[ count( $items ) - 1 ] = [
				'link' => $items[ count( $items ) - 1 ]['link'],
				'title' => sprintf( '%1$sの書いた記事', get_the_author_meta( 'display_name', get_query_var( 'author' ) ) ),
			];
		}
		return $items;
	},
	10,
	1
);

カテゴリー要素を消して「ホーム > 記事 > 記事タイトル」にする

add_filter(
	'snow_monkey_breadcrumbs',
	function( $items ) {
		global $post;
		if ( is_single() || is_page() ) {
			if ( get_post_type( $post ) === 'post' ) {
				// 新しい要素を追加
				$new_item = [
					[
						'link' => 'パーマリンクURLの/以降の部分を設定',
						'title' => '記事'
					]
				];
				array_splice( $items, 1, 0, $new_item );
				// 元から存在しているカテゴリー要素の削除
				array_splice( $items, 2, 1 );
			}
		}
		return $items;
	},
	10,
	1
);

第４回の記事に向けて