迷途知返

0. 前言

    你想到了一个很有创意的点子？你写了一个很酷的插件？

    Oh，no！wordpress官网上的发布步骤太长了，还是E文。

    难道你的插件只能躺在插件包里，还是只放在你的网站里让寥寥无几的人下载？

    相信这篇文章能让你的插件不再山寨。

1. 准备工作

1. 你得有一个插件吧：）
   你的插件最好是别人没有写过的。这个你可以在官网上搜索一下，后面还会提到这一点。
2. 在 http://wordpress.org/extend/plugins 申请一个帐号。
   你很快会收到一封邮件，里面会有密码。我找了一下，没有找到在哪里修改密码。。。
3. 安装svn
   其实，前面的几步都没有什么好说的，整个插件的发布，关键还是在于svn的使用。至于安装，我在这里就不细说了，大家可以搜索一下，有很多讲安装的文章。给出subversion的下载页面：http://www.collab.net/downloads/subversion

2. 提交申请

    你需要向wordpress.org提交你的插件发布申请。

    这里就要强调最好你的创意是别人没有的，或者是没有类似的插件，这样插件发布申请会比较容易通过申请。

    提交申请大概一天（周末时间可能会长一些），就会收到邮件，告诉你申请通过了云云。

3. 插件截图及写好你的readme.txt

    你需要对插件截几张图，关于设置或者使用的。

    关于readme.txt，官网有专门的验证工具 readme validator 和标准 WordPress/bbPress plugin readme file standard ，我在这里只是说一下各部分会显示在什么地方。

    === plugin name ===

    这部分内容会出现在你插件页面右侧的信息栏中，当然，author信息会出现在下面的Description中。

    == item ==

    类似的内容会出现在下面的各个Item中。

    Screenshots中，对应的图片名字为screenshot-1.png …， 并在readme.txt中对图片进行说明。

4. 上传插件   

    以上的工作做好之后，你就可以开始上传你的插件了。这里就涉及svn的使用了。

1.  关于subversion
   所有的文件都会存储在服务器的仓库中。所有的人都可以从这个仓库中将插件下载到本地。但是只有插件作者可以登入，那就意味着你可以在本地修改文件，添加文件，删除文件并且将这些改动上传到服务器。这样既可以更新仓库中的文件，也会修改显示在wordpress.org的插件目录中的信息。
    
2. 在本地创建一个插件目录(把你的插件文件都放进去)：

   1	$ mkdir my-local-dir

3. 检查你的仓库

   1 2 3 4 5

   $ svn co http://svn.wp-plugins.org/your-plugin-name my-local-dir > A my-local-dir/trunk > A my-local-dir/branches > A my-local-dir/tags > Checked out revision 11325.

4. 把文件copy到trunk目录下(代码和官网不一样，但目的一样)

   1 2	$ cd my-local-dir/ my-local-dir/$ cp * trunk/

5. 让svn知道你想把文件加到仓库中

   1 2 3

   my-local-dir/$ svn add trunk/* > A trunk/my-plugin.php > A trunk/readme.txt

6. 开始上传你的插件吧

   1	my-local-dir/$ svn ci -m 'Adding first version of my plugin'

   回车之后会要求你输入用户名密码，这个就是你在官网申请的用户名密码。完了之后下面就开始显示和传输文件，最后会显示版本号。

    很快，你就可以在官网插件目录中找到你的插件啦 ：）

5. 修改插件

1. 检查本地版本是不是最新的，否则你就需要从仓库中下载最新的版本

   1 2	my-local-dir/$ svn up > At revision 11326.

   看这个版本号是否和你最后一次提交的版本号一致。
    

2. 对你的插件进行修改，工具无所谓你可以用vi,nano,gedit,甚至记事本

   1	vi trunk/my-plugin.php

3. 检查本地文件的状态

   1 2	my-local-dir/$ svn stat > M trunk/my-plugin.php

   M 说明你已经对这个文件进行了修改（Modified）

4. 你可以使用svn diff来查看修改过的地方
5. 提交你的修改到服务器

   1 2 3 4

   my-local-dir/$ svn ci -m "fancy new feature: now you can foo *and* bar at the same time" > Sending trunk/my-plugin.php > Transmitting file data . > Committed revision 11327.

6. 标记一个新的版本

    用版本号来标记：   

1
2

my-local-dir/$ svn cp trunk tags/2.0
> A tags/2.0

    提交更新：

1
2
3
4
5

my-local-dir/$ svn ci -m "tagging version 2.0"
> Adding         tags/2.0
> Adding         tags/2.0/my-plugin.php
> Adding         tags/2.0/readme.txt
> Committed revision 11328.