WordPress 関数まとめ1

2024年11月13日 16:22

学んだことを整理して、ポイントや注意点をまとめました！✏️

wp_head();

ℹ️ 概要： プラグインの動作や、CSS・JavaScriptを読み込むために必要
📝 用途： header.php ファイル内の </head> タグの直前に書く

wp_footer();

ℹ️ 概要： プラグインの動作や、CSS・JavaScriptを読み込むために必要
📝 用途： footer.php ファイル内の </body> タグの直前に書く

wp_body_open();

ℹ️ 概要： プラグインを正しく動作させるために必要
📝 用途： header.php ファイル内の <body> タグの直後に書く

esc_url();

ℹ️ 概要： URLを変換する役割。URL内の悪意のあるスクリプトの実行を　　　　
　　　　防ぎ、サイトを安全に表示するために必要
📝 用途： href 属性、src 属性、action 属性で使う

<a href="<?php echo esc_url(home_url()); ?>">　　// リンク

<img src="<?php echo esc_url($image_url); ?>">　// 画像

<form action="<?php echo esc_url(admin_url()); ?>">　// フォーム

get_theme_file_uri();

ℹ️ 概要： 現在のテーマディレクトリ内のファイルの絶対パスを取得する
　　　　　引数を渡すことで、特定のファイルを指定できる
📝 用途： href 属性、src 属性で使う

<img src="

　<?php echo esc_url(
　　get_theme_file_uri('/img/logo.svg')
　); ?>

" alt="ロゴ">

home_url();

ℹ️ 概要： トップページのURLを取得する関数※ この関数はURLを取得する
　　　　　だけなので、echo とセットで使う。echoで出力し、HTMLを
　　　　　表示させるイメージ
📝 用途： 主にhref 属性で使う

※ WordPresの「一般設定」の「サイトアドレス (URL)」に設定したURLを取得できる

括弧内が空欄：
<?php echo esc_url( home_url() ); ?>　/* https://example.comが表示される */

括弧内にスラッシュ：
<?php echo esc_url( home_url( '/' ) ); ?>　/* https://example.com/が表示される */

スラッシュ＋特定のページ：
<?php echo esc_url( home_url( '/about' ) ); ?>　/* https://example.com/aboutが表示される */

補足：関数が入れ子のときは、内側の関数にはセミコロンを付けない

上のコード例のように、入れ子の内側の関数にセミコロンを付けないのは、まだ処理の途中だから。以下のように書くことで、エラーを回避できる。

一番外側の関数にだけ、セミコロンを付ける
入れ子の内側の関数には、セミコロンをつけない

・・・・・・・・・・・・・・・・・・・

入れ子になった関数は、内側から順に、外側に向かって関数が実行される。内側の関数の実行結果をもとに、外側の関数の処理が始まるイメージ。

一方で、セミコロンは「ここで処理を終わります」のような、一つの文が終わったことを表すもの。

このため、入れ子の内側の関数でセミコロンを使うと、まだ処理途中なのに、「ここで処理を終わります」という挙動となり、外側の関数が未了状態のままになってしまう。

そのため、一番外側の関数だけセミコロンを付けることで、最後まで正しく処理することができる！