URL・パス取得の記事一覧|WordPressの専門家が作る教科書 https://wordpress.ks-product.com WordPressを活用したウェブサイトの制作方法を教えます Thu, 15 Oct 2026 19:27:50 +0000 ja hourly 1 https://wordpress.org/?v=7.1.5 get_template_directory_uri と get_stylesheet_directory_uri の違い|子テーマでの使い分け https://wordpress.ks-product.com/3059/ Mon, 05 Oct 2026 15:12:00 +0000 https://wordpress.ks-product.com/3059/ 結論

子テーマを使っているサイトで、URL を取得する関数を間違えると、「画像が出ない」「CSS が 404」になります。使い分けは次のとおりです。

関数 返すもの 子テーマ使用時
get_template_directory_uri() 親テーマ(template)の URL 常に親テーマ
get_stylesheet_directory_uri() 有効なテーマ(stylesheet)の URL 子テーマ
get_theme_file_uri( $file ) 子テーマにファイルがあれば子、無ければ親の URL 子 → 親の順に探す

迷ったら、get_theme_file_uri() と get_theme_file_path() を使います。子テーマで上書きされたファイルも、自動で正しい側を指します。親テーマ側のファイルを必ず指したいとき(親の style.css を読み込む等)だけ、get_template_directory_uri() を使います。

原因・仕組み

WordPress のテーマには、template(親テーマのディレクトリ名)と stylesheet(有効なテーマのディレクトリ名)の2つの設定があります。親テーマ単体で使っている場合は同じ値、子テーマを有効にしている場合は異なる値になります。get_template_directory_uri() は前者、get_stylesheet_directory_uri() は後者を基準にします。公式リファレンスにも、子テーマの URL が欲しいときは get_stylesheet_directory_uri() を使う旨と、末尾にスラッシュが付かない旨が記載されています。また、get_theme_file_uri() は 4.7.0 で追加され、子テーマと親テーマを考慮して URL を返します。

get_template_directory_uriは常に親テーマ、get_stylesheet_directory_uriは子テーマ、get_theme_file_uriは子にファイルがあれば子、無ければ親のURLを返す子テーマを有効にしているとき、関数が返す URL親テーマのフォルダ(template)子テーマのフォルダ(stylesheet)get_template_directory_uri()get_stylesheet_directory_uri()get_theme_file_uri( $file )子にファイルがあれば子、無ければ親迷ったら get_theme_file_uri()。末尾にスラッシュは付かない
親テーマ単体で使っているときは、template と stylesheet は同じフォルダ。get_theme_file_uri() は 4.7.0 で追加。

手順(サンプルコード)

add_action( 'wp_enqueue_scripts', function () {
    // 親テーマの CSS(親の style.css を読む)
    wp_enqueue_style( 'parent-style', get_template_directory_uri() . '/style.css', array(), null );
    // 子テーマの CSS(子の style.css)
    wp_enqueue_style( 'child-style', get_stylesheet_directory_uri() . '/style.css', array( 'parent-style' ), null );
    // 子で上書きできる画像・JS はこちらが安全
    wp_enqueue_script( 'ks-app', get_theme_file_uri( 'js/app.js' ), array(), '1.0', true );
} );

// テンプレート内の画像
printf( '<img src="%s" alt="">', esc_url( get_theme_file_uri( 'images/logo.png' ) ) );

パス(include 用)は、URL とは別の関数です。get_template_directory()、get_stylesheet_directory()、get_theme_file_path() を、同じ考え方で使い分けます。URL をファイル読み込み(include)に使ってはいけません。

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

WordPress 7.1.2、PHP 8.2.12 で、DB を変更せず、pre_option_template / pre_option_stylesheet フィルターで「親 = twentytwentyfive、子 = ks-child」を擬似的に再現しました(php C:Tempwp-testrun.php template-directory-uri-vs-stylesheet-directory-uri.php)。

  • get_template_directory_uri(): http://localhost/wp-content/themes/twentytwentyfive
  • get_stylesheet_directory_uri(): http://localhost/wp-content/themes/ks-child
  • get_template_directory() と get_stylesheet_directory() は、同様に親・子のディレクトリを返した。
  • 子テーマのディレクトリが実在しない状態で get_theme_file_uri( 'assets/a.css' ) を呼ぶと、親テーマ側の URL を返した(子に無ければ親へフォールバック)。

続いて、pre_option_home を https://example.com、pre_option_siteurl を https://example.com/wp にして比較しました。

関数 結果
home_url( '/about/' ) https://example.com/about/
site_url( '/wp-login.php' ) http://example.com/wp/wp-login.php
admin_url() http://example.com/wp/wp-admin/
wp_login_url() http://example.com/wp/wp-login.php

site_url() 系で http になったのは、CLI 実行で is_ssl() が false のためです。wp-includes/link-template.php を読むと、get_site_url() はスキーム未指定のとき set_url_scheme() で is_ssl() に合わせる一方、get_home_url() は is_ssl() が false なら保存値のスキームを使う実装でした(検証環境 7.1.2 のソースで確認)。実際のサイトでは、設定の「WordPress アドレス」と「サイトアドレス」の両方を https で保存し、https でアクセスしてください。

プラグインの URL は、plugins_url( 'assets/app.js', WP_PLUGIN_DIR . '/ks-demo/ks-demo.php' ) が http://localhost/wp-content/plugins/ks-demo/assets/app.js、plugin_dir_url() が .../plugins/ks-demo/(末尾スラッシュ付き)を返しました。引数なしの plugins_url() は .../wp-content/plugins です。

get_template_directory_uri と get_stylesheet_directory_uri の違いの注意点

  • home_url() はサイトの公開 URL(訪問者がアクセスする場所)、site_url() は WordPress のコアファイルがある場所です。WordPress を /wp のサブディレクトリに置く構成では、両者が異なります。
  • URL を出力するときは esc_url()、属性やテキストには別のエスケープ関数を使います。
  • テーマ名のディレクトリを /wp-content/themes/ と直書きしないでください。WP_CONTENT_URL の変更や、ディレクトリ移動で壊れます。
  • プラグインの中では、__FILE__ を渡す plugins_url() か plugin_dir_url( __FILE__ ) を使うのが一般的です。
  • 親テーマのアップデートで、親側のファイルは上書きされます。子テーマ側に置いたファイルは残ります。

get_template_directory_uri と get_stylesheet_directory_uri の違いでよくあるミス

  • 子テーマで get_template_directory_uri() を使い、子テーマに置いた画像が表示されない。
  • URL と同じつもりで、include get_template_directory_uri() . '/x.php'; と書く。
  • home_url() の戻り値に、さらに / を付けて二重スラッシュになる。パスを渡す形(home_url( '/about/' ))を使う。
  • テーマ内で、http:// から始まる絶対 URL を直書きして、https 化で混在コンテンツになる。
  • 子テーマの style.css を、親の style.css の読み込み後に出さない。

get_template_directory_uri と get_stylesheet_directory_uri の違いのチェックリスト

  • 子テーマを使っているか確認したか。
  • 子で上書きする可能性があるファイルに、get_theme_file_uri() を使ったか。
  • include には、URL ではなくパスの関数を使ったか。
  • 出力に esc_url() を使ったか。
  • https 化後、WordPress アドレスとサイトアドレスの両方を確認したか。

get_template_directory_uri と get_stylesheet_directory_uri の違いのFAQ(よくある質問)

Q. 親テーマ単体のとき、どれを使っても同じですか。
A. 同じ結果になります。ただし、将来の子テーマ化に備えて、get_theme_file_uri() を使っておくと安全です。

Q. get_home_url と home_url の違いは?
A. home_url() は現在のサイトの get_home_url() を呼ぶ短縮形です。マルチサイトで別サイトの URL が欲しいときは get_home_url( $blog_id ) を使います(get_home_url() の使い方|説明・引数・注意点)。

Q. プラグインの CSS の URL は?
A. plugins_url( 'css/style.css', __FILE__ ) です(plugins_url() の使い方|説明・引数・注意点)。

筆者の見解(get_template_directory_uri と get_stylesheet_directory_uri の違い)

URL 関数の使い分けは、基準を1つ決めるだけで迷いが減ると考えます。私見では、テーマ内のアセットは原則として get_theme_file_uri()、親テーマを明示的に指す場合だけ get_template_directory_uri()、とルール化するのがよいです。さらに、サイトの URL は直書きせず、必ず関数から取得する習慣が、移設や https 化のときの手戻りを減らします。

get_template_directory_uri と get_stylesheet_directory_uri の違いの関連項目

出典(一次情報)

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

the_search_query() は、検索キーワードを、エスケープして出力する関数です。

基本構文

the_search_query(): void

引数

引数はありません。

戻り値

戻り値はありません。検索キーワードを出力します。

使い方(サンプル)

<input type="search" name="s" value="<?php the_search_query(); ?>">

注意点

  • 属性値の中で使える形に、エスケープして出力されます。
  • 検索結果ページ以外では、空になります。

実務での使いどころ

  • 検索フォームに、検索したキーワードを引き継ぐとき。
  • 検索結果の見出しに、キーワードを出すとき。

よくあるミスと対策

  • 値として使いたいのに、これを使っている。値は get_search_query() で取得する。
  • esc_html( the_search_query() ) のように、値として使う。この関数は、出力するだけで、値を返さない。

NG例

echo esc_html( the_search_query() ); // すでに出力される関数で、値は返らない

OK例

the_search_query();

使い分け早見表

関数 役割
the_search_query() キーワードを出力する(エスケープ済み)
get_search_query() キーワードを、文字列で取得する
get_search_link() 検索結果ページのURLを取得する

関連項目

get_search_query()、get_search_link()、is_search()

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

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

wp_lostpassword_url() は、パスワードの再設定ページのURLを返す関数です。

基本構文

wp_lostpassword_url( string $redirect = '' ): string

引数

  • $redirect:再設定メールの申請フォームを、送信したあとに移動するURL

戻り値

URLの文字列。

使い方(サンプル)

echo '<a href="' . esc_url( wp_lostpassword_url() ) . '">パスワードをお忘れですか?</a>';

注意点

  • 出力するときは、esc_url() を通します。
  • ログインページのURLは wp_login_url()、ログアウトのURLは wp_logout_url()。

実務での使いどころ

  • 独自のログインフォームに、「パスワードをお忘れですか?」のリンクを付けるとき。

よくあるミスと対策

  • /wp-login.php?action=lostpassword を直接書いている。ログインURLを変更するプラグインを使うと、壊れる。
  • 出力時に、esc_url() を通していない。

NG例

echo '<a href="/wp-login.php?action=lostpassword">パスワードをお忘れですか?</a>';

OK例

echo '<a href="' . esc_url( wp_lostpassword_url() ) . '">パスワードをお忘れですか?</a>';

使い分け早見表

関数 返すURL
wp_lostpassword_url() パスワード再設定ページのURL
wp_login_url() ログインページのURL
wp_logout_url() ログアウトのURL

関連項目

wp_login_url()、wp_logout_url()

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

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

wp_upload_dir() は、アップロードディレクトリのパスとURLなどの情報を配列で返す関数です。

基本構文

wp_upload_dir( string|null $time = null, bool $create_dir = true, bool $refresh_cache = false ): array

引数

  • $time:年月(yyyy/mm)。省略すると現在
  • $create_dir:ディレクトリを作成するか
  • $refresh_cache:キャッシュを更新するか

戻り値

path、url、basedir、baseurl、error などを含む配列。

使い方(サンプル)

$dir = wp_upload_dir();
$base_url = $dir['baseurl'];

注意点

  • error が false でない場合は、ディレクトリを作成できていません。
  • ファイルを保存する場合は path、URLが欲しい場合は url を使います。

実務での使いどころ

  • ファイルを、アップロードフォルダへ保存するとき。
  • アップロードされたファイルの、URLやパスを組み立てるとき。

よくあるミスと対策

  • 戻り値は配列。文字列として使うと、エラーや「Array」になる。
  • パス用のキー(path・basedir)と、URL用のキー(url・baseurl)を取り違える。
  • error を確認していない。ディレクトリを作成できないときは、メッセージが入る。

NG例

file_put_contents( wp_upload_dir() . '/a.txt', $data ); // 配列なので、パスにならない

OK例

$dir = wp_upload_dir();
if ( empty( $dir['error'] ) ) {
	file_put_contents( $dir['path'] . '/a.txt', $data );
	$url = $dir['url'] . '/a.txt';
}

使い分け早見表

キー 内容
path 保存先のパス(年月フォルダ付き)
url そのURL
basedir uploadsフォルダのパス
baseurl uploadsフォルダのURL
error エラーのメッセージ(なければ false)

関連項目

wp_get_attachment_url()、wp_handle_upload()、get_theme_file_path()

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

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

get_edit_post_link() は、投稿の編集画面へのURLを返す関数です。

基本構文

get_edit_post_link( int|WP_Post $post = 0, string $context = 'display' ): string|null

引数

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

戻り値

編集画面のURL。権限がなければ null。

使い方(サンプル)

$url = get_edit_post_link( 123 );

注意点

  • 編集権限のないユーザーには null が返ります。

実務での使いどころ

  • 投稿の編集画面へのリンクを、ログイン中のユーザーにだけ出すとき。
  • リンクのHTMLを自分で組み立てたいとき(デザインに合わせる場合)。

よくあるミスと対策

  • 編集の権限がないユーザーには、null が返る。確認せずに出力すると、空のリンクになる。
  • 出力時に、esc_url() を通していない。

NG例

echo '<a href="' . get_edit_post_link() . '">編集</a>'; // 権限がないと、空のリンクになる

OK例

$link = get_edit_post_link();
if ( $link ) {
	echo '<a href="' . esc_url( $link ) . '">編集</a>';
}

使い分け早見表

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

関連項目

edit_post_link()、admin_url()、edit_post_link()

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

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

wp_logout_url() は、ログアウト用のURL(nonce付き)を返す関数です。

基本構文

wp_logout_url( string $redirect = '' ): string

引数

  • $redirect:ログアウト後の遷移先

戻り値

ログアウトURL。

使い方(サンプル)

echo esc_url( wp_logout_url( home_url( '/' ) ) );

注意点

  • nonce が含まれるため、キャッシュされるページに出力すると無効になることがあります。

実務での使いどころ

  • ログアウトのリンクを作るとき。
  • ログアウト後に、トップページなど、指定のページへ移動させるとき($redirect を指定)。

よくあるミスと対策

  • URLにnonce(_wpnonce)が含まれる。ページキャッシュされたページに出すと、期限切れになり、ログアウトの確認画面が出る。
  • nonceを付けずに、wp-login.php?action=logout を直接書いている。確認画面が出る。

NG例

echo '<a href="/wp-login.php?action=logout">ログアウト</a>'; // nonce が無く、確認画面が出る

OK例

echo '<a href="' . esc_url( wp_logout_url( home_url() ) ) . '">ログアウト</a>';

使い分け早見表

関数 返すURL
wp_logout_url() ログアウトのURL(nonce付き)
wp_login_url() ログインページのURL
is_user_logged_in() ログインしているか判定

関連項目

wp_login_url()、is_user_logged_in()

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

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

wp_login_url() は、ログインページのURLを返す関数です。

基本構文

wp_login_url( string $redirect = '', bool $force_reauth = false ): string

引数

  • $redirect:ログイン後の遷移先
  • $force_reauth:再認証を強制するか

戻り値

ログインページのURL。

使い方(サンプル)

echo esc_url( wp_login_url( home_url( '/' ) ) );

注意点

  • ログインURLを変更するプラグインを使っている場合も、変更後のURLが返ります。

実務での使いどころ

  • ログインページへの、リンクを作るとき。
  • ログイン後に、元のページへ戻したいとき($redirect を指定)。

よくあるミスと対策

  • /wp-login.php を直接書いている。ログインURLを変更するプラグインを使うと、壊れる。
  • $redirect を指定せず、ログイン後に、意図しないページへ移動する。

NG例

echo '<a href="/wp-login.php">ログイン</a>';

OK例

echo '<a href="' . esc_url( wp_login_url( get_permalink() ) ) . '">ログイン</a>';

使い分け早見表

関数 返すURL
wp_login_url() ログインページのURL
wp_logout_url() ログアウトのURL
admin_url() 管理画面のURL

関連項目

wp_logout_url()、wp_lostpassword_url()

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

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

get_search_query() は、現在の検索キーワードを返す関数です。

基本構文

get_search_query( bool $escaped = true ): string

引数

  • $escaped:true でHTMLエスケープして返す(既定)

戻り値

検索キーワード。

使い方(サンプル)

echo esc_html( get_search_query() );

注意点

  • 既定でエスケープ済みです。esc_html() を重ねると二重エスケープになることがあります。

実務での使いどころ

  • 検索結果ページで、検索したキーワードを表示するとき。
  • 検索フォームに、キーワードを引き継ぐとき(value 属性)。

よくあるミスと対策

  • 既定でエスケープ済み($escaped が true)。さらにエスケープを重ねる必要はない(重ねても、二重にはならないが、冗長)。
  • 検索結果ページ以外では、空文字が返る。

NG例

echo esc_html( get_search_query() ); // すでにエスケープ済みで、冗長

OK例

echo get_search_query(); // エスケープ済み

使い分け早見表

関数 返すもの
get_search_query() 検索キーワード(既定でエスケープ済み)
get_search_link() 検索結果ページのURL
is_search() 検索結果ページか判定

関連項目

is_search()、the_search_query()、get_search_link()

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

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

get_search_link() は、サイト内検索結果のURLを返す関数です。

基本構文

get_search_link( string $query = '' ): string

引数

  • $query:検索キーワード

戻り値

検索結果のURL。

使い方(サンプル)

echo esc_url( get_search_link( 'WordPress' ) );

注意点

  • home_url( '/?s=...' ) と同じ目的で使えますが、パーマリンク設定に応じたURLを返します。

実務での使いどころ

  • 検索結果ページのURLを作るとき(キーワードを付けたリンクなど)。
  • 検索フォームの送信先を、組み立てるとき。

よくあるミスと対策

  • URLを直接組み立てている(/?s=キーワード)。パーマリンク設定によって、検索のURLの形式が違う。
  • 出力時に、esc_url() を通していない。

NG例

echo home_url( '/?s=' . $keyword ); // 形式を決め打ちしている

OK例

echo esc_url( get_search_link( $keyword ) );

使い分け早見表

関数 返すもの
get_search_link() 検索結果ページのURL
get_search_query() 検索キーワード
home_url() サイトのトップページのURL

関連項目

get_search_query()、home_url()

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

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

get_post_type_archive_link() は、カスタム投稿タイプのアーカイブページのURLを返す関数です。

基本構文

get_post_type_archive_link( string $post_type ): string|false

引数

  • $post_type:投稿タイプ名

戻り値

URL。アーカイブが無効なら false。

使い方(サンプル)

$url = get_post_type_archive_link( 'news' );
if ( $url ) {
	echo esc_url( $url );
}

注意点

  • 投稿タイプの has_archive が false だと false が返ります。

実務での使いどころ

  • カスタム投稿タイプの、アーカイブページへのリンクを作るとき。
  • ナビゲーションに、「お知らせ一覧」へのリンクを出すとき。

よくあるミスと対策

  • アーカイブを持たない投稿タイプでは false が返る。投稿タイプを登録するときの has_archive が false の場合。
  • 確認せずに出力し、空のリンクができる。

NG例

echo get_post_type_archive_link( 'news' ); // false のときは、何も出ない

OK例

$url = get_post_type_archive_link( 'news' );
if ( $url ) {
	echo '<a href="' . esc_url( $url ) . '">お知らせ一覧</a>';
}

使い分け早見表

関数 返すURL
get_post_type_archive_link() 投稿タイプのアーカイブのURL
get_permalink() 個別の投稿のURL
get_term_link() タームのアーカイブのURL

関連項目

get_permalink()、is_post_type_archive()

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

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