逆引きゴリラ

News
2021/01/12 設定値の解説記事を 2 件追加しました。
  1. ホーム
  2. フック
  3. snow_monkey_controller

snow_monkey_controller

フックタイプ

フィルターフック

説明

ページ表示の処理を行うテンプレートコントローラーを変更します。

補足説明

Snow Monkey テーマのテンプレートコントローラーとは、ページを表示する際の基本となっているファイルです。

Snow Monkey テーマには、下記のテンプレートのコントローラーファイルが存在しています。(v12 現在)

  • archive.php
  • attachment.php
  • front-page.php
  • home.php
  • 404.php
  • search.php
  • singular.php
  • page-templates/bank-content.php
  • page-templates/blank-slim.php
  • page-templates/blank.php
  • page-templates/left-sidebar.php
  • page-templates/one-column-full.php
  • page-templates/one-column-slim.php
  • page-templates/one-column.php
  • page-templates/right-sidebar.php

例えば、home.php、または front-page.php404.php にした場合には、トップページをページが見つからない際に表示される 404 ページのような表示にできます。

また、簡単にオリジナルのページデザインを表示させることも可能となります。

  • 特定の URL のページ表示をオリジナルデザインとする場合は静的ビューテンプレート機能の使用を推奨します。
  • 静的ビューテンプレート機能とは違い、条件に一致するページすべてのテンプレートコントロールを変更できます。

引数

引数名タイプ説明
$template文字列(string)テンプレートのコントローラーの PHP ファイルのフルパス

引数 $template は、必ずフルパスで設定する必要があります。

返却値

変数名タイプ説明
$template文字列(string)テンプレートのコントローラーの PHP ファイルのフルパス

変数 $template は、必ずフルパスで設定する必要があります。

サンプルコード

my-snow-monkey.php
<?php

  … 略 …

  add_filter(
    'snow_monkey_controller',
    function( $template ) {

      … ここに「テンプレートの変更条件などの処理」を記述しましょう …

      return $template;
    }
  );