WP Manifestindependent plugin directory
manifest / developer / find-pre-init-translations

Find Pre Init Translations

Logs all gettext() calls triggered before the init hook for non‑default domains, helping developers identify translation-order issues and resolve the "Function _load_textdomain_just_in_time was called incorrectly." error.

by jaimelias · github.com/jaimelias/find-pre-init-translations · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/jaimelias/find-pre-init-translations/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/jaimelias/find-pre-init-translations ↗

Description

Find Pre Init Translations logs all gettext() calls triggered before the init hook for non‑default domains. It helps WordPress developers identify translation-order issues and resolve the common error after Wordpress 6.7:

Function _load_textdomain_just_in_time was called incorrectly.

When early translations run out of order, this plugin captures the hook, text, domain, and file location, then outputs it to the debug log (or directly on screen if WP_DEBUG_DISPLAY is enabled).

Features

  • Hooks into gettext with priority 0 to catch the earliest translations.
  • Skips core (default) domain translations.
  • Honors WP_DEBUG and WP_DEBUG_DISPLAY settings.
  • Outputs a backtrace location so you can pinpoint the culprit plugin or theme.

Installation

  1. Download or clone this repository into your WordPress wp-content/plugins/ folder:
    git clone https://github.com/jaimelias/find-pre-init-translations.git
  2. Ensure your wp-config.php has debug turned on:
    define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
// Optional: show logs in browser
define('WP_DEBUG_DISPLAY', true);
  3. In the WordPress admin, go to Plugins → Installed Plugins and activate Find Pre Init Translations.

Usage

  • Browse your site or trigger the functionality you suspect runs too early.
  • Check wp-content/debug.log (or your PHP error log) for entries like:
    Pre Init Translations - hook="plugins_loaded"; text="My String"; domain="my-plugin"; location="/path/to/file.php on line 123";
  • The log will show you:
    • hook where the translation was invoked
    • text being translated
    • domain (plugin/theme text domain)
    • location of the calling file and line number

Use this information to adjust your plugin or theme so that load_textdomain() and other translation functions run during or after init.

Changelog

1.0.0

  • Initial release.

Contributing

Contributions are welcome! Please fork the repo and submit a pull request with your improvements.

License

This plugin is licensed under the GPL‑2.0+ license.