WordPressの仕組み〜テンプレートファイルの優先順位

2022 7/15

2018-07-28 2022-07-15

「テーマを作りたいんだけど、どのテンプレートを作ればいいの？」
「ページを表示するとき、テーマ内ファイルはどう使われるの？」

WordPressテーマをカスタマイズしていて、こんな疑問がでてきたので、WordPressのテンプレートファイルが選ばれる仕組みについて調べてみました。

WordPressはページによってどのテンプレートファイルを使うか決まっている

ページの種類によって、WordPress側テーマ内でどのファイルを使うかを自動で選んでくれます。

テーマのファイル構成

テーマはテンプレートファイル（PHPファイル）で構成されています。

＜assetsフォルダ内＞
css、画像、javascriptなど、装飾に必要なファイルが入っています。

＜コンテンツを表示するための主なテンプレート群＞

index.php、front-page.php ：トップページ用のテンプレート
page.php：固定ページ用のテンプレートファイル
single.php：記事投稿用のテンプレートファイル
archive.php：記事一覧用のテンプレートファイル
404.php：ページが見つからない時に表示するテンプレートファイル
search.php、seachform.php：サイト内検索用のテンプレートファイル
header.php、footer.php、sidebar.php、comments.php：ヘッダー、フッター、サイドバー、コメントなど、共通して使うパーツを切り出したファイル
functions.php：テーマ内で使う機能を記述したファイル
screenshot.png：テーマのイメージ画像

最低限必要なのはこの２つ
index.php（ページの表示を記述するテンプレートファイル）
index.phpは他に使えるファイルがなかったときに、最終的に使われるテンプレートファイルになっています。
style.css（ページの装飾を記述するCSSファイル）

テンプレートファイルの優先順位

ページの種類によって、どのテンプレートファイルを使うかは優先順位が決まっています。この順番はファイル名で判断されています。

テーマを作るときは、コンテンツに沿って、上記に応じたファイル名をつけてあげてください。

表示中のページに、どのテンプレートファイルを使われているかを確認する

<?php
    global $template;
    $template_name = basename($template, '.php');
    echo $template_name;
?>

【参考記事】WordPress で使用中のテンプレートファイル名を表示する方法 – by Takumi Hirashima

また管理バーに使用中のテンプレートファイル名を表示させるプラグインもあるようなので、テーマ開発時に使っても良さそうです。。
【参考記事】WordPressで使用されているテンプレートファイル名を管理バーに出力するプラグイン

共通パーツはモジュールテンプレートに書く

WordPressのテンプレートは１ファイルに１ページというわけではなく
パーツごとにファイルに切り出すことができます。

基本のモジュール

よく使う共通パーツを表にしました。

<?php get_header();?>
    <main role="main">
        <div class="container">
            <?php get_template_part('loop'); ?>
            <?php get_sidebar(); // sidebar.phpを読み込む?>
        </div>
    </main>
<?php get_footer(); // footer.phpを呼び出す?>

モジュールテンプレートの具体的な記述方法は、トップページのテンプレートの作り方をご覧ください。

カスタムモジュール

上記以外にも、必要に応じて、モジュールテンプレートを作ることができます。

上の例では、<?php get_template_part(‘loop’); ?>はloop.phpを呼び出すコードになります。

loop.phpには記事一覧の表示コードを記述しています。

<?php if(have_posts()):
    while(have_posts()): the_post(); ?>
        <article id="post-<?php the_ID(); ?>" <?php post_class();?>>
            <?php the_category(', '); ?>
            <a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
            <?php the_excerpt(); ?>
        </article>
    else : ?>
        <p>投稿が見つかりません。</p>
<?php endif; ?>