📁 WordPressでよく使うデータの取得・出力関数まとめ【初心者向け】

Featured image of the post

概要

WordPressでよく使う「投稿データ表示関数」「投稿データ取得関数」を備忘録としてまとめた。

表示関数と取得関数

関数は大きく以下の2種類に分類される。

関数の種類 説明 用途 補足
the_〇〇 〇〇を表示する 投稿データを表示したいときに使う。
get_the_〇〇 〇〇を取得する 投稿データをプログラムの処理内で使用したいときに使う。 echo関数と併用すればthe_〇〇と同じような動作になる。(*1)
echo( get_the_〇〇() )
💡
(*1)
the_〇〇とget_the_〇〇の値は必ずしも同じとは限らない。さらにセキュリティ上重要な処理が抜け落ちることもあるので関数を使うときは公式ドキュメントを確認するのがおすすめ

関数一覧

よく使う関数をまとめた。クリックで展開可能✅

記事ID
記事のリンク
<?php the_permalink(); ?>(表示関数)
<?php get_the_permalink(); ?>(取得関数)

表示・取得できる値の例

💡
http://localhost/wp-test/aaa/

【補足】リンク付きタイトルを表示する例
<a href="<?php the_permalink(); ?>"><?php echo get_the_title(); ?></a>

記事のタイトル
<?php the_title(); ?>(表示関数)
<?php get_the_title(); ?>(取得関数)

表示・取得できる値の例

💡
朝のルーティン - より充実した一日を迎えるために

記事の抜粋
<?php the_excerpt(); ?>(表示関数)
<?php get_the_excerpt(); ?>(取得関数)

表示・取得できる値の例

💡
こんにちは、みなさん!今日は私の朝のルーティンについてお話ししたいと思います。朝は一日のスタートを切る大切な時間であり、どのように過ごすかがその日の調子を左右することもあります。私は数年間にわたり、自分の朝のルーティンを […]

記事の本文
<?php the_content(); ?>(表示関数)
<?php get_the_content(); ?>(取得関数)

表示・取得できる値の例

💡
こんにちは、みなさん!今日は私の朝のルーティンについてお話ししたいと思います。朝は一日のスタートを切る大切な時間であり、どのように過ごすかがその日の調子を左右することもあります。私は数年間にわたり、自分の朝のルーティンを磨き上げてきました。以下に、私が行っている朝の習慣をいくつかご紹介します。
  1. 早起き
  2. ストレッチと運動
  3. 朝食の準備
  4. 目標設定と計画
  5. 読書や学習

以上が私の朝のルーティンの一部です。皆さんも自分に合った朝のルーティンを作り、良い一日を迎えてくださいね!

記事の投稿日
<?php the_date(); ?>(表示関数)
<?php get_the_date(); ?>(取得関数)

表示・取得できる値の例

💡
2023年5月31日

注意

the_date()は同じ日付に投稿された記事がある場合何も表示されない。
(the_dateは1日に複数記事の投稿があった場合、最新の投稿だけに投稿日時を出力する。)

表示形式の指定方法は以下を参照

記事の投稿時刻
<?php the_time(); ?>(表示関数)
<?php get_the_time(); ?>(取得関数)

表示・取得できる値の例

💡
7:59 AM

記事の更新日
<?php the_modified_date(); ?>(表示関数)
<?php get_the_modified_date(); ?>(取得関数)

表示・取得できる値の例

💡
2023年5月31日

記事の投稿者名
<?php the_author(); ?>(表示関数)
<?php get_the_author(); ?>(取得関数)

表示・取得できる値の例

💡
testuser

記事のカテゴリ名(リンク付き)
<?php the_category(); ?>(表示関数)
<?php get_the_category(); ?>(取得関数)

表示・取得できる値の例

💡

アイキャッチ画像
<?php the_post_thumbnail(); ?>(表示関数)
<?php get_the_post_thumbnail(); ?>(取得関数)

表示・取得できる値の例

💡
<img width="640" height="480" src="http://localhost/wp-test/wp-content/uploads/2023/05/26184822_s.jpg" class="attachment-post-thumbnail size-post-thumbnail wp-post-image" alt="" decoding="async" srcset="http://localhost/wp-test/wp-content/uploads/2023/05/26184822_s.jpg 640w, http://localhost/wp-test/wp-content/uploads/2023/05/26184822_s-300x225.jpg 300w" sizes="(max-width: 640px) 100vw, 640px">

参考サイト

より詳細なサイト