WordPressWebサイトにカスタムコードを安全に追加する方法

ユーザーは、自分のWebサイト、プラグイン、テーマを微調整したり、既存の機能にいくつかの変更を加えたりする方法を探していることがよくあります。 これらのほとんどの場合、WordPressWebサイトにカスタムコードを追加することでこれを行うことができます。

Webサイトにカスタムコードを追加しても問題はありません。 ただし、WordPress Webサイトにこれらの変更を加える場合は、注意が必要なことがいくつかあります。

この記事では、注意すべき点と、WordPressWebサイトにカスタムコードを追加するためのベストプラクティスについて説明します。

WordPressにカスタムコードスニペットを追加する前に探すべきこと

作成者がチュートリアルで提案するコードスニペットを追加する最も簡単な方法は、テーマのfunctions.phpファイルにコードスニペットを追加することです。 ただし、テーマのfunctions.phpファイルにコードスニペットを追加する場合、いくつかの制限と欠点があります。

テーマをアップグレードするたびに、 functions.phpファイルに追加したカスタムコードスニペットは、テーマを手動でアップグレードするか、1つのfunctions.phpファイルから別のファイルにコードスニペットを手動でコピーしない限り、上書きされます。 ほとんどの開発者がアップグレードを頻繁にリリースすることを念頭に置いて、特にプレミアムテーマを使用する場合、テーマのfunctions.phpファイルにコードスニペットを追加することは維持するのが非常に困難になります。

また、テーマを変更したい場合は、コードも移行する必要がありますが、これは長期的には間違いなく良くありません。

もう1つの欠点は、テーマファイルがすべてのページで実行され、テーマのfunctions.phpファイルにコードスニペットを追加することで、Webサイト全体が破損するリスクがはるかに高くなることです。

カスタムコードスニペットをWordPressサイトに追加する方法のベストプラクティスを確認してみましょう。そうすれば、コードスニペットを見逃したり、移行を忘れたり、テーマをアップグレードするときに機能が壊れたりすることを心配する必要はありません。

WordPressサイトへのカスタムコードスニペットの追加

カスタムコードは、次のいずれかの方法を使用して追加できます。

• プラグインの使用（WordPressプラグインとは何かについて詳しくは、WordPressプラグインの概要を参照してください）
• カスタムプラグインの作成
• 子テーマの作成

それでは、それぞれの方法について詳しく説明しましょう。

1.コードスニペットプラグインの使用

コードスニペット¹ プラグインは、WordPressサイトにカスタムコードを追加するための優れた方法です。自分でコードを書くのが好きでない場合は、独自のプラグインを作成するよりもこの方法の方が簡単です。

プラグインをインストールすると、新しいスニペットセクションがWordPressメニューに追加され、新しいスニペットを追加できるようになります。 各スニペットには、コード用のスペースと、コードの機能に関する追加情報の説明があります。

ヒント：サイトの便利なコードスニペットを使用している場合は、説明にURLを追加して、コードの出所を覚えておいてください。

プラグインと同様に、カスタムコードスニペットを有効または無効にしたり、PHPファイルにエクスポートしたりできます。 場合によっては、カスタムスニペットによって他のプラグインやテーマとの競合が発生することがあるため、すべてのカスタムコードを非アクティブ化すると、問題をターゲットにするのに役立ちます。

2.独自のサイト固有のプラグインを作成する

独自のカスタムサイト固有のプラグインを作成することは、コードを完全に制御できるため、WordPressサイトにカスタムコードを追加するための最良の方法です。

サイト固有のWordPressプラグインとは何ですか？

サイト固有のWordPressプラグインは、テーマに依存しないWebサイトにカスタマイズコードを追加するために使用されます。 つまり、使用するテーマに関係なく、またはテーマを切り替えても、プラグインがアクティブ化されている限り、プラグインのカスタムコードは常に実行されます。

サイト固有のWordPressプラグインを作成する方が良いのはなぜですか？

テーマの関数ファイルにカスタムコードを追加した場合、テーマを更新または切り替えると、カスタムコードは表示されなくなります。

サイト固有のWordPressプラグインを使用すると、カスタムコードスニペットをWordPressサイトに簡単に追加して、テーマに依存しないようにすることができます。 これはスタンドアロンのWordPressプラグインです。つまり、テーマに依存しません。つまり、カスタムコードを失うことなく、テーマを自由に更新または切り替えることができます。

サイト固有のWordPressプラグインを作成するために、PHPの第一人者である必要はありません。 以下の簡単な手順に従ってください。

1.プラグインディレクトリを作成します

まず、プラグインのディレクトリを作成して名前を付ける必要があります。 サイトのWebサイトなど、任意の名前にすることができます。 プラグインのディレクトリは、Webサイトの/ wp-content / plugins /ディレクトリに作成する必要があります。 この例では、プラグインwpwhitesecurity-shortcodesを呼び出しています。 注：ディレクトリ名には、スペースではなくダッシュを常に使用してください。

2.プラグインファイルを作成します

次に、プラグインのメインファイルが必要になります。 ファイル名の規則はありませんが、ファイル名をプラグイン名と同じにすることをお勧めします。 したがって、この例では、プラグインのファイル名はwpwhitesecurity-shortcodes.phpです。

このファイルには、少なくともタイトルと説明が含まれている必要があります。

NotePad ++やTextEditなどのテキストエディタを使用してこのファイルを作成します。 Microsoft Wordまたは同様のエディタを使用しないでください。テキストに書式設定データが追加され、ファイルが混乱する可能性があります。 上記のすべてのエディターは無料です。

ファイルに追加する必要があるのは次のとおりです。

<?php
/*
* Plugin Name: WP White Security Shortcodes
* Plugin URL: https://www.wpwhitesecurity.com
* Description: Site-specific plugin for custom code snippets in wpwhitesecurity.com
*/

以上です。 次に、カスタムコードを追加します。

3.カスタムコードスニペットを追加します

これで、チュートリアルなどのコードスニペットをコピーしてこのファイルに貼り付けることができます。 プラグインファイルをオフラインで作成した場合は、プラグインのフォルダーを.zipファイルとして圧縮し、WordPressダッシュボードからWebサイトにアップロードします。

これからは、コードスニペットを見逃したり、移行を忘れたり、テーマやWordPressをアップグレードするときに一部の機能を壊したりすることを心配する必要はありません。 次回WordPressコードスニペットに遭遇し、それをWebサイトに追加したい場合は、サイト固有のプラグインファイルに追加します。

4. index.phpファイルを追加します（オプション）

これはオプションの手順です。 ディレクトリの一覧表示を回避するには、プラグインディレクトリにインデックスファイルを追加する必要があります。 あなたがする必要があるのは：

index.phpというファイルを作成します
次のコンテンツを追加します。

<?php
/**
* Nothing to see here.

3.子テーマfunctions.phpを使用します

以前、テーマのfunctions.phpファイルを使用しないと言いました。 ただし、これは、テーマ固有の変更など、特定の変更に適した代替手段です。 このように、テーマ固有のカスタムコードは、テーマが存在するときに出力されます。これは、もう必要ないためです。

それでも、テーマの変更は、親テーマではなく、常に子テーマに追加する必要があるため、アップグレードしても安全です。

関数.phpにコードを追加する場合は、必ず終了PHPタグを探してください。 これはそれらがどのように見えるかです： ？> 。 テーマファイルがこれらのいずれかで終わる場合は、その上にカスタムコードを配置する必要があります。

結論

これまで見てきたように、WordPress Webサイトにカスタムコードを追加する方法はいくつかありますが、長期的にはすべてが優れているわけではありません。 ただし、特定の点で他より優れているものもあります。 たとえば、テーマ固有の変更（Webサイトのルックアンドフィール）の場合は、 functions.phpファイルにカスタムコードを追加します。 その他の変更については、理想的にはカスタムサイト固有のプラグインを作成する必要があります

安全な方法でカスタムコードをWordPressに追加し、問題が発生した場合に簡単にデバッグできるようにしてください。
この記事が、WordPressサイトにカスタムコードスニペットを簡単に追加する方法を学ぶのに役立つことを願っています。