Pedro Mendonça

Adds the CSV format to GlotPress to export/import translations and originals.
This allows you to export a translation set to a CSV file, and use this to import the translations or originals into the project.
This plugin is properly prepared for localization.
<h3>The CSV Format</h3>
The CSV output has values separated by <code>,</code> and enclosured by <code>" "</code>.
The total number of columns depends on the number of Plural Forms of the exported Locale.
For an sample file, please check out <a href="https://github.com/pedro-mendonca/GP-Format-CSV/blob/main/example.csv" rel="nofollow ugc">example.csv</a>.
The header columns for the different translations have the <code>Translation (<plural-form>)</code> naming convention, being the Plural Forms depending on each exported Locale.
See the example below for a Portuguese CSV export, which has <code>2</code> plural forms.
<h4>The exported CSV in plain text</h4>
<pre><code>"Context","Singular","Plural","Comments","References","Translation (Singular)","Translation (Plural)"
"","Singular in English.","","Comment 1.\nComment 2.","","Singular em Português.",""
</code></pre>
<h4>The main columns</h4>
The 5 main columns are <code>Context</code>, <code>Singular</code>, <code>Plural</code>, <code>Comments</code> and <code>References</code>.
<h4>The Plural Forms variable columns</h4>
The number of Plural Forms columns may vary depending on each Locale setting.
Check the below table for examples of <a href="https://github.com/GlotPress/GlotPress/blob/develop/locales/locales.php" rel="nofollow ugc">GlotPress Locales</a> from 1 to 6 Plural Forms.
<h3>Included filters</h3>
The <code>gp_format_csv_header</code> allows you to add, remove or customize items from the CSV header.
The <code>gp_format_csv_row</code> allows you to add, remove or customize items from the CSV row.
<h3>Usage</h3>
<h4>Export translations to CSV</h4>
<ol>
<li>Go to the bottom of the translation table.</li>
<li>Select <code>CSV (.csv)</code>.</li>
<li>Click on the <code>Export</code> link to download the CSV file.</li>
</ol>
<h4>Import translations from CSV</h4>
<ol>
<li>Go to the bottom of the translation table.</li>
<li>Click on the <code>Import Translations</code> link.</li>
<li>Select the CSV file to upload, the <code>Format</code> is Auto Detected.</li>
<li>Click on the <code>Import</code> button.</li>
</ol>
<h4>Import originals from CSV</h4>
<ol>
<li>Go to the project page.</li>
<li>On the project actions click on the <code>Import Originals</code> link.</li>
<li>Select the CSV file to upload, the <code>Format</code> is Auto Detected.</li>
<li>Click on the <code>Import</code> button.</li>
</ol>

CSV Format for GlotPress

Adds the CSV format to GlotPress to export/import translations and originals.

Greg Ross

A machine translate plugin for <a href="https://github.com/GlotPress/GlotPress" rel="nofollow ugc">GlotPress as a WordPress plugin</a>.
Four machine translation providers are supported:
<ul>
<li>DeepL Free (500k character free limit per month with account, but no cost)</li>
<li>DeepL Pro (pay per character, Pro account required)</li>
<li>Google Translate (pay per character)</li>
<li>Microsoft Translator (free tier available)</li>
<li>Yandex.Translate (free but requires Yandex account)</li>
</ul>
Note: This plugin assumes the source language is English as support for automated translation from other source languages is limited.
<h4>Configuration</h4>
Once you have installed GP Machine Translate, go to your WordPress admin screen and select “Settings > GP Machine Translate”.
You will have four fields to configure:
<pre><code>1. Translation Provider
2. Display extra info
3. Global API Key
4. Client ID
</code></pre>
You can select from providers with some requiring the additional fields to be filled in.
<h4>DeepL Free</h4>
DeepL has a free tier that allows you to access the API for 500k characters per month. Additional characters require a DeepL API Pro (aka paid) account.
<ul>
<li>Login/signup <a href="https://www.deepl.com/" rel="nofollow ugc">DeepL API</a></li>
<li>Go to your account and scroll down to <a href="https://www.deepl.com/pro-account/summary" rel="nofollow ugc">Authentication Key for DeepL API</a></li>
<li>Copy the <code>Authentication Key</code> and put it into <code>Global API Key</code> of GP Machine Translate.</li>
</ul>
Note also that DeepL allows for a maximum of 50 strings to be translated at once, so keep that in mind when doing bulk translations and only selected at most 50 strings.
<h4>DeepL Pro</h4>
DeepL has a Pro tier that allows you to access the API on a pay per character basis.
<ul>
<li>Login/signup <a href="https://www.deepl.com/" rel="nofollow ugc">DeepL API</a></li>
<li>Go to your account and scroll down to <a href="https://www.deepl.com/pro-account/summary" rel="nofollow ugc">Authentication Key for DeepL API</a></li>
<li>Copy the <code>Authentication Key</code> and put it into <code>Global API Key</code> of GP Machine Translate.</li>
</ul>
Note also that DeepL allows for a maximum of 50 strings to be translated at once, so keep that in mind when doing bulk translations and only selected at most 50 strings.
<h4>Google</h4>
Google Translate requires an API key to function, to do this you must register with Google and provide a payment method.
<ul>
<li>Login/signup your <a href="http://console.developer.google.com" rel="nofollow ugc">Google developers console</a></li>
<li>Select “APIs & auth”->Credentials.</li>
<li>Create a new “Public API access” key.</li>
</ul>
The public access key is what you will use to configure GP Machine Translate with, either for all users or a specific user.
<h4>Microsoft Translator</h4>
Microsoft Translator requires an API key to function, to do this you must register with Microsoft. Microsoft does have a free tier for translation, limited to 2 million characters a month so you do not need to provide payment details for this tier.
Microsoft has a walk through on how to subscribe to the Translator service here:
<pre><code>https://www.microsoft.com/en-us/translator/getstarted.aspx
</code></pre>
You will need both the client secret and client id for it to function with GP Machine Translate.
<h4>transltr.org</h4>
This service no longer exists and has been removed from the plugin.
<h4>Yandex.Translate</h4>
Yandex.Translate is a free service, however you must sign up to their service and adhere to their terms of service. This includes providing a link back to the service for translated text.
One other thing to note with Yandex.Translate is that when you sign up, you get a Yandex e-mail address and other services they provide and there is no option to opt out of them.
To get an API key, follow the instructions here:
<pre><code>https://tech.yandex.com/translate/
</code></pre>
<a href="http://translate.yandex.com/" rel="nofollow ugc">Powered by Yandex.Translate</a>.
<h4>Setting the API key</h4>
To set the API key for all users, go to the WordPress Dashboard, then Settings, then “GP Machine Translate” and set the API key (and Client ID if required).
To set if for a specific user, go to the users profile and scroll down to the “GP Machine Translate” section and set the API key (and Client ID if required).
Note, if both a global and user API key are set, the user API key will override the global API key.
<h4>Supported Languages by Provider</h4>
 DeepL 
 DeepL Pro 
 Google Translate 
 Microsoft Translator 
 Yandex.Translate
 Arabic 
 Arabic 
 Afrikaans 
 Afrikaans 
 Catalan
 Bulgarian 
 Bulgarian 
 Albanian 
 Arabic 
 Czech
 Czech 
 Czech 
 Arabic 
 Bosnian 
 Danish
 Danish 
 Danish 
 Armenian 
 Bulgarian 
 Dutch
 Dutch 
 Dutch 
 Azerbaijani 
 Catalan 
 Estonian
 English 
 English 
 Basque 
 Croatian 
 Finnish
 Estonian 
 Estonian 
 Bosnian 
 Czech 
 French (France)
 Finnish 
 Finnish 
 Bulgarian 
 Danish 
 German
 French (France) 
 French (France) 
 Catalan 
 Dutch 
 Greek
 German 
 German 
 Croatian 
 Estonian 
 Hungarian
 Greek 
 Greek 
 Czech 
 Finnish 
 Italian
 Hungarian 
 Hungarian 
 Danish 
 French (France) 
 Latvian
 Indonesian 
 Indonesian 
 Dutch 
 German 
 Lithuanian
 Italian 
 Italian 
 English 
 Greek 
 Macedonian
 Japanese 
 Japanese 
 Esperanto 
 Hebrew 
 Norwegian
 Korean 
 Korean 
 Estonian 
 Hindi 
 Portuguese (Portugal)
 Latvian 
 Latvian 
 Finnish 
 Hungarian 
 Russian
 Lithuanian 
 Lithuanian 
 French (France) 
 Indonesian 
 Slovak
 Norwegian 
 Norwegian 
 Galician 
 Italian 
 Slovenian
 Norwegian (Bokmål) 
 Norwegian (Bokmål) 
 Georgian 
 Japanese 
 Spanish (Spain)
 Polish 
 Polish 
 German 
 Klingon 
 Swedish
 Portuguese (Portugal) 
 Portuguese (Portugal) 
 Greek 
 Korean 
 Turkish
 Romanian 
 Romanian 
 Gujarati 
 Latvian 
 Ukrainian
 Russian 
 Russian 
 Hausa (Arabic) 
 Lithuanian
 Slovak 
 Slovak 
 Hebrew 
 Malay
 Slovenian 
 Slovenian 
 Hindi 
 Norwegian
 Spanish (Spain) 
 Spanish (Spain) 
 Hungarian 
 Persian
 Swedish 
 Swedish 
 Icelandic 
 Polish
 Turkish 
 Turkish 
 Indonesian 
 Portuguese (Portugal)
 Ukrainian 
 Ukrainian 
 Irish 
 Romanian
 Italian 
 Russian
 Japanese 
 Serbian
 Javanese 
 Slovak
 Kannada 
 Slovenian
 Kazakh 
 Spanish (Spain)
 Khmer 
 Swahili
 Korean 
 Swedish
 Lao 
 Thai
 Latin 
 Turkish
 Latvian 
 Ukrainian
 Lithuanian 
 Urdu
 Macedonian 
 Vietnamese
 Malagasy 
 Welsh
 Malay
 Malayalam
 Maori
 Marathi
 Mongolian
 Nepali
 Norwegian
 Norwegian (Bokmål)
 Norwegian (Nynorsk)
 Panjabi (India)
 Persian
 Polish
 Portuguese (Portugal)
 Romanian
 Russian
 Scottish Gaelic
 Serbian
 Sinhala
 Slovak
 Slovenian
 Somali
 Spanish (Spain)
 Sundanese
 Swahili
 Swedish
 Tagalog
 Tajik
 Tamil
 Telugu
 Thai
 Turkish
 Ukrainian
 Urdu
 Uzbek
 Vietnamese
 Welsh
 Yiddish
 Yoruba

GP Machine Translate

This is a most wanted function for GlotPress - I am glad someone implemented it! Easy to use, either in batch or individually.



Does what is should

A machine translate plugin for GlotPress as a WordPress plugin.

CSV Format for GlotPress vs GP Machine Translate