本文详解如何通过正确钩子 lp/template/function/course/level 扩展或修改 LearnPress 的课程难度选项（如“Beginner”“Intermediate”），纠正常见过滤器误用问题，并提供可直接部署的代码示例与注意事项。
本文详解如何通过正确钩子 `lp/template/function/course/level` 扩展或修改 learnpress 的课程难度选项（如“beginner”“intermediate”），纠正常见过滤器误用问题，并提供可直接部署的代码示例与注意事项。
在 WordPress 中使用 LearnPress 构建在线课程时，课程难度等级（Level）是课程元数据的重要组成部分，直接影响前端展示与学员筛选体验。LearnPress 默认仅提供 'beginner'、'intermediate'、'expert' 三个选项，但实际业务中常需本地化翻译（如法语年级制）或新增等级（如“4e année primaire”）。许多开发者尝试使用 learn-press/level-label 过滤器修改，却发现后台下拉菜单未更新——这是因为该过滤器仅影响单个课程页面的标签渲染（即 learn_press_get_post_level() 的返回值），而非后台编辑界面和前端表单中可用的等级列表源。
真正控制等级选项数组的是 lp/template/function/course/level 这一过滤器，它被 lp_course_level() 函数调用，而该函数直接为课程编辑页的下拉框、REST API 响应及模板渲染提供数据源。
✅ 正确做法：使用 lp/template/function/course/level 过滤器重定义整个等级数组：
生产级WordPress REST API集成，用于管理文章、页面、媒体、WooCommerce产品、Elementor内容、SEO元数据、ACF及JetEngine字段
// 在当前主题的 functions.php 或专用插件中添加
add_filter('lp/template/function/course/level', 'customize_learnpress_course_levels');
function customize_learnpress_course_levels($levels) {
// 修改默认等级的显示文本（支持国际化）
$levels['beginner'] = esc_html__('1ère année primaire', 'learnpress');
$levels['intermediate'] = esc_html__('2e année primaire', 'learnpress');
$levels['expert'] = esc_html__('3e année primaire', 'learnpress');
// 新增自定义等级（键名需唯一，建议使用连字符小写格式）
$levels['grade-4'] = esc_html__('4e année primaire', 'learnpress');
$levels['grade-5'] = esc_html__('5e année primaire', 'learnpress');
$levels['grade-6'] = esc_html__('6e année primaire', 'learnpress');
return $levels;
}
? 关键注意事项：
- ✅ 必须使用 lp/template/function/course/level，而非 learn-press/level-label；后者仅作用于单课程级别标签输出，不改变选项列表；
- ✅ 键名（如 'grade-4'）将作为数据库存储值（保存在 _lp_level 元字段中），请确保其符合 WordPress 元键命名规范（无空格、特殊字符）；
- ✅ 若需多语言支持，请始终包裹 esc_html__() 并指定文本域 'learnpress'（LearnPress 主题/插件已注册该文本域）；
- ⚠️ 修改后，已发布的课程需手动重新选择并更新等级，系统不会自动迁移旧值（例如原 'beginner' 不会自动映射为 '1ère année primaire'）；
- ? 如需彻底移除默认等级（如禁用 'expert'），可使用 unset($levels['expert'])，但需谨慎评估对现有课程的影响；
- ? 建议在子主题中操作 functions.php，避免主题更新导致代码丢失；生产环境上线前，请在测试站点验证后台表单、REST API /wp-json/learnpress/v1/courses 及前端课程卡片的等级显示一致性。
通过上述方式，您即可安全、精准地扩展 LearnPress 的课程难度体系，满足本地化教育场景的分级需求，同时保持插件兼容性与可维护性。
