"Translation loading for the fork domain was triggered too early" notice on every request (WordPress 6.7+)

オープン 初心者向け
#118 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
78/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
php
領域
backend

調査の方向性

問題は inc/Block_Patterns.php にあります。コンストラクターが setup_properties() を直接呼び出し、そのメソッドが __( 'Fork Patterns', 'fork' ) を init より前に呼んでいます。そこから始め、WP_DEBUG_LOG を有効にし、空の wp-content/languages/themes/fork-en_US.mo で再現してください。fork ドメインの通知が debug.log に表示されなくなり、コンストラクターが run() を init にフックし、fork_block_patterns_categories と fork_block_patterns フィルターが引き続き発火してパターンを登録するようになれば完了です。

索引モデルが issue の本文から書いたものです。

説明

What's wrong

On WordPress 6.7 and later, every page load (front end, admin, REST, WP-CLI) writes this notice to the debug log when WP_DEBUG is on:

PHP Notice:  Function _load_textdomain_just_in_time was called incorrectly. Translation loading for the fork domain was triggered too early. This is usually an indicator for some code in the plugin or theme running too early. Translations should be loaded at the init action or later.

On a test site the log grew by about 500 lines per test session from this notice alone. On a translated site, WordPress also loads Fork's translations earlier than it allows.

Cause

inc/Block_Patterns.php: the constructor calls setup_properties() straight away, and setup_properties() calls __( 'Fork Patterns', 'fork' ). The constructor runs from Core::__construct() while functions.php loads, which is before init. The code has been like this since 1.0.0; WordPress started reporting it in 6.7.

Steps to reproduce

WordPress only shows this notice when a translation file exists for the domain in the site's language. An English site has none, so the notice never shows there.

  1. Use a site with WP_DEBUG and WP_DEBUG_LOG on and Fork active. Either set the site language to one Fork has translations for, or (what our QA site does) create an empty wp-content/languages/themes/fork-en_US.mo.
  2. Load any page.
  3. Open wp-content/debug.log.

Expected: no notice for the fork domain.
Actual: one notice per request.

Seen on WordPress 6.7.12, 6.8, 7.1.5 and 7.2-RC2, with Fork 1.0.16.

Suggested fix

Call setup_properties() from the init callback instead of the constructor:

public function __construct() {
	add_action( 'init', array( $this, 'run' ) );
}

public function run() {
	$this->setup_properties();
	$this->register_categories();
	$this->register_patterns();
}

The fork_block_patterns_categories and fork_block_patterns filters then run at init, which is later than now. Check that nothing hooks them later than that.

主要言語
PHP
スター
0
フォーク
0
平均マージ
1時間 2分
マージ済み PR(30日)
5

環境構築

  • Dockerfile・Docker Compose ファイルなし
  • プルリクエストのテンプレートあり
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

Codeinwp/fork のほかの issue

Codeinwp/fork の issue をすべて見る

似ている issue

PHP の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。