How to Translate the File Manager Plugin into Your Language
Content
Many WordPress users want to translate the File Manager plugin to use it in their native language. However, the process can be confusing, and the plugin's structure has historically presented challenges for community translation efforts on WordPress.org. This guide explains the common issues and provides the most effective methods for creating and using translations.
Understanding the Translation Challenge
Based on community feedback, the primary issue is that the File Manager plugin is not fully configured for the official WordPress.org translation platform (Translate WordPress). While the plugin's "readme" file can be translated there, the main plugin strings often cannot be. This limitation has been a frequent point of concern for users attempting to contribute translations directly through the recommended WordPress channel.
Method 1: Manual Translation via Plugin Files
This is the traditional and most direct method for translating the plugin, as suggested by the File Manager team in support threads.
- Translate PHP Strings: Add your language files (
.poand.mo) to the/wp-file-manager/languages/directory. Name them in the formatwp-file-manager-[language_code].poandwp-file-manager-[language_code].mo(e.g.,wp-file-manager-fr_FR.mofor French). - Translate JavaScript UI: The plugin's interface uses the elFinder library. To translate it, you must add a corresponding JavaScript file to the
/wp-file-manager/lib/js/i18n/directory. The file should be named likeelfinder.[lang_code].js(e.g.,elfinder.fr.js). You may need to find an existing translation for elFinder or create your own.
Method 2: Submitting Translations to the Developers
If you have completed a translation and want it included in a future update of the plugin, you can submit it to the developers. Community members have successfully done this for languages like Russian and Persian. You can attempt to share your translation files (.po, .mo, and .js) by contacting the development team directly. Be prepared to provide a download link to your files for their review.
Important Considerations
- WordPress.org Translations: The File Manager team has indicated in responses that they are aware of the localization issues and have mentioned working on a "massive update" to address them. For now, the manual method is the most reliable.
- Clearing Cache: After adding new translation files, clear your browser cache and WordPress caching plugins to ensure the new language loads correctly.
- Plugin Updates: Be aware that manual translations added to the plugin's directories may be overwritten during an update. It is a best practice to keep a backup of your translation files so you can reinstall them if needed.
While not ideal, these methods provide a viable path to using File Manager in your language. The community's continued feedback on translation issues appears to be driving improvements for future versions of the plugin.
Related Support Threads Support
-
Translation pluginhttps://wordpress.org/support/topic/translation-plugin-14/
-
Translate on wordpress.orghttps://wordpress.org/support/topic/translate-on-wordpress-org/
-
Changeloghttps://wordpress.org/support/topic/version-numbers-correct/
-
Changeloghttps://wordpress.org/support/topic/changelog-81/
-
The plugin does not search .doc files – suggested parser belowhttps://wordpress.org/support/topic/the-plugin-does-not-search-doc-files-suggested-parser-below/
-
Improve I18N Issues (Based on 7.2.1)https://wordpress.org/support/topic/improve-i18n-issues-based-on-7-2-1/
-
Persian language (Full translation)https://wordpress.org/support/topic/persian-language-full-translation/
-
Help with translationhttps://wordpress.org/support/topic/help-with-translation-8/
-
Translate WELCOME wordhttps://wordpress.org/support/topic/translate-welcome-word/
-
This plugin is not properly prepared for localizationhttps://wordpress.org/support/topic/this-plugin-is-not-properly-prepared-for-localization-65/
-
Russian languagehttps://wordpress.org/support/topic/russian-language-12/
-
Search and Replace Operation in Multiple Folders and Fileshttps://wordpress.org/support/topic/search-and-replace-operation-in-multiple-folders-and-files/
-
Plugin not translatablehttps://wordpress.org/support/topic/plugin-not-translatable-2/
-
This plugin is not properly prepared for localizationhttps://wordpress.org/support/topic/this-plugin-is-not-properly-prepared-for-localization-66/
-
Uncought TypeErrorhttps://wordpress.org/support/topic/uncought-typeerror/
-
Error after updatehttps://wordpress.org/support/topic/error-after-update-164/
-
Translationhttps://wordpress.org/support/topic/translation-1487/