Polylang 的 SkyLang 自动翻译器入门

Welcome to SkyLang! This guide will walk you through installation, initial setup, and your first steps to auto‑translate posts, pages, products, and taxonomies with Polylang. Whether you’re using the free Google Translate engine or a Pro AI provider, you’ll be up and running in minutes.

开始之前

确保您的网站满足以下要求：

• WordPress 网站 – version 5.0 or higher recommended.
• Polylang 插件 – installed and activated, with 至少两种语言 配置。
• 免费版 – no API key needed; Google Translate is included at no cost.
• 专业版 – a valid SkyLang Pro license key to unlock AI engines (Gemini, OpenAI, Claude, OpenRouter, and OpenAI‑compatible endpoints).

笔记： All translation features rely on your Polylang language setup. If you haven’t added languages yet, do that first in Polylang → Languages.

安装

1. 下载插件 – obtain the .zip 来自您的购买收据或 WordPress 插件存储库的文件。
2. 上传并安装 – in your WordPress admin area, go to Plugins → Add New → Upload Plugin。选择 .zip 文件并单击 立即安装.
3. 激活 – after installation, click 激活插件.
4. 启动设置向导 – on first activation you’ll be automatically redirected to a multi‑step wizard. This helps you verify your languages, test a translation, and see what Pro offers. You can skip any step and finish when ready.

首次设置

完成向导后，前往 SkyLang → Settings 配置您的翻译引擎。

1. 选择您的人工智能提供商

• 自由的： 选择 谷歌翻译 – no key required.
• 专业版: 从中选择 谷歌双子座, 开放人工智能, 人性化的克劳德, 开放路由器，或一个 OpenAI 兼容 URL。输入相应的API密钥和型号。

2. 调整附加设置（可选）

• 自动同步分类法 – enable to automatically copy translated categories and tags to translated posts.
• 翻译模式 – choose between safe string extraction (recommended) or full‑content AI translation.
• 帖子类型 – select which content types (posts, pages, products, etc.) should appear in the Bulk Editor.
• 完整内容定制说明 – add instructions for the AI when using full‑content mode (Pro only).

3. 保存更改

点击 保存更改 在“设置”页面的底部。您的配置现已准备就绪。

提示： If you’re unsure, start with the default settings. You can change them anytime.

你的第一步

尝试两个核心功能来感受 SkyLang：

📋 Bulk Editor – Translate missing content in one go

1. 前往 SkyLang → Bulk Editor.
2. 使用 文件夹过滤器 显示特定的内容类型（例如， 帖子 或 页数).
3. 该表显示缺少翻译的项目。选中一项或多项旁边的复选框。
4. 点击 已选择批量翻译.
5. Watch the progress – each row shows a status badge. When complete, the translation is ready.

笔记： 您还可以翻译 全部失踪 使用一键单击项目 翻译所有缺失的内容 按钮。

⏳ Background Translate – Let translations run while you work

1. 前往 SkyLang → Background Translate.
2. 选择 帖子类型 你想包括在内。
3. 选择 翻译模式 – either “Translate untranslated only” or “Force translate all”.
4. 点击 开始后台翻译.
5. A progress bar and summary counters (total, processed, failed, remaining) show real‑time status. You can leave the page – the queue keeps running.
6. 使用 暂停, 恢复或 重置队列 根据需要。

批量编辑器

它的作用

批量编辑器为您提供了一个地方来查看 Polylang 中缺少翻译的所有帖子、页面和分类术语。您可以按内容类型过滤列表，逐页浏览结果，以及一次对多个项目执行批量操作，例如翻译、强制翻译或删除翻译。

如何使用

1. 前往 天朗 → 批量编辑器 选项卡。
2. 可以选择使用 文件夹过滤器 仅显示特定内容类型（例如产品或类别），并调整 每页项目数 控制屏幕上显示的项目数。
3. 通过选中项目旁边的框来选择您要使用的项目。
4. 单击批量操作按钮之一：
   • 已选择批量翻译 – Translate missing languages for the chosen items.
   • 强制翻译已选择 – Overwrite any existing translations.
   • 删除选定的翻译 – Remove all translations (except the source language).
   • 重新指定语言 – Change the language label assigned to the selected items.
5. Watch the progress as each item is processed — status badges show success or failure.
6. 查看每行的最终结果以确认每个操作已完成。

额外的工具栏操作

• 点击 翻译所有缺失的内容 自动翻译当前文件夹中每个不完整的项目。
• 点击 Sync categories & tags 运行分类同步。
• 点击 同步菜单 运行菜单同步。

Settings & Options

Tips & Best Practices

• 使用 文件夹过滤器 to focus on a specific content type – this keeps large lists manageable and helps you avoid accidental changes to unrelated items.
• 当您有很多项目需要翻译时，请先单击 翻译所有缺失的内容 而不是单独选择每个。
• 强制翻译已选择 overwrites existing translations, so use it only when you’re sure you want to replace the current content.
• 打开 调试切换 if something isn’t working as expected – it can reveal query issues and help you diagnose problems faster.

背景翻译

它的作用

The Background Translate feature lets you queue up post translations to run in the background — you can navigate away from the page and the process keeps going. You can watch real-time progress through a status badge, a progress bar, summary counters (total, processed, failed, remaining), and a detailed activity log.

如何使用

1. 前往 天朗 管理页面并单击 背景翻译 选项卡。
2. 选中要包含在翻译队列中的帖子类型的复选框。
3. 选择翻译模式：
   • 仅翻译未翻译的内容 – skip posts that already have translations.
   • 强制翻译全部 – process every post, even if already translated.
4. 点击 开始后台翻译 开始处理。
5. 使用进度条、状态徽章以及显示帖子总数、已处理帖子、失败帖子和剩余帖子的计数器来监控队列。
6. 您随时可以：
   • 点击 暂停 停止队列。
   • 点击 恢复 继续暂停的队列。
   • 点击 重置队列 取消所有待处理的翻译并清除进度。

Settings & Options

Tips & Best Practices

• 使用 仅翻译未翻译的内容 to save time and avoid re‑processing posts you’ve already translated.
• The activity log gives you a detailed breakdown of each translation result — check it if you need to troubleshoot any failures.
• 您可以安全地导航到其他页面或关闭选项卡；翻译过程在后台继续进行。
• 如果您需要更改设置或进行调整，请使用 暂停 和 重置队列 在开始新批次之前。

Category, Tag & Product Taxonomy Sync

它的作用

此功能执行一次性同步，将翻译的类别、标签和产品分类（例如产品类别、产品标签和产品品牌）复制到相应的翻译帖子和产品。如果某个术语不存在翻译，它将自动以目标语言创建一个新术语。

如何使用

1. 前往 天朗 管理页面并打开 工具 选项卡，或单击同步按钮 批量编辑器 工具栏。
2. 单击 Sync categories & tags 按钮来启动该过程。
3. 同步会扫描所有默认语言的帖子及其翻译。
4. 对于每个翻译的帖子，该功能都会分配源术语的翻译版本。
5. 同步完成后，状态消息会显示已更新的帖子数。

Settings & Options

此功能没有可配置的设置。只需单击同步按钮即可运行它。

Tips & Best Practices

• 翻译类别、标签或产品分类后运行同步，以确保所有翻译的帖子都使用正确的术语。
• Because the sync creates missing translations automatically, you don’t need to pre‑create translated terms before running it.
• 要在编辑内容时快速访问，请直接使用批量编辑器工具栏中的同步按钮。
• 检查同步后出现的状态消息，以确认更新了多少帖子。

菜单同步

它的作用

Menu Sync duplicates your navigation menus across all Polylang languages. When you run the sync, menu items that link to posts, pages, or categories are automatically mapped to their translated versions. If a translation doesn’t exist, the original link is kept. Any Polylang language switcher items in your menu are preserved as they are.

如何使用

1. 前往 天朗 管理页面并打开 工具 选项卡，或单击 菜单同步 按钮在 批量编辑器 工具栏。
2. 单击 同步菜单 按钮。
3. The tool scans all menus assigned to your site’s default language.
4. 对于每种目标语言，它都会创建或更新重复的菜单。
5. 指向帖子、页面或类别的菜单项与其翻译相匹配。
6. 新菜单会自动在 Polylang 中注册。

Settings & Options

此功能没有可配置的设置。单击该按钮后，同步过程会立即运行。

Tips & Best Practices

• 为帖子、页面和类别创建翻译后运行菜单同步以获得最准确的映射。
• 如果您稍后编辑默认语言菜单，请再次运行同步以将这些更改传播到其他语言菜单。
• 没有翻译的项目将保留原始语言链接，因此如果您需要完全本地化的菜单，请检查是否有任何缺失的翻译。
• 使用批量编辑器工具栏按钮可在管理内容时快速访问。

Auto-Sync Categories & Tags During Translation

它的作用

When you translate a post, this feature automatically creates translated copies of the post’s categories, tags, and product taxonomies and assigns them to the translated version. If a term doesn’t already have a translation in the target language, a new term is created so your taxonomy stays complete and consistent across languages.

如何使用

1. 前往 SkyLang → Settings.
2. 选择标记为的复选框 Auto-sync categories, tags & product taxonomies during translation.
3. 保存您的设置。
4. 下次您翻译帖子时，该插件将自动创建并分配翻译的分类术语。

Settings & Options

Tips & Best Practices

• Enable this option if you regularly translate posts with important categories or tags to keep your site’s taxonomy synchronized across languages.
• 由于新术语是自动创建的，因此请考虑首先翻译关键分类术语，以便重用现有翻译而不是创建重复项。
• 如果您希望手动为翻译内容分配类别和标签，请不要选中此复选框。
• 此功能与批量编辑器配合使用，可帮助您一次翻译许多帖子，同时保持分类关系完整。

字符串翻译（Polylang 字符串）

它的作用

添加一个 “自动翻译缺失” button to the Polylang String Translation page (Polylang → Strings translation). When clicked, the button automatically fills all empty translation fields for every non-default language using your chosen AI provider.

如何使用

1. 前往 Polylang → Strings translation 在您的 WordPress 管理员中。
2. 单击 “自动翻译缺失” 按钮位于工具栏中。
3. 该插件扫描每一行是否有空文本区域或输入字段。
4. 它按目标语言对丢失的字符串进行分组，并将其批量发送给人工智能提供商。
5. 翻译后的文本会自动插入到空白字段中。
6. 检查新填写的翻译并 保存页面 手动。

Settings & Options

没有此功能的设置。该按钮适用于您现有的 AI 提供商配置。

Tips & Best Practices

• 保存前查看 – AI translations may need minor adjustments. Always check the filled fields before clicking the save button.
• 仅填充空白字段 – Existing translations will not be overwritten, so you can safely use the button after manually translating some strings.
• 添加新字符串后使用它 – If you’ve added new translatable strings, run the “Auto-translate missing” button to quickly populate them.
• 首先配置您的 AI 提供商 – This feature relies on your selected AI provider. Make sure it is set up correctly in the translation engine settings.

翻译引擎配置

它的作用

Choose the AI service that powers your site’s translations. The free version works with Google Translate right out of the box — no API key needed. Pro unlocks access to advanced AI models like Google Gemini, OpenAI, Anthropic Claude, OpenRouter, and any OpenAI‑compatible endpoint, with full control over model selection and custom base URLs.

如何使用

1. 前往 天朗 管理页面并打开 设置 选项卡。
2. 从 人工智能提供商 下拉菜单中，选择您要使用的翻译服务。
3. 取决于您的选择：
   • 谷歌翻译（免费） – No further setup required.
   • Google Gemini、OpenAI、Anthropic、OpenRouter 或 OpenAI 兼容 – Enter the corresponding API密钥 并选择或键入 模型 姓名。
4. 如果需要，调整 API超时 （对于大帖子）或填写 自定义基本 URL 适用于 OpenAI 或 Anthropic 端点​​。
5. 点击 保存更改 应用您的配置。

Settings & Options

Tips & Best Practices

• 免费开始：默认的 Google 翻译选项可立即使用，无需 API 密钥或额外设置。
• 确保 API 密钥安全：对于专业提供商，请仔细检查您的密钥输入是否正确，并且有足够的积分来满足您的翻译量。
• 调整大内容的超时：如果长帖子翻译失败，请增加 API超时 设置给提供商更多的时间来响应。
• 使用自定义基本 URL：如果您有模仿 OpenAI API 的自托管或第三方服务，只需更改基本 URL 并提供匹配的模型名称即可。

翻译模式

它的作用

翻译模式允许您选择如何处理翻译内容。您可以从内容中提取单个可翻译字符串（安全字符串提取），也可以将完整的帖子内容发送到 AI 进行上下文感知翻译，从而保留古腾堡块、HTML 和内联样式。

如何使用

1. 进入 SkyLang 管理页面并打开 设置 选项卡。
2. 找到 翻译模式 下拉菜单。
3. 选择您要使用的模式：
   • 安全字符串提取（推荐） – for per-string extraction.
   • 完整的 post_content AI 翻译 – for complete, context-aware translation.
4. 点击 节省 应用您的选择。
5. 每当翻译内容时都会使用所选模式。

Settings & Options

Tips & Best Practices

• 使用 安全字符串提取 as your default mode – it’s reliable and works well for most content.
• 切换到 完整的 post_content AI 翻译 当您需要人工智能理解完整的上下文时，例如长文章或具有复杂格式的页面。
• 启用完整内容翻译后，请务必检查一些翻译，以确保正确保留古腾堡块和内联样式。
• 请记住，完整内容翻译可能会使用更多的人工智能处理时间，因此如果您一次翻译许多帖子，请相应地计划。

完整内容自定义 AI 说明

它的作用

This feature lets you add your own custom instructions that are sent to the AI along with SkyLang’s built-in preservation prompt when you use the Full Content translation mode. It gives you extra control over how the AI handles the tone, terminology, or specific elements of your content. (Available in the Pro version.)

如何使用

1. 前往 天朗 管理页面并打开 设置 选项卡。
2. 向下滚动到 完整内容定制说明 文本区域。
3. 输入 AI 的自定义说明（例如，首选措辞、特定领域术语或格式规则）。
4. 单击 保存设置 按钮来存储您的指令。
5. 当您使用以下方式翻译内容时 完整内容 翻译模式下，您的自定义文本将自动附加到默认保存提示中。

Settings & Options

Tips & Best Practices

• 具体说明您希望人工智能遵循的任何术语、品牌名称或风格偏好。
• Keep your instructions clear and concise – short, focused prompts often produce better results.
• 尝试不同的说明，看看哪种措辞最适合您的内容类型。
• 请记住，这些说明仅在使用完整内容翻译模式时适用；其他模式忽略此设置。

可配置的帖子类型

它的作用

此功能允许您选择可在 SkyLang 中翻译的内容类型（例如帖子、页面或产品）。在免费版本中，您可以启用帖子、页面和产品的翻译（当 WooCommerce 处于活动状态时）。专业版将此功能扩展到任何可与 Polylang 配合使用的自定义帖子类型。

如何使用

1. 进入 SkyLang 管理页面并打开 设置 选项卡。
2. 寻找 为帖子类型启用 部分。
3. 选中您要用于翻译的每种帖子类型旁边的复选框。
4. Uncheck any post type you don’t want to appear in the Bulk Editor or be translated.
5. 点击 节省 应用您的更改。

After saving, the Bulk Editor and translation features will only show the post types you’ve selected.

Settings & Options

Tips & Best Practices

• 仅启用您实际需要翻译的帖子类型。这可以保持批量编辑器的整洁并减少混乱。
• If you use WooCommerce, remember that “Products” will only appear as an option if WooCommerce is active.
• In the Pro version, custom post types registered with Polylang support will show up automatically—check them if you want them included.
• 启用新的帖子类型后，刷新批量编辑器以查看其内容是否显示以供翻译。

SEO 元翻译

它的作用

This feature automatically translates the meta titles and descriptions from popular SEO plugins—Yoast SEO, Rank Math, and All in One SEO—when you translate a post or term. It detects which SEO plugin is active on your site and ensures the appropriate meta fields are translated along with your main content.

如何使用

无需手动激活或额外步骤。每当您翻译帖子或术语时，翻译都会自动进行：

1. 使用通常的翻译工作流程开始翻译帖子或术语。
2. 系统检测活动的 SEO 插件（Yoast SEO、Rank Math 或 All in One SEO）。
3. 它从源内容中提取 SEO 标题和描述，并将其发送给 AI 提供商，以便与正文一起进行翻译。
4. 翻译后的 SEO 元值将保存到新翻译中。

Settings & Options

此功能没有可配置的设置。每次翻译内容时它都会自动运行。

Tips & Best Practices

• 在翻译之前，请确保您的源内容已填写 SEO 标题和描述。该功能只会翻译已经存在的元。
• 此功能与 Yoast SEO、Rank Math 和 All in One SEO 兼容。如果您使用其他 SEO 插件，元字段可能无法翻译。
• 翻译后，检查翻译内容的 SEO 元。自动翻译有时可能需要进行少量编辑才能听起来自然并适合您的 SEO 策略。
• Because the translation happens alongside the main content, you don’t need to take any additional steps—just translate as you normally would.

WooCommerce 产品变体翻译

它的作用

当您翻译 WooCommerce 产品时，此功能会自动创建所有产品变体的翻译版本，并将它们链接到翻译的产品。变体简短描述是使用您选择的 AI 提供商进行翻译的，所有变体元数据（例如价格、SKU 和属性）都是从原始变体复制的。

如何使用

1. 开始翻译 WooCommerce 产品（例如，从产品编辑页面或使用批量翻译工具）。
2. 该插件会自动查找附加到源产品的所有变体。
3. Each variation’s short description is translated by the AI provider.
4. 为翻译的产品创建新的变体帖子，并且每个元字段（价格、SKU、属性等）都是从源变体复制的。

No additional steps are required—the process is handled entirely during the product translation workflow.

Settings & Options

此功能没有可配置的设置。每当您翻译 WooCommerce 产品时，它都会自动运行。

Tips & Best Practices

• 查看翻译后的描述 – Variation short descriptions are automatically translated, so check them to ensure they fit the context of the translated product.
• 价格和 SKU 已复制 – If you need different pricing or SKUs for translated variations, update them manually after the translation is complete.
• 保留自定义元 – All custom variation data is copied to the translated variations, so you don’t have to re‑enter product‑specific information.
• 为您的 AI 提供商做好准备 – For best results, confirm that your AI translation provider is configured and optimised for product descriptions before translating products with variations.

Elementor Layout & Data Preservation

它的作用

翻译 Elementor 构建的页面时，该插件会深度复制和翻译 Elementor 数据，同时保留布局结构。带有可翻译文本（标题、描述、按钮文本等）的小部件设置将被翻译，并且为翻译后的帖子重新生成 Elementor CSS 文件。

如何使用

This feature works automatically — there is no separate UI or setup required. Simply translate a post that was created with Elementor, and the plugin will handle the rest.

1. 开始翻译包含 Elementor 数据的帖子（例如，从 WordPress 仪表板或使用批量编辑器）。
2. 该插件检测 Elementor 元数据并递归处理小部件结构。
3. 带有可翻译文本的小部件设置将发送到 AI 提供商进行翻译。
4. 翻译后的 Elementor 数据将保存到翻译后的帖子中。
5. 复制基本的 Elementor 元键，并为新翻译的帖子重新生成 CSS/资产。

Settings & Options

Tips & Best Practices

• 在翻译之前完成原始 Elementor 布局和文本。这确保了整个结构被正确捕获和翻译。
• 翻译后，预览翻译后的页面以验证布局是否保持不变并且所有小部件文本均已更新。
• When working with multiple Elementor pages, use the bulk editor to translate them all at once — the layout preservation works seamlessly in bulk.

入职设置向导

它的作用

入门设置向导是一个多步骤指南，在您首次激活插件后会自动出现。它可以帮助您开始检测您的 Polylang 语言、提供测试翻译并向您介绍 Pro 功能。该向导可确保您在开始翻译内容之前进行顺利的初始设置。

如何使用

1. On first activation, you are automatically redirected to the wizard’s welcome page.
2. In Step 1, review the detected Polylang languages. If everything looks correct, click “Next” to continue.
3. 步骤 2 让您测试翻译：输入一些示例文本，选择目标语言，然后查看翻译的效果。您也可以跳过此可选步骤。
4. Step 3 shows a comparison of Pro features with the option to “View Pro Plans & Pricing”. If you already have a license, you’ll see a confirmation that Pro is active.
5. Step 4 displays a review prompt. Choose “Go to Dashboard” to start using the plugin or “Visit Our Website” for additional resources.

Settings & Options

无需为入门设置向导配置任何设置。它会指导您完成设置，无需任何永久性调整。

Tips & Best Practices

• 在翻译整个页面之前，利用步骤 2 中的测试翻译来验证引擎是否适合您的内容。
• The wizard is designed to be completed in a few minutes — don’t skip it, as it ensures your languages are correctly detected.
• If you’re already a Pro user, Step 3 will confirm your license is active, so you can proceed with confidence.
• 完成后，您随时可以从主仪表板重新访问批量翻译或配置设置。

许可证管理

它的作用

许可证管理功能允许您激活、停用和验证您的 SkyLang Pro 许可证密钥。您可以查看许可证状态和到期日期，并管理自动更新和高级支持资格。

如何使用

1. 进入 SkyLang 管理页面并打开 执照 选项卡（仅适用于专业用户）。
2. 如果没有激活的许可证，请在提供的字段中输入您的许可证密钥。
3. 点击 激活许可证 — the plugin will contact the license server to validate the key.
4. Once activated, you’ll see a masked license key, a status badge (showing “Active”), and the expiry date.
5. 要停用此站点上的许可证，请单击 停用许可证.
6. 要随时通过服务器重新验证，请单击 验证许可证状态.

Settings & Options

Tips & Best Practices

• 将许可证密钥放在手边，以防站点迁移或重新安装后需要重新激活。
• 使用 验证许可证状态 定期或在进行网络更改后以确保您的密钥仍然有效。
• 在删除插件或将其转移到另一个站点以释放激活槽之前，请先停用您的许可证。
• 每个许可证密钥一次只能激活一个站点；在激活新站点之前停用旧站点。