WordPress Functions.phpファイルの説明：エッセンシャルガイド

公開: 2020-11-18

WordPressのfunctions.phpファイルは、WordPressの最も重要な操作ファイルの1つです。少なくとも、WordPress Webサイトごとに2つのfunctions.phpファイルが存在します。WordPressコアの関数ファイルと、WordPressテーマの追加の関数ファイルです。さらに、子テーマにもfunctions.phpファイルがあります。

このガイドでは、functions.phpファイルとは何か、WordPressのfunctions.phpファイルの場所、編集方法などについて説明します。 WordPress機能の入門書も提供します。に飛び込みましょう。

このガイドでは

この記事を読んでいる場合は、基本的なWordPressのインストールを開始して実行しているか、WordPressのWebサイトを既に持っている可能性があります。すべてがうまく機能しているように見えます。次に、ボタンをクリックするだけのように見えることを実行します。次に、オンラインでチュートリアルを見つけます。WordPress関数ファイルまたはfunctions.phpファイルを直接編集する必要があることがわかりました。

または、最初のWordPressテーマを作成していて、関数ファイルの編集方法やWordPressテーマ開発のベストプラクティスについて質問があるかもしれません。この記事の終わりに、WordPressのfunctions.phpファイルがどのように機能するか、そしてそれを最大限に活用する方法をよりよく理解する必要があります。

WordPressのFunctions.phpファイルとは何ですか？

WordPressのfunctions.phpファイルは、WordPressのWebサイトを機能させる重要なPHP関数を格納する強力なオペレーティングファイルです。

WordPress内の関数ファイルの主な場所は2つあります。

WordPressコアファイルにパッケージ化されているWebサイトのメインディレクトリ内にあるfunctions.phpファイル
WordPressテーマおよび/またはWordPress子テーマにあるfunctions.phpファイル。インストールした各WordPressテーマには、WordPressインストール内のルートにfunctions.phpという独自のファイルがあります。

WordPressプラグインの動作と非常によく似ていますが、functions.phpファイルは、ユーザーがカスタムPHPコードを入力してページで実行できるようにするために存在します。これは、サーバー側の計算などの基本的な追加機能から、ユーザーが利用できるPHPで記述された完全なプログラムなどのより複雑な項目まで、無数の用途に使用できます。

注：すべてのテーマには「functions.php」ファイルがあります。 WordPressを介してワンクリックでブログのテーマを変更するのは簡単ですが、これによりfunctions.phpファイルが変更されることに注意してください。

さまざまなテーマの実験を楽しんでいる場合は、行ったfunctions.phpの変更を手動で移行する必要があることに注意してください。さらに、一部のテーマは、アクティブに保守されていない場合、新しいバージョンのPHPをサポートしない可能性があり、古い機能の一部が使用できなくなります。

そのため、テーマを変更することにした後でも、正式にQAを実行するか、サイトのすべてをテストすることが重要です。テーマの移行が成功したというWordPressのメッセージを、機能がすべて転送されたことを意味するものと見なさないでください。これは手動で確認する必要があります。

WordPress関数ファイルはどこにありますか？

すべてのテーマには独自のfunctions.phpファイルがあり、テーマを移行する頻度とサイトの機能に応じて、祝福または呪いのいずれかになります。

ただし、まだ説明していない2番目の「包括的な」関数ファイルもあります。これらの各ファイルの場所と、2つのファイルの正確な違いを見てみましょう。

WordPressコアFunctions.phpファイル

名前が示すように、WordPressのコアfuntions.phpファイルは「headhoncho」関数ファイルです。この関数ファイルは、WordPressWebサイトの基本コードを提供するWordPressコアソフトウェアにバンドルされています。

WordPress Webサイトのルートディレクトリ内に、 wp-includesフォルダーまたはディレクトリにあるこの関数ファイルがあります。 wp-includesフォルダー内に入ると、 functions.phpというファイルがありfunctions.php 。このファイルの内容を調べますが、変更しないでください。後で、構造がテーマの関数ファイルの構造と少し異なることに気付くはずです。

注：すべてのWordPressコアファイルと同様に、テーマ間で関数を転送するのがどれほど面倒であっても、Webサイトのルートディレクトリに含まれているWordPressのfunctions.phpファイルを編集しないことをお勧めします。この関数ファイルは、WordPressの作成者がミッションクリティカルな機能を保存することと、高度なWordPress開発者を対象としています。

どうして？ WordPressコアファイルを編集しない理由はいくつかあります。

WordPressの新しいバージョンがリリースされるたびに、更新によってWordPressコアファイルに加えたカスタマイズまたは変更が上書きされます。最新バージョンのWordPressを実行することは、セキュリティ上の理由から常に良い考えです。そのため、ファイルをカスタマイズして最新バージョンのWordPressを実行できないようにする必要はありません。
間違った場所に1つのスペースがあるか、セミコロンが余分にあると、WordPressWebサイトが完全に破損する可能性があります。高度なWordPress開発を完全に理解していない限り、WordPressコアファイルは変更されないままである必要があります。

WordPressテーマ内の関数ファイルはどこにありますか？

それでは、テーマ固有のfunctions.phpファイルを見てみましょう。コアのfunctions.phpファイルとは異なり、このファイルは開発者/ウェブマスターであるあなたが編集することを目的としています。これらのファイルは、エラーが通常サイトを壊すことはなく、コアレベルのファイルのエラーよりもデバッグがはるかに簡単になるように構造化およびアクセスされます。

このためには、WordPressテーマを含むwp-contentフォルダーにアクセスする必要があります。機能の追加に最も関心のあるテーマのメインフォルダーを選択します。

テーマのルートフォルダー内に、 functions.phpファイルが表示されます。このファイルを開きますが、まだ内容を変更しないでください。このファイルを見て、コア関数ファイルよりも内容が少ないことに注意してください。

WordPressFunctions.phpファイルの例

適切なWordPressのfunctions.phpファイルがどのように見えるかを最もよく理解できるように、この「ミニマリスト」テンプレートを提供しています。基本的に、これにはWordPressが機能するために必要な最小限のコードが含まれています。ただし、関数がまだ入力されていないため、あまり多くのことを実行していることはわかりません。

WordPress関数ファイルには「必須」関数があります。これについては、この記事の後半で説明します。これ以上の説明なしで、これが私たちの小さなfunctions.phpファイル（テーマベース）です。これは、公式のWordPressテーマ関数の例から採用されていますが、わかりやすくするためにいくつかの副次的な項目が削除されています。

 if（！isset（$ content_width））
 $ content_width = 1000; / *これのデフォルト値タイプはピクセル単位です* /

 if（！function_exists（ 'myfirsttheme_setup'））：
 / **
 *この関数は、後でファイル内のすべてをこれに登録するために必要です
*テーマのfunctions.php。
 * /
 関数myfirsttheme_setup（）{

 / **
 *テーマ/サイト全体で画像のサポートを追加する
* /
 add_theme_support（ 'サムネイル後'）;


 / **
 *すべてのコアWP関連のサポートを有効にする
* /
 add_theme_support（ 'post-formats'、array（ 'aside'、 'gallery'、 'quote'、 'image'、 'video'））;
 }
 endif;
 add_action（ 'after_setup_theme'、 'myfirsttheme_setup'）;

そして、あなたはそれを持っています！ほとんどのテーマには、実際には、コードを追加することを歓迎する、より多くの入力された関数ファイルが付属していることを忘れないでください。このファイル内で開発する場合は、常にWordPress開発者マニュアルを参照することをお勧めします。

注：テーマのfunctions.phpファイルを編集する前に、現在のWebサイトをバックアップして、データやハードワークを失わないようにする必要があります。苦痛や苦痛なしにこれを行う1つの方法は、BackupBuddyのような単純なWordPressバックアッププラグインを使用することです。

WordPressFunctions.phpファイルセキュリティ

警告： Functions.phpファイルは、特にWordPressデータベースに直接リンクするカスタマイズされたコードがある場合（セキュリティ上の理由から、そうすべきではありません）、ハッカーの標的になることがよくあります。

本番サーバーでこれらのファイルを変更する前に、iThemes Security Proなどの適切なWordPressセキュリティプラグインを使用して、データが安全であることを確認してください。

iThemes Security Proのようなプラグインは、ファイル変更検出をWebサイトに追加できます。 iThemes Security Proのファイル変更検出機能は、Webサイトのファイルをスキャンし、次のような変更がWebサイトで発生したときに警告します。

ファイルの追加–スパイウェアの形のマルウェアは、顧客がクレジットカード情報を入力するときにキーストロークを記録する悪意のあるファイルを追加する可能性があります。
ファイルの削除–一部のマルウェアは、正当なファイルを削除し、同じ名前の悪意のあるファイルに置き換えます。
ファイルの変更–マルウェアは、変更する既存のファイルにコードを隠すことにより、悪意のあるコードを隠そうとします。

ボーナスコンテンツを入手する：WordPressセキュリティのガイド

PDFをダウンロード

WordPressでFunctions.phpファイルにアクセスするにはどうすればよいですか？

関数ファイルにアクセスするには、このプロセスを実行するためのいくつかの基本的な情報が必要です。

sFTPクレデンシャル（ホストのみがこれらを提供でき、最初の電子メールで送信される可能性があります）
選択したsFTPクライアント
アクセスしたいファイルの場所

sFTPクライアントにアクセスし、資格情報を使用してサーバーにログインすると、WordPressサイトのファイルを参照、表示、編集できます（適切なユーザー権限がある場合）。

「コア」とテーマベースの関数ファイルの両方について、上記の説明を参照してください。

WordPressのテーマ機能の説明

つまり、WordPressテーマ関数で何ができるかを理解したので、これらの関数のいくつかがどのように機能するかに興味があります。

公式のWordPress開発ガイドにアクセスして、使用できる機能の完全で最新のリストを確認する必要がありますが、便利なテーマ機能の便利なリストとそれぞれの機能を以下に示します。

themename_setup() –この関数では、「themename」をテーマの名前に置き換えるだけです。これには、テーマを設定するためのコードが含まれています。

register_nav_menus() –この関数では、カスタマイズされたナビゲーションメニューを設定するだけです。ほとんどすべての実際の（理論的ではない）テーマはこれを利用しています。そうでなければ、すべてのWordPressサイトのメニューはまったく同じに見えます！

load_theme_textdomain() –これはローカリゼーションを可能にする関数です。全国的または世界的に広範囲に及ぶWordPressサイトのローカルSEOの万能薬。これにより、ローカル地域および地域の言語とSEOの最適化が可能になります。

add_theme_support() –おそらく最も単純な関数です。これは、さまざまなタイプのメディアをサポートするモジュールをロードするようにテーマに指示するだけです。これらはすべて組み込みであるため、面倒なことはまったくありません。この機能を使用すると、RSSフィードからビデオサポートまで、さまざまなものがもたらされます。

そして、あなたはあなたの主要なWordPressテーマ機能を持っています！ただし、WordPressで利用できる機能の検討はまだ終わっていません。次に、前に説明したように、WordPressのコアから提供される利用可能な主要なWordPress関数を見ていきます。

主要なWordPress機能のトップ5リスト

次に、少なくとも知っておく必要のある主要なWordPressコア機能をいくつか紹介します。ただし、ほとんどのWordPress開発者でさえ、主に各関数のパラメーターの複雑さのために、それぞれを使用する前に公式のWordPressテーマハンドブックを参照する必要があります。

始める前に、WordPressコードリファレンスで使用できるすべてのパブリック関数を自由に見てください。

activate_plugins() –この関数は、 activate_plugin()関数からピギーバックします。その名前が示すように、インストールされているプラグインをアクティブ化するためのショートカットです。
add_menu_page() –この関数を使用すると、テーマまたはサイトのメインメニューにページを非常に簡単かつ簡単に追加できます。多くの初心者ユーザーは、生のHTMLとCSSを使用してこれを実行しようとします。残念ながら、そのアプローチはテーマ全体を台無しにする可能性があります。自分で「ハッキング」しようとするよりも、その目的のためだけに作られたこのような機能を利用するのが常に最善です。
bloginfo() – PHP開発者は、これが「phpinfo（）」と呼ばれるPHP自体の必須関数に非常に似ていることに気付くかもしれません。これは、その機能を模倣することを目的としており、WordPressのバージョン、サーバーの種類などに関する開発用のページに印刷された重要な情報を提供します。これは、特定の情報をすばやく取得する必要がある場合に最適です。
current_user_can() –この関数は「ブール値」です。つまり、「true」値または「false」値のいずれかを返します。これはデバッグに最適であり、特定の機能を利用できるかどうかを確認するために呼び出すことができます。問題の関数をパラメーターとして使用して、特定の機能にアクセスするためのWordPress権限があるかどうかを確認できます。そうでない場合は、続行する前にそれを取得して開発プロセスをスピードアップすることができます。
delete_plugins() –この関数は、その名前が示すとおりに文字通り実行します。プラグインの登録名を入力すると、この関数を実行すると、プラグインとそのディレクトリが削除されます。繰り返しになりますが、このアクションは永続的であり、元に戻すことはできないことに注意してください。この機能の実行を続行する前に、正しい名前を持っていること、サイトをバックアップしていることなどを確認してください。

必須のWordPressテーマ機能

約束したとおり、これらの「必須」のWordPressテーマ機能を確認するために戻ってきました。これらは、すべてのWordPressテーマが正しく機能するために必要な機能です。ほとんどのプログラミング形式と同様に、これらの関数を空白にしてファイルを作成するだけで、これは引き続き有効であると見なされることに注意してください。

これは、多くのブログがプロセスを実際よりもはるかに高速に見せ、「WordPressの基本」と呼ばれるものをより迅速に理解するために使用する戦術です。ただし、これらの必須または「必須」の機能をスキップして、自分自身やサイトに有利なことをしているわけではないことを忘れないでください。あなたは、単に意図したように、これらの機能に依存している一部の機能が動作しないことを確実にしています。すべてをかろうじてまとめるためだけに、継続的に戻って何かを編集する必要があるよりも、最初にサイトを正しく作成することが常に最善です。

WordPressテーマ関数の初期設定サンプルファイルを参照するだけで、にあるテーマに「必須」のすべての関数を確認できます。

Functions.phpファイルの編集

それでは、WordPress関数ファイルの基本について説明したので、このファイルを編集する方法を見てみましょう。そこにはさまざまな「ベストプラクティス」がありますが、それを行うための最良の方法は非常に簡単です。

まず、前に同じSFTPクレデンシャルを使用して同じSFTPクライアントを経由する必要があります。次に、PHPファイル自体を見つけてローカルドライブにダウンロードする必要があります。ローカルコンピューターでエディター（オープンソースのNotepad ++など）を使用して、最初にローカルで編集します。

理想的には、このファイルをテストできるものをローカルにインストールする必要があります。ただし、そうでない場合は、変更が期待どおりに機能しない場合に備えて、元のファイルがバックアップされ、復元の準備ができていることを確認してください。次に、サーバー上のそのファイルを置き換えて、実行されるのを確認します。

ベテランのWordPress開発者になるための道を進んでいる可能性が高いので、WordPressチーム自体が推奨するベストプラクティスを覚えておく必要があります。再利用できるようにしたい本質的に重要な機能を追加する場合（プログラマー向けのオブジェクト指向言語の「オブジェクト」に類似）、このPHPを使用して完全なプラグインを作成することをお勧めします。各サイトに簡単にインストールおよびアンインストールできます。これはもっと複雑に聞こえますが、実際には何年にもわたって時間を節約できます。

Functions.phpにコードを追加するにはどうすればよいですか？

このファイルの変更について言及しているだけの場合は、上記の回答をご覧ください。ただし、多くのユーザーは、ファイルに独自の機能を実際に追加することに関心があるため、この質問をします。

繰り返しになりますが、テーマファイルを際限なく編集するのではなく、このような機能をプラグインに組み込むことが「ベストプラクティス」と見なされています。とにかく、次のサブセクションでは、独自のカスタム関数を追加する方法を見ていきます。

独自のカスタム関数をWordPressに挿入するにはどうすればよいですか？

さて、ついにあなた自身の機能をWordPressに注入する時が来ました！これはどの開発者にとっても大きなマイルストーンであるため、ちょっとしたお祝いが必要かもしれません。まず、これを行う方法を詳しく見ていきましょう。

後でリリースするプラグインにカスタマイズしたコードを追加するのが常に最善ですが、少なくとも、災害が発生したい場合を除いて、ライブサイトで関数を編集しないでください。テーマのfunctions.phpファイルを編集する前に、必ずサイトの完全なバックアップを作成してください。

1.無料のプラグインを利用して、このチュートリアルで使用する「マイカスタム関数」などの関数を追加します。

私のカスタム関数

2.プラグインをインストールした後、「外観」に移動し、次に「カスタム関数」に移動します。ここで、この新しいプラグインを介して既存のカスタム関数が表示されます。

3.これに非常に単純なPHP関数を追加できます。たとえば、テキスト入力ボックスの一番下までスクロールすると、「Hello、world！」と印刷することができます。次のテキストで：

 function hello_world（）{
echo "Hello、world！";
}

4.これは単に標準のPHPであることに注意してください。構文を根本的に変更する「WordPressフレームワーク」などはありません。これは、既存のPHP開発者にとって朗報です。

5.最後の簡単なヒント！テーマとサイトが持つ機能の更新に取り組んでいる間、 wp-config.phpファイルがあります。これはテーマのルートにあり、SFTPクライアントを介してお気に入りのテキストエディターでこれを開く必要があります。

define('WP_DEBUG', false);という行を見つけdefine('WP_DEBUG', false); 。単にdefine('WP_DEBUG', true);と言うdefine('WP_DEBUG', true);変更しdefine('WP_DEBUG', true); 。開発が完了したら、 FALSEに戻す必要があることに注意してください。

Functions.phpを使用してスクリプトをヘッダーとフッターに追加するにはどうすればよいですか？

ヘッダースクリプトとフッタースクリプトは、広告目的やその他の追跡目的でよく使用されます。これらは、すべてのページに挿入する必要がある場合もあれば、特定のターゲットページに挿入する必要がある場合もあります。いずれにせよ、経験豊富なWordPressユーザーでない限り、そのPHPファイルを直接編集することはできません。

繰り返しになりますが、始める前に小さなプラグインを追加する必要があります。今回のプラグインは、Insert Headers andFootersプラグインと呼ばれます。

ヘッダーとフッターを挿入する

これをテーマまたはサイトに追加すると、[設定]、[ヘッダーまたはフッターの挿入]の順に編集機能にアクセスできるようになります。ヘッダースクリプト用に1つのボックス、フッタースクリプト用に1つのボックスが表示されます。明確にするために、このプラグインはPHPではなくJavaScriptを入力することを想定しているため、続行する前にスクリプトが正しい形式であることを確認してください。このプラグインはエラーメッセージを表示しません。これらのボックスに入れたものはすべてJavaScriptとしてページに配置されます。

追加するスクリプトをボックスに直接貼り付ける準備ができている必要があります。次に、[保存]をクリックすると、プロセスが完了します。一部のユーザーから、クライアントがブラウザキャッシュをクリアし、サーバー側のキャッシュをクリアするまでこれらの変更は表示されないという報告があります。そのため、変更を実際に有効にするには、これを行う必要がある場合があります。

まとめ：WordPressFunctions.phpファイルの入門書

WordPressのfunctions.phpファイルがどのように機能するか、関数ファイルのWordPressコアバージョンとファイルのテーマバージョンの違いについて、長い（しかしうまくいけば価値がある！）チュートリアルをご覧いただきありがとうございます。このすべての情報が、日常のWordPressワークフローとWebサイト管理の実践に取り入れられると、さらに優れたWordPress開発者になるのに役立つことを願っています。

ボーナスコンテンツを入手する：究極のWordPressメンテナンスチェックリスト

PDFをダウンロード

クリステンライト

Kristenは、2011年からWordPressユーザーを支援するチュートリアルを作成しています。通常、彼女はiThemesブログの新しい記事に取り組んでいるか、＃WPprosperのリソースを開発しています。仕事以外では、クリステンはジャーナリング（2冊の本を書いています！）、ハイキングやキャンプ、料理、家族との毎日の冒険を楽しんでおり、より現代的な生活を送っています。