-
Notifications
You must be signed in to change notification settings - Fork 31
Filter hooks
- snow_monkey_use_awesome_components (HTML コンポーネント挿入機能を有効化)
- snow_monkey_display_contents_outline (投稿への目次の自動表示を有効化)
- snow_monkey_display_child_pages (固定ページへの「このページの子ページ」の自動表示を有効化)
- snow_monkey_related_posts_args (関連記事のクエリをカスタマイズ)
- snow_monkey_breadcrumbs (パンくずの項目を変更する)
- snow_monkey_template_part_root (テンプレートのルートディレクトリを設定)
- snow_monkey_template_part_root_hierarchy_<slug> (テンプレートのルートディレクトリを配列で設定)
- snow_monkey_template_part_root_hierarchy (テンプレートのルートディレクトリを配列で設定)
- snow_monkey_google_adsense (Googleアドセンスの設定)
- snow_monkey_blocks_pro (Snow Monkey BlocksのProブロックの使用許可を設定)
- snow_monkey_copyright (copyrightの記述を設定)
- snow_monkey_get_template_part_args_<slug> (テンプレートパーツの取得クエリを操作)
- snow_monkey_get_template_part_args (テンプレートパーツの取得クエリを操作)
- snow_monkey_template_part_render (テンプレートパーツの最終出力を変更)
- snow_monkey_template_part_render_<slug> (テンプレートパーツの最終出力を変更)
- snow_monkey_pre_template_part_render_<slug> (テンプレートパーツの出力内容を定義)
- snow_monkey_pre_template_part_render (テンプレートパーツの出力内容を定義)
- snow_monkey_design_skin_choices (デザインスキンの選択設定)
- snow_monkey_recent_posts_widget_args (ウィジェット「Snow Monkey: 最近の投稿」の取得クエリを操作)
- snow_monkey_recent_posts_widget_args_<$widget_id> (ウィジェット「Snow Monkey: 最近の投稿」の該当ウィジェットIDの取得クエリを操作)
- snow_monkey_pre_page_header_image_url (ページヘッダーの画像URLを設定)
- snow_monkey_page_header_image_url(ページヘッダーの画像URLを設定 - 廃止)
- snow_monkey_content_width (コンテンツの横幅を設定する)
- snow_monkey_is_output_page_header_title (ページヘッダータイトルの表示の有効 / 無効を設定)
- snow_monkey_is_output_page_header (ページヘッダーの表示の有効 / 無効を設定)
- snow_monkey_page_header_title (ページヘッダータイトルを設定)
- snow_monkey_page_header_thumbnail_size (ページヘッダー内のアイキャッチ画像サイズを設定)
- snow_monkey_entry_summary_title_num_words (投稿タイトルのトリム文字数を指定)
- snow_monkey_layout (表示するページレイアウトの設定を行う)
- snow_monkey_view (表示するビューを設定)
- snow_monkey_child_pages_title (子ページのタイトルを設定)
- snow_monkey_controller (表示するコントローラーを設定)
- snow_monkey_social_nav_item (ソーシャルナビゲーションの各アイテム出力を変更)
- snow_monkey_output_google_analytics (ログイン時のGoogleアナリティクスのトラッキングIDの出力させない条件を変更)
- snow_monkey_output_google_tag_manager (ログイン時のGoogleアナリティクスのタグマネージャーIDの出力させない条件を変更)
- snow_monkey_nav_menu_item_title_show_description (メニュー項目に説明を表示するかどうか)
- snow_monkey_oembed_blog_card_block_editor_template (エディター上に表示されるブログカードの HTML をカスタマイズ)
- snow_monkey_oembed_blog_card_loading_template (キャッシュの有効期限が切れた場合に表示されるブログカードの HTML をカスタマイズ)
- snow_monkey_oembed_blog_card_url_template (参照先ページから正しく情報が取得できなかった場合に表示されるブログカードの HTML をカスタマイズ)
- snow_monkey_oembed_blog_card_template (ブログカードの HTML をカスタマイズ)
- snow_monkey_wp_awesome_widgets_view_hierarchy (ウィジェットのテンプレートを格納するテンプレートルートを追加)
- snow_monkey_wp_awesome_widgets_view_args(ウィジェットの引数を設定)
- snow_monkey_wp_awesome_widgets_view_render (ウィジェットの HTML をカスタマイズ)
- snow_monkey_use_auto_custom_logo_size (ロゴの自動サイズ指定の有効/無効)
- snow_monkey_debug (デバッグコメント表示/ログ出力の有効/無効)
- snow_monkey_has_drop_nav (ドロップナビゲーションを非表示化)
- snow_monkey_theme_color (スマホブラウザアドレスバーの色を設定する)
- snow_monkey_comment_form_args (コメントフォームの引数)
- snow_monkey_oembed_blog_card_cache_directory(ブログカードキャッシュの保存先を変更)
- snow_monkey_template_cache_directory(テンプレートキャッシュの保存先を変更)
- snow_monkey_editor_color_palette(エディターで選択できるカラーパレットの色を変更)
- snow_monkey_editor_gradient_presets(エディターで選択できるグラデーションプリセットをカスタマイズできる)
- snow_monkey_editor_font_sizes(エディターで選択できるフォントサイズの種類を変更)
- snow_monkey_protected_more_support_inner_blocks(「more タグとパスワード保護を同時に使用している場合、more タグより前のコンテンツを表示する」の挙動を変更)
HTML コンポーネント挿入機能を有効化
add_filter( 'snow_monkey_use_awesome_components', '__return_true' );
投稿への目次の自動表示を有効化
add_filter( 'snow_monkey_display_contents_outline', '__return_true' );
固定ページへの「このページの子ページ」の自動表示を有効化
add_filter( 'snow_monkey_display_child_pages', '__return_true' );
関連記事のクエリをカスタマイズ
/**
* @param array $args
* @return array
*/
add_filter(
'snow_monkey_related_posts_args',
function( $args ) {
// 例: 関連記事の表示最大数を12件に変更する
$args[ 'posts_per_page' ] = 12;
return $args;
}
);
パンくずの項目を変更する
※ パンくずとは、ホームから現在のページまでを指しているコンポーネントのことです。このフックでは、その項目を変更できます。
パンくず項目の配列は、下記の連想配列を所有しています。
キー名 | 説明 |
---|---|
link | パンくず項目をクリックした際に開かれるリンク先URL(空の場合、現在開かれているページが代入されます) |
title | パンくず項目の表示文字列 |
/**
* @param array $items パンくず項目の配列
* @return array パンくず項目の配列
*/
add_filter(
'snow_monkey_breadcrumbs',
function( $items ) {
// パンくず最後の項目を変更する場合の例
$items[ count( $items ) - 1 ] = [
'link' => リンクURL,
'title' => パンくずに表示するタイトル文字列,
];
return $items;
}
);
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
);
テンプレートのルートディレクトリを配列で設定
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
);
テンプレートのルートディレクトリを配列で設定
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
);
Googleアドセンスの設定
MEMO:
広告を表示したくない場合には、return
で値を返却しない形で使用する。
/**
* @param $ad アドセンス情報
* @return $ad アドセンス情報
*/
add_filter(
'snow_monkey_google_adsense',
function( $ad ) {
return $ad;
}
);
内部用フックの為、使用は非推奨
別プラグインの Snow Monkey Blocks の Pro ブロックの使用許可を設定する
add_filter( 'snow_monkey_blocks_pro', '__return_true' );
copyrightの記述を設定する
(内部用な為、使用できません)
MEMO: 5.4.8 現在、内部のみ使用可能。外部設定しても動作はしません。
理由としては、copyright についてはカスタマイザーで設定する事が推奨される為。
app/setup/copyright.php
にて最優先な取得を行われています。
add_filter(
'snow_monkey_copyright',
function( $value ) {
return '表示したい HTML 文字列';
}
);
テンプレートパーツの取得クエリを操作する
/**
* @param $args テンプレート取得クエリ
* @return $args テンプレート取得クエリ
*/
add_filter(
'snow_monkey_get_template_part_args_template-parts/common/breadcrumbs',
function( $args ) {
return $args;
}
);
テンプレートパーツの取得クエリを操作する
MEMO: 特定のテンプレートパーツ内のフックの追加や削除は、$args['slug']
などで判定し、このフックで削除します。
/**
* @param $args テンプレート取得クエリ
* @return $args テンプレート取得クエリ
*/
add_filter(
'snow_monkey_get_template_part_args',
function( $args ) {
return $args;
}
);
テンプレートパーツの最終出力を書き換える
/**
* @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
);
テンプレートパーツの最終出力を書き換える
/**
* @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
);
テンプレートパーツの出力内容を定義します。 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
);
テンプレートパーツの出力内容を定義します。 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
);
デザインスキンの選択設定
MEMO: デザインスキンに対して使用する。
実際に存在しないデザインスキンを反映させると問題となるので、デザインスキン以外での使用は 非推奨
/**
* @param $choices デザインスキンの選択用配列
* @return $choices デザインスキンの選択用配列
*/
add_filter(
'snow_monkey_design_skin_choices',
function( $choices ) {
$choices[ 'デザインスキンのslug' ] = 'デザインスキンの選択に表示するデザインスキン名';
return $choices;
}
);
ウィジェット「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: 最近の投稿」の該当ウィジェット 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;
}
);
ページヘッダーの画像URLを設定
MEMO: 適当な画像の URL を返すと表示されるようになり、null
などであれば表示されないようになる。
/**
* @param $url ページヘッダーの画像URL
* @return $url ページヘッダーの画像URL
*/
add_filter(
'snow_monkey_pre_page_header_image_url',
function( $url ) {
return $url;
}
);
v5.6.1以降、廃止
( 前述の snow_monkey_pre_page_header_image_url
へ変更されました)
使い方などは、そちらをご確認ください。
コンテンツの横幅を設定する
MEMO: 基本的に、カスタマイザーで設定されたコンテンツの横幅の値が優遇されます。
デザインスキン等の場合にカスタマイザーを使用させず、コンテンツの横幅の設定を固定化する際などに使用されます。
デフォルトは、1220です。(5.6.1現在)
/**
* @param $width コンテンツの横幅
* @return $width コンテンツの横幅
*/
add_filter(
'snow_monkey_content_width',
function( $width ) {
return $width;
}
);
ページヘッダータイトルの表示の有効 / 無効を設定する
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
);
ページヘッダーの表示の有効 / 無効を設定する
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
);
ページヘッダータイトルを設定する
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
);
ページヘッダー内のアイキャッチ画像サイズを設定
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
);
投稿タイトルのトリム文字数を指定
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
);
表示するページレイアウトの設定を行います。
※ このフックで設定可能なページレイアウトとは、「投稿の属性」の「テンプレート」に該当しているページ全体のレイアウトを指しています。
レイアウトのプロパティ値 | プロパティの説明 |
---|---|
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';
}
);
表示するビューを設定します
/**
* @param $view ビュー配列
* @return $view ビュー配列
*/
add_filter(
'snow_monkey_view',
function( $view ) {
return [
'slug' => 'templates/view/content',
'name' => 'post',
];
},
10
);
ソーシャルナビゲーションの各メニュー項目の出力を変更
※ Snow Monkey v6 ベータ2より追加 ※ 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
);
子ページのタイトルを設定します
表示するコントローラーを設定します
デフォルトでは「ログイン中のユーザーにはタグを出力しない」の設定が有効になっている場合に manage_options
の権限が付与されているユーザーの場合のみGoogleアナリティクスのタグ出力が行われません。
このフックでは、ログイン中であっても「Googleアナリティクスのトラッキング」の出力を行うか変更できます。
true
に設定した場合は出力を行い、false
に設定した場合に出力をしません。
add_filter( 'snow_monkey_output_google_analytics', '__return_true' );
デフォルトでは「ログイン中のユーザーにはタグを出力しない」の設定が有効になっている場合に manage_options
の権限が付与されているユーザーの場合のみGoogleアナリティクスのタグ出力が行われません。
このフックでは、ログイン中であっても「Googleアナリティクスのタグマネージャー」の出力を行うか変更できます。
true
に設定した場合は出力を行い、false
に設定した場合に出力をしません。
add_filter( 'snow_monkey_output_google_tag_manager', '__return_true' );
メニュー項目に説明を表示するかどうか
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
);
エディター上に表示されるブログカードの 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
);
ブログカードは、表示のたびに参照先ページの情報を取得すると速度がおそくなったり参照先ページに負荷をかけることになるため、一度取得した情報を一定時間キャッシュするようになっています。
キャッシュの有効期限が切れた場合に表示されるブログカードの 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
);
参照先ページから正しく情報が取得できなかった場合に表示されるブログカードの 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
);
ブログカードの 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
);
ウィジェットのテンプレートを格納するテンプレートルートを追加します。ウィジェットのテンプレートを読み込むときに、$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
);
ウィジェットに渡される引数を設定・変更します。
/**
* @since 8.0.0
* @param array $args
* @param array
*/
add_filter(
'snow_monkey_wp_awesome_widgets_view_args',
function( $args ) {
return $args;
}
);
ウィジェットの 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
);
デフォルトでは、ロゴサイズはカスタマイザー → デザイン → 基本デザイン設定 → ロゴサイズ設定で指定された値に基づいて自動的に縮小されますが、これを無効にしたい場合には false
を返してください。
/**
* @since 8.4.0
* @param boolean true
* @return boolean
*/
add_filter( 'snow_monkey_use_auto_custom_logo_size', '__return_false' );
テンプレートパーツ読み込み開始終了時のコメント出力、テンプレート上書き時に親テンプレートが更新/移動したときのデバッグコメント表示/ログ出力を有効化します。(WordPress のデバッグモードも有効にする必要があります。)
add_filter( 'snow_monkey_debug', '__return_true' );
ヘッダーが、simple
と left
以外の場合、ドロップナビゲーションを非表示に変更できます。
MEMO: これは false
を返却する事で、ドロップナビゲーションの表示を行わなくすることを想定したフックです。
補足: ドロップナビゲーションは、スクロールしたときに上からピロっとでてくるメニューのことです。
add_filter( 'snow_monkey_has_drop_nav', '__return_false' );
スマホのブラウザ閲覧時に表示されるアドレスバーの色(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'; // ここで好きなカラーコードを返却します
}
);
コメントフォームの引数を設定します
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;
}
);
ファイル読み込み方法を変更できます。
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
);
ブログカードキャッシュの保存先を変更できます。
add_filter(
'snow_monkey_oembed_blog_card_cache_directory',
function( $directory ) {
return $directory;
}
);
テンプレートキャッシュの保存先を変更できます。
add_filter(
'snow_monkey_template_cache_directory',
function( $directory ) {
return $directory;
}
);
エディターで選択できるカラーパレットの色を変更できます。
add_filter(
'snow_monkey_editor_color_palette',
function( $color_palette ) {
return $color_palette;
}
);
エディターで選択できるグラデーションプリセットをカスタマイズできます。
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',
],
]
);
}
);
エディターで選択できるフォントサイズの種類を変更できます。
add_filter(
'snow_monkey_editor_font_sizes',
function( $font_sizes ) {
return $font_sizes;
}
);
「more タグとパスワード保護を同時に使用している場合、more タグより前のコンテンツを表示する」のとき、more タグが入れ子にして配置している場合、その親ブロックの範囲においてコンテンツを保護するように変更できます。
add_filter(
'snow_monkey_protected_more_support_inner_blocks',
function() {
return true;
}
);