固定ページのURLの拡張子をhtmlに変更する

説明

きっかけとなったのは、カスタム投稿タイプのパーマリンク設定について調べている際にwp-includes/rewrite.phpをナナメ読みしている中、$wp_rewriteのget_page_permastructメソッドを見つけたあたり。さっそく自テーマのfunctions.phpにinitアクションを追加し、試したところあっけなく動作しました。コードは次の通り（'mytheme'の部分はお好みで変更を）。

add_action( 'init', 'mytheme_init' );
if ( ! function_exists( 'mytheme_init' ) ) {
	function mytheme_init() {
		global $wp_rewrite;
		$wp_rewrite->use_trailing_slashes = false;
		$wp_rewrite->page_structure = $wp_rewrite->root . '%pagename%.html';
//		flush_rewrite_rules( false );
	}
}

ポイントは flush_rewrite_rules関数の呼び出し。これは1度だけ呼び出せばいいので、ここではコメント化している。また、管理ページの「設定」－「パーマリンク設定」にアクセスして、そのまま「変更を保存」ボタンを押すことで同様の効果があるので、どちらかの対応を選んでほしい。

なお、ここでは単に拡張子をhtmlにしているだけだが、例えばaboutのようなディレクトリ以下のページのようにすることも可能である。

$wp_rewrite->page_structure = $wp_rewrite->root . 'about/%pagename%.html';

スラッグが'about'の親ページ作っても対応できるのだが、こちらは応用例として紹介しておく。

追記）use_trailing_slashesプロパティの値がtrueの場合、URLの末尾に'/'が付与される場合がある。パーマリンク設定によってuse_trailing_slashesプロパティの値がfalseになる場合があるが、常に'/'をつけたくない場合は意図的にfalseを設定すること。