プログラミング

WordPressのJSファイル読み込みで覚えておきたい便利ワザを2つ紹介します

jQuery PHP WordPress
WordPressのJSファイル読み込みで覚えておきたい便利ワザを2つ紹介します

 

JSファイルを読み込むときに、deferasyncを付与したい・・・

get_template_directory_uri()JSファイル内で使用したい・・・

 

WordPressには便利な関数が沢山用意されていますが、その全てが万能だということはありません。

今回はSEO対策でも必要になるdeferやasyncをスクリプトタグに付与させる方法と、テンプレートまでのパスをJSファイル内でも簡単に取得できる方法をサンプルコードをつけて解説します。

 

 

wp_enqueue_scriptを使った読み込み

 

WordPressCSSファイルやJSファイルを読み込む場合、ヘッダーまたはフッター部分に直接記載する方法functions.phpにアクションフックを記載するという方法2つがあります。

 

ではまず、JSファイルの読み込みをするためのアクションフックの基本的な記述方法を見てみましょう。

// JSの読み込み

function scriptInclude(){

              wp_enqueue_script('common-script', get_template_directory_uri() . '/assets/js/common.js', [], date('U'), true );

}

add_action( 'wp_enqueue_scripts', 'scriptInclude' );

 

scriptIncludeという自作関数を作成し、最後のadd_actionでwp_enqueue_scriptsにフックしています。

 

引数の詳細については、以下のURLを参考にしてください。

 

引数によって色んな指定が可能ですが、状況によって必要になるパラメータを付与できないのが難点です。

ですが、フィルターフックを使用することによってこれを可能にします。

 

 

deferまたはasyncを付与する

 

SEO対策も考慮して、一部のJSファイルにはdeferやasyncなどのパラメータを付与したいですね。

ですが、先ほどのwp_enqueue_scriptだけではできないので、script_loader_tagというアクションフィルターを使用してスクリプトタグの記述を書き換えます。

 

今回はdeferを付与するサンプルを公開します。こちらもfunctions.phpへ記述してください。

// deferの付与

function addDefer($tag, $handle) {

              $handles = ['common-script'];

              if(in_array($handle, $handles, true)) {

                            return str_replace(' src=', ' defer src=', $tag);

              }

              return $tag;

}

add_filter('script_loader_tag', 'addDefer', 10, 2);

 

指定したハンドルに該当する場合は、deferを付与するという内容です。

今回if判定でin_arrayを使用しているのは、もし複数のハンドルを指定する場合や追加のスクリプトタグが必要になったときに手間がかからないため、保守の面から見ても良いからです。

 

str_replaceの部分で、$tagに格納されているスクリプトタグの【src=】という部分を【 defer src=】に書き換えています。こうすればdeferasyncの追加は簡単にできます。

 

 

idやdataをもたせる

 

scriptタグに対してIDや、dataを持たせることができればPHPで使用している変数の値をJSファイル内に渡せるので便利です。

ですが、こちらもwp_enqueue_scriptだけでは付与できないので、前項でdeferを追加したときと同様のアクションフィルターを使用して付与します。

 

 

テーマまでのパスを取得

 

WordPressの場合、JSファイル内で画像のパスを指定するのが少し面倒です。相対パスにするわけにいかないため、絶対パスで記述することになりますが、テーマファイルまでのURLを毎回コピペしていれば可視性も保守性も悪くなります。

 

なので、get_template_directory_uri()で取得したURLをdataへセットします。

return str_replace('>', ' id="'.$handle.'" data-temp_path="'.get_template_directory_uri().'">', $tag);

先ほどのサンプルコードのreturn部分を変更しました。

こうすることでidにハンドル名が設定でき、data-temp_pathget_template_directory_uri()で生成したパスをセットすることができます。

 

あとはこれを、JSファイル側で受け取るだけです。

今回はWordPressのためjQueryを使用したサンプルコードになります。

// get_template_directory_uri()で生成したパスを取得する関数
var getTempPath = function(){

              var temp_path = $('#common-script').data('temp_path');

}


// 作成した関数をまとめて発火
jQuery(function($){

              getTempPath();

});

 

 

まとめ

 

いかがだったでしょうか。

今回は「WordPressのJSファイル読み込みで覚えておきたい便利ワザ」について解説しました。

 

WordPressを使ったサイト制作やブログの立ち上げをする際、SEO対策や保守効率をあげるためには便利なので、ぜひ参考にしてくださいね。

 

注目の記事

ピカチュウから学ぶオブジェクト指向 〜レベルシステム導入編〜 3
プログラミング
PHP,PHPポケモン,オブジェクト指向,ポケモン
ピカチュウから学ぶオブジェクト指向 〜レベルシステム導入編〜 3

  大人気?シリーズ「ピカチュウから学ぶオブジェクト指向」、今回はレベルシステムの導入編です。   第1回(基礎編)、第2回(クラス継承編)で作成したPokemonとPikachuのクラスを使用するので、最初から学習したい人はぜひご参考ください。      レベルシステムの導入   ポケモンのゲ...

フィールド効果技編(しろいきり) PHPポケモン 50
プログラミング
PHP,PHPポケモン,ポケモン
フィールド効果技編(しろいきり) PHPポケモン 50

フィールド効果技とは ポケモンの技の中には、ポケモンに対して状態変化や異常を与えるもの以外に、フィールド自体に効果を持たせるものがいくつかあります。PHPポケモンでは未実装ですが、そういったフィールド効果技はポケモンを交代したとしても場に効果が残り続けます。  場の状態(ポケモンwiki) https:/...

反動技編(はかいこうせん・とびひざげり)PHPポケモン40
プログラミング
PHP,PHPポケモン,ポケモン
反動技編(はかいこうせん・とびひざげり)PHPポケモン40

反動技とは ポケモンでは反動技というものがあります。反動によっても様々で、現在の仕組みのままでも実装可能なものや、新たに処理が必要なものまであります。なので、一律で反動技という同じ処理は出来ません。  反動技(ポケモンwiki) https://wiki.ポケモン.com/wiki/反動技 反動技(はんどうわざ...

SEO対策で役立つ!ライティングスキルを向上させる3ステップ
ライティング
SEO,ブログ
SEO対策で役立つ!ライティングスキルを向上させる3ステップ

  ブログやメール、SNSなどライティングスキルが問われる場面が多く、それは質に直結しています。各プラットフォームによって特徴はありますが、基礎的な文章力自体がついていれば多様な場面で役立つことは間違いありません。 文章の質が高くなれば、ブログであればSEOに強い価値のあるサイトになりますし、SNS...

PHPポケモン「レベルアップ進化編」9
プログラミング
PHP,PHPポケモン,ポケモン
PHPポケモン「レベルアップ進化編」9

  PHPポケモン(旧:ピカチュウから学ぶオブジェクト指向)も第9回目となりました。前回GitHubよりコードを配布したので、これから学習しようと考えている人は、ぜひ参考にしてください。   最初からコードの内容について学びたい人は、ぜひ記念すべき第1回から順を追って取り組んでみてください。   ...

命中率補正と交代技編 PHPポケモン 45
プログラミング
PHP,PHPポケモン,ポケモン
命中率補正と交代技編 PHPポケモン 45

命中率補正とは ダメージ計算や行動順判定には補正(ランク)を計算した結果を反映していましたが、命中率補正についてはまだ未実装だったため、今回はこちらを作成していきたいと思います。 まずはwikiを参考に、計算方法を見ていきましょう。 命中(ポケモンwiki) https:// wiki.ポケモン.com/wiki/命中 第...

スキル習得で挫折しないための3ステップ
雑記
デザイン,ブログ,プログラミング
スキル習得で挫折しないための3ステップ

  せっかく高い教材を買ったのに、気づいたら積んでしまっている・・・   そんな悩み、あなたには有りませんか? 今回は、そんな方のための勉強方法をテーマに説明していきます。 正しい勉強方法を身に着けていれば、どういったメリットがあるのでしょうか? 三日坊主になりにくい いざという...

独立してから心がけていること【社会人時代と比較して】
フリーランス
フリーランス,独立
独立してから心がけていること【社会人時代と比較して】

  今回は自分が独立してから心がけていることの中から、ある程度上手くいっていることや、オススメできるようなことを簡単に感想付きでまとめてみました。 社会人時代と比較しながらの内容なので、これからフリーランスで生きていこうと思っている人や、社会人という生活にストレスを感じている人は是非参考に...

カテゴリ

SEO対策 イベント デザイン ネットワーク ビジネスモデル フリーランス プログラミング マーケティング ライティング 動画編集 雑記

タグ

5G Adobe AfterEffects AI ajax amazon Animate api artisan atom Automator AWS Bluetooth CSS CVR description EC-CUBE4 ECショップ ESLint Facebook feedly foreach function Google Google AdSense Honeycode htaccess HTML IEEE 802.11ax Illustrator Instagram IoT JavaScript jQuery jQuery UI keyword LAN Laravel Linux MacBook MAMP meta MLM MySQL NoCode note OS OSI参照モデル Paypal Photoshop PHP phpMyAdmin PHPポケモン PremierePro rss SEO SEO対策 Sequel Pro Skype SNS SSH Symfony TCP/IP title Toastr Trait Twig Twitter UCC V系 WAN WebSub Wi-Fi wiki Windows WordPress XAMPP xml Xserver YouTube YouTuber Zoom アーティスト アウトプット アクセス層 アニメーション アフィリエイト イーブイ インターネット インプット エンジニア オブジェクト指向 お金配り クリック単価 クリック数 コミュニケーション能力 コロナ コンサルティング サムネイル システムエンジニア スタートアップ スタイルシート スパム データベース ディープフェイク デザイナー デザイン テレワーク ナンパ ニュース ネットワークモデル ノマドワーク バナー ピカチュウ ビジネス フィード フリーランス ブロガー ブログ プログラマー プログラミング プログラミング学習 プログラミング教育 プロトコル ホームページ制作 ポケモン マークアップ マーケティング メール リモートワーク レンダリング 三井住友 三宮 仕事依頼 児童デイ 児童デイサービス 児童発達支援 公開鍵 初心者 助成金 勉強法 営業 広告 広告収入 必勝マニュアル 放課後等デイサービス 朝活 楽天 深層学習 無線LAN 独立 神戸 福祉 秘密鍵 翻訳 自己啓発 英語 見積書 計算機 読書 起業 迷惑メール 配列 銀の弾丸 集客 雑学力