如何在WooCommerce产品分类页添加长短描述（OceanWP主题）

你可以通过添加自定义代码实现需求，分两步操作：

1. 给产品分类添加短描述字段 #

默认WooCommerce产品分类只有一个描述字段，先添加独立的短描述输入框，方便为每个分类填写短描述：

// 给产品分类添加短描述字段
add_action( 'product_category_add_form_fields', 'add_product_category_short_description_field', 10 );
add_action( 'product_category_edit_form_fields', 'edit_product_category_short_description_field', 10, 2 );

// 添加新分类时显示短描述字段
function add_product_category_short_description_field() {
    ?>
    <div class="form-field">
        <label for="category_short_description">短描述</label>
        <textarea name="category_short_description" id="category_short_description" rows="3" cols="50"></textarea>
        <p class="description">输入分类的短描述，将显示在归档页面顶部。</p>
    </div>
    <?php
}

// 编辑分类时显示短描述字段及已有内容
function edit_product_category_short_description_field( $term, $taxonomy ) {
    $short_description = get_term_meta( $term->term_id, '_category_short_description', true );
    ?>
    <tr class="form-field">
        <th scope="row" valign="top"><label for="category_short_description">短描述</label></th>
        <td>
            <textarea name="category_short_description" id="category_short_description" rows="3" cols="50"><?php echo esc_textarea( $short_description ); ?></textarea>
            <p class="description">输入分类的短描述，将显示在归档页面顶部。</p>
        </td>
    </tr>
    <?php
}

// 保存分类短描述内容
add_action( 'edited_product_category', 'save_product_category_short_description', 10, 2 );
add_action( 'create_product_category', 'save_product_category_short_description', 10, 2 );

function save_product_category_short_description( $term_id, $tt_id ) {
    if ( isset( $_POST['category_short_description'] ) ) {
        update_term_meta( $term_id, '_category_short_description', sanitize_textarea_field( $_POST['category_short_description'] ) );
    }
}

2. 在分类归档页面顶部显示短描述 #

添加以下代码，让短描述显示在产品列表上方：

// 在产品分类归档页面顶部显示短描述
add_action( 'woocommerce_before_shop_loop', 'display_product_category_short_description', 5 );
function display_product_category_short_description() {
    if ( is_product_category() ) {
        $term_id = get_queried_object_id();
        $short_description = get_term_meta( $term_id, '_category_short_description', true );
        
        if ( ! empty( $short_description ) ) {
            echo '<div class="category-short-description">' . wpautop( $short_description ) . '</div>';
        }
    }
}

代码添加方式 #

• 推荐添加到子主题的functions.php文件中，避免主题更新导致代码丢失；
• 也可以使用Code Snippets这类代码管理插件添加，更安全便捷。

效果验证 #

添加代码后，进入WooCommerce产品分类编辑页面，每个分类会新增「短描述」输入框，填写内容后：

• 分类归档页面顶部会显示短描述；
• 底部会保留你之前代码实现的长描述展示。

内容的提问来源于stack exchange，提问作者Sarah Tallman