The language strings for UpStream are located in 3 places:
- The main UpStream plugin
- The UpStream extensions
- The UpStream settings
In this guide, we’ll show you how to translate the UpStream extensions.
We recommend Poedit as a way to translate UpStream. Here’s how the translation process works:
- Download Poedit from poedit.net
- Run the installation script for Poedit on your desktop. Click “Create New Translation”.
- Download UpStream to your desktop.
- Select one of the existing .po files from the /languages/ folder.
- Choose the language for your translation:
You will see a list of all the English translations. On the right-hand side there’s a blank space waiting for your translation:
- At the bottom of the screen, you can enter your translation text into the “Translation” field:
- PoEdit is a particularly useful tool because it will automatically give you translation suggestions:
- When you’re finished, click “Save” in Poedit:
- Poedit will export both a .po and an .mo file for you.
- Place these in the /wp-content/languages/upstream/ folder. Create this folder if it doesn’t exist.
IMPORTANT: please note that this folder is not inside the main /upstream/ plugin folder. If you place your translation files there, they will be deleted when the UpStream plugin updates.
- For the files, use the naming structure you can see below. You can find a list of locale identifiers here.
- If your site is running your language (in this case, Spanish), UpStream will automatically detect your new files and change to your language: