テンプレートタグの記事一覧|WordPressの専門家が作る教科書 https://wordpress.ks-product.com WordPressを活用したウェブサイトの制作方法を教えます Thu, 08 Oct 2026 14:27:53 +0000 ja hourly 1 https://wordpress.org/?v=7.1.5 get_template_part と include(require)の違い|WordPress テーマで PHP ファイルを読み込む方法の使い分け https://wordpress.ks-product.com/3174/ Sat, 17 Oct 2026 23:00:00 +0000 https://wordpress.ks-product.com/?p=3174 結論

WordPress テーマで PHP ファイルを読み込むときは、表示用の部品(テンプレートパーツ)は get_template_part()、関数やクラスの定義ファイルは require と使い分けます。

比べる点 get_template_part() include / require
子テーマでの上書き できる(子テーマ → 親テーマの順に探す) できない(書いたパスをそのまま読む)
変数の受け渡し $args(5.5.0 以降)で渡す。呼び出し元のローカル変数は見えない 呼び出し元の変数がそのまま見える
ファイルが無いとき 何も出力せず false を返す include は警告、require は致命的エラー
名前の候補 slug-name.php → slug.php と順に探す なし
向いている用途 ヘッダー以外の繰り返し部品(カード、ループの中身など) functions.php から inc/*.php を読む

get_template_part() のリファレンスは、この関数の目的を「子テーマが、テーマ内の再利用部分を上書きできる簡単な仕組みを提供する」と説明しています。

原因・仕組み

get_template_part( $slug, $name, $args ) は、{$slug}-{$name}.php と {$slug}.php の候補を作り、locate_template() に渡します。locate_template() は、有効なテーマ(子テーマ)のフォルダ → 親テーマのフォルダ → wp-includes/theme-compat/ の順にファイルを探し、最初に見つかったものを読み込みます。

読み込みは WordPress 内部の関数の中で行われるので、呼び出し元のローカル変数はテンプレートから見えません。WordPress 5.5.0 で第3引数 $args が追加され、配列で値を渡せるようになりました。読み込む前には get_template_part_{$slug} アクションが実行されます。

一方、include / require は PHP の構文なので、呼び出し元のスコープでファイルを実行し、子テーマの仕組みとは無関係です。

手順(サンプルコード)

テンプレートパーツを呼ぶ(値は $args で渡す)

// index.php など
while ( have_posts() ) {
    the_post();
    get_template_part( 'parts/card', get_post_type(), array( 'show_date' => true ) );
}
// parts/card.php
$show_date = ! empty( $args['show_date'] );
?>
<article <?php post_class( 'card' ); ?>>
    <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
    <?php if ( $show_date ) : ?>
        <time datetime="<?php echo esc_attr( get_the_date( 'c' ) ); ?>"><?php echo esc_html( get_the_date() ); ?></time>
    <?php endif; ?>
</article>

投稿タイプが news なら parts/card-news.php、無ければ parts/card.php が使われます。

定義ファイルは require で読む

// functions.php
require get_theme_file_path( 'inc/setup.php' );
require get_theme_file_path( 'inc/template-functions.php' );

get_theme_file_path() は子テーマにファイルがあれば子テーマ、無ければ親テーマのパスを返すので、パスの直書きより安全です(get_theme_file_path() の使い方|説明・引数・注意点)。

動作確認(検証環境と結果)

WordPress 7.1.2(ja)、PHP 8.2.12 の CLI 検証環境で、親テーマ wl1-parent(parts/card.php と parts/card-news.php)と、parts/card-news.php だけを持つ子テーマ wl1-child を作って有効化し、確認しました。

  • get_template_part( 'parts/card', 'news' ) → 子テーマの card-news.php が読み込まれた。
  • get_template_part( 'parts/card', 'event', array( 'title' => 'イベント' ) ) → card-event.php が無いので親テーマの card.php が読み込まれ、$args['title'] は イベント。呼び出し元で定義した変数 $local は見えなかった。
  • 同じパーツを2回呼ぶと、2回とも出力された(ループ内で使える)。
  • 存在しないパーツ parts/none の戻り値は false で、エラーは出なかった。
  • include get_template_directory() . '/parts/card-news.php' は、子テーマにファイルがあっても親テーマの内容を出力した。include した card.php では $local が見えた。
  • locate_template() は /themes/wl1-child/parts/card-news.php を返した。
  • get_template_part_parts/card アクションは、読み込みの直前に $name = 'news' で実行された。
  • 手順の parts/card を parts/card-post.php(投稿タイプ post 用)として置き、ループで $args に show_date => true を渡すと、
    と
  • get_template_part( ‘parts/card.php’ ) のように拡張子まで書くと、戻り値は alse で何も読み込まれなかった。
  • get_theme_file_path() は、子テーマにある parts/card-news.php では子テーマのパス、親テーマにしかない inc-setup.php では親テーマのパスを返した。
  • ob_start() / ob_get_clean() で囲むと、パーツの出力を文字列 ‘[child card-news]’ として受け取れた。
  • 確認後、Twenty Twenty-Five に戻してテーマを削除した。

ログは testsget-template-part-vs-include-difference.md にあります。

get_template_part と includeの違いの注意点

  • get_template_part() はファイルが無くても黙って false を返すので、ファイル名の誤字に気づきにくいです。開発中は戻り値を確認すると早く見つかります。
  • $args を使えるのは WordPress 5.5.0 以降です。
  • locate_template() に利用者の入力をそのまま渡さないでください。リファレンスのユーザーノートでも、ディレクトリトラバーサルを防がない点が指摘されています。get_template_part() の slug・name も同様に、固定値か許可リストから選びます。
  • ヘッダー・フッター・サイドバーは、専用の get_header()・get_footer()・get_sidebar() を使います。

get_template_part と includeの違いでよくあるミス

  • テンプレートパーツを include で読み、子テーマで上書きできない。
  • 呼び出し元の変数がパーツ内で使えると思い込み、未定義の警告を出す($args で渡す)。
  • get_template_part( 'parts/card.php' ) のように拡張子まで書き、card.php.php を探してしまう。
  • 関数定義ファイルを get_template_part() で読み、子テーマで同名ファイルを置いたときに二重定義になる。

get_template_part と includeの違いのチェックリスト

  • 表示部品は get_template_part()、定義ファイルは require にした
  • slug に拡張子を付けていない
  • パーツへの値は $args で渡している
  • slug・name に利用者の入力を使っていない
  • パスは get_theme_file_path() で組み立てた

get_template_part と includeの違いのFAQ(よくある質問)

Q. get_template_part() で読み込んだファイルの中で $post は使えますか?
A. ループ内なら the_title() などのテンプレートタグがそのまま使えます。テンプレートタグはグローバルの投稿データを参照するためです。

Q. 戻り値で HTML を受け取りたい
A. get_template_part() は出力する関数です。文字列で欲しいときは ob_start() と ob_get_clean() で囲みます。

Q. ブロックテーマでは?
A. ブロックテーマでは parts/ フォルダの HTML テンプレートパーツをサイトエディターで使うのが基本です。PHP のパーツはパターンファイルなどで使います。

筆者の見解(get_template_part と includeの違い)

include は PHP の基本なので手が伸びがちですが、テーマの表示部品については get_template_part() を選ぶ方が、子テーマや将来の改修に強いと考えます。特に「呼び出し元の変数が見えない」という制約は不便に見えて、実際にはパーツが何に依存しているかを $args で明示させる良い制約だと私は思います。反対に、関数定義まで get_template_part() で読むのは二重定義の原因になるので、表示と定義で読み込み方を分けるのがおすすめです。

get_template_part と includeの違いの関連項目

出典(一次情報)

]]>
the_post_thumbnail が表示されない原因と対処|アイキャッチの確認手順 https://wordpress.ks-product.com/3053/ Mon, 05 Oct 2026 15:06:00 +0000 https://wordpress.ks-product.com/3053/ 結論

the_post_thumbnail() が何も表示しないときは、次の順で確認すると原因を絞れます。

  1. その投稿にアイキャッチ画像が設定されているか(has_post_thumbnail( $post_id ))
  2. 関数が「どの投稿」を対象にしているか(ループの外、または get_posts() の結果を回している場合は、グローバルの $post が未設定)
  3. 指定したサイズが存在するか、サイズ別の画像が生成されているか
  4. テーマで add_theme_support( ‘post-thumbnails’ ) をしているか(編集画面にアイキャッチ欄が出ない問題)

確実なのは、投稿IDを明示する書き方です。ループやグローバル変数に頼らず、echo get_the_post_thumbnail( $post_id, 'medium' ); のように書きます。

原因・仕組み

the_post_thumbnail() は、現在のグローバル $post に設定されたアイキャッチを出力します。メインループやWP_Queryの the_post() の中なら、$post が自動で設定されます。

get_posts() の結果を foreach で回す場合は、そのままでは $post が設定されません。公式リファレンスにも、setup_postdata() はグローバルの $post を代入しないので、自分で代入すること、と書かれています。

テーマサポートについては、公式リファレンスで、add_theme_support( ‘post-thumbnails’ ) は after_setup_theme フックで呼ぶこと(init より前)、第2引数で投稿タイプを限定できること、が説明されています。これが無いと、編集画面のアイキャッチ欄が表示されません。

手順(サンプルコード)

テーマサポートの登録

add_action( 'after_setup_theme', function () {
    add_theme_support( 'post-thumbnails' );
    // 投稿タイプを限定する場合:
    // add_theme_support( 'post-thumbnails', array( 'post', 'ks_book' ) );
} );

ループ内

if ( has_post_thumbnail() ) {
    the_post_thumbnail( 'medium' );
}

get_posts() の結果を回す場合

global $post;
$items = get_posts( array( 'numberposts' => 3 ) );
foreach ( $items as $post ) {
    setup_postdata( $post );
    if ( has_post_thumbnail() ) {
        the_post_thumbnail( 'thumbnail' );
    }
}
wp_reset_postdata();

投稿IDを明示する方法(おすすめ)

foreach ( $items as $item ) {
    echo get_the_post_thumbnail( $item->ID, 'thumbnail' );
}

動作確認(検証環境と結果)

WordPress 7.1.2(日本語)、PHP 8.2.12、テーマ twentytwentyfive。800×600 の PNG を添付ファイルとして登録し、2件の投稿のうち1件にだけアイキャッチを設定しました(teststhe-post-thumbnail-not-showing.md に全文)。

確認内容 結果
テーマの post-thumbnails サポート true
has_post_thumbnail( 設定した投稿 ) / ( 未設定の投稿 ) true / false
get_the_post_thumbnail( 未設定の投稿 ) 空文字
get_the_post_thumbnail() をループ外、グローバル $post なしで呼ぶ 空文字
get_the_post_thumbnail( ID, ‘thumbnail’ ) img 要素が出力された(class に wp-post-image、loading=”lazy” と decoding=”async” が付与)
‘full’ を指定 800×600 の img
存在しないサイズ名 ‘nosuchsize’ を指定 元画像(800×600)の img が出る。class は attachment-nosuchsize size-nosuchsize
WP_Query のループで the_post_thumbnail(‘thumbnail’) 設定済みの投稿は出力、未設定の投稿は空
get_posts() の結果で、$post を設定せず the_post_thumbnail() 空文字
setup_postdata( $item ) だけ呼ぶ 空(グローバル $post が未設定のまま)
$GLOBALS[‘post’] = $item のあと setup_postdata( $item ) 出力された
remove_theme_support( ‘post-thumbnails’ ) 後に has_post_thumbnail() と get_the_post_thumbnail() どちらも設定済みの投稿では true と出力あり
添付ファイルを削除した後の has_post_thumbnail() false

テーマのサポートを外しても、すでに設定済みの投稿のアイキャッチは出力され続けました。サポートが影響するのは、主に編集画面でアイキャッチを設定する機能です。「編集画面にアイキャッチ欄が無い」場合はテーマサポート、「欄はあるが表示されない」場合は上の1〜3、と切り分けられます。

なお、この検証環境では PHP の GD 拡張が無効で、サムネイル用の画像ファイルは別途生成されませんでした(thumbnail を指定しても、src は元画像のファイルでした)。サイズ別の画像が生成されないと、サイズ指定が効かず、元画像が表示されます。画像処理ライブラリ(GD や Imagick)の有無と、サムネイルの再生成も確認してください。

the_post_thumbnail が表示されないときの注意点

  • アイキャッチの出力は、画像の存在確認(has_post_thumbnail)と組み合わせて、未設定のときの代替表示を用意します。
  • alt 属性は、添付ファイルの代替テキストが使われます。空のままだと、実測のとおり alt=”” で出力されます。
  • the_post_thumbnail() は echo します。値として受け取りたいときは get_the_post_thumbnail() を使います。
  • get_posts() のあとは、必ず wp_reset_postdata() で戻します。

the_post_thumbnail が表示されない原因と対処でよくあるミス

  • get_posts() の結果で、$post を代入せず the_post_thumbnail() を呼んで空になる。
  • setup_postdata() を呼べば $post も設定されると思い込む。
  • サイズを追加したのに、既存の画像が再生成されず、新しいサイズで出ない。
  • 編集画面にアイキャッチ欄が無い原因を、テンプレートのせいだと思い込む。

the_post_thumbnail が表示されない原因と対処のチェックリスト

  • 対象の投稿にアイキャッチが設定されているか。
  • ループ外なら、投稿IDを渡しているか。
  • get_posts() を回すとき、$post の代入と wp_reset_postdata() を書いたか。
  • after_setup_theme で add_theme_support しているか。
  • サイズ別の画像が生成されているか。

the_post_thumbnail が表示されない原因と対処のFAQ(よくある質問)

Q. アイキャッチが無い場合に代替画像を出すには。
A. has_post_thumbnail() が false のときに、テーマ内の既定画像の img を出力します。

Q. URL だけが欲しい。
A. get_the_post_thumbnail_url( $post_id, ‘medium’ ) を使います(get_the_post_thumbnail_url() の使い方|説明・引数・注意点)。

Q. サムネイルのサイズを変えたあと、画像が古いままです。
A. 既存の画像は自動では再生成されません。再生成用のプラグインや WP-CLI のコマンドを使います(このページでは未検証)。

筆者の見解(the_post_thumbnail が表示されない原因と対処)

私見では、アイキャッチの出力は「ループに頼る」より「投稿IDを渡す」書き方のほうが、不具合の原因を追いやすいと考えます。テンプレートの部品化が進んだテーマほど、どの投稿を対象にしているかが分かりにくくなるためです。get_the_post_thumbnail( $id ) を基本形にしておくと、get_posts() や REST の結果にもそのまま使えます。

the_post_thumbnail が表示されない原因と対処の関連項目

出典(一次情報)

]]>
get_post_class() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/2926/ https://wordpress.ks-product.com/2926/#respond Sat, 03 Oct 2026 12:29:03 +0000 https://wordpress.ks-product.com/?p=2926 説明

get_post_class() は、投稿に付けるクラスを、配列で返す関数です。post_class() が出力する内容の元になります。

基本構文

get_post_class( string|string[] $class = '', int|WP_Post $post = null ): string[]

引数

  • $class:追加するクラス
  • $post:投稿のIDまたはオブジェクト(省略すると、現在の投稿)

戻り値

クラス名の配列。

使い方(サンプル)

$classes = get_post_class( 'card' );
echo esc_attr( implode( ' ', $classes ) );

注意点

  • 出力せず、配列を返します。
  • class="..." を出力するときは、post_class()。

実務での使いどころ

  • 投稿のクラスを、PHPの中で、加工して使うとき。
  • クラスに、特定の値が含まれるかを、確認するとき。

よくあるミスと対策

  • 配列を、そのまま echo している。implode() で、文字列にしてから、出力する。
  • class="..." 全体を出力する post_class() と、取り違える。

NG例

echo get_post_class(); // 配列なので、「Array」になる

OK例

$classes = get_post_class( 'card' );
echo '<article class="' . esc_attr( implode( ' ', $classes ) ) . '">';

使い分け早見表

関数 役割
get_post_class() クラスの配列を、返す
post_class() class="..." を、出力する
get_body_class() <body> のクラスの配列を、返す

関連項目

post_class()、get_body_class()

公式リファレンス:get_post_class() | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/2926/feed/ 0
get_the_time() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/2507/ https://wordpress.ks-product.com/2507/#respond Sat, 03 Oct 2026 08:27:22 +0000 https://wordpress.ks-product.com/?p=2507 説明

get_the_time() は、投稿の公開日時を、書式を指定して文字列で返す関数です。

基本構文

get_the_time( string $format = '', int|WP_Post $post = null ): string|int|false

引数

  • $format:書式(省略すると、設定の時刻形式)
  • $post:投稿のIDまたはオブジェクト(省略すると、現在の投稿)

戻り値

書式にしたがった日時の文字列。取得できないときは false。

使い方(サンプル)

echo esc_html( get_the_time( 'Y年n月j日 H:i' ) );

注意点

  • 書式を省略すると、設定の時刻形式が使われ、日付が含まれません。日付を出すときは、書式を指定します。
  • 出力ではなく、値を返します。出力する関数は the_time()。

実務での使いどころ

  • 公開日時を、変数に入れて加工するとき。
  • <time datetime> に、c 形式の日時を入れるとき。

よくあるミスと対策

  • 書式を省略し、時刻だけが取得される。
  • echo し忘れる。
  • ループの外で、投稿を指定していない。

NG例

echo get_the_time(); // 時刻だけが出る場合がある

OK例

echo esc_html( get_the_time( 'Y年n月j日' ) );

使い分け早見表

関数 役割
get_the_time() 公開日時を、文字列で取得する
the_time() 公開日時を出力する
get_the_date() 公開日を、文字列で取得する

関連項目

the_time()、get_the_date()

公式リファレンス:get_the_time() | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/2507/feed/ 0
the_modified_date() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/2505/ https://wordpress.ks-product.com/2505/#respond Sat, 03 Oct 2026 08:27:20 +0000 https://wordpress.ks-product.com/?p=2505 説明

the_modified_date() は、投稿の最終更新日を出力する関数です。

基本構文

the_modified_date( string $format = '', string $before = '', string $after = '', bool $display = true ): string|void

引数

  • $format:日付の書式(省略すると、設定の日付形式)
  • $before:日付の前に出力する文字列
  • $after:日付の後に出力する文字列
  • $display:true で出力、false で戻り値として返す

戻り値

$display が true(既定)のときは、出力のみ。false のときは、文字列を返します。

使い方(サンプル)

the_modified_date( 'Y年n月j日', '更新日:' );

注意点

  • 一度も更新していない投稿では、公開日と同じ値になります。
  • ループの中で使います。

実務での使いどころ

  • 記事の「更新日」を表示するとき。

よくあるミスと対策

NG例

$date = the_modified_date(); // 出力されるだけで、変数には入らない

OK例

$date = get_the_modified_date( 'Y年n月j日' );

使い分け早見表

関数 役割
the_modified_date() 更新日を出力する
get_the_modified_date() 更新日を、文字列で取得する
get_the_date() 公開日を、文字列で取得する

関連項目

get_the_modified_date()、get_the_date()、the_date()

公式リファレンス:the_modified_date() | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/2505/feed/ 0
the_title_attribute() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/2501/ https://wordpress.ks-product.com/2501/#respond Sat, 03 Oct 2026 08:27:15 +0000 https://wordpress.ks-product.com/?p=2501 説明

the_title_attribute() は、投稿のタイトルを、HTMLの属性値(title や alt など)の中で使えるように、エスケープして出力する関数です。

基本構文

the_title_attribute( string|array $args = '' ): void|string|null

引数

  • before:タイトルの前に付ける文字列
  • after:タイトルの後に付ける文字列
  • echo:true で出力、false で戻り値として返す(既定は true)
  • post:投稿のIDまたはオブジェクト(省略すると、現在の投稿)

戻り値

echo が true(既定)のときは、出力のみ。false のときは、文字列を返します。

使い方(サンプル)

<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>">
	<?php the_title(); ?>
</a>

注意点

  • HTMLのタグは取り除かれ、属性値として使える形にエスケープされます。
  • ループの中で使います。

実務での使いどころ

  • title 属性や alt 属性に、投稿のタイトルを入れるとき。
  • リンクの aria-label に、タイトルを入れるとき。

よくあるミスと対策

  • the_title() を属性値に使い、タイトルの中の引用符やタグで、HTMLが壊れる。
  • 値として使いたいのに、echo を false にしておらず、その場に出力されてしまう。

NG例

<a href="<?php the_permalink(); ?>" title="<?php the_title(); ?>"> <!-- タイトルに引用符があると、壊れる -->

OK例

<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>">

使い分け早見表

関数 特徴
the_title_attribute() 属性値用にエスケープして出力する
the_title() 本文中に出力する(HTMLを含み得る)
get_the_title() タイトルを、文字列として取得する

関連項目

the_title()、get_the_title()

公式リファレンス:the_title_attribute() | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/2501/feed/ 0
next_post_link() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/2491/ https://wordpress.ks-product.com/2491/#respond Sat, 03 Oct 2026 08:26:38 +0000 https://wordpress.ks-product.com/?p=2491 説明

next_post_link() は、次の投稿(公開日が1つ新しい投稿)へのリンクを出力する関数です。個別の投稿ページで使います。

基本構文

next_post_link( string $format = '%link &raquo;', string $link = '%title', bool $in_same_term = false, int[]|string $excluded_terms = '', string $taxonomy = 'category' );

引数

  • $format:リンク全体の書式。%link の部分が、リンクに置き換わる
  • $link:リンクの文字列。%title は、投稿のタイトルに置き換わる
  • $in_same_term:true にすると、同じタームの投稿だけが対象
  • $excluded_terms:除外するターム
  • $taxonomy:$in_same_term で使うタクソノミー(既定は category)

戻り値

戻り値はありません。リンクのHTMLを出力します。次の投稿がないときは、何も出力しません。

使い方(サンプル)

next_post_link( '%link &raquo;', '%title', true );

注意点

  • 個別の投稿ページで使います。
  • 次の投稿がないときは、$format も含めて、何も出力されません。

実務での使いどころ

  • ブログ記事の下に、「次の記事」へのリンクを出すとき。
  • 同じカテゴリーの中で、次の記事へ移動できるようにするとき。

よくあるミスと対策

  • リンクの枠のHTMLを、$format の外に書いている。次の投稿がないとき、空の枠が残る。枠は $format に含める。
  • アーカイブページで使っている。個別の投稿ページで使う。
  • カスタムタクソノミーで絞りたいのに、$taxonomy を指定していない。

NG例

echo '<div class="next">';
next_post_link();
echo '</div>'; // 次の投稿がないと、空の div が残る

OK例

next_post_link( '<div class="next">%link</div>', '次の記事:%title' );

使い分け早見表

関数 出力・取得するもの
next_post_link() 次の投稿へのリンクのHTMLを出力する
previous_post_link() 前の投稿へのリンクのHTMLを出力する
get_adjacent_post() 前後の投稿を、オブジェクトで取得する

関連項目

previous_post_link()、get_adjacent_post()、get_permalink()

公式リファレンス:next_post_link() | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/2491/feed/ 0
previous_post_link() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/2489/ https://wordpress.ks-product.com/2489/#respond Sat, 03 Oct 2026 08:26:36 +0000 https://wordpress.ks-product.com/?p=2489 説明

previous_post_link() は、前の投稿(公開日が1つ古い投稿)へのリンクを出力する関数です。個別の投稿ページで使います。

基本構文

previous_post_link( string $format = '&laquo; %link', string $link = '%title', bool $in_same_term = false, int[]|string $excluded_terms = '', string $taxonomy = 'category' );

引数

  • $format:リンク全体の書式。%link の部分が、リンクに置き換わる
  • $link:リンクの文字列。%title は、投稿のタイトルに置き換わる
  • $in_same_term:true にすると、同じタームの投稿だけが対象
  • $excluded_terms:除外するターム
  • $taxonomy:$in_same_term で使うタクソノミー(既定は category)

戻り値

戻り値はありません。リンクのHTMLを出力します。前の投稿がないときは、何も出力しません。

使い方(サンプル)

previous_post_link( '&laquo; %link', '%title', true );

注意点

  • 個別の投稿ページで使います。
  • 前の投稿がないときは、$format も含めて、何も出力されません。

実務での使いどころ

  • ブログ記事の下に、「前の記事」へのリンクを出すとき。
  • 同じカテゴリーの中で、前の記事へ移動できるようにするとき。

よくあるミスと対策

  • リンクの枠のHTMLを、$format の外に書いている。前の投稿がないとき、空の枠が残る。枠は $format に含める。
  • アーカイブページで使っている。個別の投稿ページで使う。
  • カスタムタクソノミーで絞りたいのに、$taxonomy を指定していない。

NG例

echo '<div class="prev">';
previous_post_link();
echo '</div>'; // 前の投稿がないと、空の div が残る

OK例

previous_post_link( '<div class="prev">%link</div>', '前の記事:%title' );

使い分け早見表

関数 出力・取得するもの
previous_post_link() 前の投稿へのリンクのHTMLを出力する
next_post_link() 次の投稿へのリンクのHTMLを出力する
get_adjacent_post() 前後の投稿を、オブジェクトで取得する

関連項目

next_post_link()、get_adjacent_post()、get_permalink()

公式リファレンス:previous_post_link() | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/2489/feed/ 0
edit_post_link() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/2457/ https://wordpress.ks-product.com/2457/#respond Sat, 03 Oct 2026 08:20:49 +0000 https://wordpress.ks-product.com/?p=2457 説明

edit_post_link() は、投稿の編集画面へのリンクを出力する関数です。編集の権限があるユーザーにだけ、表示されます。

基本構文

edit_post_link( string $text = null, string $before = '', string $after = '', int|WP_Post $post = 0, string $css_class = 'post-edit-link' );

引数

  • $text:リンクの文字列(省略すると、既定の文言。日本語環境では「編集」など)
  • $before:リンクの前に出力するHTML
  • $after:リンクの後に出力するHTML
  • $post:投稿のIDまたはオブジェクト(省略すると現在の投稿)
  • $css_class:リンクに付けるCSSクラス

戻り値

戻り値はありません。リンクのHTMLを、その場に出力します。

使い方(サンプル)

edit_post_link( '編集', '<p class="edit">', '</p>' );

注意点

  • 編集の権限がないユーザーには、何も出力されません。
  • ループの中で使うのが基本です。

実務での使いどころ

  • ログイン中の管理者や編集者に、記事から編集画面へ、すぐ移動できるリンクを出すとき。
  • テーマのデザインに合わせて、リンクの文言やクラスを変えるとき。

よくあるミスと対策

  • リンクの前後に、自分でHTMLを書いている。権限のないユーザーには、リンクだけでなく、前後の $before・$after も出力されない。前後のHTMLは、引数で渡す。
  • 値として使いたいのに、これを使っている。この関数は出力するだけ。URLは get_edit_post_link() で取得する。
  • ループの外で、投稿を指定せずに呼んでいる。

NG例

echo '<p class="edit">';
edit_post_link();
echo '</p>'; // 権限がないユーザーにも、空の段落が残る

OK例

edit_post_link( '編集', '<p class="edit">', '</p>' );

使い分け早見表

関数 返す・出力するもの
edit_post_link() 編集リンクのHTMLを出力する
get_edit_post_link() 編集画面のURLを返す(権限がなければ null)
admin_url() 管理画面のURL

関連項目

get_edit_post_link()、admin_url()

公式リファレンス:edit_post_link() | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/2457/feed/ 0
the_permalink() の使い方|説明・引数・注意点 https://wordpress.ks-product.com/186/ https://wordpress.ks-product.com/186/#respond Fri, 02 Oct 2026 15:42:03 +0000 https://wordpress.ks-product.com/186/ 説明

the_permalink() は、現在の投稿のパーマリンク(URL)を出力する関数です。

基本構文

the_permalink( int|WP_Post $post = 0 ): void

引数

  • $post:投稿IDまたはオブジェクト

戻り値

戻り値はありません(出力します)。

使い方(サンプル)

// ループ内で使用
the_permalink();

注意点

  • URLを変数に入れたいときは get_permalink() を使います。
  • 出力時にエスケープ処理(esc_url フィルター)が行われます。

実務での使いどころ

  • ループの中で、投稿のURLを出力するとき(リンクの href など)。

よくあるミスと対策

  • echo the_permalink() のように、echo を付けている。the_permalink() は、それ自体が出力する。
  • 値として使いたいのに、これを使っている。値の取得は get_permalink()。
  • ループの外で呼び、意図した投稿のURLにならない。

NG例

echo the_permalink(); // それ自体が出力する関数なので、echo は不要

OK例

<a href="<?php the_permalink(); ?>">記事へ</a>

使い分け早見表

やりたいこと 使うもの
投稿のURLを出力 the_permalink()
投稿のURLを文字列で取得 get_permalink()
投稿IDからURLを取得 get_permalink( $id )

関連項目

get_permalink()、esc_url()

公式リファレンス:the_permalink() | Function | WordPress Developer Resources

]]>
https://wordpress.ks-product.com/186/feed/ 0