README

查看 findkit.com 和 docs.findkit.com。

现在在WordPress沙盒中尝试插件

https://playground.wordpress.net/?plugin=findkit

安装

从 发布版 获取zip文件或使用Composer安装

composer require findkit/wp-findkit

注意，这假设您已在main composer.json中配置了WordPress插件的extra.installer-paths。有关详细信息，请参阅这篇文章。

页面元数据

插件通过生成Findkit元数据自动公开基本的Findkit 页面元数据。

以下字段将自动添加

• showInSearch：存档页面会自动排除
• title：干净的页面标题
• created：创建时间
• modified：修改时间
• language：来自文章或Polylang的语言
• tags：包括公共分类法的一些基本标签

这些可以通过使用findkit_page_meta过滤器进行修改，并且可以添加其他字段。

add_filter('findkit_page_meta', function ($meta, $post) {
    $meta['title'] = 'My custom title';
    return $meta;
}, 10, 2);

实时更新

当页面正在创建/编辑/删除时，插件可以自动触发几乎立即的重新抓取。在插件设置中启用实时更新。

JWT身份验证

Findkit搜索端点可以配置为需要JWT令牌身份验证。

设置

此插件自动将私有/公开密钥对生成到findkit_pubkey和findkit_privkey选项。将公开密钥添加到findkit.toml文件并将端点设置为私有

[search-endpoint]
private = true
public_key = """
-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAvbvzQ+AsMP0UnNpXmk4P
39O3M6SHkcqtP3e6TR/S1LI6cVFF/QdentwYYIABUwbEzxJuYWP6v/BLittCAWSg
YsrbImrGHokgO/ItOU/90DrBL+sL6eeMTfECe9guM5l3JrhE70z9dCuQn6GYp8CL
VAJWdLKCgmReTvEVQTwFObLpWh4YniXuWnYkw9MPxADLXkJU8MjDlwcIumQMaesP
POBVjVuPhtQ+i5V6G2BegemXl8ep6qQ2xt8spNRoAKwt6Nekt5+GWz65Q9juTGdD
6HkR15ij6sSZoOjjSWuiR0CDOhmjDXGCLtqQuLivFq6oGNgP7BqXtoR6hNwSXLSj
eFhoszDoQZjRoL7oJ/dE60wxuB8FG5duam+AXx/3IJl93sAeFWFzLPpXYmdXQVG7
2kADsYCcNgdN2RMuKGjg4Qmu/RWKzzFfI7GbNS6K47Ow0VjmSN1pb3UitTkROjAj
tPsFXX8vhV1AG9w327Wl/R4d45nd9m/dEaUPpej32caqHtWjQsVT/Sry/ZXhxzaD
4OO7YhKjEbvvHMkgTzihKAKFDIhR+revbgjAPPuwKxseiTrAeKIXDHAW4FVzUq1r
2c+CmzKcwnTle2ydkpCZhGENvqNEgRiGoj5BC5r0gYImsSQyB3B2obvOqtsXOwjn
TtZof/qoIldypZCe7BA5ETECAwEAAQ==
-----END PUBLIC KEY-----
"""

您可以使用wp cli等工具获取公开密钥值。

wp option get findkit_pubkey

并部署更改。

将findkit项目ID放入findkit_project_id并将findkit_enable_jwt设置为真值以启用JWT令牌生成，该令牌将被@findkit/ui库自动获取。

wp option set findkit_project_id 'plnGp6Rv0'
wp option set findkit_enable_jwt 1

身份验证

默认情况下，此插件仅允许已登录用户使用搜索端点，但可以使用findkit_allow_jwt过滤器进行修改

add_filter('findkit_allow_jwt', function ($allow) {
    return current_user_can('edit_posts');
}, 10, 1);

白标

Wp-findkit插件类似于findkit服务，是一个白标产品。您可以使用过滤器自定义显示的名称。

例如，重命名页面侧边栏设置

	add_filter('gettext_with_context_findkit', function($translation, $text, $context) {
		if ('Findkit' === $text && 'Sidebar options label' === $context){
			return 'My Product Name';
		}
		return $translation;
	}, 10, 3);