WordPress 使用 wp 命令创建 .opt 文件用以支持多语言
前言
个人所理解,如有错误请指正
首先需要明白一件事情,创建 .opt
文件前,首先在你的插件注释里添加以下关键注释(Text Domain 和 Domain Path 字段):
- Text Domain:文本域(个人理解),这个比较关键
- Domain Path:翻译文件存放的路径
/**
* Plugin Name: 插件的名字
* Plugin URI: https://nowtime.cc/
* Description: 插件简介
* Version: 0.0.1
* Author: Chuwen
* Author URI: https://nowtime.cc
* Text Domain: chuwen
* Domain Path: /i18n/languages/
* Requires at least: 5.5
* Requires PHP: 7.0
*
* @package Chuwen
* @date 2021/7/20 14:50
*/
以上工作完成后,就可以接着往下看了
安装 wp 命令
WP-CLI 是一款用于管理 WordPress 的命令行交互界面,无需浏览器即可完成插件更新,多站点设置等许多操作。
官网地址:https://wp-cli.org/zh-cn/
[官方]安装文档:https://wp-cli.org/zh-cn/#安装
本文主要介绍 macOS 以及 Linux 系统安装
Linux 安装教程
cd ~
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
# 检查 Phar 文件确保其正常运行:
php wp-cli.phar --info
# 要使用 wp 执行 WP-CLI 命令,必须有执行权限并且 PATH 已在环境变量中注册,例如:
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
# 最后再次验证
wp --info
macOS 可以借助 Homebrew 进行安装
Homebrew 官方安装文档:https://docs.brew.sh/Installation
其安装教程可参照:https://zhuanlan.zhihu.com/p/111014448
Homebrew 安装完成后,执行 brew install wp-cli
即可
Windows 安装教程
自行网上搜索,因为某些功能在 Windows 中将受到限制,所以我推荐在 Windows 10 以及以上的系统,安装 WSL(Windows 子系统),然后参照 Linux 系统安装
wp
命令即可
验证安装 wp 命令
输入 wp --info
即可验证
chuwen@MiBook# wp --info
OS: Darwin 19.6.0 Darwin Kernel Version 19.6.0: Thu Oct 29 22:56:45 PDT 2020; root:xnu-6153.141.2.2~1/RELEASE_X86_64 x86_64
Shell: /bin/zsh
PHP binary: /usr/local/Cellar/php@7.3/7.3.28/bin/php
PHP version: 7.3.28
php.ini used: /usr/local/etc/php/7.3/php.ini
MySQL binary:
MySQL version:
SQL modes:
WP-CLI root dir: phar://wp-cli.phar/vendor/wp-cli/wp-cli
WP-CLI vendor dir: phar://wp-cli.phar/vendor
WP_CLI phar path: /Users/chuwen
WP-CLI packages dir:
WP-CLI global config:
WP-CLI project config:
WP-CLI version: 2.5.0
生成 .pot
文件
- 假设你的 WordPress 根目录是:
/www/wwwroot/wordpress.com
- 假设你的 WordPress 插件目录:
/www/wwwroot/wordpress.com/wp-content/plugins/chuwen
首先进入的你的插件目录
cd /www/wwwroot/wordpress.com/wp-content/plugins/chuwen
然后生成 .opt
文件
# 如果你是按照最开头的做法做的,那么会自动将生成的 `.opt` 文件放到 `Domain Path` 文件夹下
wp i18n make-pot .
# 如果你想指定文件存放路径、文件名
wp i18n make-pot . i18n/languages/chuwen.pot
最后生成结果查看你插件目录下的 i18n/languages/
里面的文件即可
生成多语言
将生成的比如 chuwen.pot
复制一份,将其命名为 en_US.pot
,然后使用工具进行翻译即可