WordPress 图片尺寸限制排除方法

本文教你如何在 WordPress 中为供应商用户设置图片上传尺寸限制，并灵活排除特定页面（如店铺首页、Logo 上传页），避免误拦合规图片。通过条件判断结合 wp_handle_upload_prefilter 钩子，实现精准控制。

本文教你如何在 WordPress 中为供应商用户设置图片上传尺寸限制，并灵活排除特定页面（如店铺首页、Logo 上传页），避免误拦合规图片。通过条件判断结合 `wp_handle_upload_prefilter` 钩子，实现精准控制。

在使用 WCMP（WooCommerce Multi-Vendor Marketplace）等多供应商插件时，常需对供应商上传的图片施加尺寸约束——例如强制主图不低于 1080×1080 像素，同时防止超大图（如超过 12000×12000）影响性能。但若全局启用该限制，会误伤「店铺 Logo」「横幅 Banner」等本应允许小尺寸上传的场景。

因此，关键在于动态判断当前上传上下文：仅在非白名单页面（如商品编辑页、店铺设置页）生效校验，而在 wcmp_before_shop_front 触发的店铺首页、或特定页面（如 ID=24 的 Logo 上传页）中跳过验证。

以下是优化后的完整解决方案（推荐写入主题的 functions.php 或专用插件）：

function wcmp_vendor_image_resolution_check($file) {
    // 1. 仅对 WCMP 供应商用户执行检查
    if (!is_user_wcmp_vendor(get_current_user_id())) {
        return $file;
    }

    // 2. 【核心】排除特定页面：根据实际需求任选其一（取消注释并配置）

    // ✅ 方案 A：排除指定页面 ID（如 Logo/Banner 上传页 ID = 24）
    // if (is_page(24)) {
    //     return $file;
    // }

    // ✅ 方案 B：排除特定页面模板（如 custom-banner-upload.php）
    // if (is_page_template('custom-banner-upload.php')) {
    //     return $file;
    // }

    // ✅ 方案 C：排除 WCMP 店铺首页（推荐 —— 基于问题中提供的钩子语义）
    // 注意：wp_handle_upload_prefilter 在前端上传时触发，此时无法直接用 do_action，
    // 但我们可通过检测当前请求是否处于店铺前台来间接判断
    if (function_exists('wcmp_is_store_page') && wcmp_is_store_page()) {
        return $file;
    }

    // ✅ 方案 D：更通用的 URL 路径判断（适用于无函数支持的环境）
    // $current_url = esc_url_raw($_SERVER['REQUEST_URI']);
    // if (strpos($current_url, '/vendor-dashboard/') !== false || 
    //     strpos($current_url, '/store/') !== false) {
    //     return $file;
    // }

    // 3. 执行尺寸校验
    $image_info = getimagesize($file['tmp_name']);
    if (!$image_info) {
        return $file; // 非图片文件，跳过校验
    }

    $width  = $image_info[0];
    $height = $image_info[1];

    $min = ['width' => 1080, 'height' => 1080];
    $max = ['width' => 12000, 'height' => 12000];

    $too_small = '图片尺寸过小，请上传宽度和高度均不小于 1080 像素的图片。';
    $too_large = '图片尺寸过大，请上传宽度和高度均不超过 12000 像素的图片。';

    if ($width < $min['width'] || $height < $min['height']) {
        $file['error'] = $too_small;
        return $file;
    }

    if ($width > $max['width'] || $height > $max['height']) {
        $file['error'] = $too_large;
        return $file;
    }

    return $file;
}
add_filter('wp_handle_upload_prefilter', 'wcmp_vendor_image_resolution_check');

⚠️ 注意事项与最佳实践：

• 勿嵌套函数定义：原始答案中将整个函数包裹在 if 内是错误写法（PHP 不允许条件式函数声明），正确做法是在钩子回调内部做逻辑分支。
• 优先使用语义化判断：wcmp_is_store_page() 是 WCMP 提供的可靠函数，比依赖 URL 或页面 ID 更健壮；若不存在，可配合 is_admin() 判断后台/前台环境。
• 错误提示本地化：示例中使用中文提示，如需多语言支持，建议改用 __() 函数包裹字符串。
• 性能考虑：getimagesize() 会读取文件头，开销较小，但避免在非图片文件上重复调用（已通过 $image_info 检查规避）。
• 测试覆盖：务必在供应商账户下分别测试「商品图上传」「店铺 Logo 上传」「Banner 上传」及「后台媒体库上传」，确认规则按预期生效或跳过。

通过以上结构化实现，你既能保障平台内容质量，又赋予供应商在必要场景下的操作灵活性，真正实现“有约束的自由”。