当用户未完成某些课程模块时，原逻辑因跳过缺失数据而无法渲染对应表格单元格，导致列数错乱；本文提供基于“主课程列表驱动渲染”的解决方案，强制为每个学员保留全部8个模块列，并正确标识完成状态。
当用户未完成某些课程模块时，原逻辑因跳过缺失数据而无法渲染对应表格单元格，导致列数错乱；本文提供基于“主课程列表驱动渲染”的解决方案，强制为每个学员保留全部8个模块列，并正确标识完成状态。
在构建学习管理系统（LMS）的领导力进度追踪报表时，一个常见但关键的问题是：表格列结构必须严格对齐，即使某位学员尚未产生某模块的学习记录。原始代码通过遍历用户实际存在的课程数据（$dtd['lessons']）来动态输出 <td>，一旦某学员缺少某个模块（如 ID <code>21004）的进度条目，该列就会被跳过——最终导致整行单元格数量不一致、表头与内容错位、CSS 样式失效，甚至影响 DataTables 等前端插件的初始化。
根本解法在于反转数据驱动逻辑：不再“跟随用户数据走”，而是以预定义的“主课程模块列表”为基准进行循环渲染。这意味着无论用户是否拥有某模块数据，我们都为其保留一个 <td> 单元格，并根据其是否存在真实进度来决定填充 ✅ 或留空。<p>以下是重构后的核心逻辑（已整合进 WordPress 模板）：</p><pre class="brush:php;toolbar:false;"><?php
// 定义标准化的8个模块ID（即表头中"1"至"8"列对应的课程ID）
$master_lesson_ids = ['21032', '20999', '21001', '21004', '21007', '21009', '21013', '21015', '21018'];
foreach ($usersemail['users'] as $userdata) {
$user_courses = get_user_meta($userdata['user_id'], '_sfwd-course_progress', true);
?>
<tr>
<td><?php echo esc_html(get_user_meta($userdata['user_id'], 'first_name', true) . ' ' . get_user_meta($userdata['user_id'], 'last_name', true)); ?></td>
<!-- Color Self-Assessment 列（此处可按需扩展逻辑） -->
<td>&mdash;</td>
<?php
// 初始化本用户已完成模块计数
$num_complete = 0;
// 构建用户专属的“模块存在映射表”：仅收录属于主列表且有记录的模块ID
$user_lesson_map = [];
if (is_array($user_courses)) {
foreach ($user_courses as $course) {
if (!isset($course['lessons']) || !is_array($course['lessons'])) continue;
foreach ($course['lessons'] as $lesson_id => $lesson_data) {
if (in_array($lesson_id, $master_lesson_ids)) {
$user_lesson_map[$lesson_id] = true; // 仅标记存在性
}
}
}
}
// 关键：遍历主模块列表，确保每列必现
foreach ($master_lesson_ids as $lesson_id) {
if (isset($user_lesson_map[$lesson_id])) {
echo '<td>&#10003;</td>';
$num_complete++;
} else {
echo '<td> </td>'; // 显式留空，避免空白被压缩
}
}
?>
<!-- “Course Completed” 列：仅当8个模块全部完成才显示“Complete” -->
<td><?php echo ($num_complete === count($master_lesson_ids)) ? 'Complete' : '&mdash;'; ?></td>
<!-- “Results” 列 -->
<td class="user-results">
<a href="<?php echo esc_url('https://hrhazmat.com/user-progress-report-single-page?group_id=' . intval($ids) . '&user_id=' . intval($userdata['user_id'])); ?>">
View Results
</a>
</td>
</tr>
<?php } ?></pre><p>✅ <strong>关键改进说明</strong>： </p>
<ul>
<li>
<strong>结构稳定性保障</strong>：<code>$master_lesson_ids 作为唯一真理源，foreach 循环次数恒为 9（对应表头第3–11列），彻底消除列数浮动风险；
esc_html() 和 esc_url() 防止 XSS； 替代纯空格，确保单元格高度一致； $num_complete 在主循环中累加，最终与 count($master_lesson_ids) 严格比对，避免因数据结构嵌套差异导致误判； $master_lesson_ids 数组，无需触碰渲染逻辑。⚠️ 注意事项：
- 原始代码中
$ids在循环外部作用域可能未定义（应置于内层foreach($group_ids as $ids)中），示例已隐含修正； -
get_user_meta(..., '_sfwd-course_progress', true)返回结构依赖 LearnDash 插件版本，建议增加is_array()和键存在性校验（如isset($course['lessons'])）提升健壮性； - 若需支持多课程并行进度，应在
$user_courses解析阶段增加课程维度过滤逻辑。
通过将渲染控制权交还给确定性的主模块清单，该方案不仅解决了空白单元格缺失问题，更建立起可预测、易调试、易扩展的报表生成范式。
