この記事にはプロモーションが含まれています。

【WordPress】カスタム投稿タイプのアーカイブページと個別ページを作成

【WordPress】カスタム投稿タイプのアーカイブページと個別ページを作成

ケケンタ

カスタム投稿タイプのアーカイブページや個別ページの作成方法が分からない……

WordPressでカスタム投稿タイプを利用して

  • カスタム投稿タイプのアーカイブページ
  • カスタム投稿タイプの個別ページ

を作成する方法を解説します。

この記事を読むと分かること
  • WordPressプラグイン「CPT UI」でカスタム投稿タイプを追加する方法
  • カスタム投稿タイプのアーカイブページを作成する方法
  • カスタム投稿タイプの個別ページを作成する方法
  • 作成した各ページをリンクで繋ぐ方法



ケケンタ

ケケンタのITブログでは、WebアプリPHPLaravel)やWeb制作WordPressコーディング)について情報を発信しています。
学習中の方や実務をされている方など多くの方にアクセスいただいていますので、ぜひほかの記事も参考にしてみてください!


運動不足、気になっていませんか?

もしプログラミング学習やお仕事で運動不足が気になっているなら
連続屈伸運動がおすすめです!

ボタンにカーソルを合わせるだけ
カウントダウンが始まるタイマーをご用意してみました!

ケケンタ

無理のない範囲で、ぜひ隙間時間に屈伸運動を取り入れてみて下さい!

タイマースタート

3:00

※運動不足だと連続3分で取り組んでもかなり息が切れます
(僕は加えて気分もちょっと悪くなりました……)
絶対にご無理の無い範囲でお取り組みください!


目次

作業全体の流れ

CPT UIを使用してカスタム投稿タイプやそのアーカイブページ、個別ページを作成する方法を開設するにあたり、まずはザックリと全体の流れをお伝えします。

CPT UIを使用してカスタム投稿タイプの
アーカイブページと個別ページを作成する流れ
  • CPT UIをインストールする
  • CPT UIでカスタム投稿タイプ作成する
  • カスタム投稿タイプのアーカイブページ用のファイルを用意する
  • カスタム投稿タイプの個別ページ用のファイルを用意する
ケケンタ

それでは順番に解説していきます。

すでにカスタム投稿タイプの作成までお済の方は
【手順③】カスタム投稿タイプのアーカイブページ用のファイルを用意する
からご覧ください。

STEP1 CPT UIをインストールする

CPT UIとは?

CPT UI(正式名:Custom Post Type UI)は、WordPressプラグインのひとつで、カスタム投稿タイプを簡単に追加できるようにするためのプラグインです。

今回はこのCPT UIを使用してカスタム投稿タイプを作成し、そのアーカイブページや個別ページを作成する方法を解説していきます。

ケケンタ

それではまずはCPT UI(Custom Post Type UI)をWordPressにインストールしていきましょう。

STEP
「プラグイン」→「新規プラグイン追加」をクリックする

管理画面にある「プラグイン」→「新規プラグイン追加」をクリックします。

「新規プラグインを追加」項目
「新規プラグインを追加」項目
STEP
「プラグインの検索」フォームに「CPT UI」と入力する

以下の画像のように、画面右上にある「プラグインの検索」フォームに「CPT UI」と入力します。

「プラグインの検索」フォームにCPT UIと入力
「プラグインの検索」フォームにCPT UIと入力
ケケンタ

すると、以下のような検索結果が表示されるかと思います。

プラグイン検索結果
プラグイン検索結果
STEP
「今すぐインストール」をクリックする

続いて、「Custom Post Type UI」の「今すぐインストール」をクリックします。

「今すぐインストール」をクリック
「今すぐインストール」をクリック
STEP
「有効化」をクリックする

ボタンの表示が「有効化」に変わるので、それをクリックします。

「有効化」をクリックする
「有効化」をクリックする
STEP
「今すぐリロードする」をクリックする

すると、画面上部に「今すぐリロードする」ボタンが表示されるため、それをクリックします。

「今すぐリロードする」をクリックする

テーマによっては「今すぐリロードする」ボタンが表示されません。
その場合は、お使いのキーボードの「Ctrl + R」キーを押してページ更新を行ってください。

ケケンタ

ここまで完了すると、以下のように管理画面の左メニューの下の方に「CPT UI」の項目が追加されます。

管理画面の左メニューに「CPT UI」が追加される
管理画面の左メニューに「CPT UI」が追加される

STEP2 CPT UIでカスタム投稿タイプ作成する

ケケンタ

CPT UIをインストールできたら、続いてカスタム投稿タイプを作成していきます。

STEP
「CPT UI」→「投稿タイプの追加と編集」をクリック

まずは「CPT UI」→「投稿タイプの追加と編集」をクリックします。

「CPT UI」→「投稿タイプの追加と編集」をクリック
「CPT UI」→「投稿タイプの追加と編集」をクリック
STEP
投稿タイプ情報を入力する

以下のような画面が表示されたら、続いて「投稿タイプ情報」を入力していきます。

画面左下の「投稿タイプを追加」ボタンはまだ押さないようにして下さい

投稿タイプ情報の入力画面
投稿タイプ情報の入力画面

(例)入力する情報

項目名入力内容
投稿タイプスラッグsample
複数形のラベルサンプル
単数形のラベルサンプル
(例)入力する情報

各項目は任意の分かりやすいもので大丈夫です
※「投稿タイプスラッグ」はファイル名やソースコード上でも使用します。

入力後

投稿タイプ情報入力後の状態
投稿タイプ情報入力後の状態

「投稿タイプを追加」ボタンは押さずに次のステップへお進み下さい。
もし押してしまった場合は、画面上部にある以下の「投稿タイプを編集」タブを押してください。

「投稿タイプを編集」タブ
「投稿タイプを編集」タブ
STEP
「投稿タイプ」の「設定」内容を入力する

次に、「投稿タイプ」でアーカイブページが出力されるように設定を行っていきます。

同じ画面のまま、下の方へしばらくスクロールしていくと「アーカイブあり」という項目が見えてきます。

「アーカイブあり」項目
「アーカイブあり」項目

デフォルトでは「False」になっているため、これを「True」に変更します。

「True」に変更する
「True」に変更する

この手順はスキップすることも可能ではあるのですが、WordPressの仕組み上、上記のように「True=有効」にすることで、このあと作成するアーカイブ用ファイルの作成が楽になります。

STEP
「投稿タイプを保存」をクリックする

最後に、ページ最下部にある「投稿タイプを保存」ボタンをクリックします。

「投稿タイプを保存」をクリックする
「投稿タイプを保存」をクリックする
ケケンタ

管理画面の左メニューに「サンプル」(STEP2で入力したラベル名)という項目が表示されていればここまでの手順は順調です。

STEP3 カスタム投稿タイプのアーカイブページ用のファイルを用意する

ここからは実際に必要なファイル作成を行っていきます。

掲載するディレクトリはローカル上でのものになりますが、実際にファイル配置する際にはご自身の環境(本番サーバー)で作業をお進めください。

ケケンタ

それでは実際にファイルを作成する手順をご説明します。

STEP
テーマディレクトリ直下に「archive-○○○○.php」を作成する

テーマディレクトリ直下にアーカイブ用のPHPファイル(テンプレートファイル)を作成します。

このとき、ファイル名は

archive-「CPT UIで設定した『投稿タイプスラッグ』」.php

として下さい。

(例)ファイル名

投稿タイプスラッグを「sample」とした場合、
archive-sample.php
にする。

(例)ファイルの作成

archive-○○○○.phpを作成
archive-○○○○.phpを作成

archive-○○○○.phpとすることで「『○○○○』というスラッグを持つ投稿タイプのアーカイブページ用ファイル」であることをWordPressに伝えることができます。
これにより、実際に「○○○○」のアーカイブページにアクセスしたときarchive-○○○○.phpが呼び出されます。

STEP
作成したファイルの中にソースコードを記述する

続いて作成したファイルの中に以下のソースコードを記述します。

<?php get_header(); ?>

<div>
    <?php if ( have_posts() ) : ?>
        <?php while ( have_posts() ) : the_post(); ?>
            <!-- カスタム投稿個別ページへのリンク -->
            <p>
              <a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
            </p>
        <?php endwhile; ?>
    <?php endif; ?>
</div>

<?php get_footer(); ?>
ケケンタ

ここまででいったんアーカイブページの作成は完了なのですが、実際の表示を見てみたいという方は以下のSTEP3以降もお進めください。

STEP
「【手順②】CPT UIでカスタム投稿タイプ作成する」で作成したカスタム投稿タイプにいくつかサンプル用の投稿記事を追加する

通常の「投稿」と同じ要領で、先ほど作成したカスタム投稿タイプに記事を追加します。

STEP
アーカイブページへアクセスしてみる

STEP3でサンプルの記事をいくつか追加できたら、実際にアーカイブページへアクセスしてみましょう。

アクセスする際は以下のURLをアドレスバーにご入力ください。

https://ドメイン/カスタム投稿タイプのスラッグ

(例)アーカイブページのURL
※カスタム投稿タイプのスラッグが「sample」の場合

https://kekenta-it-blog.com/sample

ケケンタ

すると、アーカイブページと共に追加したサンプル記事の一覧が表示されたかと思います。

サンプル記事一覧
サンプル記事一覧

STEP4 カスタム投稿タイプの個別ページ用のファイルを用意する

ここまでの手順でカスタム投稿タイプのアーカイブページが作成できました。

続いては、アーカイブページの個別リンクから繋がる個別ページを作成していきます。

STEP
テーマディレクトリ直下に「single-○○○○.php」を作成する

個別ページ用のPHPファイル(テンプレートファイル)を作成します。

このとき、ファイル名は

single-「CPT UIで設定した『投稿タイプスラッグ』」.php

として下さい。

(例)ファイル名

投稿タイプスラッグを「sample」とした場合、
single-sample.php
にする。

ファイルの作成例

single-○○○○.phpを作成
single-○○○○.phpを作成

アーカイブページのときと同様の理屈で、single-○○○○.phpとすることで「『○○○○』というスラッグを持つ投稿タイプの個別ページ用ファイル」であることをWordPressに伝えることができます。
これにより、実際に「○○○○」の個別ページにアクセスしたときsingle-○○○○.phpが呼び出されます。

STEP
作成したファイルの中にソースコードを記述する

続いて作成したファイルの中に以下のソースコードを記述します。

<?php get_header(); ?>

<!-- タイトル -->
<?php the_title(); ?>
	
<!-- カスタム投稿本文 -->
<?php the_content(); ?>
		
<!-- カスタム投稿アーカイブページへのリンク -->
<a href="<?php echo esc_url(get_post_type_archive_link('カスタム投稿タイプのスラッグ')); ?>">アーカイブページ</a>

<?php get_footer(); ?>

ハイライト行(17行目)はアーカイブページへのリンクになっています。
get_post_type_archive_link(‘カスタム投稿タイプのスラッグ’)と記述することで、指定したスラッグのアーカイブページのリンクを取得できます。

(例)スラッグが「sample」の場合
get_post_type_archive_link(‘sample’)

ケケンタ

以上で個別ページの作成も完了です!
実際の表示を見てみたいという方は、アーカイブページにある個別ページリンクをクリックしてみて下さい。

アーカイブページのソースコードにあった以下の部分が個別ページへのリンクになっています。

<!-- カスタム投稿個別ページへのリンク -->
<p>
  <a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
</p>

the_permalink()で個別ページのURLを出力しています。

まとめ

ケケンタ

ここまでお疲れさまでした!

記事で見ると工程が長めなので初めて作成した方などにとって大変な作業だったのではないかと思います。

しかし、改めて

CPT UIを使用してカスタム投稿タイプのアーカイブページ・個別ページを作成する手順

を見てみると、大枠としてはそれほど複雑でないことがお分かりになるかと思います。

CPT UIを使用してカスタム投稿タイプの
アーカイブページと個別ページを作成する流れ
  • CPT UIをインストールする
  • CPT UIでカスタム投稿タイプ作成する
  • カスタム投稿タイプのアーカイブページ用のファイルを用意する
  • カスタム投稿タイプの個別ページ用のファイルを用意する

何度か経験すればおおよその流れは掴めるかと思うので、今後もこの記事を参考にしていただけると嬉しいです。

ケケンタ

この記事が少しでもお役に立ったなら何よりです。
長い記事となりましたが、最後までご覧いただきありがとうございました!

当ブログではWordPressやWeb制作、PHPに関するお役立ち情報を発信しています。

ご興味のある方はぜひほかの記事もご覧いただけると嬉しいです。

カスタム投稿タイプのアーカイブページと個別ページを作成する方法のアイキャッチ画像

この記事が気に入ったら
フォローしてね!

この記事が良いと思ったらシェアしてね!

コメント

コメントする

CAPTCHA


目次