這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

Debug Bar Localization

外掛說明

Debug Bar Localization adds a new panel to the Debug Bar which displays information on the locale for your install and the language files loaded.

Additionally it will show you:

  • The installed languages.
  • Which text-domains were called from translation functions while no load_..._textdomain() call was found for that text-domain.
  • For which text-domains load_..._textdomain() was called more than once.
  • Which files WP tried to load to obtain a translation and whether this was successful.
  • If successful: how many translated strings were found and when the translation was last updated.

Did you know ?

During the creating and continued development of this plugin a – localization related – performance issue and a bug were found in WordPress itself.
For each of these I’ve send in patches. The end-results are now in core.

Want to know more ? Here they are: Trac 35439 and Trac 35442 (and related: Trac 21319 )

Important

This plugin requires the Debug Bar plugin to be installed and activated.

Also note that this plugin should be used solely for debugging and/or in a development environment and is not intended for use on a production site.

If you like this plugin, please rate and/or review it. If you have ideas on how to make the plugin even better or if you have found any bugs, please report these in the Support Forum or in the GitHub repository.

螢幕擷圖

  • Debug Bar Localization displaying basic statistics.
  • Debug Bar Localization displaying textdomains without a 'load call'.
  • Debug Bar Localization displaying the load textdomain calls made.

安裝方式

  1. Install Debug Bar if not already installed (https://wordpress.org/plugins/debug-bar/).
  2. Extract the .zip file for this plugin and upload its contents to the /wp-content/plugins/ directory. Alternatively, you can install directly from the Plugin directory within your WordPress Install.
  3. Activate the plugin through the “Plugins” menu in WordPress.

Don’t use this plugin on a live site. This plugin is only intended to be used for development purposes.

常見問題集

Can it be used on live site ?

This plugin is only meant to be used for development purposes, but shouldn’t cause any issues if run on a production site.

What is internationalization ?

Internationalization is the process of developing your plugin/theme so that it can easily be translated into other languages.

Ref: Plugin Handbook / Theme Handbook

What is localization ?

Localization describes the subsequent process of translating an internationalized plugin/theme.

Ref: Plugin Handbook / Theme Handbook

How do I internationalize my theme/plugin ?

For plugins, see the Plugin Handbook on Internationalization.

For themes, see the Theme Handbook on Internationalization.

How do I localize my theme / plugin ?

For plugins, see the Plugin Handbook on Localization.

For themes, see the Theme Handbook on Localization.

Why is my `load_…_textdomain()` call not listed ?

There are several potential reasons for this:

  1. You might not be loading the translations correctly. See the above referenced handbook pages for more information.
  2. You might be loading your translations selectively (lean loading), only on the pages they are needed. If so, make sure you are viewing such a page to see your translation listed.
  3. You might be loading your translations too early or too late. Translations are best loaded on the (admin_)init hook. For more information see this article.

In particular take note of the following:
If your textdomain is loaded before this plugin is loaded, i.e. if you load your textdomain on the PHP file load from a must-use plugin, or if your textdomain is loaded very late, i.e. after the admin bar has loaded, this plugin can not pick up on the load_..._textdomain() call.

Why won’t the plugin activate ?

Have you read what it says in the beautifully red bar at the top of your plugins page ? As it says there, the Debug Bar plugin needs to be active for this plugin to work. If the Debug Bar plugin is not active, this plugin will automatically de-activate itself.

使用者評論

2019 年 5 月 24 日 1 則留言
When you've messed up your localize_script or plugin and you have a hard time tracking it, it helps you in no time! Great job!
2016 年 9 月 3 日 1 則留言
Just help me to debug a website that had a problem !! Thanks !!! 🙂
閱讀全部 2 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈Debug Bar Localization〉的開發相關工作。

參與者

〈Debug Bar Localization〉外掛目前已有 4 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈Debug Bar Localization〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

1.1 (2016-04-29 )

  • [Enhancement] Don’t show warning about duplicate load calls on plugins page as that’s caused by core, not by a plugin and the warning could be misleading.
  • [Enhancement] Make loading of ‘our own’ text-domain compatible with use of this plugin in the must-use plugins directory.
  • [Enhancement] Improve categorization of the loaded text-domains. This mainly applies to text-domains for which the mo_file paths are being filtered.
  • [Enhancement] Added a section showing potentially unnecessary/inefficient load_textdomain calls.

  • [Bugfix] The plugin loading order functions were inadvertently checking the wrong value and – in single site – install, adding an invalid value to the active plugins list causing incorrect ‘plugin deactivated as file not found’ notices.

  • [Compatibility] Fix WP 4.5 compatibility – the check whether a text-domain load call was made (ab)used a bug in the is_textdomain_loaded() function. This bug was fixed in WP 4.5. Fixed by creating a work-around to still be able to provide this information.

  • [Compatibility] Prevent PHP error notices in WP < 4.0.
  • General housekeeping

1.0 (2016-01-13)

  • Initial release.