theme.jsonの一部が反映されない
-
こんにちは。
表記の事象についてですが、
theme.jsonの設定値よりもサイトエディター等から更新された値(=データベースに保存されている値)の方が優先されるために起こる事象です。今回his様がおっしゃる事象の場合、
defaultFontSizesはデータベースに保存されていない可能性が高いのでtheme.jsonの値が尊重されているかと思います。
その一方、fontSizesやfontFamiliesはデータベース保存済みと考えられるため、そちらの値の方が尊重されます。そのため、
theme.jsonから更新をかけた際に変更が効かない箇所については、ご面倒でもサイトエディター等から改めて更新操作を行っていただく必要があるかと存じます。以下に詳しい解説がございます(英語)。
Global Settings and Styles – Theme Handbook | Developer.WordPress.orgご参考までに、優先順位は以下のとおりです。
- ユーザー側でサイトエディター等から設定した値(Their choice takes priority over all other levels in the hierarchy と記載あり)
- 子テーマ上の
theme.jsonの値 - 親テーマ上の
theme.jsonの値 - WordPressコア上で設定された
theme.jsonの値(デフォルト設定値)
ありがとうございます。
おっしゃる通り、データベースには登録したfontSizesなどが保存されていました。
fontFamiliesに関しましてはサイトエディター上で有効化を解除して削除、再度有効化することで実質的なリセットすることができます。ただ、
fontSizesに関しては、サイトエディター上から最新のfontSizesに更新することはできませんでした。フォントサイズプリセットから任意の値にサイズ変更→保存→サイズを削除(空にする)→保存の動作を行うと出力されるプロパティでは
--wp--preset--font-size--xs: ;のように値が無くなってしまいます。元に戻るわけでもなく、最新の
fontSizesが参照されるわけでもなく。何か見落としてる可能性もありますが、「スタイルをリセット」以外の更新方法はありませんでしょうか…。
ご確認いただきありがとうございます。
fontSizesに関しては、サイトエディター上のフォントサイズプリセットから更新や削除ができず、リセットができないという状況です。現状、他の項目と違って「フォントサイズプリセット」について個別の項目のみリセット操作ができるというわけではないようです。
手作業にはなってしまいますが、サイトエディター上からtheme.jsonに設定した値のとおりに手入力で1つ1つ設定いただくことは可能でしょうか?
(下記の「空にする」場合の状況からも考えて、手入力での設定更新は受け付けているようですね)どうしても
theme.jsonに合わせたいということでしたら、データベースに残っているfontSizesの値のうち、fontSizes.theme相当の箇所にも何かしら値が残っていないでしょうか?
データベースを編集いただく場合は細心の注意をもってご対応いただくことが前提になりますが、fontSizes.themeごと削除いただく必要があります。フォントサイズプリセットから任意の値にサイズ変更→保存→サイズを削除(空にする)→保存の動作を行うと出力されるプロパティでは
--wp--preset--font-size--xs: ;のように値が無くなってしまいました。おっしゃっている状況であれば、「プロパティの削除」ではなく、「空値のプロパティ」という状況で登録されているようです。
そのため、「空値のプロパティ」の設定が採用されており、プロパティは初期化できてはいません。何か見落としてる可能性もありますが、「スタイルをリセット」以外の更新方法はありませんでしょうか…。
詳細は申し上げませんが、直接入力する方法以外にも、技術的には可能の方法がありそうです。
ただ、少し工数がかかるのと、機能の性質上、データベースを操作するコードとならざるを得ず、通常は有償対応にてご依頼いただく内容になるかと思います。-
この返信は1ヶ月、 2週前に
yinabaが編集しました。
連投失礼します。
《参考》
フォントサイズプリセットについても、実装検討時には、他の設定内容同様に個別で「リセット」を設ける案もあったようです。しかし、「値は Backspace で消せる」「プリセット自体を削除することもできる」といった運用上の理由から、結局は「リセット」を設けない案が採用されたようです。
https://github.com/WordPress/gutenberg/pull/62328#issuecomment-2160082112
https://github.com/WordPress/gutenberg/pull/62328#issuecomment-2178595658ただし、実装当初も反対意見がなかったわけではありません。
https://github.com/WordPress/gutenberg/pull/62328#issuecomment-2178527702そのため、今後、his様や上記の反対意見者のような意見が募って提案の形になれば、将来検討し直されることがあるかもしれません。
ありがとうございます。
theme.jsonに設定した値のとおりに手入力で1つ1つ設定いただくことは可能でしょうか?サイトエディター上では、
calc()やカスタムプロパティなどが入力できないため、不可となります。「空値のプロパティ」という状況で登録されているようです。
誤って数値を編集してしまった場合、元のtheme.jsonに設定されている数値へ戻せなくなるというのは、一般ユーザーからすると結構大きな問題だと思うんですが、このあたりが今後どのように議論されているのか、後で追いかけて確認してみます。
少し工数がかかるのと、機能の性質上、データベースを操作するコードとならざるを得ず、通常は有償対応にてご依頼いただく内容になるかと思います。
はい、データベースから該当箇所を削除、数値の編集を行えばサイトエディターに反映はされます。
ただ、おっしゃるように、工数や、安全性、利便性の観点から、テーマの仕様変更でフォントサイズの追加や数値の変更などががあるたび、データベースを操作すると言うのは現実的ではないですよね。
ブロックテーマはまだ深く触れていないので、もう少し探ってみます。
症状からは、ちょっと違っているかもしれませんが、theme.json はキャッシュされていたはずなのですぐに反映されていないのでは?
テーマ開発時は wp-config.php に define( ‘WP_DEVELOPMENT_MODE’, ‘theme’ ); を記述してキャッシュを無効化してすぐに反映させていたと思います
キャッシュ時間等細かいことは覚えていないのでなんとも言えませんが、WP_DEVELOPMENT_MODE あたりを調べるとなにかわかるかもしれませんenomoto celtislab 様
症状からは、ちょっと違っているかもしれませんが、theme.json はキャッシュされていたはずなのですぐに反映されていないのでは?
調べてみましたが、
theme.jsonの読み取りは、通常はリクエストごとの判定になるため、リロードやスーパーリロード等行えば基本的にはファイル更新後の値が採用されますね。また、既に私が上で申し上げている通り、まずは
theme.jsonよりもデータベース上の値が優先されます。そして、実際にデータベース上に値が残っていたため、本事象が発生しておりました。もう1点、仮に
theme.jsonのキャッシュが残っていたのだとすれば、"defaultFontSizes": falseが更新後に反映される事象とも矛盾が生じるかと思います。以上のことから、キャッシュ云々は本事象にはあまり関係がありません。
—
Core の実装を見ると、
theme_jsonグループの Global Settings / Styles のキャッシュは、基本的にリクエストをまたいで永続化しないようになっています。そのため、「theme.jsonを変更したものの、キャッシュの有効期限が切れていないため古い値が残っている」という種類のものではなさそうです。
https://github.com/WordPress/wordpress-develop/blob/6b08132f3f0fd92d813af07247f349d30200071d/src/wp-includes/class-wp-theme-json-resolver.php#L104また、今回の場合は「スタイルをリセット」すると新しい
theme.jsonのfontSizesが反映されることと、データベース内の Global Styles から該当するfontSizesの値を削除した場合にも反映されることを確認しています(his様が既にお伝えいただいているとおりです)。テーマ開発時は wp-config.php に define( ‘WP_DEVELOPMENT_MODE’, ‘theme’ ); を記述してキャッシュを無効化してすぐに反映させていたと思います
キャッシュ時間等細かいことは覚えていないのでなんとも言えませんが、WP_DEVELOPMENT_MODE あたりを調べるとなにかわかるかもしれませんおっしゃる通り、
define( ‘WP_DEVELOPMENT_MODE’, ‘theme’ );は theme.json 関連のキャッシュを回避する用途では有効です。ただし、Global Stylesやデータベース上に保存されたユーザー設定そのものを無効にしたり、theme.json 側の値を優先させたりするものではありません。
そのため、いずれにしても、今回のfontSizesの件については挙動は変わらないのではないかと思います。-
この返信は1ヶ月、 2週前に
yinabaが編集しました。
Global Settings / Styles のキャッシュは、基本的にリクエストをまたいで永続化しないようになっています
自分の記憶では永続化してた気がしたので wp_get_global_stylesheet() のコードを見てみたらオブジェクトキャッシュですね
オブジェクトキャッシュのプラグインを入れてなければ永続化しませんね
不一致が生じる場合の一例として、プラグイン等が高速化のためにグローバルスタイルをキャッシュしてプラグインがそれを使用することで発生した経験はあります
これまた、今回の事象には当てはまらなそうですが一応紹介まで
その時は、DB上のグローバルスタイルデータの更新日時を適切なフックを使用してアップデートし、プラグイン側に更新を検知させてプラグイン側のキャッシュの更新を促して解消させました
ちょっと特殊な例ですが、全プラグイン停止やテーマの変更で違いがでるか確認してみては$post_id = WP_Theme_JSON_Resolver::get_user_global_styles_post_id(); if(!empty($post_id)){ wp_update_post( ['ID' => $post_id] ); }補足情報です
おそらく今回の事象は yinaba 様がおっしゃるとおり仕様通りの優先度による問題と思われますが
対応としては、スタイルをカスタムして使用するのを可能な限り避けるのが良いのではないかと思います
theme.json や style.css 等のファイルとして管理する
色・タイポグラフィ・レイアウトなどをカスタムしたい場合は、スタイルセットを切り替える仕組み
スタイルバリエーションを使用する
スタイルバリエーションは、twentytwentyfive 等のテーマが使っているやつです
styles ディレクトリに切り替え用の json ファイルを作成しますtheme.json
styles/
blue.json
green.json
dark.jsonこれでいろいろなスタイルセットから切り替えことができるようになります
ただ、注意点もあります
バリエーションによるグローバルスタイルの切り替えはリセット動作を含んでいます
バリエーション毎にユーザーの追加カスタマイズを自動保存・復元する機能は持っていないので切り替えるとカスタムしたデータは失われてしまいます
2022年から指摘されていて未だ未対応で、このような問題もあるのでバリエーションを持たす場合はスタイルをUIでカスタムしないほうが問題を避けれますhttps://github.com/WordPress/gutenberg/issues/38333
私ならこの場合どう対応するかなと考えると、スタイルのカスタムや追加CSSは使用せずにtheme.json やバリエーション、style.css 等を使用することでメンテナンスをやりやすい方法を検討するかなと言う感じです
ちょっと脱線してしまったみたいで申し訳ない (^_^;)こんにちは。
Create Block Themeでテーマを作っており、theme.jsonを頻繁に更新しています。
まずここの大前提について確認なのですが、Create Block Themeプラグインの基本的な使い方は、「サイトエディターやグローバルスタイルで行った変更をテーマディレクトリに書き戻す」ことを繰り返しながら、テーマを構築していきます。テーマそのものを作ることが目的のプラグインであるため、そもそもデータベースにグローバルスタイルを保存する、ということは行いません。theme.jsonを直接編集することも基本的にありません。
サイトエディター上では、
calc()やカスタムプロパティなどが入力できないため、不可となります。これはつまり、やりたいことがCreate Block Themeプラグインでできる事の範疇を超えていることを意味します。Create Block Themeを使わず、直接theme.jsonを含むテーマファイル一式を一から構築してみてはどうでしょうか。
Aki Hamano 様
ありがとうございます。Create Block Themeは、テーマの雛形を作成する目的で初回に使用しただけで、その後は使用していません。現在はプラグイン自体もインストールしておらず、theme.jsonを含むファイルは直接編集しています。
また、他のテーマやTwenty Twenty-Fiveなどのデフォルトテーマでも同じ問題が再現されたことから、テーマファイルを直接一から構築した場合でも、今回の
font-sizeが更新されない問題については同じ状況になると考えています。Aki Hamano 様
補足です。
理由は既に私が上で申し上げているとおり、本事象はtheme.jsonよりもデータベース上の値が優先されるためでございます。
Create Block Themeを使わずとも、サイトエディター上で一度保存操作をすれば、データベース上に値が保存されますよね? それ以後にtheme.jsonの内容を書き換えても、基本的にはデータベース上の値が優先されるようになっています。
his様(および私)はそのことを言っています。子テーマか親テーマか、プラグインを使って作成されたテーマかは全く関係ありません。his様がご確認いただいているとおり、デフォルトテーマでも容易に再現可能です。
親テーマのtheme.jsonよりも子テーマのtheme.jsonの値の方が優先されるという違いはありますが、データベース上の値の方がさらに優先度は高いです。従って、以下は全くの見当違いになります。
Create Block Themeを使わず、直接theme.jsonを含むテーマファイル一式を一から構築してみてはどうでしょうか。
投稿いただく前に、スレッドに書き込まれている内容を今一度ご確認のほどよろしくお願いします。
-
この返信は1ヶ月、 1週前に
yinabaが編集しました。
失礼しました。
Create Block Theme プラグインは、テーマのひな型を作成するだけでなく、グローバルスタイル、サイトエディター上のテンプレートの変更をテーマファイルに書き戻し、DB上のグローバルスタイル設定をリセットする、という操作が可能です。そのため、現在もCreate Block Themeを使ってそのような操作をおこなっていないか、原因の切り分けのために確認したかった次第です。
しかし、現在はもう使われていないとの事ですので、私のコメントは無視していただいて構いません。
このトピックに返信するにはログインが必要です。