WP RSS Aggregator has been translated into a number of languages and we are always adding new languages to the list. This is a guide for those wishing to contribute a new translation.
You’ll need some specific tools to prepare translation files for WP RSS Aggregator and it’s add-ons. If you’re experienced with translating WordPress plugins, you likely already have the necessary tools installed. If you aren’t you should download and install a translation tool like Poedit. This document will walk you through creating translations using Poedit.
Creating a New Translation
Translations are created by building off a PO file. The PO file is used by translation tools and contains all the strings that need to be translated. In WP RSS Aggregator and its plugins, the file is called default.po and it is stored in the languages directory.
To view the contents of the PO file:
- Launch Poedit
- Select File > New From POT/PO File…
- Open the default.po file for the add-on you’re translating. E.g., wp-rss-feed-to-post/languages/default.po
- Select the language you’ll be translating into from the box that appears.
Poedit should then load and display the strings. The following image shows Poedit after starting a new Czech language translation for the Feed to Post add-on.
The screen is divided into two columns showing the source text (in English) and the translated strings. Also note that the correct filename (visible in the title bar) for that language is generated by Poedit.
Translating the Strings
The Source text and Translation text areas on the bottom of the screen will be updated when a new row and string are selected. Enter your translation in the Translation text area and press Cmd+Enter or Ctrl+Enter to save and move to the next string.
After you translate all the strings, click the Validate button (the left-most button in the toolbar) to ensure all translations are valid. Once there are no problems, you're ready to create the MO file that will contain your translation.
The MO File
The file created when saving a translation in Poedit is another .po file. This is the file that Poedit reads and modifies as you edit your translation. However, WordPress uses a compressed version of the .po file, which has a .mo extension. When you're finished with your translation, ensure the Automatically compile MO file when saving checkbox is set in the Poedit Preferences panel. While you're there, make sure to fill out the Name and Email fields with your information.
Save your translation and send the .po and .mo files to the WP RSS Aggregator team via the submissions form below.