WordPress フィルターの紹介: 50 個のフィルターの包括的な概要-PHPチュートリアル-php.cn

WordPress フィルターの紹介: 50 個のフィルターの包括的な概要

WBOY

リリース： 2023-09-02 11:34:01

オリジナル

1514 人が閲覧しました

WordPress 过滤器简介：50 个过滤器的全面概述

WordPress は素晴らしいプラットフォームであり、世界で最も人気のあるコンテンツ管理システムです。このタイトルの理由は、その拡張性のためです。このシリーズでは、WordPress を拡張する最良の方法の 1 つであるフィルターについて学びます。

この機能の基礎は フック - WordPress のフィルターとアクションです。これらがなければ、WordPress の真のスケーラビリティを活用することはできません。

このシリーズでは、WordPress をスケールするための最良の方法の 1 つであるフィルターについて学びます。これは、次の内容に焦点を当てた 7 部構成のシリーズになります。

コアには数百の WordPress フィルターがあり、これらの 50 の例はそれらのサブセット (約 10%) にすぎません。そのため、このシリーズが好きで、新しいフィルターの新しい例を提案する場合は、付録がある可能性があります。

とにかく、WordPress フィルターを導入しましょう。はじめましょう！

WordPress フィルターとは何ですか?

Codex では、フィルターは次のように定義されます。

フィルターは、WordPress がデータに対して特定のアクションを実行する前に、実行中の特定の時点でデータを通過させる関数です。フィルターはデータベースとブラウザーの間、およびブラウザーとデータベースの間に配置され、WordPress でのほとんどの入出力は少なくとも 1 つのフィルターを通過します。 WordPress はデフォルトでいくつかのフィルタリングを実行しますが、プラグインは独自のフィルタリングを追加できます。

したがって、フィルターは本質的に、WordPress が出力する前に Web サイトのデータを

処理する関数です。 フィルターは、WordPressの2種類のフックのうちの1つです。もう1つは、アクションと呼ばれ、別の一連の記事の主題です。複雑なトピックのように見えますが、フィルター (および操作) は非常に簡単に理解できます。私も初めてそれらに出会ったときは怖気づいていましたが、その単純さを見てからは、Codex を確認したりコアコードを詳しく調べたりするだけで、何百ものフィルターと操作について学ぶことができました。

絶対に知っておくべきフィルターが何百もあります。ただし、まず、それらの使用方法を知る必要があります。

WordPress でのフィルターの使用

先ほども述べたように、WordPress フィルターの使用は非常に簡単です。基本的な機能のいくつかを理解するには、各フィルターの機能を理解する必要があります。 (正直に言うと、すべてのフィルターを学習するのが最も難しい部分ですが、ご想像のとおり、すべてのフィルターを一度に学習することはできません。必要に応じて学習する必要があります。)

このセクションでは、次の 4 つのことについて説明します。

フィルター関数の作成,

フィルターに掛けてください、
フィルターから関数を削除します。
独自のフィルターを作成します。

フィルターから渡されたデータを処理するには、データの処理方法を定義する関数を作成し、それをフィルターにフックする必要があります。

投稿タイトルの母音を削除するプラグインを構築しているとします。「投稿タイトルの母音を削除する」と言う代わりに、「この機能 (母音を削除する) を投稿タイトルのフィルターにフックする」と言います。

複雑ですか?あまり。次の例では、

anything

から母音を削除する関数をコーディングします。リーリー この関数は、$title

文字列を受け取り、母音を削除して返します。簡単ですよね？ここで、次のレベルに進んでフィルターに接続しましょう:

リーリー 新しい機能に気づきましたか? add_filter()

を簡単に見てみましょう:

リーリー

$tag

$function_to_add
$priority
10 です。設定が低い場合、関数は早く実行され、設定が高い場合、関数は後で実行されます。 $accepted_args
1 です。フィルターを削除

フィルターに付加された関数を削除することもできます。これを行うには、

remove_filter()

という単純な関数を使用します。それがどのように機能するかを見てみましょう:

リーリー パラメータは add_filter()

とほぼ同じです。

$tag（必需）- 过滤器的名称。
$function_to_remove（必需）- 要删除的函数的名称。
$priority（可选）- 函数的优先级（首次挂钩函数时定义）。

还有另一个名为 remove_all_filters() 的函数，它只有两个参数（$tag 和 $priority），您可以在其中设置过滤器的名称并设置优先级。顾名思义，它会删除所有与过滤器挂钩的函数。

创建您自己的过滤器

想知道这些过滤器是如何创建的？有一个名为 apply_filters() 的特殊函数，它围绕核心代码创建数百个过滤器。当然，它可以在核心之外使用，这意味着我们也可以在插件和主题内创建过滤器。

让我们看看它是如何工作的：

<?php

apply_filters( $tag, $value, $var1, $var2 /* ...and so on */ );

?>

ログイン後にコピー

$tag（必填）- 您的过滤器挂钩的名称。
$value (必填) - 通过 add_filter() 挂钩的过滤器函数修改的值。
$var1、$var2 等（可选）- 过滤器的参数（任意数量）。过滤器函数可以使用这些参数，但它们不能由函数返回。

让我们考虑一个例子：假设您编写了一个仅返回 Peter Griffin 的名言的函数：

<?php

function peter_griffin_quote() {
	$quote = "The bird is the word.";
	return $quote;
}

?>

ログイン後にコピー

如果您想让人们过滤此引用（并保留您的插件代码），您需要使用 apply_filters() 函数，如下所示：

<?php

function peter_griffin_quote() {
	$quote = "The bird is the word.";
	return apply_filters( 'peter_griffin_quote', $quote );
}

?>

ログイン後にコピー

这样，另一个开发人员使用您的插件就可以像这样处理您的函数数据：

<?php

function change_the_quote( $quote ) {
	$quote = str_replace( 'bird', 'nerd', $quote );
	return $quote;
}

add_filter( 'peter_griffin_quote', 'change_the_quote' );

?>

ログイン後にコピー

现在，每次运行 peter_griffin_quote() 函数时，Peter 的引用都会略有更改，而无需开发人员编辑您的插件文件。小菜一碟！

如果您需要有关此主题的更多信息，您应该查看 Pippin Williamson 关于 Tuts+ Code 的精彩教程：“使用操作和过滤器编写可扩展插件”。在本教程中，您可以学习如何为您的插件或主题创建过滤器和操作。