【WordPress】HTMLアンカーの自動生成機能を有効にする方法

2022年4月23日2022年11月6日WordPress

この記事では、WordPress5.9で実装されて、早くも5.9.1で廃止されてしまったHTMLアンカーの自動設定を再び有効（オン）にする方法について書きます。

「functions.php」に、本記事で紹介するコードを記述することで、ブロックのHTMLアンカーの自動生成機能を再び有効にできます。

WordPress5.9（2022年3月11日公開）で、見出しのHTMLアンカーの自動生成機能が実装されました。いちいちHTMLアンカーを自分で作成しなくても、勝手に作成してくれる機能です。例えば、「テスト」という見出し2を作成したら、自動的に「テスト」というアンカーが付与されます。

この機能は、色々と批判が多かったようです。2022年2月22日に公開されたWordPress 5.9.1にて、廃止されてしまいました。正確には、廃止ではなく、デフォルトの状態が有効→無効になりました。

WordPress5.9.1のリリースノート画像 — 参考：Version 5.9.1 – WordPress.org Forums

つまり、有効にするコード（PHP）を書けば、5.9と同じように5.9.1以降でもHTMLアンカーの自動生成機能を利用できます。元に戻すのも簡単です。

「あの機能、めっちゃ便利だったのに、早々に廃止されて自動生成されなくなった！やっぱりほしい！」という方、ぜひ試してみてください。

「そもそも、HTMLアンカー（ページジャンプ）機能って何？」って方は、公式サイトが参考になるかと思います。リンクをクリックしたら、任意の場所に飛んでくれる機能です。いわゆる目次です。

記事執筆時のWordPressバージョン：WordPress 6.0.1（2022年8月5日）
使っているテーマ：Luxeritas

1. HTMLアンカーの自動生成を有効にする手順
2. 感想

HTMLアンカーの自動生成を有効にする手順

大体3分もあれば、有効にできます。

「functions.php」にコードを記述する

WordPress管理画面にアクセスします。左側にあるお使いのテーマ名（僕の場合、Luxeritas）→子テーマの編集をクリックします。

「functions.php」タブをクリックします。

コードを書き込む画面が表示されるので記述していきます。既に書かれているコードは消さずに、改行して新しい行に書きます。コードは、以下になっています。

//5.9.1で廃止されたHTMLアンカーの自動生成を有効にするコード
add_filter( 'block_editor_settings_all', function( $editor_settings, $editor_context ) {
	$editor_settings['generateAnchors'] = true;
	return $editor_settings;
}, 10, 2 );
//5.9.1で廃止されたHTMLアンカーの自動生成を有効にするコード終了

WordPress6.0以前を利用している方へ

WordPress5.9.〇系を使っている方は、上記コードが使えないと思います。代わりに下記コードを使ってみてください。

2022年5月くらいに、予告なしに「__experimentalGenerateAnchors」という文字列が「generateAnchors」に変更されました。最近のWordPressバージョンを使っている方は、上記コードでOKです。

//5.9.1で廃止されたHTMLアンカーの自動生成を有効にするコード
add_filter(
	'block_editor_settings_all',
	static function( $settings ) {
		$settings['__experimentalGenerateAnchors'] = true;
		return $settings;
	}
);
//5.9.1で廃止されたHTMLアンカーの自動生成を有効にするコード終了

書き込めたら、「保存」をクリックします。