WordPressの高速化や軽量化を試みると、プラグインの利用を控えfunctions.phpにコードを書いて機能を拡張していくことになります。そこで発生するのが、たとえば以下のようなデメリット。
- 修正するときに該当箇所が探しにくい
- 同じような機能の関数を書いてしまう
- アップデートがあるテーマを利用しつつ親テーマの
functions.phpに追記しているなら、アップデートごとに書いた内容がリセットされてしまう
これらを解決するため、コードを複数のファイルに分割して functions.php にインクルード（組み込み）する方法をおすすめします。
プラグイン「Code Snippets」を使って整理する
視覚的に同等の機能をもつプラグインに「Code Snippets」があります。関数だけでなく、本文中で使用するショートコードも登録可能。
インストール方法
こちらはWordPress公式プラグインなので、例によって2通りの方法があります。
- WordPress.orgよりzipファイルをダウンロード
- ダッシュボード＞プラグイン＞新規追加＞「Code Snippets」を検索
設定
General
| 見出し原文 | 解説 |
|---|---|
| Activate by Default | スニペットを保存したとき、デフォルトで有効化するか |
| Enable Snippet Tags | スニペット一覧画面に分類タグを表示するか |
| Enable Snippet Descriptions | スニペット一覧画面に説明文を表示するか |
| Snippets List Order | スニペット一覧画面のデフォルト順序。 Priority：個別の優先順位 Name (A-Z)：名称のアルファベット順 Name (Z-A)：名称の逆アルファベット順 Modified (latest first)：更新日の昇順 Modified (oldest first)：更新日の降順 |
| Disable Shortcode Syntax Highlighter | シンタックスハイライトを向こうにするか |
| Complete Uninstall | 「Code Snippets」をアンインストールするとき、すべてのスニペットとプラグイン設定も削除するか |
Description Editor
| 見出し原文 | 解説 |
|---|---|
| Row Height | スニペットの説明文を入力するエディタの高さ（何行分か） |
| Use Full Editor | ビジュアルエディタのすべての機能を有効化するか |
| Media Buttons | メディアの追加ボタンを有効化するか |
Code Editor
| 見出し原文 | 解説 |
|---|---|
| Theme | コードエディタのテーマを Monokai などから選択 |
| Indent With Tabs | インデントはタブを使用するか |
| Tab Size | インデントをタブにするときのタブ文字の幅 |
| Indent Unit | インデントをスペースにするときのスペース数 |
| Wrap Lines | 長い行を右端で折り返すか |
| Line Numbers | 行番号を表示するか |
| Auto Close Brackets | 入力時、括弧と引用符を自動的に閉じるか |
| Highlight Selection Matches | 現在選択されているすべてのインスタンスをハイライト表示するか |
| Highlight Active Line | 編集中の行をハイライト表示するか |
| Editor Preview | ここまでのエディタ設定のプレビュー |
関数の登録・編集・削除
- スニペットのタイトルを入力します。
- コードを記述します。
- 実行場所/タイミングを選択します。左から「すべての場所」、「管理画面のみ」、「フロントエンドのみ」、「一度だけ」。
- 優先順位を設定します。設定でPriority順を選択していた場合、この数値によりスニペット一覧画面での並び順が変わります。
- スニペットの説明文を入力します。
- スニペットを分類するためのタグを入力します。
- 左から「変更を保存して有効化」、「変更を保存」、「ダウンロード」、「エクスポート」、「削除」。
問題が起きたときの対処法
プラグインを使っていても functions.php を編集しているという事実は変わりません。画面が真っ白になるなどの不具合が起きたときは、以下の手順を踏みます。
- 9行目の内容を
wp-config.phpに追記してデバッグモードにする/** * 開発者へ: WordPress デバッグモード * * この値を true にすると、開発中に注意 (notice) を表示します。 * テーマおよびプラグインの開発者には、その開発環境においてこの WP_DEBUG を使用することを強く推奨します。 */ define('WP_DEBUG', false); define('CODE_SNIPPETS_SAFE_MODE', true); /* 編集が必要なのはここまでです ! WordPress でブログをお楽しみください。 */ - Code Snippets の管理画面から問題のあるコードを無効にする
- 1で追記したコードを削除、もしくはコメントアウトしてデバックモードを解除する
プラグインなしで整理する
先に挙げたデメリットの3項目め「アップデートがあるテーマを利用しつつ親テーマのfunctions.phpに追記しているなら、アップデートごとに書いた内容がリセットされてしまう」に該当する方は、事前準備として子テーマを作成し元からあったコードと自分で書いたコードを分ける必要があります。
他者にアップデートされない自作テーマを使っていたり、既に子テーマを使っている場合はもちろん必要ありません。
functions.php を分割してPHPファイルを作る
まずはどのようにコードを分割していくかのルールを決めます。
- 1機能ごとに細かく分ける
コードを探す手間がなくなり有効化・無効化が一行コメントアウトするだけになるが、コードのぶんファイル数が増える - 機能する場所などで大まかに分ける
探す手間やコメントアウトの箇所は少し増えるが、ファイル数は少なめに調整できる
私は後者で分けるタイプです。
この分割ルールに則ってファイルを作っていきます。
テキストエディタにコードを貼りつけ、他のテンプレートファイルと被らない「任意の文字列.php」とするのをfunctions.phpが空になるまで繰り返すだけ。
Ex. 私の分割ルール
| ファイル名 | 内容 |
|---|---|
| func-init.php | 初期設定的な関数（絵文字機能の停止、セルフピンバッグ無効など） |
| func-breadcrumb.php | パンくずリストの出力 |
| func-write.php | Gutenbergのカスタムブロック追加など |
| func-dashboard.php | ダッシュボード内のカスタマイズ |
| func-form.php | メールフォームのカスタマイズ |
| form-shortcode.php | ショートコードの登録 |
| form-posttype.php | カスタム投稿タイプ、タームなどの登録 |
できあがったファイル郡はテーマディレクトリに保存します。
今後の修正などをテキストエディタからのみ行うのであればfunctionsやinc、libなどの名前をつけたサブディレクトリ（フォルダ）にまとめると分かりやすいです。これらのディレクトリ名はプラグインなどでもよく使われていますね。
インクルードに使う関数
ファイルをインクルードする関数はいくつかあります。
include()load_template()locate_template()get_query_template()get_template_part()
1のみ PHP の関数で、おそらく最も高速です。速さでいうと次点は2でしょうか。
しかしどちらも絶対パスの記述が必須なので、親テーマの階層にあるのか、子テーマの階層にあるのか、またサブディレクトリにあるのかをきっちりと記述しなければいけません。
最初、1番目の include() を使おうとしてハマりました。
子テーマの functions.php は親テーマのそれを上書きするものではなく、おおざっぱに言えば既に1度インクルード作業が行われていると捉えることができます。
PHP では実行されているファイルのある階層が常にカレントディレクトリになるという規則があるため、子テーマの functions.php でインクルードを行うと、たとえば先ほど分割したPHPファイル init.php のありかは親テーマのディレクトリだと解釈されてしまうんですね。__FILE__ や dirname を使えば正しいパスを渡すことはできますが、WordPressの関数を使えばもっと簡単に記述できます。
推奨されているのが5番目の get_template_part() です。
ソースを覗いてみると locate_template() を使用しているのが分かります。相対パスでOK、まず子テーマのディレクトリを検索してから親テーマの検索をしてくれる、ということで子テーマでこれを行いたいのであれば非常に便利！
WordPressのバージョンが3.0以降であれば使えますので、私はこちらをおすすめします。
functions.php にインクルードする
では、この get_template_part() を使って分割した PHP ファイルをインクルードしていきましょう。
サブディレクトリ（lib と仮定）にまとめた {slug}-{name}.php を読み込む場合
get_template_part( lib/$slug, $name ); サブディレクトリにまとめず、その他のテンプレートファイル群と同じディレクトリにある {slug}-{name}.php を読み込む場合
get_template_part( $slug, $name ); パラメータ$nameは任意なので、仮にinit.phpというファイルを読み込む場合は以下のように省略できます。
get_template_part( 'init' );こうして分割したすべてのPHPファイルをfunctions.phpにインクルードすれば整理は完了です。
CSS ファイルや Javascript ファイルのように分割することで表示が遅くなるものではないので、functions.phpの肥大化が気になる方はぜひ試してみてください。
