
函数/钩子名 | 描述 |
---|---|
query_loop_block_query_vars (过滤钩子) | query_loop_block_query_vars – 这是一个过滤钩子,允许开发者修改循环块查询的查询变量。循环区块查询是用来检索一组文章以在循环区块中显示。通过使用这个过滤器,开发者可以修改用 |
excerpt_allowed_wrapper_blocks (过滤钩子) | excerpt_allowed_wrapper_blocks: 这个过滤器类似于excelpt_allowed_blocks,但它允许你控制在文章摘录中允许哪些包装块。 |
excerpt_allowed_blocks (过滤钩子) | excerpt_allowed_blocks: 这个过滤器允许你控制在文章摘录中允许哪些块类型。默认情况下,所有的块类型都是允许的,但这个过滤器可以用来限制文章摘录中允许的块类型。 |
block_type_metadata_settings (过滤钩子) | block_type_metadata_settings是一个过滤钩子,允许你修改一个块类型的元数据的设置。该钩子接收一个元数据设置的数组,并在需要时返回一个修改的数组。 |
block_parser_class (过滤钩子) | block_parser_class是一个过滤钩子,允许你改变块编辑器用来解析块的类。该钩子接收类的名称,并在需要时返回一个修改的值。 |
wp_migrate_old_typography_shape (函数) | wp_migrate_old_typography_shape: 这个函数用来将旧的排版设置转换为WordPress 5.5及以后版本中使用的新格式。它是在将网站升级到最新版本的WordPress时使 |
unregister_block_type (函数) | unregister_block_type: 该函数取消对一个自定义块类型的注册。它需要一个参数,即$block_name,它是块的名称。 |
unregister_block_style (函数) | unregister_block_style: 这个函数取消注册一个自定义的块样式。它有两个参数:$block_name,是块的名称,$style_handle,是样式的名称。 |
strip_core_block_namespace (函数) | strip_core_block_namespace: 这是一个WordPress的函数,可以从块名中去除”core/”命名空间。它需要一个参数,$block_name,并返回去掉”core/”命名空 |
serialize_blocks (函数) | serialize_blocks: 这是一个WordPress的函数,它将块的数组序列化为一个字符串。它通常用于将块的内容保存到数据库或通过网络发送: 这个函数需要一个参数,即块对象的数组。 |
serialize_block_attributes (函数) | serialize_block_attributes: 这是一个WordPress的函数,它将一个块的属性序列化为一个字符串。它通常用于将块的属性保存到数据库或通过网络发送: 这个函数需要一个参数,即 |
serialize_block (函数) | serialize_block: 这是一个WordPress的函数,它把一个单一的内容块序列化为一个字符串。它通常用于将块内容保存到数据库或通过网络发送: 这个函数需要一个参数,即块对象。 |
render_block (函数) | render_block: 这个函数用于在WordPress中渲染一个块: 这个函数有一个参数,就是要渲染的块。 |
remove_block_asset_path_prefix (函数) | remove_block_asset_path_prefix: 这个函数是用来移除区块脚本和样式的资产路径前缀的: 当你想加载你自己的自定义脚本和样式而不使用资产路径前缀时,这个函数很有用。 |
register_block_type_from_metadata (函数) | register_block_type_from_metadata: 这个函数用来从一个包含块的选项和设置的元数据文件中注册一个新的块类型。它需要一个参数:$file。$file是包含块的选项的元数据 |
register_block_type (函数) | register_block_type: 这个函数用来为WordPress的块编辑器注册一个新的块类型。它需要两个参数:$name和$args。$name是一个定义块类型名称的字符串,而$args是一 |
register_block_style_handle (函数) | register_block_style_handle: 该函数用于注册一个新的块样式句柄,以用于定制块的样式。它需要三个参数:$handle, $style_args, 和$asset_callba |
register_block_style (函数) | register_block_style: 这个函数为一个区块类型注册了一个区块样式。块样式用于向块类型添加自定义的CSS样式。 |
register_block_script_handle (函数) | register_block_script_handle: 这个函数为一个区块类型注册了一个脚本句柄。脚本句柄用于为该块类型的脚本排队。 |
parse_blocks (函数) | parse_blocks: 这个函数将给定内容字符串中的块解析为一个块对象的列表。它需要一个参数:$content(字符串),表示要解析的内容。 |
has_blocks (函数) | has_blocks: 这是一个WordPress的函数,用来检查一个文章或页面的内容中是否存在任何块。如果有任何块存在,该函数返回一个布尔值为true,否则为false。 |
has_block (函数) | has_block: 这个函数用于检查一个文章或页面的内容中是否存在特定的块: 该函数将块的类型作为一个参数,如果该块存在,则返回一个布尔值为true,否则为false。 |
get_query_pagination_arrow (函数) | get_query_pagination_arrow函数是一个WordPress函数,用于检索查询中下一页或上一页的分页链接: 这个函数接受一个可选的链接文本参数,并返回到下一页或上一页的链接。 |
get_dynamic_block_names (函数) | get_dynamic_block_names: 这个函数用来检索当前WordPress安装中所有注册的动态块的名称。动态块是一种可以由用户创建和定制的块。 |
get_comments_pagination_arrow (函数) | get_comments_pagination_arrow: 这个函数用来生成特定页面的评论分页箭头的HTML。 |
get_comment_delimited_block_content (函数) | get_comment_delimited_block_content – 这个函数返回一个评论的内容,任何HTML标签都被剥离出来: 当评论显示在一个HTML块元素(如或)中时,它被设计为使用。它把 |
get_block_metadata_i18n_schema (函数) | get_block_metadata_i18n_schema:此函数返回块编辑器元数据的模式。它不接受任何参数。 |
generate_block_asset_handle (函数) | generate_block_asset_handle: 这个函数用来为一个区块生成一个唯一的资产句柄。这个句柄用于识别与该块相关的资产,例如它的脚本和样式文件。 |
filter_block_kses_value (函数) | filter_block_kses_value – 这个过滤器用来修改一个区块的允许的HTML标签和属性。它接受允许的标签和属性作为它的参数。 |
filter_block_kses (函数) | filter_block_kses – 这个过滤器用于修改一个区块的允许的HTML标签和属性。它接受允许的标签和属性作为它的参数。 |
filter_block_content (函数) | filter_block_content – 这个过滤器用于在渲染前修改一个块的内容。它接受块的内容和块的类型作为其参数。 |
excerpt_remove_blocks (函数) | excerpt_remove_blocks: 这个过滤器用于从自动生成的文章摘录中删除特定的块。 |
do_blocks (函数) | do_blocks: 这个钩子用来渲染文章编辑器的内容,包括经典编辑器和块编辑器。 |
build_query_vars_from_query_block (函数) | build_query_vars_from_query_block: 该函数用于根据块编辑器中的查询块的数据建立WP_Query对象的参数。 |
build_comment_query_vars_from_block (函数) | build_comment_query_vars_from_block: 这个函数用于根据块编辑器中的评论块的数据建立WP_Comment_Query对象的参数。 |
block_version (函数) | block_version: 这个函数返回WordPress块编辑器的当前版本号。 |
block_has_support (函数) | block_has_support: 这个函数检查一个块是否支持某个特定的功能或属性: 该函数需要两个参数:区块类型(如”core/image”)和特征名称(如”align”)。 |
_restore_wpautop_hook (函数) | _restore_wpautop_hook: 这个函数在原wpautop函数被插件或主题修改后将其恢复到默认状态。 |
_excerpt_render_inner_blocks (函数) | excerpt_render_inner_blocks: 这个函数用于在块编辑器中渲染摘录块的内部块: 这个函数被WordPress内部用来渲染摘录块。 |
apply_filters
函数用于调用一个钩子上的所有过滤器函数。它的基本用法如下:
$value = apply_filters( 'hook_name', $value, $var1, $var2, ... );
其中:
'hook_name
' 是你要应用过滤器函数的钩子名称。
$value
是你要传递给过滤器函数的值。
$var1, $var2, …
是你要传递给过滤器函数的其他参数。
常量的命名有一些约定和规则。首先,常量的名称应该全部大写,用下划线分隔单词。例如,MY_CONSTANT_NAME
。其次,常量的名称应该是有意义的,能够清晰地描述常量的用途或值。最后,避免使用已经被PHP或WordPress定义的常量名称,以避免冲突。
在WordPress中,常量的命名规则和约定如下:
ABSPATH
。WP_DEBUG
.WP_
,例如: WP_CONTENT_DIR
。例如,以下是符合WordPress常量命名规则的示例:
define( 'WP_DEBUG', true ); define( 'WP_CONTENT_DIR', '/var/www/html/wp-content' ); define( 'MY_CUSTOM_CONSTANT', 'Hello World' );
遵循这些命名规则和约定可以帮助保持代码的一致性和可读性,使得WordPress主题或插件更易于理解、维护和扩展。
要使用WordPress REST API,可以按照以下步骤进行操作:
这些是使用WordPress REST API的基本步骤。你可以根据具体需求进行深入学习和实践,探索更多可用的终点和功能。对于详细的API文档和参考,请查阅WordPress官方文档或REST API官方手册。
在WordPress中,钩子函数可以在以下几个地方使用:
add_filter()
`函数注册在特定过滤器(filter hooks)上执行的钩子函数。add_action()
`函数在特定的动作点上添加自定义内容,或使用` add_filter()
`函数修改主题函数的输出。functions.php
`的文件,用于添加自定义功能和修改WordPress行为。该文件中可以使用钩子函数来注册特定的动作点和过滤器,并添加相应的钩子函数来处理这些事件。do_action()
`或` apply_filters()
`函数调用,然后在需要的地方注册相应的钩子函数。总结起来,WordPress中的钩子函数可以在插件、主题、自定义功能文件以及WordPress核心文件中使用,用于注册和处理特定的WordPress事件或动作。这允许开发者在这些地方插入自定义逻辑,以实现个性化的功能和修改WordPress的行为。
wp_insert_post()
函数用于插入新的文章。你需要传递一个关联数组,包含文章的各项参数,如标题、内容、分类等。例如:
$post_data = array( 'post_title' => '新的文章', 'post_content' => '这是一篇新的文章。', 'post_status' => 'publish', // 设置为 'publish' 以立即发布文章 'post_type' => 'post', // 也可以设置为 'page' 或其他自定义的文章类型 ); $post_id = wp_insert_post($post_data);
如果你想要插入更复杂的文章,例如包含多个分类或标签,你可以在 $post_data
数组中添加更多的键值对。
你可以使用 get_template_directory()
和 get_stylesheet_directory()
函数来获取当前主题的目录路径。 get_template_directory()
返回当前主题模板的目录路径,而 get_stylesheet_directory()
返回当前子主题的目录路径。例如:
$theme_dir = get_template_directory(); $child_theme_dir = get_stylesheet_directory();