使用Subversion与WordPress插件目录

遵循这些逐步说明在公共Wordpress插件目录中添加和更新插件.

视频中的这些基本步骤如下:

  • 使用您的插件入门
  • 注册WordPress.org帐户
  • 请求将新插件放在Wordpress插件目录
  • 为您的机器安装SVN客户端
  • 为项目选择一个本地目录
  • 您的插件请求批准电子邮件
  • 本文的目录项
  • 将新的服务器目录拉到本地计算机
  • 完成开发您的插件
  • 使您的第一个版本提供给公众

    • 更新项目目录中继
    • 标记服务器上的新版本
    • 使用新标记版本
    • 更新本地项目目录

    • 更新Readme.txt稳定标记

  • 您的插件新的开发

使用插件入门

是否有一个想法或者几乎完成版本0.1,您需要为插件的名称和描述.制作名称简短和描述,给出了一个插件的想法."蜡上的蜡堵塞"不是一个好名字."下拉影子制造商"要好得多.您不需要将"插件"添加到实际标题.

与您的头衔一起,您应该写一篇简短的描述告诉人们您的插件提供的好处.我建议这个描述不到150个字符.

寄存器寄存器以获取wordpress.org帐户

如果您尚未拥有WordPress.org帐户-用于在支持论坛等中交互-您需要获得一个.只需转到:https://login.wordpress.org/register

请求将新插件放在WordPress插件目录

使用兼容许可证提供的最合理的插件可以在Wordpress插件目录中获取空间.

  1. 转到:http://wordpress.org/extend/plugins/add/
  2. 填写您的标题和描述
    (我告诉过你你需要那个!)
  3. 跳过从此表格上载的插件-即使您的插件已准备就绪.

您的插件目录请求由真实的人处理,因此可能需要一段时间.

为计算机安装SVN客户端

使用插件目录,您需要计算机上的子变压器客户端.

  • 对于Windows,我推荐玳瑁.
  • 对于mac,似乎scplugin是一个很好的包装.

只需选择一个并安装它.还有更多的要说.

为项目选择本地目录

subversion将使插件文件的本地副本与WordPress插件目录最新.我建议在本地计算机上创建一个目录,在那里您将保留所有颠覆性跟踪的项目.警告:如果您的本地计算机上有Web开发环境,请不要将本地Web服务器的WordPress插件目录用作项目目录.

例如,如果您的机器上有一个本地WordPress安装,其中插件文件夹为:

documents/public_html/devdomain.com/wp-content/plugins/

......请勿认为您可以使用该目录同步您的WordPress插件目录项目.这会导致你痛苦.

而是创建这样的示例的目录:

documents/projects/wp-plugins-public/

每个插件项目文件夹都将在"WP-Plugins-Public"中.对于本教程,我将使用名为"content-scheduler"的插件文件夹.所以,我会制作一个目录:

documents/projects/wp-plugins-public/content-scheduler

您的插件请求批准电子邮件

一旦您的插件请求已获得批准,您将收到一封带有SVN存储库的链接的电子邮件.这专门用于该插件,并且需要继续使用Subversion Syncing.

本文的目录项

在本文中提到了这么多不同的目录,项目和文件夹,可能很容易被混淆.在使用此Subversion工作流程时,让我们同意三个不同的位置.

  1. 工作目录
    这是您正在更改和测试的当前代码副本.它应该在开发Web服务器上的"/WP-Content/Plugins/"文件夹中.在我的机器上,它碰巧是:
    documents/public_html/devdomain.com/wp-content/plugins/content-scheduler/
  2. 项目目录
    这是您的subversion客户端将与WordPress插件目录同步的目录.在我的机器上,这是:
    documents/projects/wp-plugins-public/content-scheduler/
  3. 服务器目录
    这是指存储在WordPress插件目录中的项目.这是公众能够获得插件的地方.根位置称为"SVN存储库",将在插件请求批准电子邮件中分配给您.对于我的例子,这是:
    http://plugins.svn.wordpress.org/content-scheduler

将新服务器目录拉到本地计算机

即使您在插件目录中的新插件位置中没有将任何文件放在Plugin目录中,则需要将该目录的副本拉下来.这样做设置了一些幕后的旗帜,以帮助您的Subversion客户知道最新的是什么,而不是.

  1. 右键单击项目目录插件文件夹.
  2. 选择"svn结帐".
  3. 在第一个字段中输入您的WordPress SVN存储库URL(从批准电子邮件中从您的批准电子邮件中.
  4. 您的项目目录插件文件夹应在第二个字段中.
    由于您通过右键单击该文件夹来启动此过程,因此应该填充此字段.
  5. 单击"确定"

完成开发插件

开发和测试您的插件.这包括创建一个正确的"Readme.txt"文件来与之相同."Readme.txt"文件不仅仅是关于您的插件的一些随机注释.WordPress插件目录使用"Readme.txt"文件的内容来了解​​哪个版本的插件被视为当前,也可以在目录中构建插件页面的内容.

  • 有关创建正确的"Readme.txt"文件的更多信息,请参阅此WordPress Readme.txt示例.

"Readme.txt"文件的重要部分是"稳定"标记.在您正在开发插件时,请留下此标签读"Trunk".发布用于公共消费的版本后,我们将使用正确的版本号更新.

使您的第一个版本可用于公共

更新项目目录中继

  1. 将工作目录的内容复制到项目目录的"Trunk"文件夹中.
    在我的情况下,我正在复制我的插件的全部内容从工作目录下:
    /documents/public_html/devdomain.com/wp-content/plugins/content-scheduler/
    到我的项目目录:
    /documents/projects/wp-plugins-public/content-scheduler/
  2. 右键单击项目目录中的"Content-Scheduler"插件文件夹,然后选择"SVN提交".
  3. 如果需要,请为提交注释.
  4. 查看已被认为是新的文件列表,并将复制到服务器.如果此列表看起来准确,请单击"确定",将在WordPress.org中将文件复制到您的服务器目录.

标记服务器上的新版本

您已更新"Trunk"中的文件,但这不是公众应该下载的内容.您需要使用"标记"来创建"Trunk"的副本.此副本不会进一步更改,并将提供公共使用.对于此示例,让我们创建1.0版.

  1. 右键单击项目目录的"主干"文件夹,然后选择"分支/标记".
    对我来说,这是:
    /documents/projects/wp-plugins-public/content-scheduler/trunk/
  2. "到URL"位置字段将结束"/trunk".您需要将其更改为"/tags/1.0"以创建您的1.0版.
  3. 如果需要,您可以添加关于此标记操作的说明.
  4. 单击"确定"和 Ignore 任何关于"重要的消息以更改为此分支..."

使用新标记版本

更新本地项目目录

您刚刚告诉服务器在"/tags/1.0"目录中进行项目文件的新副本.现在,我们需要将您当地的项目目录带入到新的标签上.

这个过程看起来很奇怪.您可能想知道为什么您不能在本地的"/tags/1.0"目录中制作自己的副本.如果您这样做,服务器目录和项目目录会变得凌乱并混淆更新的内容以及不存在的内容.

  • 再次右键单击项目目录,然后选择"SVN更新".
    这将从服务器目录中提取更改为本地项目目录.在这种情况下,更改是添加文件的"/tags/1.0"副本.

更新Readme.txt稳定标记

所有正确的文件都是为了公众使用您的插件.但是,我们必须告诉插件目录,该目录标记了公众应该使用的标记版本.

  1. 在本地项目目录的"Trunk"文件夹中编辑"Readme.txt"文件.
    对我来说,这是如下:
    /documents/projects/wp-plugins-public/content/scheduler/trunk/readme.txt
  2. 将"稳定标签"更改为您的发布版本"1.0"
  3. 保存文件
  4. 右键单击刚刚更新的"README.TXT"文件,然后选择"SVN提交".

那是!在15分钟左右:

  1. WordPress插件目录将更新您的项目列表
  2. "1.0"将被视为稳定标签
  3. "/tags/1.0/readme.txt"中的信息将用于填写您的项目页面.

插件的新开发

很可能,您将改进您的插件并需要发布它们.这是它的作品.

  1. 对工作目录中的插件进行更改.
    这些更改应包括根据需要的Readme.txt文件的更改,例如ChangeLog条目.
  2. 将工作目录复制到本地项目目录中的更改.
  3. 确保Readme.txt文件对当前的公共版本具有正确的"稳定"标记.
  4. 右键单击项目目录,然后选择"SVN提交"以将新的中继器更改为服务器目录.
  5. 右键单击项目目录中的"Trunk"目录,然后选择"分支/标记"以创建新版本标记以获取发布.(确保"从以下命令创建存储库中的副本:"设置为"工作副本".)
  6. 右键单击项目目录,然后选择"SVN更新"以从服务器目录下拉下标记.
  7. 更新项目目录的"/treadme.txt"文件中的稳定标记以匹配您创建的新版本标记.
  8. 右键单击项目目录(yes,一个时间),然后选择"svn commit"以将更新的Readme.txt文件置于服务器.

phew.这就是全部!

6

发表回复