WordPress创建自定义钩子.docVIP

插件不但可以使用内核的内置钩子，他们也可以创建自定义的钩子供其他插件和模板使用。 插件可以使用4个可用函数中的一个来创建自定义钩子。 do_action() do_action_ref_array() apply_filters() apply_filters_ref_array() 前两个创建自定义动作钩子，后两个创建自定义过滤器钩子。 创建自定义钩子的优点 自定义钩子使得你的插件更灵活，使其可以被其他插件扩展，让你可以钩到你的整个插件自己的其他执行过程中。 使用自定义钩子还可以防止用户直接修改你的插件。这一点的重要性在于，当你更新你的插件时，用户不会失去他们修改的内容。 自定义动作钩子实例 在这个例子中，建立了一个插件安装函数。这个函数定义了一个可以更换的常量。别的插件也可以在这个钩子上执行任何代码。因为你在那一点上提供了钩子。 ?php add_action( plugins_loaded, boj_myplugin_setup ); function boj_myplugin_setup() { /* 允许动作最先触发 */ do_action( boj_myplugin_setup_pre ); /* 检查 root slug 是否定义 */ if( !defined( BOJ_MYPLUGIN_ROOT_SLUG ) ) define( BOJ_MYPLUGIN_ROOT_SLUG, articles ); } ? 其他插件或者模板可以钩到 boj_myplugin_setup_pre 来执行任何函数。 比如你想把 BOJ_MYPLUGIN_ROOT_SLUG 常量从 ‘articles’ 改为 ‘papers’ ，你可以建立一个动作并添加到这个钩子中： ?php add_action( boj_myplugin_setup_pre, boj_define_myplugin_constants ); function boj_define_myplugin_constants() { define( BOJ_MYPLUGIN_ROOT_SLUG, papers ); } ? 自定义过滤器钩子实例 假设有一个函数显示一个具有一个特定阐述的文章列表。你也许希望其他人能够过滤那个参数或者过滤最终结果。 下面的例子中，写一个函数根据收到的评论条数列取了前10的文章。这个函数让用户可以在从数据库获取数据前过滤这个参数，并且可以过滤最终输出的 HTML 列表。 ?php function boj_posts_by_comments() { /* 默认参数 */ $args = array( post_type = post, posts_per_page = 10, order = DESC, oerderby = comment_count ); /* 应用过滤器 */ $args = apply_filters( boj_posts_by_comments_args, $args ); /* 设置输出变量 */ $out = ; /* 由给定的参数从数据库查询文章 */ $loop = new WP_Query( $args ); /* 检查是否返回结果 */ if( $loop - have_posts() ) { $out .= ul ; while( $loop - have_posts() ) { $loop - the_post(); $out .= the_title( li, /li, false ); } $out .= /ul; } $out = apply_filters( boj_posts_by_comments, $out ); echo $out; } ? 要过滤参数，给 boj_posts_by_comments_args 添加一个过滤器。比如你希望把数量从默认的10变成15，添加下面的过滤器： ?php add_filter( boj_posts_by_comments_args, boj_change_posts_by_comments_args ); function boj_change_posts_by_comments_args( $args ) { $args[posts_per_page] = 15; return $args; } ? 要过滤最后的 HTML 输出，添加一个过滤器到 boj_posts_by_comments。比如你想把 ul 改成 ol。 ?php add_filter( boj_posts_by_comments, boj_change_posts_by_comments ); function boj_change_posts_by_comments(