前台投稿与编辑

它负责什么

子比主题的前台投稿不是简单的 wp_insert_post() 表单。它把登录态、投稿开关、用户权限、内容审核、草稿、付费内容、特色封面、专题、高级筛选和媒体归属串成了一条完整流程。

做投稿相关二次开发时，优先沿用主题已有入口，只在确认过的 Hook、Filter、Meta 或 Ajax 节点上扩展。这样可以保留主题原本的审核、权限、通知、附件归属和付费校验。

核心文件

pages/newposts.php
action/new_posts.php
inc/functions/zib-frontend-set.php
inc/functions/zib-attachment.php

Ajax 动作

posts_save 与 posts_draft 共用同一个回调，主题通过请求里的 action 决定是走发布校验还是草稿保存。

投稿页开关

常见开关和权限来自主题配置与用户能力：

扩展投稿能力时，不要只检查当前用户是否登录。主题实际判断的是“用户是否能对这个动作和这个对象执行操作”。

保存流程

投稿保存的大致顺序：

1. 判断是否需要人机验证：_pz('verification_newposts_s')。
2. 读取 posts_id，判断新增或编辑。
3. 使用 zib_current_user_can() 校验新增、编辑权限。
4. 校验标题、内容、分类。
5. 对 posts_save 进行标题长度、内容长度、分类必填等发布校验。
6. 根据 audit_new_post、ZibAudit::is_audit() 和用户免审能力决定 post_status。
7. 未登录投稿使用 _pz('post_article_user', 1) 作为作者，并把投稿人信息拼入标题。
8. 触发 zib_pre_insert_post。
9. 调用 wp_insert_post($postarr, 1)。
10. 保存付费内容：zib_ajax_newpost_save_pay($in_id, false)。
11. 保存特色封面：zib_ajax_newpost_save_featured($in_id, false)。
12. 保存专题和高级筛选字段。
13. 触发新增、编辑或待审核 Hook。
14. 返回子比统一 JSON 响应。

关键 Hook

示例结构：

add_action('new_add_posts', 'zib_docs_after_new_post', 10, 1);

function zib_docs_after_new_post($post)
{
    if (empty($post->ID) || 'post' !== $post->post_type) {
        return;
    }

    update_post_meta($post->ID, 'custom_review_flag', 1);
}

这类扩展只保存自己的数据，不接管主题原有保存流程。

付费内容

投稿页使用 posts_zibpay 作为文章付费配置的 Meta。保存函数是：

zib_ajax_newpost_save_pay($post_id, false);

常见字段：

主题会重新校验价格、积分、会员价和资源字段。新增付费类型时，不要只改前端表单，也要确认 Zibpay 阅读、下载、订单和权限判断链路是否识别新数据。视频投稿、视频封面、编辑器视频按钮、iframe 嵌入、剧集切换和付费视频字段见 视频资源与播放器。

特色封面

特色封面通过 featured_data 保存：

zib_ajax_newpost_save_featured($post_id, false);

支持类型：

如果扩展投稿页的封面能力，建议继续提交 featured_data，让主题函数处理 Meta 写入，不要在 Ajax 外另写一套封面保存逻辑。

前台快速设置

inc/functions/zib-frontend-set.php 提供前台编辑对象设置的统一弹窗和保存入口。主题先生成输入项，再用 Filter 允许模块补充字段：

add_filter('zib_frontend_set_input_array', 'zib_docs_frontend_set_input', 10, 5);

function zib_docs_frontend_set_input($page_input, $post_id, $type, $taxonomy, $post_type)
{
    if ('post' !== $type) {
        return $page_input;
    }

    $page_input[] = array(
        'id'    => 'custom_notice',
        'type'  => 'text',
        'title' => '补充说明',
    );

    return $page_input;
}

保存时使用：

add_action('zib_frontend_set_save', 'zib_docs_frontend_set_save', 10, 2);

function zib_docs_frontend_set_save($object_data, $type)
{
    if ('post' !== $type || empty($object_data['id'])) {
        return;
    }

    $value = !empty($_POST['custom_notice']) ? sanitize_text_field($_POST['custom_notice']) : '';
    zib_update_post_meta($object_data['id'], 'custom_notice', $value);
}

这个模式适合给前台设置弹窗增加字段。保存时仍要检查对象类型、对象 ID、用户权限和字段来源。

删除文章

删除入口先生成确认弹窗，再走 new_post_delete Ajax。主题会检查：

zib_current_user_can('new_post_delete', $post);

扩展删除逻辑时，不要在前端隐藏按钮后就认为安全。服务端必须重新判断文章是否存在、是否属于当前流程、当前用户是否有删除能力、文章状态是否允许删除。

扩展建议

• 增加投稿字段时，优先使用主题前台设置 Filter、投稿表单扩展点或保存 Hook。
• 保存扩展字段时使用 sanitize_text_field()、wp_kses_post()、absint()、zib_update_post_meta() 等合适的清洗和封装。
• 付费、下载、余额、积分、订单相关字段必须回到 Zibpay 权限链路里验证。
• 媒体上传和附件归属交给主题已有上传、合并、归属 Hook 处理。
• 自动发布、自动审核、同步索引这类动作适合放到保存后的 Action，不要直接绕过 zib_ajax_new_posts()。

常见风险