Getting Started

Welcome to SkyTranslate! This guide will help you get up and running with bulk translation for your multilingual WordPress site.

Before You Begin

Make sure you meet the following requirements:

• WordPress – A running WordPress installation (any modern version).
• TranslatePress – The TranslatePress plugin must be installed, activated, and configured with at least one secondary language. Your multilingual setup should be ready before using SkyTranslate.
• Admin permissions – You need the ability to install and activate plugins, and manage translation settings.

No additional setup is required to start with the Free version – it uses Google Translate right away. If you plan to upgrade to Pro later, you will need API keys for your chosen premium AI engine.

Installation

1. Download the SkyTranslate plugin from your purchase source or the WordPress plugin repository.
2. In your WordPress admin, go to プラグイン → 新規追加.
3. クリック Upload Plugin and select the downloaded .zip file, or search for “SkyTranslate” if it’s in the repository.
4. クリック 今すぐインストール、次に 有効化.
5. After activation, you’ll see a new menu item: SkyPlugins → SkyTranslate Bulk Translate.

That’s it – the plugin is installed and ready.

First-Time Setup

The only essential setting to get started is choosing your translation engine.

1. 「 SkyPlugins → SkyTranslate Bulk Translate in your WordPress admin.
2. 左下の 設定 タブに切り替えます。
3. 選択 Google Translate (the default Free option).
4. クリック 設定の保存.

Your translation engine is now configured. All bulk, background, and editor translations will use Google Translate until you switch to a different engine.

Your First Steps

Translate a group of posts

1. に行きます 一括編集 tab under SkyPlugins → SkyTranslate Bulk Translate.
2. In the table, you’ll see your published posts and pages. Use the checkboxes to select the items you want to translate.
3. で Target Language dropdown, choose one language or すべての言語 (to translate into every secondary language you have set up).
4. Adjust the Batch Size および API Timeout if needed (the defaults work well for most sites).
5. Skip already translated languages is enabled by default – this avoids re-translating content that is already fully translated.
6. クリック 選択した項目を自動翻訳.

A progress bar will appear and a live log will show each step. When it finishes, your content is translated and saved in the TranslatePress dictionary.

Queue translations to run in the background

1. を開きます Background Translate タブに切り替えます。
2. Choose an Operation Mode:
   • Only untranslated / partial content – translates what’s missing.
   • Force translate whole selection – overwrites all existing translations.
3. 選択してください 投稿タイプ および Target Language.
4. Set Strings Per Batch および API Timeout (adjust if you have many strings or a slow API).
5. Optionally, set a Retry Limit to handle temporary failures.
6. クリック Start Operation.

The plugin will create a queue and process each item one by one using WordPress cron. You can pause, resume, or delete the operation at any time. The progress table updates in real-time so you can see what’s done and what’s next.

一括翻訳

What It Does

This feature lets you select multiple published posts or pages and translate them in bulk using Google Translate or premium AI models. It supports batch processing with configurable batch size and timeout, and provides a progress bar to track the translation progress.

How to Use It

1. に行きます 一括編集 tab under SkyTranslate.
2. Use the search bar and post type filter to find the content you want to translate.
3. Select the posts or pages by checking the boxes next to each item.
4. Choose a Target Language from the drop-down – either “All Languages” or a specific secondary language.
5. Adjust the Batch Size (number of strings processed per request) and API Timeout (maximum seconds to wait for a response).
6. Optionally, enable Skip already translated languages to avoid re‑translating content that is already complete.
7. クリック 選択した項目を自動翻訳 (to translate only missing or partial translations) or Force Translate Selected (to overwrite all existing translations).
8. Watch the progress bar and live status log. Wait until the process finishes.

Settings & Options

Tips & Best Practices

• Use “Skip already translated languages” to save time and resources – it avoids reprocessing content that is already complete.
• Adjust Batch Size carefully: a larger batch can speed up translation, but may cause timeouts if your content is lengthy. Start with a moderate value (e.g., 100) and increase as needed.
• Choose the right translate button: use Auto Translate for incremental updates, and Force Translate when you want to completely refresh all translations.
• Keep an eye on the progress bar and status log – if an API timeout is too short, some translations may fail. Try increasing the timeout value if errors occur.

Background Translate

What It Does

The Background Translate feature lets you queue up content for automatic translation. It uses WP‑Cron to process translations in the background, so the operation continues even after you close your browser. You can choose to translate only missing or partial content, or force‑translate the entire selection.

How to Use It

1. に行きます Background Translate tab inside SkyTranslate一括翻訳.
2. Configure your translation settings (see the table below for details).
3. クリック Start Operation to begin queuing and translating your content.
4. While the operation is running, use Pause Operation to temporarily stop processing or Resume Operation to continue.
5. To remove the current operation entirely, click Delete Operation.

Settings & Options

Tips & Best Practices

• 使用してください Only untranslated / partial content to save API calls and speed up the process when you only need to fill in missing translations.
• If you need to re‑translate everything (for example after editing the source content), choose Force translate whole selection.
• Queuing multiple target languages at once lets you handle all secondary languages in a single operation.
• Keep an eye on the real‑time status table to monitor progress, spot failures early, and adjust settings if needed.

Settings (Google Translate Engine)

What It Does

Configure the translation engine used by all translation tools in SkyTranslate. Your choice here applies to both bulk translation and the inline editor helper. The page also displays which post types are available for automatic translation.

How to Use It

1. In your WordPress admin, go to SkyPlugins > SkyTranslate Bulk Translate.
2. 左下の 設定 タブに切り替えます。
3. Select a translation engine by clicking its radio button.
   • The free version includes Google Translate.
   • Pro versions add ジェミニ, OpenAI, Claude, OpenAI Compatible、そして OpenRouter.
4. クリック 設定の保存 to apply your choice.

Settings & Options

Tips & Best Practices

• The translation engine you choose here is used everywhere – bulk translation and the editor helper. Changing it will affect all future translations.
• If you are using the free version, only Google Translate is available. Upgrading to Pro unlocks AI-powered engines with potentially higher quality and customization.
• To see which post types support auto-translate, look at the list shown on the same Settings page.
• Always click 設定の保存 after making a change, or your selection won’t be applied.

TranslatePress Editor Integration (String Fetcher)

What It Does

Adds a blue AI翻訳 button directly inside the TranslatePress editor. With a single click, it scans the entire preview page and extracts all translatable content — including SEO meta fields — then displays them in a floating panel. You can auto-translate every string at once using Google Translate (or Pro AI) and save the translations to the TranslatePress dictionary.

How to Use It

1. Open the TranslatePress editor for the page you want to translate (the editor loads when the URL contains the trp-edit-translation parameter).
2. In the editor toolbar, locate the blue AI Translate button next to the Save button.
3. 左下の AI翻訳 button. The plugin will scan the preview and editor DOM and gather all translatable strings.
4. A floating results panel will appear, listing all fetched strings.
5. To auto-translate all strings, click the AI翻訳 button inside the results panel.
6. Use the search bar at the top of the panel to quickly find specific strings.
7. When you’re done, close the panel by clicking the close icon (×) or the backdrop area.

Settings & Options

Tips & Best Practices

• One-click page translation: Use the AI翻訳 button for a quick, full-page translation instead of translating strings one by one.
• SEO metadata included: The fetcher also picks up SEO meta fields (e.g., title, description) from the preview — make sure to review them after auto-translation.
• Review after auto-translate: Google Translate or Pro AI will fill in all strings automatically, but it’s a good practice to check the results for context accuracy.
• Search before translating: If you only need to translate a subset, use the search bar in the results panel to locate specific strings before clicking the AI Translate button.

Clear Translations

What It Does

The Clear Translations feature lets you delete existing translations for specific content items. You can remove translations for a single language or for all languages at once. This permanently deletes the translations from the TranslatePress dictionary.

How to Use It

1. Go to your WordPress Admin dashboard and navigate to SkyPlugins > SkyTranslate Bulk Translate.
2. を開きます 一括編集 タブに切り替えます。
3. Locate the post or content item you want to update.
   • To clear a translation for one language, click the trash icon on the language pill for that language.
   • To clear all translations for the item, click the Clear Translations row action link.
4. A confirmation dialog will appear. Click Confirm to proceed.
5. The plugin will fetch the page strings, find the matching entries in the dictionary, and remove the translations.

Settings & Options

This feature does not have any configurable settings.

Tips & Best Practices

• Clear per‑language when you only need to update one language.
  Use the trash icon on a specific language pill to avoid affecting translations for other languages.
• Clearing translations is permanent.
  Once removed, the translation cannot be recovered unless you have a backup. Consider exporting your translations first if you might need them later.
• Test with a single language first.
  If you’re unsure about clearing all translations, start by clearing one language to confirm the result.
• After clearing, the post will display its default language content for the affected languages until new translations are added.

Language Status Overview

What It Does

This feature gives you a quick snapshot of translation progress for each content item. Color-coded pills show whether a post is fully translated, partially translated, missing, empty, or in error state. You can expand or collapse the details to see coverage percentages per language.

How to Use It

1. 「 SkyTranslate一括翻訳 in the WordPress Admin.
2. を開きます 一括編集 タブに切り替えます。
3. Look at the 言語 column for any post — you’ll see a summary like “2/3 translated”.
4. クリック Show Details to expand the per-language pills. Each pill shows a color indicator and the coverage percentage for that language.
5. To collapse the details, click Hide Details.

Settings & Options

This feature does not have any configurable settings.

Tips & Best Practices

• Use the color-coded pills to quickly spot posts that need attention (red or gray indicators often mean missing or empty translations).
• Expand a post’s details to see exactly how complete each language is before launching bulk translation.
• Prioritize posts with “missing” or “empty” states — these are the best candidates for bulk translation.
• The summary “X/Y translated” lets you scan many posts at once and decide where to focus your translation efforts.

License Management (Pro)

What It Does

Activate, deactivate, and verify the SkyTranslate Pro license. This unlocks Premium AI models, automatic updates, and priority support. Once activated, your license status is checked daily and the expiry date is shown on the License tab.

How to Use It

1. 「 WordPress Admin > SkyPlugins > SkyTranslate Bulk Translate, then click the ライセンス タブに切り替えます。
2. で License Key field, paste or type the license key you received after purchase.
3. クリック Activate License to send the activation request.
   • If successful, your Pro features will unlock and your license status and expiry date will appear.
4. To remove the license from this site, click Deactivate License.
5. To manually re‑check your license validity, click Verify License Status.
6. To buy a new license or view upgrade options, click Purchase a License (you will be taken to the SkyTranslate store).

Settings & Options

Tips & Best Practices

• Keep your license key confidential – treat it like a password. Do not share it publicly.
• Deactivate before moving sites – always click Deactivate License before migrating or re‑installing on a new domain.
• Check your license status regularly – use Verify License Status after any major update or if you suspect your key has been revoked.
• Watch the expiry date – the displayed expiry date helps you plan renewals so Pro features remain uninterrupted.

Premium AI Translation Engines (Pro)

What It Does

Premium AI Translation Engines let you connect advanced AI models like Gemini, OpenAI, Claude, OpenAI‑compatible providers, and OpenRouter (with access to over 200 models) to your translations. These engines provide higher‑quality, context‑aware translations compared to standard services like Google Translate.

How to Use It

1. In your WordPress admin, go to SkyPlugins → SkyTranslate → 一括翻訳 and open the 設定 tab. (This tab appears only when your Pro license is active.)
2. Under the “Premium AI Engines” section, select the engine you want to use by clicking its radio button: ジェミニ, OpenAI, Claude, OpenAI Compatible、または OpenRouter.
3. Enter the required API key for your chosen engine and, if needed, choose or type the model identifier.
4. クリック 設定の保存 to store your credentials. After saving, all bulk translations and editor helper features will use this selected AI engine instead of the default option.

Settings & Options

Tips & Best Practices

• Keep API keys secure – Treat your keys like passwords. Never share them or expose them in public code. Store them only in the settings provided.
• Choose the right model for your needs – For general translations, a faster model may be enough. For nuanced or technical content, try a more advanced model (e.g. Gemini 2.5 Pro or GPT‑5).
• Test with a single translation first – Before running a large bulk translation, test a small batch to verify that the engine and model produce the quality you want.
• Use OpenRouter for flexibility – With OpenRouter, you can access hundreds of models from different providers without managing separate keys. Check the model identifier format required by OpenRouter.

Custom Post Types Support (Pro)

What It Does

This feature lets you include any public custom post type in the bulk translation workflow. After you select the desired post types in Settings, they appear in the bulk translation list and gain the row-level auto-translate action.

How to Use It

1. に移動します。 SkyTranslate一括翻訳 in your WordPress admin.
2. 左下の 設定 タブに切り替えます。
3. で カスタム投稿タイプ section, check the boxes next to the public custom post types you want to translate.
4. クリック 設定の保存 to apply your selection.
5. The chosen post types will now be available in the post type filter on the Bulk Edit table and will be processed by the background translation queue.

Settings & Options

Tips & Best Practices

• Only public custom post types appear in the settings list. If a custom post type is not visible, check that it is set to public.
• After saving your changes, the new post types are immediately available for bulk translation.
• Use the post type filter on the Bulk Edit table to quickly focus on content from a specific custom post type.
• This feature requires an active Pro license. If the Settings tab is not visible, verify your license status.

WooCommerce Product Translation (Pro)

What It Does

This feature automatically extracts and translates WooCommerce product fields alongside your regular page content. It includes product titles, short descriptions, full descriptions, and variation descriptions when you use bulk translation or background translation. No extra setup is needed—the fields are handled seamlessly if WooCommerce is active and you have a valid Pro license.

How to Use It

The feature works automatically in the background. Follow these steps to use it:

1. Make sure WooCommerce is installed, activated, and you have a valid Pro license for your translation plugin.
2. Go to the Bulk Translation tool or the Background Translate feature.
3. Start the translation process as you normally would (for example, by scanning pages or running a background translation job).
4. The plugin will automatically include all WooCommerce product fields (titles, short descriptions, descriptions, and variation descriptions) in the list of translatable strings.
5. Translate the strings using the translation interface. The completed translations are saved to the translation dictionary and applied to your product pages.

Settings & Options

This feature does not have any configurable settings. It operates automatically when WooCommerce is active and a valid Pro license is present.

Tips & Best Practices

• Activate WooCommerce first: The feature only works when WooCommerce is installed and active on your site.
• Use Bulk Translation for efficiency: Run a bulk translation scan to quickly capture all product fields at once, especially if you have many products.
• Combine with Background Translate: For ongoing changes, enable background translation to keep product fields in sync without manual intervention.
• Maintain a valid Pro license: This feature is part of the Pro version—ensure your license is valid to continue using it.