Question 1

为什么用户角色在Gibbon Planner模块中没有被翻译？

Accepted Answer

这是v29.00.00之前版本中的一个bug，当时角色字符串未通过翻译函数处理。解决方法是升级到Gibbon v29或更高版本。如果无法立即升级，请手动编辑modules/Planner/planner_view_full.php文件，将第1291行从$cell->addContent($person['role']);改为$cell->addContent(__($person['role']));

Question 2

如何修复 Gibbon“Manage Applications”编辑页面上的 'Undefined variable $families' 和 TypeError current() null 错误？

Accepted Answer

这是 Gibbon v30.0.01 (FamilyFields.php) 中的一个已知 bug，当招生账户关联到家庭（gibbonFamilyID 已设置）但未关联到任何人员（gibbonPersonID 为 NULL）时就会出现——通常是在开启 'Create Family' 的情况下接受了缺少 Parent 1 字段的表单所致。此时 Edit/Add 申请页面不显示任何表单，并记录 'Undefined variable $families' 以及 'TypeError: current(): Argument #1 ($array) must be of type array, null given'。修复方法：升级到 Gibbon v31，该版本已修补此问题 (PR #2191)。作为手动临时解决方案，可编辑 src/Forms/Builder/Fields/FamilyFields.php：在使用前初始化 `$families = [];`；当仅设置了 gibbonFamilyID 时，使用 `getByID()` 加载家庭信息，并根据 `!empty($families)` 进行分支判断；同时在 `shouldValidate()` 中，当 gibbonPersonID 或 gibbonFamilyID 任一被设置时返回 false，使隐藏的地址字段不会被设为必填。

Question 3

为什么 Gibbon 中申请人的结果页面上缺少 'Submission Email: An email was sent to...' 这一行？

Accepted Answer

这是 Gibbon v30.0.01（以及 dev 分支）中的一个已知 bug，影响启用了 Send Submission Email 但没有 Parent 1 email 字段的表单。确认邮件仍会发送——只是结果行对申请人隐藏，而教职员工能够看到它，因为他们的只读视图还会检查已存储的结果。修复方法：升级到 Gibbon v31，该问题已在其中解决（PR #2190）。对于 v30.0.01，请修补 src/Forms/Builder/Process/SendSubmissionEmail.php 中的 SendSubmissionEmailView::display()（约第 72 行），将该检查替换为：if (!$data->hasResult('submissionEmail') && !$data->has('submissionEmail') && !$data->has('parent1email')) return;，以便结果既能从已存储的结果中读取，也能从表单数据中读取。

Question 4

如何在 Gibbon 中将 Surname、Preferred Name 或 Official Name 设置为可选字段？

Accepted Answer

升级到 Gibbon v31，该版本通过现有的 Personal Data Field 设置添加了此功能。学校管理员可以将个人数据字段（如 surname 和 preferredName）配置为必填、可选或隐藏。注意：firstName 和 officialName 默认仍为必填，而其他字段可设为可选。这解决了学生导入允许 surname 留空、但 Edit User 表单仍要求填写的不一致问题。实现细节请参阅 PR #2180。

Question 5

为什么我的Gibbon表单数字字段拒绝接受小数值并显示“Must be in format %1$s”？

Accepted Answer

这是Gibbon v28.0.01中的一个已知缺陷：HTML的step属性未在带有小数位的数字输入上设置，导致浏览器的默认步长（1）拒绝小数。错误消息“必须采用 %1$s 格式”来自自定义验证回退。修复方法是编辑 src/Forms/Input/Number.php 并实现步长逻辑：添加一个step属性，将其设置为'0.'后跟(decimalPlaces-1)个零和'1'（例如，对于1位小数，step='0.1'）。如果通过新的step()方法设置了自定义步长，则使用该值。在补丁合并之前，临时解决方法是使用带有模式验证的文本输入，或使用JavaScript覆盖step属性。

Gibbon Core

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐