stevezehngut/wp-utils

WordPress 提供实用功能的函数集合。

v7.0.1 2024-07-01 21:59 UTC

This package is auto-updated.

Last update: 2024-10-01 00:17:48 UTC


README

Codacy Badge Codacy Badge

使生活变得更轻松的实用函数。

数据库

db_transaction( $callable, $args = [] )

在数据库事务中运行给定的回调,如果发生错误则回滚事务。

get_raw_option_value( $key )

执行非常直接、简单的查询到 WordPress 选项表,绕过正常的 WP 缓存。

get_id_from_slug( $slug, $post_type = 'post', $force = false )

根据 slug 查找帖子。

get_meta_key_from_meta_value()

根据元值执行反向查找元键。

ACF

get_acf_meta_value_by_acf_key()

当已知 ACF 字段键和帖子 ID,但字段位于组内时使用。

is_acf_loadable() (弃用)

检查 ACF 是否可加载以及 ACF_LITE 是否为真。

用户

generate_unique_username( $username )

给给定的用户名附加一个计数器,直到没有用户使用该用户名为止。

杂项

get_current_url()

返回当前 URL。

get_current_url_clean()

返回当前 URL,但不包含查询参数。

get_user_display_name( $user_id )

通过用户 ID 轻松获取用户显示名称。

get_env_value( $key, $filter = null )

辅助函数,用于检查各种地方的环境变量:$_ENV(通过 .env.php 文件设置)、常量(通过 define() 调用设置)、过滤器,利用传递的过滤器

remove_filters_for_anonymous_class( $hook_name = '', $class_name = '', $method_name = '', $priority = 10 )

从匿名类中删除过滤器/操作。

add_inline_svg()

检查 SVG 文件是否存在,然后再获取其内容。

get_current_datetime()

获取一个设置为 WordPress 本地时区的 DateTime 对象。

get_site_timezone()

获取一个设置为网站本地时区的 DateTimeZone 对象。

init_term( $slug, $taxonomy )

检查并返回一个通过 slug 的术语。如果尚不存在,则初始化术语。

行为/过滤器

这些必须通过创建 \Zeek\WP_Util\Behaviors() 类来启动。

file_mod_allowed

默认情况下,禁用文件修改(插件添加、删除、主题文件编辑等)。通过 env 常量覆盖:FILE_MOD_ALLOWED