WordPressの「脚注」が更新できない・元に戻るときの原因と対処法

Cocoonカスタマイズ集
この記事は約3分で読めます。
記事内に広告が含まれています。

はじめに

WordPressのGutenbergエディターで脚注を編集しても、保存後に元の状態へ戻ってしまうことがあります。

私の環境(WordPress 7.1.4)では、エディターの「カスタムフィールド」パネルを表示していると、脚注の変更が正常に保存されない現象を確認しました。

この記事では、脚注が更新されない現象と、その原因として考えられるカスタムフィールドの影響、対処方法について紹介します。

現象

Gutenbergエディターで脚注を編集して「更新」を押しても、ページをリロードすると更新前の状態に戻ってしまいます。

具体的には、次のような状態になります。

  • 本文中の脚注番号(アンカー)は残っている
  • 脚注ブロックの内容だけが古い状態に戻る
  • 新しく追加した脚注が消えてしまう

私の環境では、エディターの「カスタムフィールド」パネルを表示していると、この現象が発生しました。

WordPressの公式フォーラムでも、カスタムフィールドのパネルを表示していると脚注を編集できなくなり、パネルを非表示にすると編集できるようになった事例が報告されています。

原因

脚注の本文は、投稿のカスタムフィールドにある footnotes というキーに、JSON形式で保存されています。

このキーは、先頭にアンダースコア(_)が付かない公開のメタキーです。
そのため、カスタムフィールドのパネルを表示すると、ほかのカスタムフィールドと同じように footnotes もパネル内に表示されます。

この点については、WordPressの公式フォーラムでも取り上げられています。

この投稿では、カスタムフィールドの一覧に footnotes が表示される理由について質問されており、カスタムフィールドのパネルを非表示にすることで問題を回避できた事例も紹介されています。

これらの報告から、カスタムフィールドのパネルに表示される footnotes の値と、エディターで編集した脚注の内容が競合し、変更が正常に保存されない可能性が考えられます。

ただし、内部でどのような処理が行われているのか、詳しい原因までは確認できていません。

WordPressの開発チケットでも、報告者は footnotes のキーを非公開にすればカスタムフィールドのパネルに表示されなくなり、問題を回避できるのではないかと推測しています。
原因の特定や修正については、Gutenbergエディター側で扱う問題とされています。

対策

Gutenbergエディター

現時点で確認できている回避策は、カスタムフィールドのパネルを非表示にすることです。

次の手順で設定を変更します。

  1. エディター右上のオプション(︙)を開く
  2. 「設定」を選択する
  3. 「パネル」で「カスタムフィールド」をオフにする(図1参照)
  4. エディターのページをリロードする

カスタムフィールドを編集する必要がある場合だけパネルを表示し、脚注を編集するときは非表示にしておくと安全です。

なお、すでに消えてしまった脚注は、カスタムフィールドのパネルを非表示にしただけでは復元されません。
本文中の脚注番号(アンカー)が残っている場合は、脚注の内容を入れ直す必要があります。

さいごに

今回紹介した方法を使えば、カスタムフィールドのパネル表示による脚注の更新トラブルを回避できます。
脚注を編集するときは、カスタムフィールドのパネルを非表示にしておきましょう。

タイトルとURLをコピーしました