如何为WordPress自定义文章类型的自定义元框编写循环批量处理错误码字段

首先定义全局配置控制错误码总组数，后续调整错误码数量仅需修改该配置值即可，无需改动其他逻辑：

// 错误码总组数配置，需要新增时直接修改该数字即可
define( 'ERROR_CODE_TOTAL_COUNT', 25 );

1. 改造钩子注册逻辑 #

无需为每个字段单独绑定save_post钩子，仅需注册1个统一的保存钩子即可：

function error_codes_setup() {
    add_action( 'add_meta_boxes', 'add_error_code_box' );
    // 仅注册一个统一的保存钩子，无需重复绑定25*2个钩子
    add_action( 'save_post', 'save_error_code_fields', 10, 2 );
}

function add_error_code_box(){
    add_meta_box(
        'error_code_box',
        esc_html__( 'Error Codes', 'example' ),
        'error_code_box',
        'error_codes',
        'normal',
        'low'
    );
}

2. 改造元框渲染逻辑 #

通过循环自动生成指定数量的输入框组：

function error_code_box ( $post ){
    wp_nonce_field( basename( __FILE__ ), 'error_codes_nonce' ); ?>
    <table>
        <tr>
            <th><label>错误码名称</label></th>
            <th><label>错误码描述</label></th>
        </tr>
        <?php for ( $i = 1; $i <= ERROR_CODE_TOTAL_COUNT; $i++ ) :
            // 序号补零对齐，如1转为01
            $index = str_pad( $i, 2, '0', STR_PAD_LEFT );
            $name_key = "error_code_name_{$index}";
            $desc_key = "error_code_desc_{$index}";
            // 读取已保存的字段值
            $name_val = get_post_meta( $post->ID, $name_key, true );
            $desc_val = get_post_meta( $post->ID, $desc_key, true );
        ?>
        <tr>
            <td>
                <input 
                    type="text" 
                    name="<?php echo esc_attr( $name_key ); ?>" 
                    id="<?php echo esc_attr( $name_key ); ?>" 
                    class="error_code_name"
                    value="<?php echo esc_attr( $name_val ); ?>" 
                    size="15"
                />
            </td>
            <td>
                <input 
                    type="text" 
                    name="<?php echo esc_attr( $desc_key ); ?>" 
                    id="<?php echo esc_attr( $desc_key ); ?>" 
                    class="error_code_desc" 
                    value="<?php echo esc_attr( $desc_val ); ?>" 
                    size="60"
                />
            </td>
        </tr>
        <?php endfor; ?>
    </table>
    <?php
}

3. 改造字段保存逻辑 #

在统一的保存函数中循环处理所有字段的校验与保存，仅做一次全局权限校验，避免重复逻辑：

function save_error_code_fields( $post_id, $post ) {
    // 全局nonce校验
    if ( !isset( $_POST['error_codes_nonce'] ) || !wp_verify_nonce( $_POST['error_codes_nonce'], basename( __FILE__ ) ) ) {
        return $post_id;
    }
    // 全局权限校验
    $post_type = get_post_type_object( $post->post_type );
    if ( !current_user_can( $post_type->cap->edit_post, $post_id ) ) {
        return $post_id;
    }

    // 循环处理所有错误码字段
    for ( $i = 1; $i <= ERROR_CODE_TOTAL_COUNT; $i++ ) {
        $index = str_pad( $i, 2, '0', STR_PAD_LEFT );
        
        // 处理错误码名称字段
        $name_key = "error_code_name_{$index}";
        $new_name_val = isset( $_POST[$name_key] ) ? sanitize_text_field( $_POST[$name_key] ) : '';
        $old_name_val = get_post_meta( $post_id, $name_key, true );
        if ( $new_name_val && '' === $old_name_val ) {
            add_post_meta( $post_id, $name_key, $new_name_val, true );
        } elseif ( $new_name_val && $new_name_val != $old_name_val ) {
            update_post_meta( $post_id, $name_key, $new_name_val );
        } elseif ( '' === $new_name_val && $old_name_val ) {
            delete_post_meta( $post_id, $name_key, $old_name_val );
        }

        // 处理错误码描述字段
        $desc_key = "error_code_desc_{$index}";
        $new_desc_val = isset( $_POST[$desc_key] ) ? sanitize_text_field( $_POST[$desc_key] ) : '';
        $old_desc_val = get_post_meta( $post_id, $desc_key, true );
        if ( $new_desc_val && '' === $old_desc_val ) {
            add_post_meta( $post_id, $desc_key, $new_desc_val, true );
        } elseif ( $new_desc_val && $new_desc_val != $old_desc_val ) {
            update_post_meta( $post_id, $desc_key, $new_desc_val );
        } elseif ( '' === $new_desc_val && $old_desc_val ) {
            delete_post_meta( $post_id, $desc_key, $old_desc_val );
        }
    }
}

内容的提问来源于stack exchange，提问作者Justin Lucas