从一个小故障开始 - 我如何帮助改进Joomla核心
并非每个功能在第一次在网站上使用时都能正常工作,但有时确实存在无法通过更改设置解决的问题。这就是我的“故障”如何变成Joomla核心代码更改的故事。
背景
去年11月,我为Joomla社区杂志撰写了一篇名为《探索核心 - 智能搜索和搜索结果设置》的文章,并在我的开发网站上展示了智能搜索功能的一些示例。这真是一次愉快的体验,而且在深入研究Joomla功能的过程中,通常总有一些新的发现。
智能搜索提供了一些显示搜索结果选项,其中一个选项是包括标题和选定的任何元数据以及简介图像。到目前为止,一切顺利,但当我测试这个功能时,图像并不总是显示出来。事实上,很多时候我看到的只是标题,没有图像。
更仔细地查看搜索结果,我可以看到有一个<img src=”/” />标签出现,但这只是那样。源代码中没有任何内容。所以我添加了一个类,然后我得到了<img class=’dantest’ />,但仍然没有图像显示。
我们都是世界的一部分
如果你曾经遇到过使某物正常工作的难题,那么你可能已经遵循了一些“下一步”操作。这些可能包括点击Google、你的首选搜索引擎、Stack Exchange、Joomla论坛或Joomla Mattermost上的某个频道。经过大量搜索后,我在Joomla改进频道中提出了一个问题。
丹:“关于智能搜索的问题。我已经检查了所有设置,甚至使用了全新的 Joomla 4 安装,但图片无法在结果中显示。它显示了一个带有“/”作为源的 img 标签。并且我在文章中设置了简介和完整图片。”
很快我就被建议尝试使用不同的模板,以防我的模板覆盖了一些代码。我照做了,但没有任何成效。事实上,我更进一步。我的安装仍然运行在 Joomla 4 上,所以我创建了一个全新的 Joomla 5 安装,添加了内容以及简介和完整图片,但问题仍未解决。
询问了解的人
了解社区中的成员非常有帮助,因为有时候在频道中发出的一般呼吁并不能得到你想要的答案。有人建议我联系汉斯·帕彭贝格(Hannes Papenberg),他是生产部门虫群(Bug Squad)的负责人——一个由 Joomla 用户组成的精英团队,负责检查报告的问题,看是否是虫虫,并努力解决它们。
经过几个问题和一些进一步的测试后,很明显问题(对我来说)并没有解决,所以我提出了一个GitHub 上的问题。当我认为我发现了联系人中的问题的时候,我以前也这样做过。那次我被迅速派去查看“未记录的功能”,尽管我认为这仍然是需要检查的东西。
这次我打开了一个问题,大约10天后,我看到一个红色的“虫虫”标签被添加。
大问题
在 Joomla GitHub 上有很多问题。目前有850个开放问题。虫群需要时间来处理列表,并复制报告的“虫虫”。
一旦虫虫被复制,就会提出代码更改,这被称为拉取请求。GitHub 将其描述为:“...一个提议将一组更改从一条分支合并到另一条分支。在拉取请求中,合作者可以在将更改合并到主代码库之前审查和讨论提议的更改集。”
汉斯调试了我的问题,并在代码中找到了罪魁祸首。这是一个非常小的更改,但对于我来说却意义重大。如果文件名中有空格,智能搜索就无法处理它。代码更改被提出,并成为了拉取请求 #42725
合并和测试
接下来是什么?我发现了一个虫虫,它已经在 Joomla 代码的一个分支中被修复,几个开发者能够测试并验证问题已被解决。
汉斯说:“我们需要2次成功的测试来确认解决方案。在那之后,维护者还要审查代码并检查它。”
一旦代码被审查,就可以将其合并到核心中。
虫群
查看 GitHub 上的问题页面,你会发现有些问题旁边有评论,但有些需要检查和验证。汉斯说:“...我们只需要有人测试拉取请求,评估报告的票据,如果他们能编码(这并不是必须的),他们也可以修复问题。”
要加入 Joomla 虫群,请登录或注册https://joomlacommunity.cloud.mattermost.com/,然后前往 PD 虫群频道。
我有没有问题?
虽然问题频道确实包含了一些错误报告,但最佳起点是Joomla论坛,那里每天都有许多经验丰富的Joomla用户回答问题。大多数时候,论坛上的答案就能解决你的问题。如果不行,有人会指引你正确的方向。
《Joomla社区杂志》上发表的一些文章代表了作者对特定主题的个人观点或经验,可能并不代表Joomla项目的官方立场。
通过接受,您将访问https://magazine.joomla.net.cn/外部第三方提供的服务
评论