{"id":4074,"date":"2012-04-09T17:38:57","date_gmt":"2012-04-10T00:38:57","guid":{"rendered":"http:\/\/www.ait-pro.com\/aitpro-blog\/?p=4074"},"modified":"2012-11-13T12:20:48","modified_gmt":"2012-11-13T19:20:48","slug":"wordpress-plugin-language-translation-tutorial-translating-a-wordpress-plugin-using-poedit","status":"publish","type":"post","link":"https:\/\/www.ait-pro.com\/aitpro-blog\/4074\/misc-projects\/wordpress-tips-tricks-fixes\/wordpress-plugin-language-translation-tutorial-translating-a-wordpress-plugin-using-poedit\/","title":{"rendered":"WordPress Plugin Language Translation Tutorial – Translating A WordPress Plugin Using Poedit"},"content":{"rendered":"
\n

WordPress Language Translation .po and .mo files are not necessary to translate the BulletProof Security plugin\u2019s English language into your language. Please click the BulletProof Security Forum Topic link below to find out how to use the Google Chrome Browser to automatically translate the English text in the BulletProof Security plugin into your language.<\/strong><\/span><\/p>\n

http:\/\/forum.ait-pro.com\/forums\/topic\/bulletproof-security-language-translation-google-chrome-automatic-language-translation-for-plugins\/<\/a><\/p>\n

 <\/p>\n

This\u00a0WordPress Plugin Language Translation Tutorial is using the BulletProof Security WordPress plugin as the example for this tutorial. \u00a0The same Poedit language translation techniques would be used to translate other WordPress plugins. \u00a0There are 2 language translation methods shown in this tutorial. \u00a0The second method is probably the simpler and faster method –\u00a0New Catalog from POT file… Plugin Language Translation – Method 2<\/strong><\/span>.<\/p>\n

Language Translation Tutorial For The BulletProof Security Plugin With Poedit
\u00a0 <\/strong><\/span><\/h2>\n

New Catalog… Plugin Language Translation – Method 1
\u00a0<\/strong><\/span><\/h2>\n

Download the bulletproof-security.zip file and the Poedit .po editing software<\/span><\/strong><\/span><\/h2>\n

1.<\/span><\/strong>\u00a0Download the BulletProof Security zip file to your computer from WordPress.org here
http:\/\/wordpress.org\/extend\/plugins\/bulletproof-security\/<\/a>
The zip file name will be bulletproof-security.0.47.zip (or whatever version of BPS that you will be translating).<\/p>\n

2.<\/span><\/strong><\/span> Unzip the zip file to your C: Drive. This will create a folder called bulletproof-security. C:\\bulletproof-security.<\/p>\n

3.<\/span><\/strong><\/span> Download and install Poedit from here http:\/\/www.poedit.net\/download.php<\/a>.<\/p>\n

Set up Poedit to Translate the BulletProof Security plugin into your language<\/span><\/h2>\n

4.<\/strong><\/span> Open Poedit, click on the File menu, click on New catalog… you will see this window below.<\/p>\n

\"Poedit<\/a><\/p>\n

5.<\/strong><\/span> For Project name and version: type in bulletproof-security and then choose your Language and Country and type in your Team and Team’s email address.<\/p>\n

6.<\/strong><\/span> Click on the Paths tab. Click on the New Item button and type in the path to the bulletproof-security folder the unzipped on your computer. Very Important!<\/strong><\/span> After typing in the path to the bulletproof-security folder you need to click anywhere in the white area below the path you just entered in order for the path to be saved. See the next screenshot with an arrow pointing to the white area below the path you just entered. The blue box should disappear, which will indicate that the path is saved. This also applies to adding New items to the Keywords Tab as well.<\/p>\n

\"Poedit<\/a><\/p>\n

\"Poedit<\/a><\/p>\n

7.<\/strong><\/span> \u00a0Click on Keywords tab. \u00a0Click on the New item button and add _e (underscore e), then add __ \u00a0(double underscores) and click the OK button. \u00a0Very Important!<\/strong><\/span> After typing in the _e and __ New items you need to click anywhere in the white area below just like you did on the Paths tab to save your path. \u00a0The blue box should disappear, which will indicate that both of your New items are saved.\u00a0<\/p>\n

\"Poedit<\/a><\/p>\n

Creating and naming your .po file<\/span><\/strong><\/span><\/h2>\n

8.<\/strong><\/span> When you click the OK button a file explorer window will automatically open. Navigate to the bulletproof-security folder you unzipped on your computer. You will be saving your new .po file using the naming convention shown below. In this example I am creating a Spanish .po translation file using the naming convention of bulletproof-security-es_ES.po. Very Important!<\/strong><\/span> The naming convention for your .po file is composed of a Language Code and a Country Code. The lower case “es” is for the Spanish language and the upper case “ES” is for Spain. For a German .po file for BPS the file name would be bulletproof-security-de_DE.po. Your .mo file will automatically be created by Poedit and named using the same naming convention of your .po file automatically.<\/p>\n

Find Your Language Code and Country Code For Naming Your .po File<\/span><\/strong>
http:\/\/www.gnu.org\/software\/gettext\/manual\/html_chapter\/gettext_16.html#Language-Codes<\/a><\/p>\n

\"Poedit<\/a><\/p>\n

Poedit Updating catalog…<\/strong><\/span><\/h2>\n

9.<\/strong><\/span> If you have done everything correctly then when you click the Save button you should see an Updating catalog… window and then an Update summary window pop up. When you click the OK button you will now see BulletProof Security plugin text strings ready for translation. See next screenshot.<\/p>\n

\"Poedit<\/a><\/p>\n

Translating the BulletProof Security Plugin Text Strings<\/strong><\/span><\/h2>\n

10.<\/strong><\/span> After clicking the OK button you will see the BulletProof Security plugin text strings ready for translation.<\/p>\n

\"Poedit<\/a><\/p>\n

Translating the BulletProof Security Plugin Text Strings Continued<\/strong><\/span><\/h2>\n

11.<\/span><\/strong><\/span> To translate each text string you will click on it and then enter the translation of the text string in the bottom text area. In this example I have translated the English word “Settings” to the Spanish word “Configuraci\u00f3n”. In the right Translation window you will see your translated words. Once you have completed translating all the English text strings into your language you will then click the File menu and click Save. This will save your .po file and also save your .mo file that was automatically created by Poedit. \u00a0<\/p>\n

To speed up the language translation process, you can use the Google Language Translator. \u00a0Copy the original text to be translated into Google Translate and then make any corrections to the translation directly within the Google Translator window. \u00a0Your corrections will be remembered so that any other similar translations will not need to be corrected. \u00a0Then copy the translated text back into Poedit. \u00a0This is a huge time saver since you would not need to actually type in the text translation and would instead just be doing a copy and paste from Google Translate to Poedit.<\/p>\n

In this example for creating Spanish translation files for BPS, the 2 files are named: bulletproof-security-es_ES.po and bulletproof-security-es_ES.mo. If you were translating BPS into German the 2 files would be named: bulletproof-security-de_DE.po and bulletproof-security-de_DE.mo.<\/p>\n

Important Note:<\/strong><\/span>\u00a0 for text strings that contain %s please include those in your translated text.
Example:<\/strong><\/span>
Original string:<\/strong><\/span> Downloaded %s times
Translation:<\/strong><\/span> Descargado %s veces<\/p>\n

Send your completed .po and .mo BulletProof Security plugin translation files to info[at]ait-pro[dot]com.<\/p>\n

\"Poedit<\/a><\/p>\n

Troubleshooting<\/span><\/strong><\/span><\/h2>\n

If something is not set up correctly and you did not see the BulletProof Security plugin text strings you can manually check your Poedit settings by clicking on the Catalog menu and then click Settings… where you can check the Project info, Paths and Keywords Tabs for incorrect settings.<\/p>\n

\"Poedit<\/a><\/p>\n

To manually run another check for translatable text strings in the BulletProof Security php plugin files you can click on Update catalog button on the Poedit toolbar.<\/p>\n

\"Poedit<\/a><\/p>\n

 <\/p>\n

Language Translation Tutorial For The BulletProof Security Plugin With Poedit
\u00a0<\/strong><\/span><\/h2>\n

New Catalog from POT file… Plugin Language Translation – Method 2
\u00a0<\/strong><\/span><\/h2>\n

Download the bulletproof-security.zip file and the Poedit .po editing software<\/span><\/strong><\/h2>\n

1.<\/span><\/strong><\/span> Download the BulletProof Security zip file to your computer from WordPress.org here
http:\/\/wordpress.org\/extend\/plugins\/bulletproof-security\/<\/a>
The zip file name will be bulletproof-security.0.47.zip (or whatever version of BPS that you will be translating).<\/p>\n

2.<\/strong><\/span> Unzip the zip file to your C: Drive. In this tutorial the folder name I used is: \u00a0C:\\BPS47.<\/p>\n

3.<\/strong><\/span> Download and install Poedit from here http:\/\/www.poedit.net\/download.php.<\/p>\n

4.<\/span><\/strong><\/span>\u00a0Open Poedit, click the File menu and click New Catalog from POT file… \u00a0The Open catalog template window will open. \u00a0Navigate to the folder where you unzipped the \u00a0zip file you downloaded and click on the bulletproof-security.pot file and click the Open button. \u00a0For this example the folder path is: \u00a0C:\\BPS47\\languages.<\/p>\n

\"Poedit<\/a><\/p>\n

\"Poedit<\/a><\/p>\n

5.<\/strong><\/span>\u00a0After clicking the Open button the Poedit Settings window will open to the Project info Tab. \u00a0Enter your Team name, Team’s email address, choose the Language that you will be translating the plugin too and choose the Country that is associated with the language translation. \u00a0You only need to enter in the Project info information and click the OK button. \u00a0The Paths and Keywords Tabs already contain the correct information and do not require additional changes by you.<\/p>\n

\"Poedit<\/a><\/p>\n

\"Poedit<\/a><\/p>\n

6.<\/strong><\/span>\u00a0After clicking the OK button a Save as… window will open. \u00a0Type in the name of your new .po file. \u00a0For this example I am creating a Spanish .po language translation file. \u00a0So the name of the file will be: \u00a0bulletproof-security-es_ES.po and then click Save. \u00a0<\/p>\n

Very Important!<\/strong><\/span> The naming convention for your .po file is composed of a Language Code and a Country Code. The lower case “es” is for the Spanish language and the upper case “ES” is for Spain. For a German .po file for BPS the file name would be bulletproof-security-de_DE.po. Your .mo file will automatically be created by Poedit and named using the same naming convention of your .po file automatically.<\/p>\n

Find Your Language Code and Country Code For Naming Your .po File<\/strong><\/span>
http:\/\/www.gnu.org\/software\/gettext\/manual\/html_chapter\/gettext_16.html#Language-Codes<\/p>\n

\"Poedit<\/a><\/p>\n

7.<\/span><\/strong><\/span> After clicking Save you will now see the BulletProof Security plugin text strings ready for language translation.<\/p>\n

\"Poedit<\/a><\/p>\n

8.<\/span><\/strong><\/span> See Step 11.<\/span><\/strong><\/span> above – Translating the BulletProof Security Plugin Text Strings Continued<\/strong><\/span><\/p>\n

More Help Resources<\/strong><\/span><\/p>\n

http:\/\/www.appthemes.com\/blog\/how-to-translate-a-wordpress-theme\/<\/a><\/p>\n

http:\/\/codex.wordpress.org\/User:Skippy\/Creating_POT_Files<\/a><\/p>\n

http:\/\/codex.wordpress.org\/I18n_for_WordPress_Developers<\/a><\/p>\n

http:\/\/codex.wordpress.org\/Translating_WordPress<\/a><\/p>\n

\u00a0<\/h2>\n

Bonus WordPress Language Translation Tutorial – checking .po and .mo files<\/strong><\/span><\/h2>\n

Quickly switch WP Dashboard admin languages with a single click without having to modify the wp-config.php file. \u00a0This comes in real handy if you are checking language translation .po and .mo files for errors.<\/p>\n

1.<\/strong><\/span> Install the WP Native Dashboard plugin –\u00a0http:\/\/wordpress.org\/extend\/plugins\/wp-native-dashboard\/<\/a><\/p>\n

2.<\/strong><\/span> Download the WordPress version in the language you want –\u00a0http:\/\/codex.wordpress.org\/WordPress_in_Your_Language<\/a><\/p>\n

3.<\/strong><\/span> Unzip the WordPress Language version you downloaded to your computer and copy the \/wp-content\/languages .po and .mo files to your WordPress website’s \/wp-content\/languages folder. \u00a0If the languages folder does not exist in your website’s wp-content folder then create it or just copy the entire languages folder from the WordPress language version that you downloaded and unzipped to your website’s wp-content folder.<\/p>\n

4.<\/strong><\/span> Click on the Native Dashboard link under the Settings Panel and on the options page under Installed Languages you should now see the particular language that you just added to your website’s \/wp-content folder.<\/p>\n

5.<\/strong><\/span> \u00a0To switch languages click on the top left corner of your WP Admin bar where you will see a drop down list of available languages to choose from.<\/p>\n

 <\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

WordPress Language Translation .po and .mo files are not necessary to translate the BulletProof Security plugin\u2019s English language into your language. Please click the BulletProof Security Forum Topic link below to find out how to use the Google Chrome Browser to automatically translate the English text in the BulletProof Security plugin into your language. http:\/\/forum.ait-pro.com\/forums\/topic\/bulletproof-security-language-translation-google-chrome-automatic-language-translation-for-plugins\/ […]<\/p>\n","protected":false},"author":167,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_links_to":"","_links_to_target":""},"categories":[13],"tags":[500,499,497,498,496],"class_list":["post-4074","post","type-post","status-publish","format-standard","hentry","category-wordpress-tips-tricks-fixes","tag-translate-bps","tag-translate-bulletproof-security","tag-translate-wordpress-plugin-poedit","tag-translating-wordpress-plugins","tag-wordpress-plugin-language-translation-tutorial"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.ait-pro.com\/aitpro-blog\/wp-json\/wp\/v2\/posts\/4074","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ait-pro.com\/aitpro-blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.ait-pro.com\/aitpro-blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.ait-pro.com\/aitpro-blog\/wp-json\/wp\/v2\/users\/167"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ait-pro.com\/aitpro-blog\/wp-json\/wp\/v2\/comments?post=4074"}],"version-history":[{"count":0,"href":"https:\/\/www.ait-pro.com\/aitpro-blog\/wp-json\/wp\/v2\/posts\/4074\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.ait-pro.com\/aitpro-blog\/wp-json\/wp\/v2\/media?parent=4074"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.ait-pro.com\/aitpro-blog\/wp-json\/wp\/v2\/categories?post=4074"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.ait-pro.com\/aitpro-blog\/wp-json\/wp\/v2\/tags?post=4074"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}