建设多语言网站 – Polylang 插件的使用

2020年2月22日
EBRP研究
网站搭建

多语言网站优化，少不了多语言的插件，其中PolyLang就是一款常用的语言插件。
翻译了 Polylang 插件的官方文档，使用 Polylang 插件可以创建多语言的 WordPress 网站，在附件里，你可以下载到这款插件的简体中文翻译文件，解压以后，放在 Polylang 插件的 languages 目录下。
Polylang 管理界面

创建语言

Polylang 有 50 种预定义的语言，在设置菜单里，找到语言，从下拉菜单里选择想要添加的语言的名称，然后点击添加语言。
如果你想要的语言没在列表里，或者你不想要默认的设置，你可以自己修改，每种语言都有 5 个字段。

全名：在网站上显示的语言的名称，比如：English，Français，简体中文，繁体中文。
区域设置：用在 WordPress 上的语言代码，必须填写跟 WordPress 区域设置一致的代码，不然主题翻译就不能正常工作。一般由两个小写字母，一个下划线，再加上两个大写字母组成。例如：en_US，fr_FR，zh_CN。不过也有一些区域设置只用两个或三个小写字符，比如：ar，el，ckb。
语言代码：这个代码会用在 URL 上，最好使用两个小写字母的 ISO 639-1 语言，比如：en，fr，cn …
文字方向：一般的语言都是从左向右阅读，不过也会从右向左阅读的语言（阿拉伯语，希伯来语）。Polylang 会告诉主题使用 LTR 还是 RTL 样式。注意并不是所有主题都支持两种文字方向（默认的 2011，2012 主题支持）。
排序：在语言切换工具上显示的语言的顺序。

记得点击 添加语言 按钮，可劲儿添加，因为没有限制。Polylang 会自动为你下载语言文件，如果没下载成，你可以手工下载：svn.automattic.com/wordpress-i18n/ 。把下载下来的语言文件放在 /wp-content/languages 目录下。
Polylang 还会试着去下载默认的 2010，2011，2012 这些主题的语言文件，如果也没下成，可以使用上面的地址手工下载，然后放在 /wp-content/themes/your_theme/languages 目录下。
更多信息请阅读：codex.wordpress.org/WordPress_in_Your_Language

设置

默认语言：当有人第一次访问你网站首页的时候使用的默认的语言。
要是安装 Polylang 在已有的网站上，会出现红色字儿的提示：有些文章，页面，分类或标签还没有设置语言，你想把它们设置为默认的语言吗？你可以点击这个快速设置所有已有的文章，页面，分类，标签的语言。同样适用于自定义内容类型，自定义分类法。注意不会修改文章，页面，分类或者标签的 URL。
检测浏览器语言：勾选以后，如果有人第一次访问你的网站的首页，网站的语言会根据用户的浏览器的设置来设置。如果网站的语言里没有用户浏览器的语言，那么就会使用默认的语言。
URL 修改

重要的选择：

从内容设置语言：Polylang 尽可能不修改 URL，默认，只有需要的时候才添加语言信息到 URL 上（主要是规档），不需要就不会添加（文章，页面，分类，标签）。这样即便禁用了这个插件，大部分重要的链接也不会受影响。
语言代码：例如：/en/，当使用简洁链接时会添加到所有 URL 上。这样如果禁用了这个插件，每个 URL 都会遗失语言信息，也就是所有的 URL 链接都会被破坏。

其它控制 URL 的相关选项：

在简洁链接中保留 /language/：月度规档的 URL 就会是这样：www.yoursite.com/language/en/2011/11/
从简洁链接中移除 /language/：月度规档的 URL 会是这样：www.yoursite.com/en/2011/11/
为默认语言隐藏 URL 语言信息，这样只有默认的语言会隐藏语言信息，那么默认语言的月度规档的 URL 看起来是这样地：www.yoursite.com/2011/11/
重定向语言页面到首页：不使用静态首页的话，这个选项是没有用的。例如，首页 URL 看起来是这样：www.yoursite.com/en/

控制语言与翻译的更多选项：

媒体：翻译媒体的标题与描述。
同步：创建文章与页面的翻译时可以避免重复动作，比如设置分类与标签，特色图像，父页面等等。你可以选择到底用不用同步。如果网站上有自定义内容类型或者分类法的时候，你也可以选择使用语言与翻译。最后别忘了点保存更改按钮。

主题的国际化（ i18n ）与本地化（ l10n ）

这步很重要，不然你的主题在显示文章或页面的时候不会显示翻译。要跟主题的作者确认一下主题是不是国际化（是否可翻译）还有本地化（已经翻译）了你需要的语言。了解更多可以参考宁皓网的《 WordPress 主题开发》课程。
检查主题的 header.php 是否有类似的代码：
<html <?php language_attributes(); ?>>
有些浏览器或机器人会使用这行代码检查你的页面语言。
语言切换器

语言切换小工具（ Widgets ）

到小工具的管理页面，你可以找到语言切换器，它目前有五个选项：

显示语言名称
显示标示
强制链接到首页
隐藏当前语言
使用下拉菜单的形式显示

如果你取消了 “显示语言名称” 和 “显示标示” 这两个选项，小工具会显示语言名称。如果你勾选了 “使用下拉菜单的形式显示” ，就不会显示标示，无论你是否选择勾选了 “显示标示” 选项。
如果你勾选了“强制链接到首页”，小工具会一直把访问者带到相应的语言的首页上，不勾选，语言切换器会试着找到翻译页。（没找到的话会回到首页上）。
如果勾选了 “隐藏当前语言”，小工具就不会显示当前语言。
不管使用哪个选项，切换工具上的语言只有在至少有一个文章或页面使用了这个语言的时候才显示。
语言的标示图像可以在 wp_content/polylang 目录里找到，比如区域设置为 en_US，那么就会使用 en_US.png 这个图像。

导航菜单

你的主题必须支持自定义导航菜单，而且必须在 wp_nav_menu 函数里使用了一个主题区域。例如：
wp_nav_menu(array('theme_location' => 'primary')); 可以
wp_nav_menu(array('menu' => 'nav menu')); 不可以
你可以为每种语言创建菜单。然后到菜单选项卡里的语言设置页面为每种语言选择正确的菜单。
你可以添加一个语言切换器在菜单的结尾处。勾选 “在菜单结尾处显示语言切换器”。
如果你没勾选 “显示语言名称” 还有 “显示标示”，语言切换器会使用语言名称。
如果勾选了“强制链接到首页”，语言切换器会把访问者带到正确的语言的首页，不然它会去寻找翻译页面（没找到的话就会回到首页上）。
勾选 “隐藏当前语言”，语言切换器就不会显示当前语言。
最后记得点击保存更改按钮。

字符串翻译

Polylang 可以翻译用户定义的字符串，比如网站的标题，标语，小工具标题。你还可以为每种语言选择不同的语言格式和时间格式。插件或主题可能会添加其它的字符串到这个列表里。
名称：为了方便排序。
字符串：要翻译的字符串。
翻译：不同语言下每个字符串的翻译。
默认所有翻译的字符串都会保存在数据库里，有一个复选框允许你清理在数据库里的没有用的字符串。