概要

functions.phpは、WordPressテーマに機能を追加するための任意のPHPファイルです。WordPressはテーマを読み込む際に、そのファイルがあれば自動で読み込みます。[1]

この記事が指すのはテーマ側のファイルで、WordPress本体のファイルは対象外です。編集するときは、ファイル名だけでなく、どのテーマに属するかを確かめます。

functions.phpで扱う機能

functions.phpは、テーマ固有の処理をWordPressに組み込む場所です。代表的な用途は次のとおりです。[1]

  • フック登録:WordPressの処理が所定の箇所に達したときに呼び出す関数を登録します。[2]
  • テーマ設定:テーマが対応する機能をWordPressへ伝えます。たとえば、テーマの初期設定でブロック用スタイルへの対応を宣言できます。[1]
  • スクリプトやスタイルの読み込み:テーマの表示に必要なJavaScriptやCSSを、WordPressが用意する読み込みの仕組みで追加します。[1]

フックを通じてWordPressと連携する

ファイルの読み込みと、フックに登録した関数の実行は別です。functions.phpにフックへの登録処理を書いた場合、ファイルが読み込まれた時点で関数を登録します。WordPressが対応するフックまで処理を進めると、その関数が呼ばれます。[1][2]

アクションは決まったタイミングで処理を加えるために使います。フィルターは受け取った値を加工し、その値を後続の処理へ返すために使います。[2]

プラグインと役割を分ける

テーマに結び付いた処理はfunctions.phpに、テーマを替えても使う機能はプラグインに置くのが基本です。たとえば、そのテーマが使うスタイルの読み込みは前者に向きます。[1]

WordPress公式は、独自の投稿タイプの登録をプラグインに置くことを推奨しています。テーマを切り替えても、その種類のコンテンツを扱う機能を引き継ぐためです。[3]

編集前に確認すること

本番へ反映する前に、影響する画面と、元に戻す手段を確認します。

  • 構文と動作:このファイルは公開画面と管理画面の両方で読み込まれます。[1]変更箇所の構文を確かめ、両方の画面で意図した動作になっているか確認します。
  • 復旧:CISAは、重要データのバックアップを実際に復元できるか試験するよう推奨しています。[4]変更前の版を保管し、戻し方を確かめてから編集します。
  • 更新対象:編集したファイルが親テーマと子テーマのどちらに属するかを記録し、更新時に対象を確かめます。子テーマを有効にし、両方にファイルがあるときは、WordPressは子テーマのファイルを先に読み込みます。[1]

参考文献・出典

  • Supervisor
    supervisor

    桑田 陽介

    代表取締役

    Web制作・運用・改善に20年以上携わり、WordPress、CMS構築、SEO、AWSなど、Webサイトの企画・制作から公開後の運用まで幅広く担当。実務経験にもとづき、本記事の内容・表現・技術情報を監修しています。

Contact us

『ホームページ制作の相談をしたい』『もっとたくさん商品を売りたい』等、ご要望をお伝えくださいませ。

疑問に思っていること、お困りごと、具体的な内容が未定でも、まずはお気軽にご相談くださいませ。