贡献

嘿,你!想为Jetpack贡献力量吗?

你知道吗?是的,你是否有助于使Jetpack更加强大和安全?Jetpack是一个100%符合GPL的WordPress插件,所以,如果你使用并喜欢Jetpack,为什么不为这个项目贡献力量呢?

(如果你不使用和喜欢Jetpack,你还在等什么?立即下载!)

Jetpack是开源的,就像WordPress本身一样。您可以测试计划的改进、检查代码、文件和查看错误报告,甚至提交自己的修补程序。社区的贡献使WordPress和Jetpack如此强大。

通过对Jetpack的贡献,您可以改进数百万网站的功能,同时获得实际开发经验。最重要的是,所有级别的开发人员都可以提供帮助——无论你几乎无法识别过滤器(或不知道这意味着什么),还是你已经编写了自己的插件,你都可以参与进来。

为每个人做贡献!

后院火箭队:Jetpack新手

只是想知道Jetpack是什么?欢迎!

首先,在测试站点上安装Jetpack并四处查看-启用一些模块,然后尝试自定义它们。(需要一个开始的地方吗?尝试一下移动主题,或移动共享按钮.)

接下来,尝试注册我们的Beta程序。Beta测试人员在公开发布之前会对更新、修复和新功能进行测试,因此它们是开发过程中非常重要的一部分。如果你感兴趣,你可以在这里注册Beta程序.

一旦你掌握了Jetpack的工作原理,为什么不看看GitHub,我们用来跟踪错误的工具? 你马上就可以开始提交错误报告了。

远程飞行:中间编码器

如果您能够轻松阅读和编辑代码,但尚未从头开始编写自己的代码,请通过提交错误报告来帮助消除错误。如果您以前从未提交过错误报告,请查看创建一个很棒的Bug报告确保您的报告包含开发人员快速有效解决问题所需的所有信息。

如果你要提交报告,你还需要熟悉github。一旦你觉得报告很舒服,就开始环视代码并准备好采取下一步行动——提交补丁。

星际旅行:高级开发人员

你自己写代码吗?你能阅读别人的代码并提出改进建议吗?也许你已经编写了自己的插件,或者戴上了太阳镜直接窥视WordPress的核心。

如果是你,那就加入竞争,开始创建和提交补丁。看一看这些悬而未决的问题了解社区认为需要关注的事情类型。您可以从查看标有的问题开始“社区”里程碑、或与“Good First Bug”标签,这是熟悉Jetpack代码库的好方法。

Jetpack的绝大多数功能都需要连接到WordPress.com开发模式或a临时站点,通常最好创建一个可以连接到WordPress.com的测试站点。

贡献的螺母和螺栓

加入Beta计划

我们的Beta程序旨在让您能够简单地进行测试,并告诉我们在下一版本的Jetpack中我们做错了什么(和对了什么)。作为Beta测试人员,您的任务是帮助我们测试下一版本的Jetpack,并让我们了解您的体验。UI令人困惑吗?模块是否工作不正常?有什么东西丢了吗?我们需要知道!

这听起来像是你感兴趣的东西吗?如果是,请注册成为Beta测试人员开始吧。除了安装、激活Jetpack并更新到最新版本之外,您还需要运行WordPress的最新版本。

帮助将Jetpack翻译成另一种语言

任何人都可以帮助翻译Jetpack。您可以建议新字符串在这里.

您可以了解更多有关GlotPress工作原理的信息在这里.

签出源代码

包括WordPress在内的大多数软件项目都使用版本控制系统来跟踪源代码和修订。Jetpack在上可用github.

以下是使用Git下载Jetpack的基本步骤:

安装Git

获取Git的最简单方法是从以下位置下载操作系统的二进制包Git的网站-有适用于大多数主要操作系统的软件包,包括Mac OSX、Windows、几个版本的Linux等。

更多信息,请查看Git网站上的文档.

创建GitHub帐户并生成SSH密钥

Jetpack的代码托管在GitHub.com网站。虽然您可以在不创建帐户的情况下浏览和下载插件代码,但如果您想通过报告错误或提出补丁来做出贡献,则需要注册GitHub。

注册后,我们建议您生成SSH密钥,以便在计算机和GitHub之间建立安全连接。这将允许您从GitHub中提取代码并推送补丁,而无需每次都输入密码。你可以跟着本指南将SSH密钥添加到您的计算机和GitHub帐户。

导航Jetpack Git存储库

源代码和修订保存在储存库。您可以使用命令行界面(CLI)或使用客户端程序,它允许您签出、查看、编辑和修补源代码。

Jetpack存储库可用在这里,有四个重要部分:

  • 大旅行箱:最新开发代码。
  • 问题:错误、功能请求、备注、建议、补丁……它们都在里面!
  • Pull请求:这是代码建议所在的位置。

检查代码

安装Git后,您需要先签出代码,然后才能使用它—也就是说,您将从远程位置(存储库)将代码下载到您的计算机上。方法如下:

  1. 引导到Jetpack的GitHub页面,然后点击“分叉”按钮:
    福克这样做时,您可以将Jetpack的当前开发版本复制到自己的GitHub帐户。
  2. 在您的计算机上,打开终端并导航到您想要Jetpack所在的目录。
  3. 执行clone命令例如,要查看您刚刚在GitHub上创建的Jetpack存储库的副本:
    git克隆git@github.com:YOUR_GITHUB_USERNAME/喷气背包.git喷气背包
  4. 导航到喷气背包目录:cd喷射包
  5. 将原来的Jetpack存储库添加为新的远程:它将允许您将我们对原始存储库所做的更改拉入,从而使您的本地副本保持最新。
    git远程添加上游git@github.com:自动/jetpack.git

如果创建该fork已经有一段时间了,那么您需要确保使用的是Jetpack的最新开发版本,请使用fetch和merge命令将最新的Jetpack更改应用于本地存储库,而不会丢失任何本地更改。

git获取上游git签出中继git合并上游/主干

创建一个很棒的Bug报告

问题选项卡是一个用于跟踪项目和错误的票证数据库,我们使用它来管理新功能、错误报告和常规项目任务。它的设计目的是让人们尽可能简单地报告错误并提交代码补丁。

要成为明星记者,请遵循以下三条准则:

1.确保这个bug真的是一个bug。

在您报告错误之前,请确保这不仅仅是网络小鬼或兼容性问题。

首先,确保运行的是WordPress和Jetpack的最新版本。然后通过关闭所有其他插件并切换到默认的TwentyThirteen或Twenty 14teen主题开始调查。你还看到这个问题吗?如果是这样,您可能发现了一个错误。

如果问题消失了,可能是由于与某个插件或主题发生冲突所致。现在,一次测试一个——只激活Jetpack和该主题或插件,以消除其他变量。当问题再次出现时,您已经找到了罪魁祸首。

2.查看是否已报告。

要检查是否已报告错误,您可以:

这些地方都没有提到?不是因为与另一个插件或主题冲突?乔治,你发现了一只虫子!该报告了。

3.提交详细、准确的错误报告。

你的问题越具体,别人就越容易解决问题。登录GitHub打开一个新问题,并填写所有相关细节:简明扼要的总结和清晰的描述是关键。如果有人提到过,比如Jetpack支持论坛,包括一个链接。

下面是一个有用的摘要示例:

问题摘要:Jetpack Image小部件不会显示所选图像。

复制步骤:

  1.  激活Extra Sidebar Widgets模块
  2.  在侧栏中包含Jetpack Image小部件,并填写所有字段,包括图像URL
  3.  保存小工具并查看您的站点

预期行为或结果:侧栏应显示所选图像

实际行为或结果:出现错误:“找不到图像。”

示例链接(如果适用):http://example.com/image-widget(http://example.com/image-widget)/

屏幕截图:此处显示错误消息的屏幕截图

跨浏览器测试,AKA“不要忘记Internet Explorer 8”

如果您认为自己遇到了一个bug,并且已经完成了上面详细介绍的所有步骤,那么值得检查一下这个问题是否可以在不同的浏览器中重现。您可以在上找到所有主要浏览器的最新版本的下载链接浏览Happy.

您还应该检查潜在的错误是否仅限于一个浏览器;这对于任何可能与JavaScript或jQuery相关的错误都特别重要,因为某些浏览器比其他浏览器更容易遇到这些问题。

对现有问题发表意见

除了报告错误和提交修补程序之外,您还可以跟踪您感兴趣的任何问题的进度,或向现有问题添加详细信息。

要关注问题,请登录GitHub,找到您感兴趣的问题,滚动到底部,然后单击订阅:

订阅问题

如果您有信息要添加到现有票据中,请随时添加评论!

修补所有东西!创建和提交修补程序

臭虫叮咬

如果你正在修复一个bug,首先分叉Jetpack的存储库并将Jetpack的新分支克隆到您的计算机上。一旦完成,创建新分支然后,看看那个分支。

git分行名称git结帐分支机构名称

然后,您可以编辑文件并提交更改。

  • 要获取已更改文件的列表,请使用状态命令:
    git状态
  • 要以逐行补丁格式显示所做的更改,请使用diff命令输出标准差异在对源代码所做的所有更改中:
    差异比较
  • 要在单个文件中显示差异,请使用diff命令(或包含多个文件路径以显示一组页面之间的差异):
    git-diff路径/to/file

导出修补程序

要共享您所做的更改,您需要将更改推送到GitHub上的存储库,然后向Jetpack提交拉取请求。

  1. 首先将所做的更改提交到本地存储库。为此,您需要首先将已更改的文件添加到临时区域:
    git添加。
  2. 然后,提交您的更改:
    git提交

    您需要保持提交消息的第一行简短,快速解释您的更改。然后,您可以在下面的行中提供更多详细信息。

  3. 既然您已经提交了更改,它们就可以被推到Github上了,如下所示:
    git推送源分支名称
  4. 最后一步是创建Pull Request,让我们了解您的更改。当您访问fork时,GitHub将提示您创建此Pull Request:创建拉取请求单击“比较和拉取请求”创建拉取请求!

为每个人开发最佳实践

有关最佳实践,请参阅WordPress.org codex中的信息。您将找到有关的更多信息PHP程序,HTML格式,CSS公司JavaScript脚本那里的编码标准。

有问题吗?

这篇文章的评论已关闭,但我们仍在这里提供帮助!访问支持论坛,我们很乐意回答任何问题。

查看支持论坛