wp_enqueue_script JavaScriptのリンクが出力されない

埼玉県所沢市でホームページ制作などを行っているRishunTradingです。自社テーマ(Rishun)で、Webサイトを制作しています。
｢wp_register_script｣と、｢wp_enqueue_script｣を使用する事で、JavaScriptのファイルのリンクを、指定したタイミングでページに出力することができます。
その際に、少しはまった事があったので、備忘録も兼ねて記載しておきます。

１.発生した事象
- 解説
2.原因

１.発生した事象

wp_enqueue_script( 'mainscript',
                   get_stylesheet_directory_uri() . '/main.js',
                   array('rishun'),
                   '1.0.0',
                   true );

1

2

3

4

5

wp_enqueue_script( 'mainscript',

get_stylesheet_directory_uri() . '/main.js',

array('rishun'),

'1.0.0',

true );

解説

■第１パラメータ
‘mainscript’は、スクリプトを区別するための名前(ハンドル名)。

■第２パラメータ
リンクするスクリプトの場所。='(スクリプトのURL)’。get_stylesheet_directory_uri()は、子テーマのディレクトリのURI。子テーマのJavaScriptファイルのリンクを出力しようとしています。

■第３パラメータ
依存対象のスクリプト。今回rishunテーマ(親テーマ)の”rishun.js”のファイルのリンクを出力した後に出力する必要があるため、親テーマのスクリプトの名前(ハンドル名)を入れています。

■第４パラメータ
本スクリプトのVersionです。

■第５パラメータ
デフォルトは、falseで、falseを指定すると、<head>タグ内にスクリプトのリンクが出力されます。trueにすると、</body>タグの直前に出力されます。表示レスポンスを早くするため、今回trueの遅延読み込みにしています。

詳細はこちらのリファレンスを参照下さい。
wp_enqueue_script

今回、このような指定をした際に、該当の”main.js”のリンクが出力されず、少しはまりました。

2.原因

wp_footer()テンプレートタグの宣言を忘れた事が原因。

わかってしまうと、悲しくなるのですが、第５パラメータで”true”にしていますので、</body>の直前に出力されるわけですが、wp_footer()テンプレートタグの宣言がないため発生。”true”にした場合は、テーマ内の適切な位置に wp_footer() テンプレートタグが含まれていることが必須条件です。

■以下は、リファレンスの内容
– 第５パラメータ($in_footer) –
（真偽値）（オプション）スクリプトは通常 HTML ドキュメントの <head> に置かれるが、もしこのパラメータが true の場合 </body> 終了タグの前に配置される。テーマ内の適切な位置に wp_footer() テンプレートタグが含まれていることが必須となる。

皆さまのお役に立てれば幸いです。