Description
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.
The CSV Format
The CSV output has values separated by ,
and enclosured by " "
.
The total number of columns depends on the number of Plural Forms of the exported Locale.
For an sample file, please check out example.csv.
The header columns for the different translations have the Translation (<plural-form>)
naming convention, being the Plural Forms depending on each exported Locale.
See the example below for a Portuguese CSV export, which has 2
plural forms.
The exported CSV in plain text
"Context","Singular","Plural","Comments","References","Translation (Singular)","Translation (Plural)"
"","Singular in English.","","Comment 1.\nComment 2.","","Singular em Português.",""
The main columns
The 5 main columns are Context
, Singular
, Plural
, Comments
and References
.
The Plural Forms variable columns
The number of Plural Forms columns may vary depending on each Locale setting.
Check the below table for examples of GlotPress Locales from 1 to 6 Plural Forms.
Included filters
The gp_format_csv_header
allows you to add, remove or customize items from the CSV header.
The gp_format_csv_row
allows you to add, remove or customize items from the CSV row.
Usage
Export translations to CSV
- Go to the bottom of the translation table.
- Select
CSV (.csv)
. - Click on the
Export
link to download the CSV file.
Import translations from CSV
- Go to the bottom of the translation table.
- Click on the
Import Translations
link. - Select the CSV file to upload, the
Format
is Auto Detected. - Click on the
Import
button.
Import originals from CSV
- Go to the project page.
- On the project actions click on the
Import Originals
link. - Select the CSV file to upload, the
Format
is Auto Detected. - Click on the
Import
button.
FAQ
-
Can I help translating this plugin to my own language?
-
Yes you can! If you want to translate this plugin to your language, please click here.
-
Can I contribute to this plugin?
-
Sure! You are welcome to report any issues or add feature suggestions on the GitHub repository.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“CSV Format for GlotPress” is open source software. The following people have contributed to this plugin.
Contributors“CSV Format for GlotPress” has been translated into 4 locales. Thank you to the translators for their contributions.
Translate “CSV Format for GlotPress” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.2
- Tested with WordPress 6.5.
- Tested with GlotPress 4.0.
- Tested with PHP 8.3.
- Add WP Plugin Check CI test.
- Update dependencies.
1.0.1
- Fix log error message typo. Props @fxbenard.
1.0.0
- Initial release.
- All WPCS and PHPStan level 9 verified.