Translating
From Shopp Documentation
Join our collaborative translation project and contribute your translations to the Shopp community.
Contents |
Shopp Translation Project
The Shopp Translation Project is a site setup to manage collaborative translation efforts into an online repository where translations are accessible to everyone.
Setting up an Account
To participate in the translation projection, you will need to register an account. You will receive an email with an activation link and code to activate your new translation account. When you login for the first time, be sure to sign-up to the languages you will be working on in the Shopp project.
Select the languages under My Languages to choose the languages you want to work on. Then be sure to select Shopp under the My Projects menu.
Translating
To start working on a translation, login to your account on the Shopp Translation Project and select the Shopp project link under the language you plan on working on.
Online Translating
Online tranlating works best if you plan on translating a few messages at a time. Click on the Translate tab and then click Quick Translate to work on untranslated strings. The untranslated (English) string will appear in the left column with a text entry box on the right for your translation. Click the Suggest button to submit your translation to be reviewed by the language leader. If translating the string is tricky, you may want to use the comment box to include some commentary about why you chose the wording you provided.
Offline Translating
If you are looking to translate the entire translation file, it may be easier to work on using an offline editor such as POEdit. You will need to download and install POEdit for your computer and then download the PO file you want to work on from the Shopp Translation Project.
PO files can be accessed from the language of your choice, by logging into your account, selecting the Shopp project link under the language and click the Review tab. Find the Shopp.po listing and click the Download (Option+Click the link to download the file on a Mac).
Open the Shopp.po file in POEdit and begin editing. Select the line you want to translate and enter the translated message into the textbox at the bottom. Repeat for each message. Click the Save to save your changes to the file.
When you are ready, you can submit your translated file back to the Shopp Translation Project. Login and click the Shopp project link under the appropriate language. Click the Translate tab. At the bottom, you may upload your edited PO file from your system to the Shopp Translation Project. Select the file, choose the merge the files option and click the Upload button. Be patient as processing complex PO files can take some time to process.
Private Translation
Shopp includes the lang/Shopp.pot file that provides a PO template to work from in your own private translation work. Simply use a PO editor such as POEdit to get started.
Here are some instructions for using POEdit:
- First you must download POEdit. This program is multi-platform and open source.
- Once you have POEdit up and running, copy the file Shopp.pot from wp-content/plugins/shopp/lang/ to your desktop and open it with POEdit.
- Now, select the line you wish to translate and place the translated line into the textbox at the bottom. Repeat as necessary.
- Once you have finished your translation, File->Save your work. Name it some similar to shopp-fr_FR.mo where the fr_FR would be changed to your locale name (languagecode_COUNTRYCODE, for example en_US)
- P lace the .mo file into the wp-content/plugins/shopp/lang directory.
- Now, the final step, edit your wp-config.php file and set the variable WPLANG to your new translation (see Installing & Using Translations below)
Available Translations
You can find translation files for Shopp available for download in the Extras area of shopplugin.net.
Installing & Using Translations
To install translation files you will need to download and uncompress them. The .mo file should be uploaded to your shopp/lang/ directory of your Shopp install. Then, edit the wp-config.php file in WordPress and add the WPLANG setting like so:
define('WPLANG','en_US');
The locale name should match the locale reference included in the name of the .mo file to activate it.
Make sure the translation file is named Shopp-lang.mo (eg. Shopp-sv_SE.mo).
Default Templates
Please note that to prevent confusion to theme writers, there are no gettext __() function calls in the default templates. This means that for a translation to be complete for a new site, the templates will have to be modified manually.

