CSV Format for GlotPress

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 () 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

1. Go to the bottom of the translation table.
2. Select CSV (.csv).
3. Click on the Export link to download the CSV file.

Import translations from CSV

1. Go to the bottom of the translation table.
2. Click on the Import Translations link.
3. Select the CSV file to upload, the Format is Auto Detected.
4. Click on the Import button.

Import originals from CSV

1. Go to the project page.
2. On the project actions click on the Import Originals link.
3. Select the CSV file to upload, the Format is Auto Detected.
4. Click on the Import button.

Unreleased

• Tested with WordPress 6.8.

1.0.3

• Require WP 5.1.
• Tested with WordPress 6.6.
• Tested with GlotPress 4.0.1.
• Tested with PHP 8.3.
• Removed Git Updater forbiden plugin header.
• Fix docblock type param.
• Update dependencies.

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.