
简单有效的WordPress调试及故障排查小技巧
wp_update_comment ( $commentarr, $wp_error = false )
wp_update_comment: 这个函数用来更新WordPress数据库中的一个现有评论。它接收一个用于更新评论的参数数组,例如它的内容、作者姓名、作者电子邮件、作者URL和批准状态。
更新数据库中现有的评论。
在更新之前,过滤评论并确保某些字段是有效的。
function wp_update_comment( $commentarr, $wp_error = false ) { global $wpdb; // First, get all of the original fields. $comment = get_comment( $commentarr['comment_ID'], ARRAY_A ); if ( empty( $comment ) ) { if ( $wp_error ) { return new WP_Error( 'invalid_comment_id', __( 'Invalid comment ID.' ) ); } else { return false; } } // Make sure that the comment post ID is valid (if specified). if ( ! empty( $commentarr['comment_post_ID'] ) && ! get_post( $commentarr['comment_post_ID'] ) ) { if ( $wp_error ) { return new WP_Error( 'invalid_post_id', __( 'Invalid post ID.' ) ); } else { return false; } } $filter_comment = false; if ( ! has_filter( 'pre_comment_content', 'wp_filter_kses' ) ) { $filter_comment = ! user_can( isset( $comment['user_id'] ) ? $comment['user_id'] : 0, 'unfiltered_html' ); } if ( $filter_comment ) { add_filter( 'pre_comment_content', 'wp_filter_kses' ); } // Escape data pulled from DB. $comment = wp_slash( $comment ); $old_status = $comment['comment_approved']; // Merge old and new fields with new fields overwriting old ones. $commentarr = array_merge( $comment, $commentarr ); $commentarr = wp_filter_comment( $commentarr ); if ( $filter_comment ) { remove_filter( 'pre_comment_content', 'wp_filter_kses' ); } // Now extract the merged array. $data = wp_unslash( $commentarr ); /** * Filters the comment content before it is updated in the database. * * @since 1.5.0 * * @param string $comment_content The comment data. */ $data['comment_content'] = apply_filters( 'comment_save_pre', $data['comment_content'] ); $data['comment_date_gmt'] = get_gmt_from_date( $data['comment_date'] ); if ( ! isset( $data['comment_approved'] ) ) { $data['comment_approved'] = 1; } elseif ( 'hold' === $data['comment_approved'] ) { $data['comment_approved'] = 0; } elseif ( 'approve' === $data['comment_approved'] ) { $data['comment_approved'] = 1; } $comment_id = $data['comment_ID']; $comment_post_id = $data['comment_post_ID']; /** * Filters the comment data immediately before it is updated in the database. * * Note: data being passed to the filter is already unslashed. * * @since 4.7.0 * @since 5.5.0 Returning a WP_Error value from the filter will short-circuit comment update * and allow skipping further processing. * * @param array|WP_Error $data The new, processed comment data, or WP_Error. * @param array $comment The old, unslashed comment data. * @param array $commentarr The new, raw comment data. */ $data = apply_filters( 'wp_update_comment_data', $data, $comment, $commentarr ); // Do not carry on on failure. if ( is_wp_error( $data ) ) { if ( $wp_error ) { return $data; } else { return false; } } $keys = array( 'comment_post_ID', 'comment_author', 'comment_author_email', 'comment_author_url', 'comment_author_IP', 'comment_date', 'comment_date_gmt', 'comment_content', 'comment_karma', 'comment_approved', 'comment_agent', 'comment_type', 'comment_parent', 'user_id', ); $data = wp_array_slice_assoc( $data, $keys ); $result = $wpdb->update( $wpdb->comments, $data, array( 'comment_ID' => $comment_id ) ); if ( false === $result ) { if ( $wp_error ) { return new WP_Error( 'db_update_error', __( 'Could not update comment in the database.' ), $wpdb->last_error ); } else { return false; } } // If metadata is provided, store it. if ( isset( $commentarr['comment_meta'] ) && is_array( $commentarr['comment_meta'] ) ) { foreach ( $commentarr['comment_meta'] as $meta_key => $meta_value ) { update_comment_meta( $comment_id, $meta_key, $meta_value ); } } clean_comment_cache( $comment_id ); wp_update_comment_count( $comment_post_id ); /** * Fires immediately after a comment is updated in the database. * * The hook also fires immediately before comment status transition hooks are fired. * * @since 1.2.0 * @since 4.6.0 Added the `$data` parameter. * * @param int $comment_id The comment ID. * @param array $data Comment data. */ do_action( 'edit_comment', $comment_id, $data ); $comment = get_comment( $comment_id ); wp_transition_comment_status( $comment->comment_approved, $old_status, $comment ); return $result; }
在WordPress中,你可以使用 add_action
函数添加一个钩子函数。钩子函数是在特定事件发生时自动触发的函数。
add_action
函数的第一个参数是钩子名称,第二个参数是要执行的函数名,第三个参数是函数的优先级(可选)。
例如,添加一个在文章保存后执行的钩子函数的代码如下:
function my_save_post_function( $post_ID, $post ) { // 执行你的代码 } add_action( 'save_post', 'my_save_post_function', 10, 2 );
这里, save_post
是钩子名称, my_save_post_function
是要执行的函数名,10是函数的优先级,2是传递给钩子函数的参数数量。
wp_reset_query()
函数用于重置WordPress的查询。在自定义查询或修改查询参数之后,你可能需要使用这个函数来重置到默认的查询。例如:
// 自定义查询 $args = array( 'post_type' => 'product', 'posts_per_page' => 10, ); $custom_query = new WP_Query($args); // 重置查询 wp_reset_query();
创建自定义的WordPress插件需要以下步骤:
使用 get_post
和 get_page
获取单个文章或页面的详细信息:
// 获取文章或页面的ID $post_id = get_the_ID(); // 获取文章或页面的详细信息 $post = get_post($post_id); // 获取文章或页面的标题 $title = $post->post_title; // 获取文章或页面的内容 $content = $post->post_content;
wp_enqueue_script
和 wp_enqueue_style
函数的使用:
wp_enqueue_script()
:此函数位于wp-includes/script-loader.php文件中。它会将JavaScript文件添加到WordPress网站的页脚中。您可以在主题的functions.php文件中调用此函数,以添加自定义的JavaScript文件。wp_enqueue_style()
:此函数位于wp-includes/script-loader.php文件中。它会将CSS文件添加到WordPress网站的部分中。您可以在主题的functions.php文件中调用此函数,以添加自定义的CSS文件。使用 wp_head
和 wp_footer
在主题中添加自定义内容:
wp_head()
:此函数位于wp-includes/general-template.php文件中。它会在文档的部分中输出内容。您可以在主题的header.php文件中调用此函数,以在部分中添加自定义内容。wp_footer()
:此函数位于wp-includes/general-template.php文件中。它会在文档的部分中输出内容。您可以在主题的footer.php文件中调用此函数,以在部分中添加自定义内容。