これでテーマの更新も怖くない！『Code Snippets』はfunctions.phpを編集できるWordPressプラグイン

WordPressのfunctions.phpファイルを直接編集せずにカスタマイズできるプラグイン『Code Snippets』をご紹介します。

Code Snippetsとは

WordPressで作ったサイトをあれこれカスタマイズしようとすると、functions.phpを編集しないと実現できないようなケースがしばしば出てきます。基本的にはfunctions.phpファイル中に追加したい機能を書き込む等すればよいのですが、WordPressのテーマをバージョンアップしたり、異なるテーマに入れ替えをすると、functions.phpが新しいものに差し替えられてしまうリスクがあります。せっかくfunctions.phpを手作業で編集したのに、テーマ更新で上書きされて消えてしまったら困りますよね。

Code Snippetsプラグインを使うと、このような”functions.phpファイルを直接編集するときのリスク”を気にせずカスタマイズできるようになります。

使い方

1. インストール〜有効化

Code Snippetsプラグインをインストールして有効化します。

2. スニペット新規追加（functions.phpに追加したいコードの登録）

ここでは例として「アイキャッチ画像を表示するショートコード」のスニペットを登録してみます。

まず管理画面のメニューから「スニペット」→「新規作成」を開きます。

次に「スニペット新規追加」にスニペット名とコードを書き込んで保存します。

作成したスニペットをそのまま有効化して大丈夫なら「変更を保存＆有効化」ボタンをクリックします。

＜補足＞
こちらは追加するスニペット部分を拡大したものです。「showeyecatch」という名前のショートコードを登録しています。

Code Snippetsに登録したショートコードを実際に使ってみましょう。

以下のアイキャッチ画像が設定された投稿ページに、ショートコード showeyecatch を入力します。

投稿記事の冒頭にショートコードをセット。

投稿ページの画面をプレビューしてみると・・・

ちゃんとアイキャッチ画像が表示されていますね。

functions.phpファイルを直接編集せずにショートコードを追加することができました。

3. 画面が真っ白に？！問題が起きたときはセーフモードで対処

functions.phpを直接編集するときと同様に、登録したスニペット（コード）に誤りがあればWordPressの画面が真っ白になるなど不具合を起こす可能性はあります。もしそのような状態になってしまった場合には、以下の手順のとおり、セーフモードを使って対処しましょう。

【STEP1】セーフモードをONにする

wp-config.phpファイルに以下をセットすることで、Code Snippetsがセーフモードで起動するようになります。

具体的には以下のように追記して、セーフモードをONにします。

【STEP2】問題のあるスニペットを非アクティブ（無効）にする

セーフモードをONにするとスニペットが実行されなくなりますので、誤ったスニペットの影響もなくなります。WordPressの管理画面も正常に開けるようになりますので、スニペットの管理メニューを開き、問題を起こしていると思われるスニペットを無効にしましょう。

なおセーフモードがONになっているときは、スニペットの管理画面に以下のような警告文が表示されます。

意訳すると「セーフモード起動中、スニペットは実行されません！セーフモードをOFFにするにはwp-config.phpのCODE_SNIPPETS_SAFE_MODE定数を削除してください。」 という感じでしょうか。

【STEP3】セーフモードをOFFにする

STEP1で追記したコードを削除、またはコメントアウトします。以降、セーフモードが解除され、スニペットが通常どおり実行されるようになります。

参考：Code Snippets公式サイト（英語）

ひとこと

このプラグインを使えば、テーマの変更とfunctions.phpのカスタマイズを切り離して考えることができます。

テーマの更新が気になってfunctions.phpファイルの編集に二の足を踏んでいた方は、Code Snippetsプラグインを試してみてはいかがでしょうか？

Code Snippets

ジャンル：functions.php

概要： functions.phpを管理画面上でカスタマイズできるようになるプラグイン