simogol

<p>Polyglot helps administrators run controlled translation jobs from Tools > Polyglot for:</p>
<ul>
<li>Polylang String Translations</li>
<li>Pages, Posts, and public Custom Post Types (CPTs)</li>
</ul>
<p>The plugin is designed for safe, incremental translation workflows and does not create missing translated posts.</p>
<p>Polyglot is built for projects that use WordPress as a CMS with a clear separation between content and presentation (for example, headless WordPress setups). It is not recommended for page-builder-heavy workflows (such as Elementor) where content and presentation are tightly coupled.</p>
<h4>Configuration</h4>
<ul>
<li>Save Google API key in WordPress admin</li>
<li>API key is stored encrypted in WordPress options</li>
<li>Tabs are locked until an API key is configured</li>
</ul>
<h4>Translation Strings tab</h4>
<ul>
<li>Select Polylang string group</li>
<li>Select source and target languages</li>
<li>Translate only missing target-language string values</li>
<li>Background queue processing with live progress</li>
</ul>
<h4>Pages, Posts and CPT tab</h4>
<ul>
<li>Select one content type (page, post, or one public CPT)</li>
<li>Select source and target languages</li>
<li>Choose translation scope:
<ul>
<li>default content only (title, content, excerpt)</li>
<li>default content + custom fields</li>
</ul>
</li>
<li>Custom field mode includes:
<ul>
<li>inline preview of custom field names that Polyglot will attempt to translate</li>
<li>explicit risk acknowledgment checkbox before job start</li>
</ul>
</li>
</ul>
<h4>Translation rules</h4>
<p>For each eligible source/target pair, a field is translated only when:</p>
<ul>
<li>target value equals source value, or</li>
<li>source value is non-empty and target value is empty.</li>
</ul>
<p>If target has different non-empty content, it is treated as edited and skipped.</p>
<h4>Custom field safety</h4>
<p>When custom-field translation is enabled, Polyglot auto-detects non-protected meta keys and applies safeguards:</p>
<ul>
<li>skips protected/internal keys</li>
<li>skips technical key patterns (for example id, slug, token, url, hash)</li>
<li>skips values that look serialized/JSON/URL/numeric/token-like</li>
<li>supports exclusion hook: <code>polyglot_excluded_meta_keys</code></li>
</ul>
<p>Default excluded keys currently include:</p>
<ul>
<li>item_author</li>
</ul>
<h4>Job processing and progress</h4>
<ul>
<li>Jobs run in background batches using WP-Cron</li>
<li>Progress view includes status, remaining, scanned, translatable, translated, skipped, failed, and last error</li>
<li>If no eligible fields are found, Polyglot shows a success notice and does not start a queue</li>
</ul>
<h4>Troubleshooting failed jobs</h4>
<p>If a job ends with done_with_errors, open the Job Progress panel and review the Failure details list.<br />
Each row includes:</p>
<ul>
<li>Error category ([API], [SAVE], [OTHER])</li>
<li>Error message</li>
<li>Related identifiers (field key, language, post IDs, or string name)</li>
</ul>
<p>To inspect raw job data directly:</p>
<ul>
<li>wp option get polyglot_translation_job –format=json</li>
</ul>
<p>Key fields:</p>
<ul>
<li>status</li>
<li>last_error</li>
<li>totals.failed</li>
<li>errors[]</li>
</ul>
<p>If errors are API-related, verify:</p>
<ul>
<li>Cloud Translation API is enabled in the same Google Cloud project used by the key</li>
<li>Billing is enabled for that project</li>
<li>API key restrictions allow this WordPress instance (referrer/IP restrictions and API restriction to Cloud Translation API)</li>
</ul>
<h4>Important billing notice</h4>
<p>Google Cloud Translation API is a paid service with usage-based pricing.</p>
<ul>
<li>Large translation jobs can generate significant costs</li>
<li>Review quotas, billing settings, and pricing before running bulk jobs</li>
</ul>
<h4>Disclaimer</h4>
<p>Polyglot is provided as is, without any warranty of any kind.</p>
<ul>
<li>Use this plugin at your own risk.</li>
<li>Always create a full database and files backup before running translation jobs.</li>
<li>Translation jobs can modify content and custom fields; review your settings and previews carefully before starting.</li>
<li>The plugin author is not liable for data loss, site issues, translation quality issues, or other damages resulting from use.</li>
</ul>
<h3>External services</h3>
<p>This plugin relies on Google Cloud Translation API (Basic v2) to perform automated translations. The service is the only third-party endpoint contacted by the plugin.</p>
<p>What it is used for:</p>
<ul>
<li>Translating Polylang String Translation entries on demand.</li>
<li>Translating post/page/CPT title, content, excerpt, and (when explicitly enabled) selected custom field values on demand.</li>
<li>Validating the saved API key by calling the languages list endpoint when the administrator clicks “Test Saved API Key”.</li>
</ul>
<p>What data is sent and when:</p>
<ul>
<li>Each translation request sends the source text, the source language code, and the target language code to https://translation.googleapis.com/language/translate/v2 along with the configured API key in the request URL. Requests are made only while a translation job is processing or when the administrator clicks “Test Saved API Key”.</li>
<li>The validation request sends only the API key to https://translation.googleapis.com/language/translate/v2/languages.</li>
<li>No personal data, user identifiers, IP addresses, or site visitor data are sent by the plugin. Standard HTTP request metadata (such as referrer set to the site URL) is included so the API key can be restricted by HTTP referrer in Google Cloud.</li>
</ul>
<p>Service provider: Google LLC. By using this plugin you agree to Google Cloud’s terms.</p>
<ul>
<li>Google Cloud Terms of Service: https://cloud.google.com/terms</li>
<li>Google Privacy Policy: https://policies.google.com/privacy</li>
<li>Google Cloud Translation documentation: https://cloud.google.com/translate/docs</li>
</ul>


Polyglot for Polylang

Automatically translate Polylang strings and content using Google Cloud Translation API (Basic v2).

31416k

<p>This plugin allows you to add a language selector to your WordPress site, leveraging Google Translate technology to automatically translate pages. This plugin relies on the external service Google Translate; see the “External Services” section below for what data is sent, when, and links to Google’s terms and privacy policy.</p>
<p>Features:<br />
– Language selector in navigation menu<br />
– Floating selector option<br />
– Shortcode to insert anywhere<br />
– Support for multiple languages<br />
– Easy configuration from admin panel<br />
– Uses Google Translate for automatic translation</p>
<h3>Configuration</h3>
<ol>
<li>Go to ‘Settings’ > ‘Translate3K’</li>
<li>Select the languages you want to enable</li>
<li>Choose the selector position (menu, floating, or both)</li>
<li>Select the selector style</li>
<li>Save changes</li>
</ol>
<h3>Shortcode Usage</h3>
<p>You can use [language_selector] in:<br />
– Pages or posts<br />
– Text widgets<br />
– Theme templates<br />
– Any area that supports shortcodes</p>
<h3>Menu Support</h3>
<p>The selector will be automatically added to the end of the main menu. To disable this and use only the shortcode, select “Shortcode only” in the options.</p>
<h3>Notes</h3>
<ul>
<li>This plugin uses the free Google Translate service</li>
<li>Translations are performed by Google and may not be perfect</li>
<li>Recommended for sites with static content</li>
<li>For e-commerce or dynamic sites, consider a professional translation plugin</li>
</ul>
<h3>External Services</h3>
<p>This plugin uses the following third-party service. By using the plugin, you and your site visitors accept that this service may receive data as described below.</p>
<ul>
<li>
<p>Google Translate (translate.google.com)</p>
</li>
<li>
<p>What it is used for: The plugin loads Google Translate on your site so that visitors can choose a language and see the page content translated. Translation is done by Google in the visitor’s browser.</p>
</li>
<li>
<p>What data is sent and when: When a visitor loads a page that shows the language selector, the plugin loads a script from Google (translate.google.com). When the visitor selects a language other than the default, the visible page content may be sent to Google’s servers to be translated. This includes the text and structure of the page that the visitor is viewing. No data is sent until the visitor uses the language selector. The plugin does not send personal data to Google on behalf of the site owner; any data sent is the same as when a visitor uses translate.google.com directly.</p>
</li>
<li>
<p>Terms of Service: https://policies.google.com/terms</p>
</li>
<li>Privacy Policy: https://policies.google.com/privacy</li>
</ul>


Translate3K – Browser Language Switcher

Adds a language selector for automatic page translation using Google Translate.

Polyglot for Polylang vs Translate3K – Browser Language Switcher