让自己的 WordPress 插件支持“新版本”提醒
开发一个 WordPress 插件的新版本后,想提醒老版本的用户有“新版本”可供下载。开始,每次版本更新,我都要在博客里发布“新版本”信息,以提醒插件用户。但是,很多插件用户并不会经常浏览我的博客,因而得不到提醒。
如果将插件注册到 WordPress 官方网站,那么,只要使用此插件的用户,都能即时在他们的 WordPress 站点的“插件管理”页面,看到“新版本”的提醒信息。即使是在插件注册之前就使用了插件的用户,也能获得提醒。
要让自己的 WordPress 插件支持“新版本”提醒,操作如下:
1. 注册一个 WordPress.org 网站的帐号
网址:http://wordpress.org/support/register.php
2. 添加你的插件信息
网址:http://wordpress.org/extend/plugins/add/
需要填写如下信息:
- 你插件的名字
- 一到两句话的插件描述
- 你的插件的原始链接(可选的)
3. 等待审批
审批需要 3-4 天,可能更长。
审批通过后,会在注册时提供的邮箱里收到 WordPress.org 的通知。通知中最重要的是插件的 subversion 目录。比如我的 WP-T-WAP 插件,subversion 目录为 http://svn.wp-plugins.org/wp-t-wap 。
subversion 是一个版本控件软件,简称 SVN。据说是 CVS 替代产品。(要了解 SVN 请访问:http://www.subversion.org.cn/)
4. 下载和安装 TortoiseSVN
网址:http://tortoisesvn.net/downloads
TortoiseSVN 是 SVN 的客户端。主要操作在“目录”和“文件”的右键菜单中。
5. 创建 SVN 项目目录
比如我的 WP-T-WAP 插件的 SVN 项目目录为 d:\svn-home\wp-t-wap\ 。
6. 从 WordPress.org 取出插件的 SVN 项目
以我的 WP-T-WAP 插件为例。对 d:\svn-home\wp-t-wap\ 目录单击右键,选择 "SVN Checkout…"菜单。在 "URL of repository" 项里填入 "http://svn.wp-plugins.org/wp-t-wap" (实际操作,应修改为第 3 步中 WordPress 通知邮件里提供的 SVN 目录)。
如果操作正确,会在 d:\svn-home\wp-t-wap\ 目录里出现 branches、tags 和 trunk 三个目录。
7. 创建 readme.txt 文件
readme.txt 文件用于存放插件的名称、版本、简介、安装方法等信息。为了让全世界的用户都可以使用,最好使用英文填写。模块如下:
http://wordpress.org/extend/plugins/about/readme.txt
一般只填写"Plugin Name"、"Description"和"Installation"三段就好了。后面的可以删除。(如果需要的话,填写更详细的信息当然更好)
"Plugin Name"段中,"Contributors" 字段填写作者名字,"Donate link"字段填写作者主页,"Tags"字段填写插件相关的关键字,"Requires at least"字段填写能适用的 WordPress 的最低版本,"Tested up to"字段填写测试的 WordPress 版本,"Stable tag"字段填写插件的版本号。
"Stable tag"是关键字段,用于比较两个版本的新旧。
"Description"段应填写 HTML 格式信息。如果要换行,需加入 <br> 标签。
"Installation"段填写插件的安装步骤。
8. 拷贝插件到 trunk 目录
将插件的所有文件拷贝至第 6 步中从 WordPress 取出的 trunk 目录。(注意,是拷贝插件的文件,而不是插件的目录)
readme.txt 文件也拷贝至 trunck 目录。
9. 提交 trunk 目录至 WordPress 的 SVN 服务器
右键单击 Trunk 目录,选择 "SVN Commit" 菜单。在 "Message" 项里填写操作备注。点击 "OK" 按钮提交。
10. 添加插件的版本
上一步只是提交插件源码至服务器,这一步要从源码生成一个插件版本。
右健单击 trunk 目录,选择 "TortoiseSVN » Branch/Tag" 。在 "To URL" 项里填入版本存放路径。
比如 WP-T-WAP 1.8 的版本存放路径应为 "http://svn.wp-plugins.org/wp-t-wap/tags/1.8" 。"1.8" 代表版本号,必须与此时 trunk 目录的 readme.txt 文件中的 "Stable tag" 字段对应。
下次再添加更新的版本时,记得修改 "Stable tag" 字段。
11. 等待 WordPress 从 SVN 里更新插件信息
新添加的插件版本,在 15 分钟内,将更新至 WordPress.org 的插件发布页(比如:http://wordpress.org/extend/plugins/wp-t-wap/)。更新后,插件用户就能在 WordPress 站点的“插件管理”页面里,看到插件的“新版本”提醒信息了。
[ 标签: svn, WordPress插件开发 ][ 固定链接:http://blog.tanggaowei.com/2008/05/wordpress-5.html ]


