WordPressのカスタマイズをしていると、PHPコードをどこかに書く必要が出てきます。
「よく調べたらfunctions.phpに書けばいい」と書いてある。とりあえず書いてみたら画面が真っ白になった——この経験をした方は少なくありません。
結論から言います。WordPressにPHPコードを追加するときは、WPCodeを使ってください。functions.phpを直接触る必要がなくなります。ミスがあっても、そのスニペットを無効にするだけでサイトが復旧します。
この記事では、WPCodeを使う理由と、基本的な使い方を解説します。
なぜfunctions.phpを直接触ってはいけないのか
1文字のミスでサイトが壊れる
functions.phpはWordPressの動作に直結するファイルです。PHPの構文エラーが1か所あるだけで、サイト全体が真っ白になります。
「サイトが真っ白になった」状態は、WordPressの管理画面にもアクセスできません。FTPでファイルを修正するか、サーバーパネルのファイルマネージャーで修正するしかありません。
非エンジニアにとって、このリカバリー作業は難易度が高いです。
テーマ更新でコードが消える
親テーマのfunctions.phpに直接コードを書いた場合、テーマを更新するとそのコードは消えます。
子テーマを使えばこの問題は回避できます。ただし、子テーマを正しく設定するにはある程度の知識が必要です。
WPCodeを使えば、テーマとは独立してコードを管理できます。テーマを更新しても、WPCodeで管理したコードは消えません。
WPCodeとは何か｜スニペット単位でコードを管理する
PHPスニペットをプラグインとして管理する
WPCodeはWordPressのコードスニペットを安全に管理するプラグインです。
PHPコード・CSSコード・JavaScriptコードを「スニペット」という単位で登録し、個別にオン/オフできます。
スニペットに問題がある場合は、そのスニペットだけを無効にできます。サイト全体には影響しません。
WPCodeで管理できるコードの種類
WPCodeで管理できるコードは複数の種類があります。
PHPスニペット：functions.phpに書くような処理。
HTMLコード：<head>タグや<body>タグへの挿入。
CSSコード：サイト全体のスタイル追加。
JavaScriptコード：任意のスクリプト追加。
WPCodeの基本的な使い方
インストール
WordPress管理画面の「プラグイン」→「新規追加」から「WPCode」を検索してインストール・有効化します。
スニペットの作成
管理画面の左メニューに「Code Snippets」が追加されます。「Code Snippets」→「新規追加」を開きます。
スニペット名（管理用の名前）を入力し、コードタイプを選択します。コードを入力し、右側の「状態」を「有効」にして保存します。
実際の使用例：Googleアナリティクスのコード追加
GA4のトラッキングコードをサイトに追加する場合の例です。
WPCodeの「新規追加」を開きます。スニペット名を「GA4 トラッキングコード」とします。コードタイプは「HTML スニペット」を選択します。
GA4の管理画面からコピーした <script> タグを貼り付けます。挿入場所は「ページヘッダー（すべてのページ）」を選択します。「有効」にして保存します。
これで全ページの<head>内にトラッキングコードが挿入されます。
実際の使用例：カスタム関数の追加
特定のカスタム関数をWordPressに追加する場合の例です。
コードタイプを「PHP スニペット」に変更します。PHPコードを入力して保存します。
PHPコードの記述ミスがあった場合、WPCodeは自動でスニペットを無効にしてサイトを保護する機能があります（バージョンによって異なります）。
子テーマとWPCodeの使い分け
CSSカスタマイズはどこに書くか
CSSのカスタマイズには複数の方法があります。
WordPressのカスタマイザーにある「追加CSS」→少量のCSSに向いています。
子テーマのstyle.css→テーマ全体に関わるCSSに向いています。
WPCodeのCSSスニペット→条件付きCSS（特定ページだけ適用）に向いています。
どの方法でもCSSの内容は反映されます。管理しやすい場所を選んでください。
PHPカスタマイズの推奨場所
PHPのカスタマイズはWPCodeを推奨します。
子テーマのfunctions.phpに書く方法もありますが、コード量が増えてくると管理が複雑になります。WPCodeならスニペットごとに名前をつけて管理できるため、「どのコードが何をしているか」が把握しやすいです。
まとめ｜WPCodeで解決できる3つの問題
この記事の内容を整理します。
WPCodeを使うことで解決できる問題が3つあります。
問題1：functions.phpの直接編集リスク
→WPCodeを使えばfunctions.phpを触らずにコードを追加できます。
問題2：テーマ更新でコードが消える問題
→WPCodeはテーマとは独立しているため、テーマ更新の影響を受けません。
問題3：コードの管理が煩雑になる問題
→スニペットごとに名前をつけて管理できます。何のコードか一目でわかります。
PHPコードを追加する機会があるすべてのWordPressサイトに入れておく価値があるプラグインです。
