スクリプト・スタイル読み込みの記事一覧|WordPressの専門家が作る教科書 https://wordpress.ks-product.com WordPressを活用したウェブサイトの制作方法を教えます Tue, 20 Oct 2026 23:00:00 +0000 ja hourly 1 https://wordpress.org/?v=7.1.5 wp_enqueue_script で defer / async を付ける方法|strategy の使い方 https://wordpress.ks-product.com/3074/ Tue, 20 Oct 2026 23:00:00 +0000 https://wordpress.ks-product.com/?p=3074 結論

WordPress 6.3 以降では、wp_enqueue_script() と wp_register_script() の第5引数を配列にして、strategy に defer または async を指定できます。

wp_enqueue_script( 'ks-app', get_theme_file_uri( 'js/app.js' ), array(), '1.0', array(
    'strategy'  => 'defer',
    'in_footer' => true,
) );

公式リファレンスの変更履歴にも、6.3.0 で $in_footer の真偽値が $args 配列に拡張され、読み込み戦略を指定できるようになった旨が記載されています。6.3 より前のバージョンでは strategy が使えないため、script_loader_tag フィルターで属性を付ける方法を使います。

原因・仕組み

defer は、HTML の解析を止めずにダウンロードし、解析完了後に順番どおり実行します。async は、ダウンロード後に、解析を中断してすぐ実行し、実行順序は保証されません。依存関係のあるスクリプトには async は向きません。

WordPress は、依存関係を考慮して、指定された戦略を実際に適用できるかを判断します。たとえば、defer 指定のスクリプトに、戦略なし(ブロッキング)のスクリプトが依存している(依存される側になっている)場合や、after のインラインスクリプトが付いている場合は、指定どおりになりません。この判断は「適用可能な戦略」として内部で計算されます。

手順(サンプルコード)

add_action( 'wp_enqueue_scripts', function () {
    // 独立したスクリプト: defer
    wp_enqueue_script( 'ks-defer', get_theme_file_uri( 'js/d.js' ), array(), '1', array( 'strategy' => 'defer', 'in_footer' => true ) );
    // 独立した計測タグなど: async
    wp_enqueue_script( 'ks-async', get_theme_file_uri( 'js/a.js' ), array(), '1', array( 'strategy' => 'async' ) );
    // 従来の書き方(フッター読み込みのみ)
    wp_enqueue_script( 'ks-old', get_theme_file_uri( 'js/old.js' ), array(), '1', true );
} );

// 6.3 より前、または古い環境向けの代替(特定ハンドルに defer を付ける)
add_filter( 'script_loader_tag', function ( $tag, $handle ) {
    if ( 'ks-legacy' === $handle && false === strpos( $tag, ' defer' ) ) {
        return str_replace( ' src=', ' defer src=', $tag );
    }
    return $tag;
}, 10, 2 );

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

WordPress 7.1.2、PHP 8.2.12 で、出力された script タグを確認しました(php C:Tempwp-testrun.php script-defer-async-strategy.php)。

ハンドル 指定 出力された属性
ks-defer strategy=defer, in_footer=true data-wp-strategy="defer" defer
ks-async strategy=async async data-wp-strategy="async"
ks-lib register 時に defer 指定。戦略なしの ks-child-none の依存先として出力 data-wp-strategy="defer" のみ(defer 属性は付かず)
ks-child-none 指定なし、ks-lib に依存 属性なし
ks-old-style 第5引数 true(旧形式) 属性なし(フッター出力)
ks-with-inline defer、wp_add_inline_script( ..., 'after' ) を追加 data-wp-strategy="defer" のみ(defer 属性は付かず)

観察できた事実は次のとおりです。defer を指定しても、戦略なしのスクリプトの依存先になっている ks-lib と、after のインラインスクリプトを持つ ks-with-inline には、defer 属性そのものは付きませんでした(data-wp-strategy 属性は残る)。単独の ks-defer だけに defer 属性が付いています。理由は wp-includes/class-wp-scripts.php の filter_eligible_strategies() で確認できます。戦略なしの(非エイリアスの)スクリプトが依存元にいると空配列(=ブロッキング)を返し、after のインラインスクリプトがあるハンドルも空配列を返す実装です(検証環境 7.1.2 のソースで確認)。実際に属性が付くかは、必ず出力されたタグで確認してください。script_loader_tag を使う代替コードは、構文確認のみで、実行は検証していません。

ブラウザでの実行順序やパフォーマンスの計測は、この環境では行っていません。

wp_enqueue_script で defer / async を付ける方法の注意点

  • async は実行順が不定です。他のスクリプトに依存するもの、依存されるものには使いません。
  • jQuery に依存する自作スクリプトは、jQuery 側の戦略との関係で、指定どおりにならないことがあります。出力されたタグで確認します。
  • インラインスクリプトを併用すると、本検証のように defer 属性が付かない場合があります。実際のタグ出力を確認してください。
  • 計測タグ(アナリティクス)を async にするのは一般的ですが、同意管理ツールとの順序には注意します。
  • 古い script_loader_tag フィルターで defer を付けている既存コードと、strategy を併用すると、二重に付く場合があります。

wp_enqueue_script で defer / async を付ける方法でよくあるミス

  • 第5引数に array( 'defer' => true ) のように、存在しないキーを書く。
  • strategy を指定したのに、依存先がブロッキングのため効かないと気づかない。
  • async を、依存関係のあるスクリプトに付けて、実行順の不具合を起こす。
  • wp_register_script の段階では指定せず、後から wp_enqueue_script で $args を渡し、反映されないと誤解する(登録済みのハンドルは最初の登録が優先されます)。

wp_enqueue_script で defer / async を付ける方法のチェックリスト

  • WordPress は 6.3 以降か。
  • 依存先のスクリプトにも戦略を指定したか。
  • 出力された script タグで、属性を確認したか。
  • インラインスクリプトとの順序を確認したか。
  • 画面表示と、主要な機能(フォーム、メニュー)の動作を確認したか。

wp_enqueue_script で defer / async を付ける方法のFAQ(よくある質問)

Q. defer と async のどちらを使うべきですか。
A. 実行順が重要なら defer、他に依存しない独立したスクリプトなら async が目安です。

Q. テーマの JS が動かなくなりました。
A. 実行タイミングが変わった可能性があります。DOMContentLoaded を待つ、または strategy を外して比較してください。

Q. in_footer と strategy の関係は?
A. 別の指定です。フッターに置くかどうかが in_footer、読み込み方法が strategy です(wp_enqueue_script が読み込まれない原因)。

筆者の見解(wp_enqueue_script で defer / async を付ける方法)

defer は、多くのサイトで最初に試す価値のある設定だと考えます。ただし、効果の大きさは構成によって違うため、数値の改善を約束することはできません。変更前後でページを計測し、主要機能の動作確認と合わせて判断してください。私見では、まず自作のスクリプトから適用し、外部ライブラリやプラグインのスクリプトは、様子を見ながら広げるのが安全です。

wp_enqueue_script で defer / async を付ける方法の関連項目

出典(一次情報)

]]>
wp_localize_script と wp_add_inline_script の違い|JSへ値を渡す方法 https://wordpress.ks-product.com/3073/ Sun, 18 Oct 2026 23:00:00 +0000 https://wordpress.ks-product.com/?p=3073 結論

PHP の値を JavaScript に渡す手段は主に2つあります。

  • wp_localize_script(): 翻訳文字列(ローカライズ)を渡す本来の用途向け。第3引数の配列を var 名前 = {...} の形で出力する。スカラー値が文字列になる。
  • wp_add_inline_script(): 任意の JS コードを、スクリプトの前(before)か後(after)に追加する。WordPress 4.5.0 で追加。型を保った JSON を渡せる。

公式リファレンスにも、wp_localize_script() は「実際に文字列をローカライズするとき」に使い、一般的なデータの受け渡しには wp_add_inline_script() を使うよう書かれています。新規実装なら、翻訳以外は wp_add_inline_script() に wp_json_encode() を組み合わせるのが無難です。

原因・仕組み

wp_localize_script() が内部で作る JS では、トップレベルのスカラー値は文字列になります。リファレンスにも、真は "1"、偽は空文字になる旨の記載があります。そのため、true を渡したつもりが JS 側で "1" になり、if ( cfg.debug === true ) が成立しない、という不具合が起こります。

出力位置も異なります。localize のデータは、対象スクリプトの直前に <script id="ハンドル-js-extra"> として出力されます。wp_add_inline_script() は、before を指定すると直前、after(既定)なら直後です。どちらも、対象のハンドルが登録(またはキューに追加)済みである必要があります。

手順(サンプルコード)

同じ設定値を、2つの方法で渡して比較する例です。

add_action( 'wp_enqueue_scripts', function () {
    wp_register_script( 'ks-main', get_theme_file_uri( 'js/main.js' ), array(), '1.0', true );
    wp_enqueue_script( 'ks-main' );

    $cfg = array(
        'ajaxUrl' => admin_url( 'admin-ajax.php' ),
        'perPage' => 10,
        'debug'   => true,
        'labels'  => array( 'ok' => '完了', 'max' => 3 ),
    );

    // 方法1: localize(翻訳文字列向け。数値・真偽が文字列になる)
    wp_localize_script( 'ks-main', 'ksLocalized', $cfg );

    // 方法2: inline(型を保つ。before で main.js より先に定義)
    wp_add_inline_script( 'ks-main', 'window.ksInline = ' . wp_json_encode( $cfg ) . ';', 'before' );
} );

翻訳文字列だけを渡すなら、localize も適切です。その場合は __() で翻訳した文字列を配列に入れます。

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

WordPress 7.1.2、PHP 8.2.12 で、フッターのスクリプト出力を取得しました(php C:Tempwp-testrun.php localize-script-vs-add-inline-script.php)。

  • localize の出力: var ksLocalized = {"ajaxUrl":"http://localhost/wp-admin/admin-ajax.php","perPage":"10","debug":"1","ratio":"1.5","labels":{"ok":"完了","max":3}};。トップレベルの perPage は "10"、debug は "1"、ratio は "1.5" と文字列になった。入れ子の labels.max は数値 3 のままだった。
  • inline(before)の出力: window.ksInline = {"ajaxUrl":"http://localhost/...","perPage":10,"debug":true,"ratio":1.5,...}。型が保たれた。
  • 出力順は、ks-main-js-extra(localize)、ks-main-js-before、本体の ks-main-js、ks-main-js-after の順になった。
  • 未登録のハンドル ks-nothing への wp_add_inline_script() と wp_localize_script() は、どちらも false を返し、何も出力されなかった。

ブラウザ上で JS の値の型を typeof で確認する検証は、行っていません。

wp_localize_script と wp_add_inline_script の違いの注意点

  • wp_add_inline_script() に <script> タグを含めてはいけません(含めるとタグが取り除かれる旨が公式に記載されています)。
  • JSON を渡すときは json_encode() ではなく wp_json_encode() を使います(wp_json_encode() の使い方|説明・引数・注意点)。
  • 渡す値に、ユーザー入力が含まれる場合、wp_json_encode は JS 文字列としては安全に出力しますが、JS 側で innerHTML に入れる処理でXSSにならないように注意します。
  • nonce は、キャッシュされるページに埋め込むと期限切れになります(wp_create_nonce() の使い方|説明・引数・注意点)。
  • 大きなデータをインラインで出すと、HTML が肥大化します。大量なら REST API で別取得にします。

wp_localize_script と wp_add_inline_script の違いでよくあるミス

  • wp_localize_script() を、対象ハンドルの登録(wp_register_script() または wp_enqueue_script())より前に呼び、何も出力されない(本検証でも未登録ハンドルへの呼び出しは false)。
  • true を渡して JS 側で === true と比較する。文字列の "1" になる。
  • wp_add_inline_script() を、wp_head の中の独立した場所で呼び、対象ハンドルが未登録のまま。
  • 変数名にハイフンを含める。JS の変数名として不正になります。
  • module 型のスクリプトにインラインでグローバル変数を渡し、スコープが合わない。

wp_localize_script と wp_add_inline_script の違いのチェックリスト

  • 翻訳文字列か、設定値かを判断したか。
  • 設定値なら wp_add_inline_script と wp_json_encode を使ったか。
  • 対象ハンドルは、呼び出し時点で登録済みか。
  • JS 側の型比較を、実際の出力に合わせたか。
  • ユーザー入力を含む値は、描画時にエスケープしているか。

wp_localize_script と wp_add_inline_script の違いのFAQ(よくある質問)

Q. wp_localize_script は非推奨ですか。
A. 公式リファレンスの時点では非推奨とはされていません。翻訳文字列以外の用途では、wp_add_inline_script が推奨されています。

Q. before と after はどう使い分けますか。
A. 本体が読み込まれる時点で変数が必要なら before、本体の関数を呼ぶ処理なら after を使います。

Q. 複数回呼べますか。
A. wp_add_inline_script は同じハンドルへ複数回追加でき、本検証でも before と after を併用できました。

筆者の見解(wp_localize_script と wp_add_inline_script の違い)

私見では、新しく書くコードで wp_localize_script を設定値の受け渡しに使う理由は、あまりありません。型が変わる挙動は、気づきにくい不具合の元だからです。ただし、既存のテーマやプラグインは localize を使っていることが多く、すぐ全部を書き換える必要まではないとも考えます。触るついでに、少しずつ置き換えるのが現実的です。

wp_localize_script と wp_add_inline_script の違いの関連項目

出典(一次情報)

]]>
wp_enqueue_script が読み込まれない原因と対処|依存関係・フック・バージョン https://wordpress.ks-product.com/3049/ Mon, 05 Oct 2026 15:02:00 +0000 https://wordpress.ks-product.com/3049/ 結論

wp_enqueue_script() で登録した JavaScript がページに出ないときは、次の5点を順に確認します。

  1. 依存関係(第3引数)に、未登録のハンドルが含まれていないか。
  2. 正しいフックで呼んでいるか(フロントは wp_enqueue_scripts、管理画面は admin_enqueue_scripts、ログイン画面は login_enqueue_scripts)。
  3. 同じハンドル名が、別の場所で先に登録されていないか。
  4. テンプレートに wp_head() / wp_footer() が書かれているか(in_footer が true なら wp_footer() が必須)。
  5. 条件分岐(is_page() など)で、意図せず除外されていないか。

特に1は、依存関係が満たされないと script タグが出力されない一方で、以前のバージョンでは警告もエラーも出なかったため、見落としやすい原因です(本検証環境 7.1.2 では、WP_DEBUG 有効時に _doing_it_wrong の通知が出ました。後述のケースA)。

原因・仕組み

wp_enqueue_script() は、スクリプトを「キューに入れる」関数です。実際の出力は、wp_head() や wp_footer() の中で wp_print_scripts() などが走るときに行われます。このとき、依存先がすべて登録済みかどうかが確認されます。

$ver の扱いは、false(既定)なら WordPress のバージョンが付き、null なら付かず、文字列ならその値が付きます。WordPress 6.3 からは、第5引数が $in_footer(真偽値)から $args 配列に拡張され、strategy(defer / async)と in_footer を指定できます(詳細はwp_enqueue_script で defer / async を付ける方法)。

手順(サンプルコード)

正しい登録の基本形です。

add_action( 'wp_enqueue_scripts', function () {
    wp_enqueue_script(
        'ks-app',
        get_theme_file_uri( 'js/app.js' ),
        array( 'jquery' ),                               // 依存先は登録済みのハンドル名
        filemtime( get_theme_file_path( 'js/app.js' ) ),  // 更新時刻で自動的にキャッシュを更新
        array( 'in_footer' => true )
    );
} );

原因を調べるときは、次のコードをテンプレートや functions.php に一時的に入れ、状態を確認します。

add_action( 'wp_print_footer_scripts', function () {
    foreach ( array( 'registered', 'enqueued', 'done' ) as $s ) {
        error_log( "ks-app $s: " . var_export( wp_script_is( 'ks-app', $s ), true ) );
    }
}, 1 );

enqueued が true で done が false なら、キューには入ったが出力されていません。依存関係かフッターの欠落を疑います。

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

WordPress 7.1.2、PHP 8.2.12 で実行しました(php C:Tempwp-testrun.php wp-enqueue-script-not-loading.php、ログは tests フォルダ)。

  • ケースA: ks-app が未登録の ks-missing-lib に依存。enqueued=true、registered=true だが、出力された script は「なし」、done=false。このバージョンでは doing_it_wrong の通知が発生し、内容は「ハンドル ks-app のスクリプトは、未登録の依存関係とともにキューへ追加されました: ks-missing-lib」(バージョン 6.9.1 で追加と表示)でした。デバッグ表示が無効の環境では、気づきにくいままです。
  • ケースB: 依存先を wp_register_script で登録し、キューに入れ直すと、ks-missing-lib-js と ks-app-js の両方が出力された。
  • ケースC: 先に first.js で登録済みのハンドルに、後から別の src で wp_enqueue_script しても、登録された src は first.js のままで、後の指定は無視された。
  • ケースD: $ver に false を渡すと ?ver=7.1.2、null では付かず、文字列 3.1 では ?ver=3.1 になった。

テーマのテンプレートに wp_footer() が無い場合の挙動は、この検証では実行していません。

wp_enqueue_script が読み込まれないときの注意点

  • 依存関係が不明なとき、wp_script_is( 'handle', 'registered' ) で登録の有無を確認します。
  • jQuery は WordPress 同梱のハンドル jquery を指定します。別の CDN の jQuery を使う場合は、wp_deregister_script と再登録が必要で、プラグインとの互換性に注意が要ります。
  • 他のプラグインが同じハンドル名を使うと、片方しか有効になりません。ハンドルには接頭辞を付けます。
  • キャッシュ系プラグインや CDN が古い JS を配信している場合は、$ver を変更して確認します。
  • 管理画面で読み込むスクリプトは、admin_enqueue_scripts のフック引数 $hook_suffix で対象画面を絞ります。

wp_enqueue_script が読み込まれない原因と対処でよくあるミス

  • wp_enqueue_scripts に掛けず、functions.php の直下で wp_enqueue_script() を呼ぶ。
  • get_template_directory_uri() を使い、子テーマ側のファイルを指せていない(get_template_directory_uri と get_stylesheet_directory_uri の違い)。
  • <script> タグを header.php に直書きし、依存関係の順序を壊す。
  • $ver を毎回 time() にして、ブラウザキャッシュが全く効かなくなる。
  • 条件分岐で is_page( 'contact' ) を使い、スラッグや ID の指定が実際の固定ページとずれている。

wp_enqueue_script が読み込まれない原因と対処のチェックリスト

  • 依存先ハンドルは、すべて登録済みか。
  • フック名は、表示する画面に合っているか。
  • ハンドル名に接頭辞を付け、重複を避けたか。
  • wp_head() と wp_footer() がテンプレートにあるか。
  • ブラウザの開発者ツールで、JS の URL が 404 になっていないか。
  • ファイルのパスは、親子テーマの関係を考慮しているか。

wp_enqueue_script が読み込まれない原因と対処のFAQ(よくある質問)

Q. wp_register_script と wp_enqueue_script の違いは?
A. 前者は登録だけ、後者は登録と出力予約です。後者の src を省略すると、登録済みのハンドルをキューに入れるだけになります(wp_register_script() の使い方|説明・引数・注意点)。

Q. 読み込まれたか確認する方法は?
A. wp_script_is( 'ks-app', 'done' ) で出力済みかを確認でき、ブラウザのページソースで id が ks-app-js の script タグを探す方法も使えます。

Q. 読み込み順を変えたい。
A. 依存関係(第3引数)で先に読むものを指定します。依存の宣言が、順序を保証する唯一の正式な方法です。

筆者の見解(wp_enqueue_script が読み込まれない原因と対処)

読み込まれない問題の多くは、ブラウザ側ではなく、PHP 側のキューの状態に原因があると考えます。wp_script_is() の3つの状態を見る習慣を付けると、推測で試行錯誤する時間をかなり減らせます。また、依存関係の未登録に通知が出る環境では、開発中は必ずデバッグ表示を有効にしておくのがよいと思います。

wp_enqueue_script が読み込まれない原因と対処の関連項目

出典(一次情報)

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

wp_body_open() は、body 開始タグの直後でアクションフックを実行する関数です。タグマネージャーなどの出力に使われます。

基本構文

wp_body_open(): void

引数

引数はありません。

戻り値

戻り値はありません(wp_body_open アクションを実行します)。

使い方(サンプル)

// header.php の body タグの直後に記述
wp_body_open();

注意点

  • WordPress 5.2 で追加された関数です。テーマに入れていないと、Googleタグマネージャーの noscript などが出力されません。

実務での使いどころ

  • <body> の開始の直後に、タグ(Googleタグマネージャーの <noscript> など)を出力するとき。
  • header.php で、<body> の直後に、wp_body_open() を呼ぶ。

よくあるミスと対策

  • テーマの header.php で、wp_body_open() を呼んでいない。フックに登録した処理が、出力されない。
  • <body> の直後以外の場所で呼んでいる。
  • 古いWordPressでは、関数がない場合がある。呼ぶ前に、function_exists() で確認する。

NG例

<body <?php body_class(); ?>>
<!-- wp_body_open() が無く、フックの処理が出力されない -->

OK例

<body <?php body_class(); ?>>
<?php
if ( function_exists( 'wp_body_open' ) ) {
	wp_body_open();
}
?>

使い分け早見表

フック 出力する場所
wp_head() <head> の終わりの直前
wp_body_open <body> の開始の直後
wp_footer() </body> の直前

関連項目

wp_head()、wp_footer()

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

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

wp_footer() は、テーマのフッター部分で呼び出すと、WordPressやプラグインが出力するスクリプトなどを出力する関数です。

基本構文

wp_footer(): void

引数

引数はありません。

戻り値

戻り値はありません(wp_footer アクションを実行します)。

使い方(サンプル)

// footer.php の </body> の直前に記述
wp_footer();

注意点

  • footer.php の </body> の直前に必ず記述します。入れ忘れると、フッター読み込みのスクリプトや管理バーが動きません。

実務での使いどころ

  • footer.php の </body> の直前に、wp_footer() を書き、フッターのスクリプトや、管理バーを出力させる。
  • フッターで、スクリプトやタグを出力するとき(add_action( 'wp_footer', ... ))。

よくあるミスと対策

  • テーマの footer.php に wp_footer() がなく、フッターで読み込むスクリプトや、管理バーが出力されない。
  • </body> の後ろに、wp_footer() を書いている。
  • JavaScriptを、wp_footer に直接書いている。wp_enqueue_script() で、フッターに読み込む($in_footer を true)。

NG例

add_action( 'wp_footer', function () {
	echo '<script src="/js/a.js"></script>'; // 依存関係を管理できない
} );

OK例

add_action( 'wp_enqueue_scripts', function () {
	wp_enqueue_script( 'my-script', get_theme_file_uri( '/js/a.js' ), array(), '1.0.0', true );
} );

使い分け早見表

フック 出力する場所
wp_head() <head> の終わりの直前
wp_body_open() <body> の開始の直後
wp_footer </body> の直前

関連項目

wp_head()、wp_body_open()

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

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

wp_head() は、テーマの head 要素内で呼び出すと、WordPressやプラグインが出力するタグ(スタイル、メタ情報など)を出力する関数です。

基本構文

wp_head(): void

引数

引数はありません。

戻り値

戻り値はありません(wp_head アクションを実行します)。

使い方(サンプル)

// header.php の head 内に記述
wp_head();

注意点

  • テーマの header.php の </head> の直前に必ず記述します。入れ忘れると、プラグインのCSS・JSが読み込まれません。
  • wp_enqueue_scripts は wp_head の中で実行されます。

実務での使いどころ

  • header.php の </head> の直前に、wp_head() を書き、スクリプトやCSS、メタタグを出力させる。
  • プラグインやSEOのタグを、<head> に出力するとき(add_action( 'wp_head', ... ))。

よくあるミスと対策

  • テーマの header.php に wp_head() がなく、プラグインのタグやCSSが出力されない。
  • <script> や <link> を、wp_head に直接書いている。CSSとJavaScriptは、wp_enqueue_script()・wp_enqueue_style() で読み込む。
  • </head> の後ろに、wp_head() を書いている。

NG例

add_action( 'wp_head', function () {
	echo '<script src="/js/a.js"></script>'; // 依存関係を管理できない
} );

OK例

add_action( 'wp_enqueue_scripts', function () {
	wp_enqueue_script( 'my-script', get_theme_file_uri( '/js/a.js' ), array(), '1.0.0', true );
} );

使い分け早見表

フック 出力する場所
wp_head <head> の終わりの直前
wp_body_open() <body> の開始の直後
wp_footer() </body> の直前

関連項目

wp_footer()、wp_body_open()

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

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

add_editor_style() は、ブロックエディターやクラシックエディターに、テーマ独自のスタイルを反映させる関数です。

基本構文

add_editor_style( string|string[] $stylesheet = 'editor-style.css' ): void

引数

  • $stylesheet:CSSファイルのパス(テーマからの相対パス)

戻り値

戻り値はありません。

使い方(サンプル)

add_action( 'after_setup_theme', function() {
	add_theme_support( 'editor-styles' );
	add_editor_style( 'css/editor.css' );
} );

注意点

  • after_setup_theme フックの中で呼びます。
  • ブロックエディターで使うには add_theme_support( 'editor-styles' ) が必要です。

実務での使いどころ

  • エディターの見た目を、サイトの表示に近づけるとき。
  • 編集画面専用のCSSを、読み込むとき。

よくあるミスと対策

  • ブロックエディターで使うのに、add_theme_support( 'editor-styles' ) を呼んでいない。エディターのスタイルが適用されない。
  • after_setup_theme フックの外で呼んでいる。
  • フロント用のCSSを、そのまま使い、エディターの余白や幅がずれる。エディター専用のCSSを用意する。

NG例

add_editor_style( 'editor-style.css' ); // ブロックエディターでは、これだけでは適用されない

OK例

add_action( 'after_setup_theme', function () {
	add_theme_support( 'editor-styles' );
	add_editor_style( 'editor-style.css' );
} );

使い分け早見表

やりたいこと 使うもの
エディターにCSSを読み込む add_editor_style()
フロントにCSSを読み込む wp_enqueue_style()
ブロックごとのCSS wp_enqueue_block_style()

関連項目

add_theme_support()、wp_enqueue_style()

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

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

wp_enqueue_block_style() は、特定のブロックにだけ適用する独自のスタイルを登録・読み込みする関数です。

基本構文

wp_enqueue_block_style( string $block_name, array $args ): void

引数

  • $block_name:ブロック名(例:core/button)
  • $args:handle、src、path など

戻り値

戻り値はありません。

使い方(サンプル)

wp_enqueue_block_style( 'core/button', array(
	'handle' => 'my-button-style',
	'src'    => get_theme_file_uri( 'css/button.css' ),
) );

注意点

  • そのブロックが使われているページでだけ出力されます。
  • ブロックテーマ・ブロックエディターを使うサイトで有効です。

実務での使いどころ

  • 特定のブロックに、独自のスタイルを追加するとき。
  • ブロックを使っているページだけで、CSSを読み込みたいとき。

よくあるミスと対策

  • ブロック名を、名前空間なしで指定している。core/paragraph のように、名前空間付きで指定する。
  • handle が、他のスタイルと重なっている。
  • src を指定せず、CSSが読み込まれない(handle と src は、実質、必須)。

NG例

wp_enqueue_block_style( 'paragraph', array( 'handle' => 'my-p', 'src' => get_theme_file_uri( '/css/p.css' ) ) ); // 名前空間がない

OK例

add_action( 'init', function () {
	wp_enqueue_block_style( 'core/paragraph', array(
		'handle' => 'my-paragraph',
		'src'    => get_theme_file_uri( '/css/paragraph.css' ),
	) );
} );

使い分け早見表

やりたいこと 使うもの
特定のブロックだけにCSSを読み込む wp_enqueue_block_style()
すべてのページにCSSを読み込む wp_enqueue_style()
インラインのCSSを追加する wp_add_inline_style()

関連項目

wp_enqueue_style()、register_block_type()

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

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

wp_enqueue_global_styles() は、ブロックテーマ用のグローバルスタイル(theme.json 由来のCSS)を読み込む関数です。

基本構文

wp_enqueue_global_styles(): void

引数

引数はありません。

戻り値

戻り値はありません。

使い方(サンプル)

// 通常はWordPress本体が呼び出す
add_action( 'wp_enqueue_scripts', 'wp_enqueue_global_styles' );

注意点

  • 通常は本体が自動で呼ぶので、自分で呼ぶ必要はありません。
  • 不要な場合は remove_action で外すことがあります。

実務での使いどころ

  • theme.json のスタイル(グローバルスタイル)を出力する関数。通常は、WordPressが自動で呼ぶ。
  • クラシックテーマで、グローバルスタイルを読み込みたくないときに、外す対象として知っておく。

よくあるミスと対策

  • 自分で呼ぶ必要は、通常ない。
  • theme.json を使うテーマで、これを外し、色・フォント・余白などの見た目が崩れる。
  • 外すとき、全ページで確認せずに外している。

NG例

// 確認せずに、すべてのサイトで外している
remove_action( 'wp_enqueue_scripts', 'wp_enqueue_global_styles' );

OK例

add_action( 'after_setup_theme', function () {
	if ( ! wp_is_block_theme() ) {
		remove_action( 'wp_enqueue_scripts', 'wp_enqueue_global_styles' );
		remove_action( 'wp_footer', 'wp_enqueue_global_styles', 1 ); // バージョンによっては、必要
	}
} );
// 外したあとは、全種類のページで、見た目を確認する

使い分け早見表

やりたいこと 使うもの
グローバルスタイルを読み込む wp_enqueue_global_styles()(通常は自動)
独自のCSSを読み込む wp_enqueue_style()
ブロックごとのCSSを読み込む wp_enqueue_block_style()

関連項目

wp_enqueue_style()、wp_dequeue_style()

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

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

wp_enqueue_media() は、メディアアップローダー(ライブラリ選択ダイアログ)に必要なスクリプトとスタイルを読み込む関数です。

基本構文

wp_enqueue_media( array $args = array() ): void

引数

  • $args:post(関連付ける投稿)など

戻り値

戻り値はありません。

使い方(サンプル)

add_action( 'admin_enqueue_scripts', function() {
	wp_enqueue_media();
} );

注意点

  • 管理画面で独自のメディア選択ボタンを作るときに必要です。
  • admin_enqueue_scripts フックで呼びます。

実務での使いどころ

  • 独自のメディアアップロードボタンで、メディアライブラリのダイアログ(wp.media)を使うとき。
  • 管理画面の独自設定ページに、画像の選択欄を作るとき。

よくあるミスと対策

  • wp.media を使う前に、この関数を呼んでいない。メディア用のスクリプトやテンプレートが、読み込まれない。
  • すべての管理画面で呼んでいる。必要なページだけで呼ぶ(admin_enqueue_scripts フックの中で、画面を判定する)。
  • 画像を選択するJavaScript自体は、別に自分のスクリプトを用意して、wp_enqueue_script() で読み込む必要がある。

NG例

add_action( 'admin_enqueue_scripts', function () {
	wp_enqueue_media(); // すべての管理画面で、読み込まれる
} );

OK例

add_action( 'admin_enqueue_scripts', function ( $hook ) {
	if ( 'toplevel_page_my-settings' === $hook ) {
		wp_enqueue_media();
	}
} );

使い分け早見表

やりたいこと 使うもの
メディアライブラリのダイアログを使う wp_enqueue_media()
自分のスクリプトを読み込む wp_enqueue_script()
自分のCSSを読み込む wp_enqueue_style()

関連項目

wp_enqueue_script()、wp_get_attachment_url()

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

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