{"id":134,"date":"2025-02-06T12:40:05","date_gmt":"2025-02-06T12:40:05","guid":{"rendered":"https:\/\/documentation.userswp.io\/article\/how-to-translate-or-localize-userswp\/"},"modified":"2025-03-26T16:49:10","modified_gmt":"2025-03-26T16:49:10","slug":"how-to-translate-or-localize-userswp","status":"publish","type":"gd_place","link":"https:\/\/userswp.io\/documentation\/article\/how-tos\/how-to-translate-or-localize-userswp\/","title":{"rendered":"How To Translate Or Localize UsersWP"},"content":{"rendered":"\n

UsersWP, by default, comes in English. (en_US)<\/h3>\n\n\n\n
<\/span>Our users fully translated UsersWP into several languages<\/a>. If yours is incomplete or you want to edit a language, you can by following the steps in this document.<\/span><\/div>\n\n\n\n

There are 2 options, creating a translation file or using an existing translation file.<\/p>\n\n\n\n

\n
\n

Create a translation file<\/strong><\/strong><\/p>\n\n\n\n

Download and install POEdit<\/a>. Launch it to open this file:<\/p>\n\n\n\n

userswp\/languages\/userswp-en_US.po\t<\/pre>\n\n\n\n

Add your translations<\/strong> and once you finish, click File > Compile to MO…<\/strong><\/p>\n\n\n\n
Change the file name<\/strong> to reflect your Locale<\/strong> (the Locale is a unique code for each language). For example, if your translation is to <\/strong>Italian<\/strong>, the locale is it_IT.<\/strong> <\/p>\n\n\n\n
The file name should be:<\/p>\n\n\n\n
userswp-it_IT.mo<\/pre>\n\n\n\n

Here you can find the full list of Locale<\/a> codes.<\/p>\n\n\n\n
Inside the wp-content folder, create the folder \/languages\/<\/p>\n\n\n\n
Inside the languages folder, create the folder \/plugins\/<\/p>\n\n\n\n
Transfer the .mo file<\/strong> via FTP into the newly created folder:<\/p>\n\n\n\n
The complete path should look like this:<\/p>\n\n\n\n
wp-content\/languages\/plugins\/userswp-it_IT.mo<\/pre>\n<\/div>\n\n\n\n
\n
Using an existing translation file<\/strong><\/p>\n\n\n\n
Download<\/strong> the desired language file from the UsersWP GlotPress page<\/a>.<\/p>\n\n\n\n
You can download the file as .po file and modify it following point 1 of this doc or download it directly as .mo file, skip editing with POEdit \/ compiling the mo file, and follow the steps from here<\/a>.<\/p>\n\n\n\n
<\/span>If you save the translation file in the wp-content\/plugins\/userswp\/languages\/ folder, you will lose your translation with each plugin update.<\/span><\/div>\n<\/div>\n\n\n\n
\n
Change WordPress language<\/strong><\/p>\n\n\n\n
From your WordPress dashboard go to Settings > General > Site Language. Change it to your language. WordPress and UsersWP will start using the translation files for your language. <\/p>\n\n\n\n
\"\"\/<\/figure>\n<\/div>\n<\/div>\n\n\n\n
<\/p>\n\n\n\n
Translating Add-ons<\/h2>\n\n\n\n
to translate the add-ons<\/strong> the procedure is identical<\/strong>. Only the location of the translation files changes:<\/p>\n\n\n\n
They can be downloaded from our website and not from wordpress.org. <\/p>\n\n\n\n
The URL is https:\/\/userswp.io\/translate\/projects\/<\/a>.<\/p>\n\n\n\n
Once you are ready to load your translation file<\/strong>, the path for example for the Location Manager should look like this<\/strong>:<\/p>\n\n\n\n
\/wp-content\/languages\/plugins\/userswp-en_US.mo<\/pre>\n\n\n\n

Let’s take another example. For the Advanced search add-on the path should look like this:<\/p>\n\n\n\n
\/wp-content\/languages\/plugins\/uwp-search-en_US.mo<\/pre>\n\n\n\n
Updating Translations<\/h2>\n\n\n\n
Sometimes a new release comes out with new features and in some cases, these new features require new text strings.<\/p>\n\n\n\n
When this happens, you’ll need to merge your translated PO file with the new language file provided with the update.<\/p>\n\n\n\n
To do so, you need to have both files on your desktop. For example: <\/p>\n\n\n\n
userswp-it_IT.po (your translated PO file)

userswp-en_US.po (the new translation file shipped with the plugin update)<\/pre>\n\n\n\n

Open the first file<\/strong> (userswp-it_IT.po) with POEdit<\/b> <\/p>\n\n\n\n
From the PoEdit menu, click Catalogue<\/strong> and then Update from POT file\u2026<\/strong><\/p>\n\n\n\n
Browse to the new PO file (userswp-en_US.po) and press the open button.<\/div>\n\n\n\n
That will merge the new language strings with your translated file. Make any changes as required, save and upload the new MO file with updated translation in the wp-content\/languages\/plugins folder.    <\/div>\n","protected":false},"excerpt":{"rendered":"
UsersWP, by default, comes in English. (en_US) There are 2 options, creating a translation file or using an existing translation file. Translating Add-ons to translate the add-ons the procedure is identical. Only the location of the translation files changes: They can be downloaded from our website and not from wordpress.org.  The URL is https:\/\/userswp.io\/translate\/projects\/. Once […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"article\/tags":[],"article\/categories":[41,7],"class_list":["post-134","gd_place","type-gd_place","status-publish","hentry","gd_placecategory-how-tos","gd_placecategory-tips-tricks-more"],"_links":{"self":[{"href":"https:\/\/userswp.io\/documentation\/wp-json\/wp\/v2\/article\/134","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/userswp.io\/documentation\/wp-json\/wp\/v2\/article"}],"about":[{"href":"https:\/\/userswp.io\/documentation\/wp-json\/wp\/v2\/types\/gd_place"}],"author":[{"embeddable":true,"href":"https:\/\/userswp.io\/documentation\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/userswp.io\/documentation\/wp-json\/wp\/v2\/comments?post=134"}],"version-history":[{"count":0,"href":"https:\/\/userswp.io\/documentation\/wp-json\/wp\/v2\/article\/134\/revisions"}],"wp:attachment":[{"href":"https:\/\/userswp.io\/documentation\/wp-json\/wp\/v2\/media?parent=134"}],"wp:term":[{"taxonomy":"gd_place_tags","embeddable":true,"href":"https:\/\/userswp.io\/documentation\/wp-json\/wp\/v2\/article\/tags?post=134"},{"taxonomy":"gd_placecategory","embeddable":true,"href":"https:\/\/userswp.io\/documentation\/wp-json\/wp\/v2\/article\/categories?post=134"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}