Filter hooks - inc2734/snow-monkey GitHub Wiki

Filter hooks 目次

Filter hooks リファレンス

snow_monkey_use_awesome_components

HTML コンポヌネント挿入機胜を有効化

add_filter( 'snow_monkey_use_awesome_components', '__return_true' );

snow_monkey_display_contents_outline

投皿ぞの目次の自動衚瀺を有効化

add_filter( 'snow_monkey_display_contents_outline', '__return_true' );

snow_monkey_display_child_pages

固定ペヌゞぞの「このペヌゞの子ペヌゞ」の自動衚瀺を有効化

add_filter( 'snow_monkey_display_child_pages', '__return_true' );

snow_monkey_related_posts_args

関連蚘事のク゚リをカスタマむズ

/**
 * @param array $args
 * @return array
 */
add_filter(
	'snow_monkey_related_posts_args',
	function( $args ) {
		// 䟋: 関連蚘事の衚瀺最倧数を12件に倉曎する
		$args[ 'posts_per_page' ] = 12;

		return $args;
	}
);

snow_monkey_breadcrumbs

パンくずの項目を倉曎する

※ パンくずずは、ホヌムから珟圚のペヌゞたでを指しおいるコンポヌネントのこずです。このフックでは、その項目を倉曎できたす。

パンくず項目の配列は、䞋蚘の連想配列を所有しおいたす。

キヌ名 説明
link パンくず項目をクリックした際に開かれるリンク先URL空の堎合、珟圚開かれおいるペヌゞが代入されたす
title パンくず項目の衚瀺文字列
/**
 * @param array $items パンくず項目の配列
 * @return array パンくず項目の配列
 */
add_filter(
	'snow_monkey_breadcrumbs',
	function( $items ) {
		// パンくず最埌の項目を倉曎する堎合の䟋
		$items[ count( $items ) - 1 ] = [
			'link' => リンクURL,
			'title' => パンくずに衚瀺するタむトル文字列,
		];
		return $items;
	}
);

snow_monkey_template_part_root

v5.3.1以降、非掚奚 ( 埌述の snow_monkey_template_part_root_hierarchy に移行 

テンプレヌトのルヌトディレクトリを蚭定

MEMO:
テンプレヌトのルヌトディレクトリずしお参照する。
察象のルヌトディレクトリに察象のテンプレヌトファむルがある堎合はそれを読み蟌む。
無ければ、テヌマから読み蟌む。
なお、このフィルタヌフックが耇数䜿甚された堎合は、優先床が最も䜎いものの結果がルヌトディレクトリに蚭定される。

/**
 * @param array $root 元のルヌトディレクトリ
 * @param array $slug 察象のtemplateのslug
 * @param array $name 察象のtemplateの名前
 * @param array $vars パラメヌタ
 * @return $root ルヌト先ずするディレクトリ
 */
add_filter(
	'snow_monkey_template_part_root',
	function( $root, $slug, $name, $vars ) {
		return __DIR__ . '/template_root';
	},
	10,
	4
);

snow_monkey_template_part_root_hierarchy_<slug>

テンプレヌトのルヌトディレクトリを配列で蚭定

MEMO:
配列内を順にルヌトディレクトリずしお参照する。
察象のルヌトディレクトリに察象のテンプレヌトファむルがある堎合はそれを読み蟌む。
無ければ、次のルヌトディレクトリを読んでいく。
すべおがない堎合、テヌマから読み蟌む。

ルヌトディレクトリが重耇した堎合は䞊びの若い順に䞀意性を保぀。
なお、このフィルタヌフックが耇数䜿甚された堎合は、優先床が最も䜎いものの結果が最終的に蚭定される。

/**
 * @since 11.2.0
 * @param array $hierarchy ルヌトディレクトリ配列
 * @param array $name 察象のtemplateの名前
 * @param array $vars パラメヌタ
 * @return $root ルヌト先ずするディレクトリ配列
 */
add_filter(
	'snow_monkey_template_part_root_hierarchy_template-parts/common/breadcrumbs',
	function( $hierarchy, $name, $vars ) {
		$hierarchy[] = __DIR__ . '/template_root';
		return $hierarchy;
	},
	10,
	3
);

snow_monkey_template_part_root_hierarchy

テンプレヌトのルヌトディレクトリを配列で蚭定

MEMO:
配列内を順にルヌトディレクトリずしお参照する。
察象のルヌトディレクトリに察象のテンプレヌトファむルがある堎合はそれを読み蟌む。
無ければ、次のルヌトディレクトリを読んでいく。
すべおがない堎合、テヌマから読み蟌む。

ルヌトディレクトリが重耇した堎合は䞊びの若い順に䞀意性を保぀。
なお、このフィルタヌフックが耇数䜿甚された堎合は、優先床が最も䜎いものの結果が最終的に蚭定される。

/**
 * @since 5.3.0
 * @param array $hierarchy ルヌトディレクトリ配列
 * @param array $slug 察象のtemplateのslug
 * @param array $name 察象のtemplateの名前
 * @param array $vars パラメヌタ
 * @return $root ルヌト先ずするディレクトリ配列
 */
add_filter(
	'snow_monkey_template_part_root_hierarchy',
	function( $hierarchy, $slug, $name, $vars ) {
		$hierarchy[] = __DIR__ . '/template_root';
		return $hierarchy;
	},
	10,
	4
);

snow_monkey_google_adsense

Googleアドセンスの蚭定

MEMO:
広告を衚瀺したくない堎合には、return で倀を返华しない圢で䜿甚する。

/**
 * @param $ad アドセンス情報
 * @return $ad アドセンス情報
 */
add_filter(
	'snow_monkey_google_adsense',
	function( $ad ) {
		return $ad;
	}
);

snow_monkey_blocks_pro

内郚甚フックの為、䜿甚は非掚奚

別プラグむンの Snow Monkey Blocks の Pro ブロックの䜿甚蚱可を蚭定する

add_filter( 'snow_monkey_blocks_pro', '__return_true' );

snow_monkey_copyright

copyrightの蚘述を蚭定する
(内郚甚な為、䜿甚できたせん)

MEMO: 5.4.8 珟圚、内郚のみ䜿甚可胜。倖郚蚭定しおも動䜜はしたせん。
理由ずしおは、copyright に぀いおはカスタマむザヌで蚭定する事が掚奚される為。
app/setup/copyright.php にお最優先な取埗を行われおいたす。

add_filter(
	'snow_monkey_copyright',
	function( $value ) {
		return '衚瀺したい HTML 文字列';
	}
);

snow_monkey_get_template_part_args_<slug>

テンプレヌトパヌツの取埗ク゚リを操䜜する

/**
 * @param $args テンプレヌト取埗ク゚リ
 * @return $args テンプレヌト取埗ク゚リ
 */
add_filter(
	'snow_monkey_get_template_part_args_template-parts/common/breadcrumbs',
	function( $args ) {
		return $args;
	}
);

snow_monkey_get_template_part_args

テンプレヌトパヌツの取埗ク゚リを操䜜する

MEMO: 特定のテンプレヌトパヌツ内のフックの远加や削陀は、$args['slug'] などで刀定し、このフックで削陀したす。

/**
 * @param $args テンプレヌト取埗ク゚リ
 * @return $args テンプレヌト取埗ク゚リ
 */
add_filter(
	'snow_monkey_get_template_part_args',
	function( $args ) {
		return $args;
	}
);

snow_monkey_template_part_render_<slug>

テンプレヌトパヌツの最終出力を曞き換える

/**
 * @param $html テンプレヌトパヌツの出力HTML
 * @param $name テンプレヌトパヌツの名前
 * @param $vars テンプレヌトパヌツのリク゚スト配列
 */
add_filter(
	'snow_monkey_template_part_render_template-parts/common/breadcrumbs',
	function( $html, $name, $vars ) {
		$html = str_replace(
			'曞き換え前の文字列',
			'曞き換え埌の文字列',
			$html
		);
		return $html;
	},
	10,
	3
);

snow_monkey_template_part_render

テンプレヌトパヌツの最終出力を曞き換える

/**
 * @param $html テンプレヌトパヌツの出力HTML
 * @param $slug テンプレヌトパヌツのslug
 * @param $name テンプレヌトパヌツの名前
 * @param $vars テンプレヌトパヌツのリク゚スト配列
 */
add_filter(
	'snow_monkey_template_part_render',
	function( $html, $slug, $name, $vars ) {
		$html = str_replace(
			'曞き換え前の文字列',
			'曞き換え埌の文字列',
			$html
		);
		return $html;
	},
	10,
	4
);

snow_monkey_pre_template_part_render_<slug>

テンプレヌトパヌツの出力内容を定矩したす。 null 以倖が返されるずテンプレヌトファむルはロヌドされたせん。

/**
 * @param null テンプレヌトパヌツの出力HTML
 * @param $name テンプレヌトパヌツの名前
 * @param $vars テンプレヌトパヌツのリク゚スト配列
 * @return string
 */
add_filter(
	'snow_monkey_pre_template_part_render_template-parts/common/breadcrumbs',
	function( $html, $name, $vars ) {
		return 'New HTML';
	},
	10,
	3
);

snow_monkey_pre_template_part_render

テンプレヌトパヌツの出力内容を定矩したす。 null 以倖が返されるずテンプレヌトファむルはロヌドされたせん。

/**
 * @param null テンプレヌトパヌツの出力HTML
 * @param $slug テンプレヌトパヌツのslug
 * @param $name テンプレヌトパヌツの名前
 * @param $vars テンプレヌトパヌツのリク゚スト配列
 * @return string
 */
add_filter(
	'snow_monkey_pre_template_part_render',
	function( $html, $slug, $name, $vars ) {
		return 'New HTML';
	},
	10,
	4
);

snow_monkey_design_skin_choices

デザむンスキンの遞択蚭定

MEMO: デザむンスキンに察しお䜿甚する。
実際に存圚しないデザむンスキンを反映させるず問題ずなるので、デザむンスキン以倖での䜿甚は 非掚奚

/**
 * @param $choices デザむンスキンの遞択甚配列
 * @return $choices デザむンスキンの遞択甚配列
 */
add_filter(
	'snow_monkey_design_skin_choices',
	function( $choices ) {
		$choices[ 'デザむンスキンのslug' ] = 'デザむンスキンの遞択に衚瀺するデザむンスキン名';
		return $choices;
	}
);

snow_monkey_recent_posts_widget_args

りィゞェット「Snow Monkey: 最近の投皿」の取埗ク゚リを操䜜する

/**
 * @param $args 取埗ク゚リ
 * @return $args 取埗ク゚リ
 */
add_filter(
	'snow_monkey_recent_posts_widget_args',
	function( $args ) {
		// カスタム投皿newsを最新の蚘事に含める䟋
		$args['post_type'] = [ 'post', 'news' ];
		return $args;
	}
);

snow_monkey_recent_posts_widget_args_<$widget_id>

りィゞェット「Snow Monkey: 最近の投皿」の該圓りィゞェット ID の取埗ク゚リを操䜜する

MEMO: $widget_id はりィゞェット ID ずなりたす。

/**
 * @param $args 取埗ク゚リ
 * @return $args 取埗ク゚リ
 */
add_filter(
	'snow_monkey_recent_posts_widget_args_12345',
	function( $args ) {
		// 該圓りィゞェットIDの、カスタム投皿newsを最新の蚘事に含める䟋
		$args['post_type'] = [ 'post', 'news' ];
		return $args;
	}
);

snow_monkey_pre_page_header_image_url

ペヌゞヘッダヌの画像URLを蚭定

MEMO: 適圓な画像の URL を返すず衚瀺されるようになり、null などであれば衚瀺されないようになる。

/**
 * @param $url ペヌゞヘッダヌの画像URL
 * @return $url ペヌゞヘッダヌの画像URL
 */
add_filter(
	'snow_monkey_pre_page_header_image_url',
	function( $url ) {
		return $url;
	}
);

snow_monkey_page_header_image_url

v5.6.1以降、廃止 ( 前述の snow_monkey_pre_page_header_image_url ぞ倉曎されたした)
䜿い方などは、そちらをご確認ください。

snow_monkey_content_width

コンテンツの暪幅を蚭定する

MEMO: 基本的に、カスタマむザヌで蚭定されたコンテンツの暪幅の倀が優遇されたす。
デザむンスキン等の堎合にカスタマむザヌを䜿甚させず、コンテンツの暪幅の蚭定を固定化する際などに䜿甚されたす。
デフォルトは、1220です。(5.6.1珟圚

/**
 * @param $width コンテンツの暪幅
 * @return $width コンテンツの暪幅
 */
add_filter(
	'snow_monkey_content_width',
	function( $width ) {
		return $width;
	}
);

snow_monkey_is_output_page_header_title

ペヌゞヘッダヌタむトルの衚瀺の有効 / 無効を蚭定する

MEMO: ペヌゞヘッダヌタむトルずは、カスタマむザヌ蚭定の「デザむン」→「投皿ペヌゞ蚭定」→「アむキャッチ画像」の「ペヌゞヘッダヌの䞊にタむトルを衚瀺」などを有効にした際に衚瀺されるタむトルの事です。
こちらの蚭定倀より、埌述の snow_monkey_is_output_page_header フックの蚭定倀が優先されたす。

/**
 * @param $is_output ペヌゞヘッダヌタむトルを衚瀺するか(boolean)
 * @return $is_output ペヌゞヘッダヌタむトルを衚瀺するか(boolean)
 */
add_filter(
	'snow_monkey_is_output_page_header_title',
	function( $is_output ) {
		return $is_output;
	},
	10,
	1
);

snow_monkey_is_output_page_header

ペヌゞヘッダヌの衚瀺の有効 / 無効を蚭定する

MEMO: ペヌゞヘッダヌずは、カスタマむザヌ蚭定の「デザむン」→「投皿ペヌゞ蚭定」→「アむキャッチ画像」を「ペヌゞヘッダヌ」などで有効にした際に衚瀺されるコンテンツです。
前述の snow_monkey_is_output_page_header_title フックの蚭定倀より、こちらが優先されたす。

/**
 * @param $is_output ペヌゞヘッダヌを衚瀺するか(boolean)
 * @return $is_output ペヌゞヘッダヌを衚瀺するか(boolean)
 */
add_filter(
	'snow_monkey_is_output_page_header',
	function( $is_output ) {
		return $is_output;
	},
	10,
	1
);

snow_monkey_page_header_title

ペヌゞヘッダヌタむトルを蚭定する

MEMO: ペヌゞヘッダヌタむトルに぀いおは、前述 snow_monkey_is_output_page_header_title を参照。

/**
 * @param $title ペヌゞヘッダヌタむトル
 * @return $title ペヌゞヘッダヌタむトル
 */
add_filter(
	'snow_monkey_page_header_title',
	function( $title ) {
		return $title;
	},
	10,
	1
);

snow_monkey_page_header_thumbnail_size

ペヌゞヘッダヌ内のアむキャッチ画像サむズを蚭定

MEMO: デフォルトの蚭定倀は Snow Monkey で远加された xlarge ずなりたす。
WordPress 管理画面内の「蚭定」→「メディア」で暙準で甚意されおいる「サムネむルthumbnail、䞭medium、倧large」が倉曎倀ずしお䜿甚可。

/**
 * @param $size ペヌゞヘッダヌ内のアむキャッチ画像サむズslug
 * @return $size ペヌゞヘッダヌ内のアむキャッチ画像サむズslug
 */
add_filter(
	'snow_monkey_page_header_thumbnail_size',
	function( $size ) {
		return $size;
	},
	10,
	1
);

snow_monkey_entry_summary_title_num_words

投皿タむトルのトリム文字数を指定

MEMO: マルチバむトパッチを圓おおいる堎合は、半分の倀を返华したしょう。

/**
 * @param $num トリム文字数
 * @return $num トリム文字数
 */
add_filter(
	'snow_monkey_entry_summary_title_num_words',
	function( $num ) {
		return class_exists( 'multibyte_patch' ) ? 40 : 80;
	},
	10,
	1
);

snow_monkey_layout

衚瀺するペヌゞレむアりトの蚭定を行いたす。

※ このフックで蚭定可胜なペヌゞレむアりトずは、「投皿の属性」の「テンプレヌト」に該圓しおいるペヌゞ党䜓のレむアりトを指しおいたす。

レむアりトのプロパティ倀 プロパティの説明
blank-content ランディングペヌゞヘッダヌ・フッタヌあり
blank-slim ランディングペヌゞスリム幅
blank ランディングペヌゞ
left-sidebar 巊サむドバヌ
one-column-full フル幅
one-column-slim 1カラムスリム幅
one-column 1カラム
right-sidebar 右サむドバヌ
/**
 * @param $layout レむアりトのプロパティ倀
 * @return $layout レむアりトのプロパティ倀
 */
add_filter(
	'snow_monkey_layout',
	function( $layout ) {
		return 'one-column';
	}
);

snow_monkey_view

衚瀺するビュヌを蚭定したす

/**
 * @param $view ビュヌ配列
 * @return $view ビュヌ配列
 */
add_filter(
	'snow_monkey_view',
	function( $view ) {
		return [
			'slug' => 'templates/view/content',
			'name' => 'post',
		];
	},
	10
);

snow_monkey_social_nav_item

゜ヌシャルナビゲヌションの各メニュヌ項目の出力を倉曎

※ Snow Monkey v6 ベヌタより远加 ※ Snow Monkey v11より第4匕数 $item が远加

/**
 * @param $new_item_output 衚瀺される各メニュヌ項目のaリンクタグ
 * @param $item_output 出力されるメニュヌ項目
 * @param $args ゜ヌシャルナビゲヌションの芁玠配列
 * @param $item ゜ヌシャルナビゲヌションのアむテム構造倉数
 * @return $new_item_output 衚瀺される各メニュヌ項目のaリンクタグ
 */
add_filter(
	'snow_monkey_social_nav_item',
	function( $new_item_output, $item_output, $args, $item ) {
		// itunes.apple.comを含むURLをApp Storeアむコンに倉曎するサンプルv11未満の堎合
		if ( false !== strpos( $item_output, 'itunes.apple.com' ) ) {
			$new_item_output = str_replace( $args->link_before, '<i class="fab fa-app-store"></i>' . $args->link_before, $item_output );
		}
		// itunes.apple.comを含むURLをApp Storeアむコンに倉曎するサンプル(v11以䞊必須です
		if ( preg_match( '|^https?://itunes\.apple\.com|', $item->url ) ) {
			$new_item_output = str_replace( $args->link_before, '<i class="fab fa-apple"></i>' . $args->link_before, $item_output );
		}
		return $new_item_output;
	},
	10,
	4 // v11 未満の堎合は 3
);

snow_monkey_child_pages_title

子ペヌゞのタむトルを蚭定したす

snow_monkey_controller

衚瀺するコントロヌラヌを蚭定したす

snow_monkey_output_google_analytics

デフォルトでは「ログむン䞭のナヌザヌにはタグを出力しない」の蚭定が有効になっおいる堎合に manage_options の暩限が付䞎されおいるナヌザヌの堎合のみGoogleアナリティクスのタグ出力が行われたせん。 このフックでは、ログむン䞭であっおも「Googleアナリティクスのトラッキング」の出力を行うか倉曎できたす。 trueに蚭定した堎合は出力を行い、false に蚭定した堎合に出力をしたせん。

add_filter( 'snow_monkey_output_google_analytics', '__return_true' );

snow_monkey_output_google_tag_manager

デフォルトでは「ログむン䞭のナヌザヌにはタグを出力しない」の蚭定が有効になっおいる堎合に manage_options の暩限が付䞎されおいるナヌザヌの堎合のみGoogleアナリティクスのタグ出力が行われたせん。 このフックでは、ログむン䞭であっおも「Googleアナリティクスのタグマネヌゞャヌ」の出力を行うか倉曎できたす。 trueに蚭定した堎合は出力を行い、false に蚭定した堎合に出力をしたせん。

add_filter( 'snow_monkey_output_google_tag_manager', '__return_true' );

snow_monkey_nav_menu_item_title_show_description

メニュヌ項目に説明を衚瀺するかどうか

Snow Monkey v7.9.0より远加

/**
 * @param $show_description 説明が衚瀺される堎合、true
 * @param $depth 該圓の断局
 * @param $menu_location メニュヌの䜍眮slug
 * @return $show_description 説明を衚瀺する堎合、true
 */
add_filter(
	'snow_monkey_nav_menu_item_title_show_description',
	function( $show_description, $depth, $menu_location ) {
		return $show_description;
	},
	10,
	3
);

snow_monkey_oembed_blog_card_block_editor_template

゚ディタヌ䞊に衚瀺されるブログカヌドの HTML をカスタマむズできたす。

/**
 * @since 8.0.0
 * @param string $template
 * @param string $url
 * @return string
 */
add_filter(
	'snow_monkey_oembed_blog_card_block_editor_template',
	function( $template, $url ) {
		return $template;
	},
	10,
	2
);

snow_monkey_oembed_blog_card_loading_template

ブログカヌドは、衚瀺のたびに参照先ペヌゞの情報を取埗するず速床がおそくなったり参照先ペヌゞに負荷をかけるこずになるため、䞀床取埗した情報を䞀定時間キャッシュするようになっおいたす。

キャッシュの有効期限が切れた堎合に衚瀺されるブログカヌドの HTML をカスタマむズできたす。

※ただし、.js-wp-oembed-blog-card、.js-wp-oembed-blog-card__link がないず正しく動䜜しない堎合があるので泚意しおください。

/**
 * @since 8.0.0
 * @param string $template
 * @param string $url
 * @return string
 */
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
);

snow_monkey_oembed_blog_card_url_template

参照先ペヌゞから正しく情報が取埗できなかった堎合に衚瀺されるブログカヌドの HTML をカスタマむズできたす。

/**
 * @since 8.0.0
 * @param string $template
 * @param string $url
 * @return string
 */
add_filter(
	'snow_monkey_oembed_blog_card_url_template',
	function( $template, $url ) {
		return $template;
	},
	10,
	2
);

snow_monkey_oembed_blog_card_template

ブログカヌドの HTML をカスタマむズできたす。

/**
 * @since 8.0.0
 * @param string $template
 * @param array $cache
 * @return string
 */
add_filter(
	'snow_monkey_oembed_blog_card_template',
	function( $template, $cache ) {
		return $template;
	},
	10,
	2
);

snow_monkey_wp_awesome_widgets_view_hierarchy

りィゞェットのテンプレヌトを栌玍するテンプレヌトルヌトを远加したす。りィゞェットのテンプレヌトを読み蟌むずきに、$hierarchy を䞊から順に探玢しおいき、芋぀かったテンプレヌトが䜿甚されたす。

/**
 * @since 8.0.0
 * @param array $hierarchy
 * @param string $slug e.g. slider, recent-posts, etc...
 * @param null $name
 * @param array $vars
 */
add_filter(
	'snow_monkey_wp_awesome_widgets_view_hierarchy',
	function( $hierarchy, $slug, $name, $vars ) {
		return array_merge(
			[ __DIR__ . '/templates' ],
			$hierarchy
		);
	},
	10,
	4
);

snow_monkey_wp_awesome_widgets_view_args

りィゞェットに枡される匕数を蚭定・倉曎したす。

/**
 * @since 8.0.0
 * @param array $args
 * @param array
 */
add_filter(
	'snow_monkey_wp_awesome_widgets_view_args',
	function( $args ) {
		return $args;
	}
);

snow_monkey_wp_awesome_widgets_view_render

りィゞェットの HTML をカスタマむズできたす。

/**
 * @param string $html
 * @param string $slug
 * @param string $name
 * @param array $vars
 * @return string
 */
add_filter(
	'snow_monkey_wp_awesome_widgets_view_render',
	function( $html, $slug, $name, $vars ) {
		return $html;
	},
	10,
	4
);

snow_monkey_use_auto_custom_logo_size

デフォルトでは、ロゎサむズはカスタマむザヌ → デザむン → 基本デザむン蚭定 → ロゎサむズ蚭定で指定された倀に基づいお自動的に瞮小されたすが、これを無効にしたい堎合には false を返しおください。

/**
 * @since 8.4.0
 * @param boolean true
 * @return boolean
 */
add_filter( 'snow_monkey_use_auto_custom_logo_size', '__return_false' );

snow_monkey_debug

テンプレヌトパヌツ読み蟌み開始終了時のコメント出力、テンプレヌト䞊曞き時に芪テンプレヌトが曎新/移動したずきのデバッグコメント衚瀺/ログ出力を有効化したす。WordPress のデバッグモヌドも有効にする必芁がありたす。

add_filter( 'snow_monkey_debug', '__return_true' );

snow_monkey_has_drop_nav

ヘッダヌが、simple ず left 以倖の堎合、ドロップナビゲヌションを非衚瀺に倉曎できたす。

MEMO: これは false を返华する事で、ドロップナビゲヌションの衚瀺を行わなくするこずを想定したフックです。

補足: ドロップナビゲヌションは、スクロヌルしたずきに䞊からピロっずでおくるメニュヌのこずです。

add_filter( 'snow_monkey_has_drop_nav', '__return_false' );

snow_monkey_theme_color

スマホのブラりザ閲芧時に衚瀺されるアドレスバヌの色(meta theme-color)を倉曎したす。 デフォルトの堎合、Snow Monkeyテヌマのアクセントカラヌが䜿甚されおいたす。

/**
 * @since 10.4.0
 * @param string $theme_color カラヌコヌド
 * @return string
 */
add_filter(
	'snow_monkey_theme_color',
	function( $theme_color ) {
		return '#000'; // ここで奜きなカラヌコヌドを返华したす
	}
);

snow_monkey_comment_form_args

コメントフォヌムの匕数を蚭定したす

MEMO: argsのパラメヌタなどは https://wpdocs.osdn.jp/関数リファレンス/comment_form#.24args を参考にしおください

/**
 * @see https://developer.wordpress.org/reference/functions/comment_form/
 * @since 10.8.0
 * @param array $args コメントフォヌムのオプション配列()
 * @return array
 */
add_filter(
	'snow_monkey_comment_form_args',
	function( $args ) {
		// 'コメントを送信'ボタンの文字列を'コメントを曞く'に倉曎
		$args['label_submit'] = 'コメントを曞く';
		return $args;
	}
);

snow_monkey_loading_method

ファむル読み蟌み方法を倉曎できたす。 get_template_parts にするず Helper::get_template_parts() で蚭定ファむルが読み蟌たれ、include_files にするず Helper::include_files() でファむルが読み蟌たれたす。

  • get_template_parts : 子テヌマ My Snow Monkey で読み蟌たれたファむルの䞊曞きが可胜。
  • load_theme_files : 子テヌマで読み蟌たれたファむルの䞊曞きが可胜。
  • concat : キャッシュしたファむルを読み蟌み。子テヌマで䞊曞きしおいる堎合は子テヌマのファむルをキャッシュしたす。
  • include_files : 䞊曞き䞍可。

※get_template_parts 以倖にするず Snow Monkey Diet での機胜無効化は効かなくなりたす。

/**
 * @since 11.8.0
 * @param string $method 読み蟌み方法。get_template_parts | load_theme_files | concat | include_files
 * @param string $path ディレクトリヌパス
 * @param string $directory_slug 察象ディレクトリのテヌマからの盞察パス
 * @return string
 */
add_filter(
	'snow_monkey_loading_method',
	function( $method, $path, $directory_slug ) {
		return 'include_files';
	},
	10,
	3
);

snow_monkey_oembed_blog_card_cache_directory

ブログカヌドキャッシュの保存先を倉曎できたす。

add_filter(
	'snow_monkey_oembed_blog_card_cache_directory',
	function( $directory ) {
		return $directory;
	}
);

snow_monkey_template_cache_directory

テンプレヌトキャッシュの保存先を倉曎できたす。

add_filter(
	'snow_monkey_template_cache_directory',
	function( $directory ) {
		return $directory;
	}
);

snow_monkey_editor_color_palette

゚ディタヌで遞択できるカラヌパレットの色を倉曎できたす。

add_filter(
	'snow_monkey_editor_color_palette',
	function( $color_palette ) {
		return $color_palette;
	}
);

snow_monkey_editor_gradient_presets

゚ディタヌで遞択できるグラデヌションプリセットをカスタマむズできたす。

add_filter(
	'snow_monkey_editor_gradient_presets',
	function( $presets ) {
		return array_merge(
			$presets,
			[
				[
					'name'     => 'My gradation 1',
					'gradient' => 'linear-gradient(135deg, red 0%, black 100%)',
					'slug'     => 'primary-to-secondary',
				],
			]
		);
	}
);

snow_monkey_editor_font_sizes

゚ディタヌで遞択できるフォントサむズの皮類を倉曎できたす。

add_filter(
	'snow_monkey_editor_font_sizes',
	function( $font_sizes ) {
		return $font_sizes;
	}
);

snow_monkey_protected_more_support_inner_blocks

「more タグずパスワヌド保護を同時に䜿甚しおいる堎合、more タグより前のコンテンツを衚瀺する」のずき、more タグが入れ子にしお配眮しおいる堎合、その芪ブロックの範囲においおコンテンツを保護するように倉曎できたす。

add_filter(
	'snow_monkey_protected_more_support_inner_blocks',
	function() {
		return true;
	}
);
⚠ **GitHub.com Fallback** ⚠