📦 Homepage Popup Notice — SVN 操作手册

插件 Slug: homepage-popup-notice · SVN URL: https://plugins.svn.wordpress.org/homepage-popup-notice

📌 账号信息

• SVN 用户名：tsxcc（注意大小写）
• SVN 密码：去 WP.org 个人资料 → Subversion (SVN) Password 生成
• ⚠️ SVN 密码和登录密码不一样

一、首次上传（已完成 ✅）

1. 检出仓库

1. 本地建文件夹，比如 D:\svn-homepage-popup-notice
2. 打开文件夹 → 右键 → SVN Checkout
3. URL of repository：

   https://plugins.svn.wordpress.org/homepage-popup-notice

4. 其余默认，点 OK
5. 输入账号（tsxcc）+ SVN 密码

✅ 完成后目录结构：assets/ branches/ tags/ trunk/

2. 放代码 + Add

1. 把插件所有文件复制到 trunk\ 下
2. 右键 trunk → TortoiseSVN → Add...
3. 弹出列表确认后点 OK
4. 文件图标会变成绿色 + 号

📌 Add 只是本地标记，不会弹出账号密码框。

3. 提交到服务器

1. 右键 trunk → SVN Commit...
2. Log Message 填：Initial release v1.0.2
3. 点 OK → 弹出账号密码框 → 输入

⚠️ Commit 时才会弹出账号密码框，用户名 tsxcc，密码用 SVN 密码。

4. 打标签（用户能收到更新推送的关键）

1. 右键 trunk → TortoiseSVN → Branch/Tag...
2. To URL：

   https://plugins.svn.wordpress.org/homepage-popup-notice/tags/1.0.2

3. Log Message 填：Tag 1.0.2
4. 不要勾 "Switch working copy to new branch/tag"
5. 点 OK

⚠️ 没打 tag 用户收不到更新推送！ 每次发版都必须打 tag。

二、发新版本（日常更新流程）

三步走，以从 v1.0.2 升级到 v1.0.3 为例：

步骤 1：修改插件代码

本地修改好代码后，必须更新版本号（共 3 处）：

还要在 readme.txt 的 Changelog 里加上这次更新说明：

== Changelog ==

= 1.0.3 =
* 修复了 XXX
* 优化了 YYY

= 1.0.2 =
* 其他更新...

步骤 2：提交 trunk

1. 右键 trunk → SVN Commit...
2. Log Message：v1.0.3 - 修复了 XXX
3. 点 OK

步骤 3：打 tag

1. 右键 trunk → TortoiseSVN → Branch/Tag...
2. To URL：

   https://plugins.svn.wordpress.org/homepage-popup-notice/tags/1.0.3

3. Log Message：Tag 1.0.3
4. 不要勾 "Switch working copy to new branch/tag"
5. 点 OK

三、插件截图与封面图

截图放在 assets\ 目录下（和 trunk、tags 平级，不在 trunk 里面）。

怎么放：

1. 把图片复制到 assets\ 目录下
2. 右键 assets → TortoiseSVN → Add... → OK
3. 右键 assets → SVN Commit...
4. Log Message：Add screenshots and banner
5. 点 OK

✅ assets 不需要打 tag，提交后即时生效。

📸 截图建议： 至少放 2 张——后台设置页 + 前台弹窗效果。用浏览器截屏后裁一下就行。

⚠️ 注意 MIME 类型： SVN 默认给 PNG 加 application/octet-stream 会导致图片不显示。必须改成 image/png：

1. 右键图片 → TortoiseSVN → Properties
2. 选中 svn:mime-type → Edit → 值改为 image/png
3. 提交

四、添加中文翻译

插件首页显示「此插件尚未翻译成简体中文」是因为缺少 .mo 文件。推荐用在线方式翻译：

方式一：在线翻译（推荐）

1. 打开 GlotPress 翻译平台：

   https://translate.wordpress.org/projects/wp-plugins/homepage-popup-notice/

2. 选 简体中文
3. 逐条翻译（每条就是一个词/一句话）
4. 提交后 WP 自动推送，不需要重新上传插件

方式二：本地生成（需 Poedit）

1. 下载安装 Poedit
2. File → New from POT/PO file → 选 languages/homepage-popup-notice.pot
3. 目标语言选 Chinese (Simplified)
4. 逐条填中文翻译 → 保存为 homepage-popup-notice-zh_CN.po
5. Poedit 自动生成同名的 .mo 文件
6. 两个文件放到 trunk\languages\ 下 → 提交 trunk → 打 tag

五、注意事项总表

六、快捷键流程（做熟了看这里）

=== 更新到 vX.X.X ===

1. 修改代码 + 更新版本号（3 处）
2. trunk → SVN Commit... → "vX.X.X - 更新说明"
3. trunk → Branch/Tag... → .../tags/X.X.X → "Tag X.X.X"