WordPress, メンテナンス中ページをカスタマイズする

WordPress5.3からメンテナンス中のページのカスタマイズがかんたんになりました。

理由は『wp_die()の機能強化』です。これによって、コードが直感的でHTMLも見やすくなりました。

優先度は低いですが、あまり見られないページに力を入れてるとサイトのクオリティが高いと思われます。

（見た目だけのカッコつけだけど。）

DBエラーページ（db-error.php）、PHPエラーページ（php-error.php）の作り方と、ほぼほぼ同じです。

（だから書いてある内容もほぼ同じ。）

WordPress, データベースのエラーページをカスタマイズする

WordPress, PHP Fatalエラーページをカスタマイズする

WP5.3から、wp_die()で指定するパラメータのメッセージ（第1パラメータ）にHTMLタグが使えるようになりました。

（ようはHTML文が挿入できる。）

これで、ドロップインで作成するメンテナンス中の専用ページがスッキリと余計なことを考えずに作成できます。

HTMLは<body>部だけでいいです。

（CSSスタイル、JavaScriptも挿入可）

かんたんに超高速WordPressでサイトを作る、KUSANAGIが使える低価格クラウド・VPS・レンタルサーバ

作成するサンプル
maintenance.phpのフォーマット

作成するサンプル

まずはWP5.3以降のデフォルトページとカスタマイズしたページをお見せします。

デフォルトページ

カスタマイズページ

大したことはしていません。HTMLとCSSを数分で書いただけです。それでそれなりのものができます。

ということで実際に作ってみましょう。

maintenance.phpのフォーマット

メンテナンスページは/wp-content/maintenance.phpです。説明はあとにしてまずはフォーマットから。

コードを表示閉じる

<?php
if ( ! function_exists( 'wp_die' ) ) {
    require_once( ABSPATH . WPINC . '/functions.php' );
}
wp_load_translations_early();
header( 'Retry-After: 600' );
ob_start();
?>
<!-- CSSファイル -->
<link rel="stylesheet" href="https://sample.com/sample.css" >
<style type='text/css'>
  // ここにインラインスタイルを書く。
</style>

// ここにHTMLを書く。

<!-- JS -->
<script></script>
<?php
wp_die( ob_get_clean(), __( 'Maintenance' ), 503 );

このかたちでページを作成します。

PHPコードはなんでこうなるのか？

PHPコードは

maintenance.phpが無いとき、どうやってデフォルトページを作っているか？

を考えて、その部分のWordPressのコードからパクってきました。

（『maintenance.php』でWPコードを検索。）

/wp-includes/load.php, wp_maintenance()

コードを表示閉じる

if ( file_exists( WP_CONTENT_DIR . '/maintenance.php' ) ) {
    require_once WP_CONTENT_DIR . '/maintenance.php';
    die();
}

require_once ABSPATH . WPINC . '/functions.php';
wp_load_translations_early();

header( 'Retry-After: 600' );

wp_die(
    __( 'Briefly unavailable for scheduled maintenance. Check back in a minute.' ),
    __( 'Maintenance' ),
    503
);

なんでfunctions.phpをrequireするのか？

wp_load_translations_early()を入れる理由は？

HTTPレスポンスヘッダに'Retry-After: 600'を入れる理由は？

なんで503コードなの？

これらのすべての答えは