stevezehngut / wp-utils
WordPress 提供实用功能的函数集合。
v7.0.1
2024-07-01 21:59 UTC
Requires
- php: >=8.0
- a7/autoload: *
- arrilot/dotenv-php: *
README
使生活变得更轻松的实用函数。
数据库
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。