MENU

問い合わせ

    お問い合わせ


    【WordPressで作るキュレーションメディア 第11回】権限・編集フロー・運用 ― 下書きレビュー、バックアップ、更新

    (2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)

    キュレーションメディアは、公開してからが本番です。書き手が増えれば「誰が公開してよいか」を決める必要があり、記事が増えれば消えたときの損失も大きくなります。そして WordPress 本体・テーマ・プラグインは、公開後もセキュリティ更新が続きます。

    「サイトはできた。でも、ライターが勝手に公開しないようにしたいし、バックアップや更新は誰が、どうやればいいの?」

    結論から言うと、「書く人は公開できない」権限と、公開前の自動チェック、レビュー担当への通知で編集フローを仕組みにし、バックアップは「復元できることを確かめる」まで、更新は「ステージングで確認してから本番へ」を手順として決めることです。どれも一度作って終わりではなく、保守契約の中で誰が担当するかを決めておく必要があります。

    前回の第10回では、表示速度の改善と計測を行いました。最終回の今回は、権限と編集フロー、バックアップと復元、更新の手順を作り、連載全体を振り返ります。

    目次

    今回のゴールと、WordPress の権限の考え方

    WordPress の権限は、「ロール(役割)」と「権限(capability)」の2段階です。ロールは権限の束で、たとえば標準の「寄稿者」は記事を書けますが公開できず、「編集者」は他人の記事も公開できます。プログラムで判定するときはロール名ではなく、current_user_can( 'publish_posts' ) のように権限で判定するのが基本です。

    📰 出典:WordPress Developer Resources「Roles and Capabilities」

    今回作る編集フローは次のとおりです。

    手順誰が仕組み
    1. 下書きを書き、画像を入れるライター独自ロール「ライター」(公開の権限なし、画像のアップロードは可)
    2. レビュー待ちとして提出するライター「レビュー待ち」で保存。公開しようとしてもレビュー待ちになる
    3. 通知を受け取る編集長・管理者レビュー待ちになった時点でメール通知
    4. 確認して公開する編集長・管理者公開時に「公開前チェック」(引用元カードの必須項目、監修日)を自動で実行

    今回追加・変更したファイル

    ファイル内容
    プラグイン includes/roles.php独自ロール「ライター」「編集長」、公開権限のない保存をレビュー待ちにする処理(新規)
    プラグイン includes/review-flow.phpレビュー待ちの通知、公開前チェック(新規)
    プラグイン curation-tools.php読み込み、有効化時のロール作成、バージョン 1.0.0
    scripts/backup.sh・scripts/restore.shバックアップと復元(新規)
    .gitignoreバックアップの保存先 backups/ を追加

    独自ロール「ライター」と「編集長」

    wp-content/plugins/curation-tools/includes/roles.php(curation_tools_install_roles() の抜粋)

    $writer_caps = array(
    	'read'         => true,
    	'edit_posts'   => true,
    	'delete_posts' => true,
    	'upload_files' => true,
    );
    remove_role( 'curation_writer' );
    add_role( 'curation_writer', 'ライター', $writer_caps );
    
    $editor = get_role( 'editor' );
    $chief  = $editor ? $editor->capabilities : array();
    $chief['list_users']            = true;
    $chief['curation_review_posts'] = true;
    remove_role( 'curation_editor_in_chief' );
    add_role( 'curation_editor_in_chief', '編集長', $chief );
    
    $admin = get_role( 'administrator' );
    if ( $admin ) {
    	$admin->add_cap( 'curation_review_posts' );
    }
    • ライターは標準の寄稿者に近いロールですが、画像のアップロード(upload_files)を許可しています。公開(publish_posts)や公開済み記事の編集の権限はありません。
    • 編集長は編集者の権限に、ユーザー一覧の閲覧(list_users)と、独自の権限「レビュー担当」(curation_review_posts)を加えたものです。
    • 管理者にもレビュー担当の権限を加えます。通知の送り先は、ロール名ではなくこの権限で決めます。

    ロールはデータベースに保存されるため、毎回のページ表示で作り直すのではなく、プラグインの有効化時と、ロール定義の版が変わったときだけ更新します。プラグインを無効化してもロールは削除しません。削除すると、そのロールのユーザーが何もできなくなるためです。

    公開の権限がない保存は「レビュー待ち」にする

    画面や REST API から公開しようとした場合は、WordPress 本体が権限を確認して拒否します。ただし、プログラムから直接記事を保存する処理(WP-CLI でユーザーを指定した場合など)には、この確認が働きません。そこで、保存直前のデータを確認し、公開の権限がないユーザーの「公開」は「レビュー待ち」に置き換える保険を入れました。

    includes/roles.php(curation_tools_force_pending_for_writers() の抜粋)

    if ( 'post' !== $data['post_type'] || ! is_user_logged_in() ) {
    	return $data;
    }
    if ( in_array( $data['post_status'], array( 'publish', 'future' ), true ) && ! current_user_can( 'publish_posts' ) ) {
    	$data['post_status'] = 'pending';
    }
    return $data;

    ログインしていない処理(予約投稿の自動公開など)は対象外にしています。予約投稿は、公開の権限を持つ人が予約した時点で確認済みだからです。

    includes/roles.php の全文です。上の2つの抜粋のほか、ロール定義の版が変わったときだけロールを作り直す処理(curation_tools_maybe_update_roles())を含みます。第0回から有効にしているプラグインでも、このファイルを置いた後の最初の表示でロールが作られます。

    wp-content/plugins/curation-tools/includes/roles.php の全文(82行・新規)
    <?php
    /**
     * 権限: 独自ロール「ライター」「編集長」と、レビュー担当を表す権限 curation_review_posts。
     *
     * - ライター: 記事の下書き作成・画像のアップロード・レビュー待ちへの提出まで。公開はできない。
     * - 編集長  : 編集者(editor)の権限+ユーザー一覧の閲覧+レビュー担当。
     * - 管理者  : 既存の権限にレビュー担当を追加する。
     *
     * ロールはデータベース(wp_options の wp_user_roles)に保存されるため、毎回の読み込みでは作らず、
     * 有効化時と、ロール定義の版(CURATION_TOOLS_ROLES_VERSION)が変わったときだけ更新する。
     * プラグインを無効化してもロールは消さない(そのロールのユーザーが権限を失うのを避けるため)。
     *
     * 権限の判定は、ロール名ではなく capability(current_user_can)で行う。
     *
     * @package Curation_Tools
     */
    
    if ( ! defined( 'ABSPATH' ) ) {
    	exit;
    }
    
    define( 'CURATION_TOOLS_ROLES_VERSION', '1' );
    
    /**
     * ロールを作成・更新する(何度実行しても同じ結果になる)。
     */
    function curation_tools_install_roles() {
    	$writer_caps = array(
    		'read'         => true,
    		'edit_posts'   => true,
    		'delete_posts' => true,
    		'upload_files' => true,
    	);
    	remove_role( 'curation_writer' );
    	add_role( 'curation_writer', 'ライター', $writer_caps );
    
    	$editor = get_role( 'editor' );
    	$chief  = $editor ? $editor->capabilities : array();
    	$chief['list_users']            = true;
    	$chief['curation_review_posts'] = true;
    	remove_role( 'curation_editor_in_chief' );
    	add_role( 'curation_editor_in_chief', '編集長', $chief );
    
    	$admin = get_role( 'administrator' );
    	if ( $admin ) {
    		$admin->add_cap( 'curation_review_posts' );
    	}
    
    	update_option( 'curation_tools_roles_version', CURATION_TOOLS_ROLES_VERSION, false );
    }
    
    /**
     * プラグインの更新でロール定義が変わった場合に作り直す。
     */
    function curation_tools_maybe_update_roles() {
    	if ( get_option( 'curation_tools_roles_version' ) !== CURATION_TOOLS_ROLES_VERSION ) {
    		curation_tools_install_roles();
    	}
    }
    add_action( 'init', 'curation_tools_maybe_update_roles' );
    
    /**
     * 公開権限のないユーザーが「公開」「予約公開」で保存しようとした場合は「レビュー待ち」にする。
     *
     * 通常の画面や REST API では WordPress 本体が公開を拒否するが、ログイン中のユーザーとして
     * wp_insert_post() を直接呼ぶ処理(WP-CLI の --user 指定など)にも同じルールを適用するための保険。
     * ログインしていない処理(予約投稿の自動公開、ユーザー指定のない WP-CLI)は対象外。
     *
     * @param array $data    保存する投稿データ(スラッシュ付き)。
     * @param array $postarr 元の投稿データ。
     * @return array
     */
    function curation_tools_force_pending_for_writers( $data, $postarr ) {
    	if ( 'post' !== $data['post_type'] || ! is_user_logged_in() ) {
    		return $data;
    	}
    	if ( in_array( $data['post_status'], array( 'publish', 'future' ), true ) && ! current_user_can( 'publish_posts' ) ) {
    		$data['post_status'] = 'pending';
    	}
    	return $data;
    }
    add_filter( 'wp_insert_post_data', 'curation_tools_force_pending_for_writers', 10, 2 );

    レビュー待ちの通知と、公開前チェック

    レビュー担当へのメール通知

    記事のステータスが変わるときに呼ばれる transition_post_status フックで、「レビュー待ち」になった記事をレビュー担当に知らせます。

    includes/review-flow.php(curation_tools_notify_pending_review() の抜粋)

    if ( 'pending' !== $new_status || 'pending' === $old_status || 'post' !== $post->post_type ) {
    	return;
    }
    
    $reviewers = get_users(
    	array(
    		'capability' => 'curation_review_posts',
    		'exclude'    => array( (int) $post->post_author ),
    		'fields'     => array( 'user_email' ),
    	)
    );

    メールには記事のタイトル、執筆者、編集画面の URL を書きます。本番でメールを確実に届けるには、サーバーのメール送信設定(SMTP やメール配信サービス)が別途必要です。サンプルの Docker 環境ではメールは送信されないため、検証では送信内容を記録する仕組みを一時的に入れて確認しました。

    公開前チェック

    第4回の引用元カードでは、必須項目の入力漏れをエディターで「警告」するだけにしていました。今回、公開するときにだけ、入力漏れがあれば公開を止めるようにしました。

    includes/review-flow.php(curation_tools_check_before_publish() の抜粋)

    $post_id = isset( $prepared->ID ) ? (int) $prepared->ID : 0;
    $status  = $prepared->post_status ?? ( $post_id ? get_post_status( $post_id ) : 'draft' );
    if ( ! in_array( $status, array( 'publish', 'future' ), true ) ) {
    	return $prepared;
    }
    
    $content  = $prepared->post_content ?? ( $post_id ? (string) get_post_field( 'post_content', $post_id, 'raw' ) : '' );
    $meta     = is_array( $request['meta'] ) ? $request['meta'] : array();
    $problems = curation_tools_publish_problems( $content, $post_id, $meta );
    if ( empty( $problems ) ) {
    	return $prepared;
    }
    
    return new WP_Error(
    	'curation_publish_check',
    	'公開前チェックで問題が見つかりました: ' . implode( ' ', $problems ),
    	array(
    		'status'   => 400,
    		'problems' => $problems,
    	)
    );

    チェックする項目は次のとおりです。

    • 引用元カード:引用文・出典名が空でないこと、出典 URL が http(s) の URL であること、確認日が実在する日付であること
    • 監修(第6回):監修者を設定した記事に監修日があること

    ブロックエディターは REST API で保存するので、rest_pre_insert_post フィルターでエラーを返すと、エディターに「公開に失敗しました。公開前チェックで問題が見つかりました: …」と理由が表示されます。下書き保存、レビュー待ちへの提出、自動保存は止めません。

    このチェックは入力漏れを見つけるもので、引用が適法かどうか、内容が正しいかどうかは判断しません。最終的な確認は、レビュー担当の人が行います。

    includes/review-flow.php の全文です。上の2つの抜粋のほか、引用元カードと監修日の問題点を集める curation_tools_publish_problems() と、フックの登録を含みます。

    wp-content/plugins/curation-tools/includes/review-flow.php の全文(154行・新規)
    <?php
    /**
     * 編集フロー: レビュー待ちの通知と、公開前チェック。
     *
     * - 記事が「レビュー待ち(pending)」になったら、レビュー担当(curation_review_posts を持つユーザー)にメールで知らせる
     * - ブロックエディター(REST API)から公開・予約公開するとき、引用元カードの必須項目と
     *   監修日の入力漏れがあれば公開を止め、理由を表示する
     *
     * @package Curation_Tools
     */
    
    if ( ! defined( 'ABSPATH' ) ) {
    	exit;
    }
    
    /**
     * レビュー待ちになった記事を、レビュー担当に知らせる。
     *
     * @param string  $new_status 新しいステータス。
     * @param string  $old_status 元のステータス。
     * @param WP_Post $post       投稿。
     */
    function curation_tools_notify_pending_review( $new_status, $old_status, $post ) {
    	if ( 'pending' !== $new_status || 'pending' === $old_status || 'post' !== $post->post_type ) {
    		return;
    	}
    
    	$reviewers = get_users(
    		array(
    			'capability' => 'curation_review_posts',
    			'exclude'    => array( (int) $post->post_author ),
    			'fields'     => array( 'user_email' ),
    		)
    	);
    	$to = array_filter( wp_list_pluck( $reviewers, 'user_email' ), 'is_email' );
    	if ( empty( $to ) ) {
    		return;
    	}
    
    	$author = get_userdata( (int) $post->post_author );
    	$title  = curation_tools_plain_text( get_the_title( $post ) );
    	$lines  = array(
    		'レビュー待ちの記事があります。',
    		'',
    		'タイトル: ' . $title,
    		'執筆者: ' . ( $author ? $author->display_name : '(不明)' ),
    		'確認する: ' . admin_url( 'post.php?post=' . $post->ID . '&action=edit' ),
    	);
    
    	wp_mail(
    		$to,
    		sprintf( '[%1$s] レビュー待ち: %2$s', wp_specialchars_decode( get_bloginfo( 'name' ), ENT_QUOTES ), $title ),
    		implode( "\n", $lines )
    	);
    }
    add_action( 'transition_post_status', 'curation_tools_notify_pending_review', 10, 3 );
    
    /**
     * 公開前チェック: 本文とメタから、公開してはいけない入力漏れを探す。
     *
     * @param string $content 本文(ブロックのマークアップ)。
     * @param int    $post_id 投稿ID(新規作成時は 0)。
     * @param array  $meta    リクエストで送られたメタ(未送信の項目は保存済みの値を使う)。
     * @return string[] 問題の説明。問題がなければ空。
     */
    function curation_tools_publish_problems( $content, $post_id, $meta = array() ) {
    	$problems = array();
    
    	foreach ( curation_tools_find_blocks( parse_blocks( $content ), 'curation-tools/source-card' ) as $index => $block ) {
    		$attrs = $block['attrs'];
    		$label = sprintf( '引用元カード(%d個目)', $index + 1 );
    		if ( '' === trim( wp_strip_all_tags( $attrs['quote'] ?? '' ) ) ) {
    			$problems[] = $label . 'の引用文が空です。';
    		}
    		if ( '' === trim( $attrs['sourceTitle'] ?? '' ) ) {
    			$problems[] = $label . 'の出典名が空です。';
    		}
    		$url = (string) ( $attrs['url'] ?? '' );
    		if ( ! in_array( wp_parse_url( $url, PHP_URL_SCHEME ), array( 'http', 'https' ), true ) || ! wp_parse_url( $url, PHP_URL_HOST ) ) {
    			$problems[] = $label . 'の出典URLが http(s) の URL ではありません。';
    		}
    		if ( '' === curation_tools_sanitize_date( $attrs['checkedDate'] ?? '' ) ) {
    			$problems[] = $label . 'の確認日が YYYY-MM-DD の日付ではありません。';
    		}
    	}
    
    	$supervisor = array_key_exists( '_curation_supervisor_id', $meta ) ? (int) $meta['_curation_supervisor_id'] : (int) get_post_meta( $post_id, '_curation_supervisor_id', true );
    	$supervised = array_key_exists( '_curation_supervised_on', $meta ) ? (string) $meta['_curation_supervised_on'] : (string) get_post_meta( $post_id, '_curation_supervised_on', true );
    	if ( $supervisor > 0 && '' === curation_tools_sanitize_date( $supervised ) ) {
    		$problems[] = '監修者が設定されていますが、監修日がありません。';
    	}
    
    	return $problems;
    }
    
    /**
     * 指定した名前のブロックを、入れ子の中まで探す。
     *
     * @param array  $blocks parse_blocks() の結果。
     * @param string $name   ブロック名。
     * @return array
     */
    function curation_tools_find_blocks( $blocks, $name ) {
    	$found = array();
    	foreach ( $blocks as $block ) {
    		if ( $name === $block['blockName'] ) {
    			$found[] = $block;
    		}
    		if ( ! empty( $block['innerBlocks'] ) ) {
    			$found = array_merge( $found, curation_tools_find_blocks( $block['innerBlocks'], $name ) );
    		}
    	}
    	return $found;
    }
    
    /**
     * REST API(ブロックエディター)で公開・予約公開するときに、公開前チェックを行う。
     *
     * 問題があれば保存せずにエラー(400)を返し、エディターにはその理由が表示される。
     * 下書き保存・レビュー待ちへの提出は止めない。
     *
     * @param stdClass        $prepared 保存する投稿データ。
     * @param WP_REST_Request $request  リクエスト。
     * @return stdClass|WP_Error
     */
    function curation_tools_check_before_publish( $prepared, $request ) {
    	// 自動保存(/autosaves)は公開ではないので対象外。
    	if ( str_contains( $request->get_route(), '/autosaves' ) ) {
    		return $prepared;
    	}
    
    	$post_id = isset( $prepared->ID ) ? (int) $prepared->ID : 0;
    	$status  = $prepared->post_status ?? ( $post_id ? get_post_status( $post_id ) : 'draft' );
    	if ( ! in_array( $status, array( 'publish', 'future' ), true ) ) {
    		return $prepared;
    	}
    
    	$content  = $prepared->post_content ?? ( $post_id ? (string) get_post_field( 'post_content', $post_id, 'raw' ) : '' );
    	$meta     = is_array( $request['meta'] ) ? $request['meta'] : array();
    	$problems = curation_tools_publish_problems( $content, $post_id, $meta );
    	if ( empty( $problems ) ) {
    		return $prepared;
    	}
    
    	return new WP_Error(
    		'curation_publish_check',
    		'公開前チェックで問題が見つかりました: ' . implode( ' ', $problems ),
    		array(
    			'status'   => 400,
    			'problems' => $problems,
    		)
    	);
    }
    add_filter( 'rest_pre_insert_post', 'curation_tools_check_before_publish', 10, 2 );

    プラグイン本体で2つのファイルを読み込み、有効化のときにもロールを作るようにして、バージョンを 1.0.0 にします。wp-content/plugins/curation-tools/curation-tools.php に次の変更を加えます(+ が追加、- が削除)。

    --- a/wp-content/plugins/curation-tools/curation-tools.php
    +++ b/wp-content/plugins/curation-tools/curation-tools.php
    @@ -2,7 +2,7 @@
     /**
      * Plugin Name:       Curation Tools
      * Description:       キュレーションメディア用の小さな機能群(引用元カード・ランキング・関連記事・構造化データなど)。連載の各回で機能を追加していく。
    - * Version:           0.9.0
    + * Version:           1.0.0
      * Requires at least: 6.8
      * Requires PHP:      8.2
      * Author:            third-hero
    @@ -17,7 +17,7 @@ if ( ! defined( 'ABSPATH' ) ) {
     	exit;
     }
     
    -define( 'CURATION_TOOLS_VERSION', '0.9.0' );
    +define( 'CURATION_TOOLS_VERSION', '1.0.0' );
     define( 'CURATION_TOOLS_FILE', __FILE__ );
     define( 'CURATION_TOOLS_DIR', plugin_dir_path( __FILE__ ) );
     define( 'CURATION_TOOLS_URL', plugin_dir_url( __FILE__ ) );
    @@ -35,6 +35,8 @@ require_once CURATION_TOOLS_DIR . 'includes/toc.php';
     require_once CURATION_TOOLS_DIR . 'includes/schema.php';
     require_once CURATION_TOOLS_DIR . 'includes/ogp.php';
     require_once CURATION_TOOLS_DIR . 'includes/pr-notice.php';
    +require_once CURATION_TOOLS_DIR . 'includes/roles.php';
    +require_once CURATION_TOOLS_DIR . 'includes/review-flow.php';
     
     /**
      * ブロックを登録する。
    @@ -53,11 +55,12 @@ function curation_tools_register_blocks() {
     add_action( 'init', 'curation_tools_register_blocks' );
     
     /**
    - * 有効化時: タクソノミーを登録してからリライトルール(URL の対応表)を作り直す。
    + * 有効化時: タクソノミーを登録してからリライトルール(URL の対応表)を作り直し、独自ロールを作る。
      */
     function curation_tools_activate() {
     	curation_tools_register_feature_taxonomy();
     	flush_rewrite_rules();
    +	curation_tools_install_roles();
     }
     register_activation_hook( __FILE__, 'curation_tools_activate' );
     

    wp-content/plugins/curation-tools/package.json のバージョンもそろえます(+ が追加、- が削除)。

    --- a/wp-content/plugins/curation-tools/package.json
    +++ b/wp-content/plugins/curation-tools/package.json
    @@ -1,6 +1,6 @@
     {
     	"name": "curation-tools",
    -	"version": "0.4.0",
    +	"version": "1.0.0",
     	"private": true,
     	"description": "キュレーションメディア用プラグインのブロック(エディター用 JS)をビルドする",
     	"license": "GPL-2.0-or-later",

    バックアップと復元

    何をバックアップするか

    対象内容このサンプルでの扱い
    データベース記事・設定・ユーザー・メタなどbackup.sh で書き出す
    uploadsアップロードした画像などbackup.sh でアーカイブ
    languages日本語化の翻訳ファイルbackup.sh でアーカイブ(再取得も可能)
    テーマ・プラグインのコード子テーマ・自作プラグインGit などのリポジトリで管理し、そこから戻す
    WordPress 本体コアのファイル同じバージョンを入れ直す

    scripts/backup.sh(新規・全文)

    #!/usr/bin/env bash
    # バックアップ: データベース(mysqldump)と uploads(アップロードファイル)・languages(翻訳ファイル)を backups/ に保存する。
    # 使い方: ./scripts/backup.sh
    #
    # - WP-CLI コンテナの標準出力に書き出し、ホスト側でファイルに保存する(コンテナにホストのフォルダを書き込ませない)。
    # - DB のダンプにはユーザーのパスワードハッシュなども含まれる。backups/ は git に入れず、アクセスできる人を限ること。
    # - 本番ではバックアップを別の場所(別サーバー・ストレージ)にも保管し、定期的に復元を試すこと。
    set -euo pipefail
    
    cd "$(dirname "$0")/.."
    stamp="$(date +%Y%m%d-%H%M%S)"
    dir="backups/${stamp}"
    mkdir -p "${dir}"
    chmod 700 backups "${dir}"
    
    wpcli() { docker compose --progress quiet run --rm -T wpcli "$@"; }
    
    echo "==> データベースを書き出し: ${dir}/db.sql"
    # wp db export は WP-CLI イメージ内の MariaDB クライアントを使うが、MySQL 8.4 の既定の認証方式
    # (caching_sha2_password)に対応していないため、db コンテナの mysqldump で書き出す。
    # パスワードはコマンドラインに書かず、コンテナの環境変数から MYSQL_PWD で渡す。
    docker compose exec -T db sh -c 'MYSQL_PWD="$MYSQL_PASSWORD" exec mysqldump -u"$MYSQL_USER" --single-transaction --no-tablespaces --default-character-set=utf8mb4 "$MYSQL_DATABASE"' > "${dir}/db.sql"
    
    echo "==> uploads と翻訳ファイルをアーカイブ: ${dir}/wp-content.tar.gz"
    # テーマ・プラグインはリポジトリ(コード)から戻すので含めない。
    wpcli sh -c 'cd /var/www/html/wp-content && mkdir -p uploads languages && tar czf - uploads languages' > "${dir}/wp-content.tar.gz"
    
    # 復元時に同じバージョンか確認できるよう、WordPress とプラグイン・テーマの一覧も残す
    wpcli wp core version > "${dir}/core-version.txt"
    wpcli wp plugin list --fields=name,status,version --format=csv > "${dir}/plugins.csv"
    wpcli wp theme list --fields=name,status,version --format=csv > "${dir}/themes.csv"
    
    ls -l "${dir}"
    echo "==> 完了: ${dir}"

    当初は WP-CLI の wp db export を使う予定でしたが、WP-CLI の Docker イメージに入っているデータベースのクライアントが、MySQL 8.4 の標準の認証方式(caching_sha2_password)に対応しておらず、接続できませんでした。そこで、データベースのコンテナに入っている mysqldump で書き出しています。パスワードはコマンドラインに書かず、コンテナの環境変数から渡しています。

    📰 出典:MySQL 8.4 Reference Manual「Caching SHA-2 Pluggable Authentication」

    データベースのダンプには、ユーザーのパスワードのハッシュなどが含まれます。backups/ は .gitignore に入れてリポジトリに含めず、フォルダの権限も所有者だけにしています。本番では、サーバーとは別の場所(別のストレージなど)にも保管してください。

    復元用の scripts/restore.sh です。データベースは backup.sh と同じ理由で、データベースのコンテナの mysql で取り込みます。

    scripts/restore.sh(新規・全文)

    #!/usr/bin/env bash
    # 復元: backup.sh で作ったバックアップから、データベースと uploads・languages を戻す。
    # 使い方: ./scripts/restore.sh backups/<日時>
    #
    # 空の環境に戻す手順の例:
    #   docker compose down -v && docker compose up -d && ./scripts/restore.sh backups/20251021-120000
    # - 現在のデータベースの内容は上書きされる。実行前に、今の状態も backup.sh で保存しておくこと。
    # - 復元先の URL が異なる場合は、復元後に wp search-replace で URL を置き換える。
    set -euo pipefail
    
    cd "$(dirname "$0")/.."
    dir="${1:?使い方: ./scripts/restore.sh backups/<日時>}"
    for f in db.sql wp-content.tar.gz; do
      [[ -f "${dir}/${f}" ]] || { echo "${dir}/${f} がありません。" >&2; exit 1; }
    done
    
    wpcli() { docker compose --progress quiet run --rm -T wpcli "$@"; }
    
    echo "==> DB の起動と WordPress コアの展開を待機"
    docker compose up -d --wait db >/dev/null
    for i in $(seq 1 60); do
      if docker compose exec -T wordpress test -f /var/www/html/wp-config.php; then break; fi
      sleep 2
    done
    
    echo "==> データベースを復元"
    # backup.sh と同じ理由で、db コンテナの mysql クライアントを使う。
    docker compose exec -T db sh -c 'MYSQL_PWD="$MYSQL_PASSWORD" exec mysql -u"$MYSQL_USER" --default-character-set=utf8mb4 "$MYSQL_DATABASE"' < "${dir}/db.sql"
    
    echo "==> uploads と翻訳ファイルを復元"
    wpcli sh -c 'tar xzf - -C /var/www/html/wp-content' < "${dir}/wp-content.tar.gz"
    
    wpcli wp cache flush
    wpcli wp rewrite flush
    
    if [[ -f "${dir}/core-version.txt" ]]; then
      echo "==> バックアップ時の WordPress: $(cat "${dir}/core-version.txt") / 現在: $(wpcli wp core version)"
    fi
    echo "==> 完了"

    2つのスクリプトに実行権限を付け、バックアップの保存先を Git の管理から外します。

    chmod +x scripts/backup.sh scripts/restore.sh

    .gitignore に次の変更を加えます(+ が追加、- が削除)。

    --- a/.gitignore
    +++ b/.gitignore
    @@ -11,6 +11,9 @@
     # メディア(アップロードファイル)
     /wp-content/uploads/
     
    +# バックアップ(scripts/backup.sh の出力。DB のダンプを含むため絶対にコミットしない)
    +/backups/
    +
     # 依存・ビルド成果物(ブロックをビルドする回以降)
     node_modules/
     build/

    復元できることを確かめる

    バックアップは、復元できて初めて意味があります。検証では、環境をデータごと削除してから復元しました。

    ./scripts/backup.sh
    docker compose down -v          # データベースと WordPress 本体のボリュームごと削除
    docker compose up -d
    ./scripts/restore.sh backups/<日時>

    restore.sh は、データベースを取り込み、uploads と翻訳ファイルを戻し、キャッシュとリライトルール(URL の対応表)を作り直します。復元先の URL が違う場合は、復元後に wp search-replace で URL を置き換えます。第10回で .htaccess に足したキャッシュの設定は、docker compose down -v で WordPress 本体のボリュームと一緒に消えるため、使う場合は第10回の手順でもう一度足します。

    📰 出典:WordPress Developer Resources「WordPress Backups」

    更新の手順:ステージングで確認してから本番へ

    このサンプルは、連載の再現性のために WordPress 6.8 系の特定のバージョンに固定し、自動更新も止めています。実際のサイトでは、セキュリティ更新を止めずに適用し続ける必要があります。WordPress が公式にサポートするのは最新版だけです。

    📰 出典:WordPress.org「Security」

    更新は、次の手順を基本にします。

    1. 本番のバックアップを取る(backup.sh と同じ内容)
    2. ステージング(本番と同じ構成の確認用環境)に本番のバックアップを復元する
    3. ステージングで更新する(WordPress 本体の最新のマイナー版、テーマ、プラグインの順)
    4. 確認する:トップ・記事・まとめ・ランキングの表示、ブロックエディターでの編集と公開、引用元カード・監修パネル・PR 表記、閲覧数の記録、構造化データ・OGP の出力
    5. 本番を更新する。問題があれば、手順1のバックアップから戻す
    # 更新できるものの確認(ステージングで)
    docker compose run --rm wpcli wp core check-update
    docker compose run --rm wpcli wp plugin list --update=available
    docker compose run --rm wpcli wp theme list --update=available

    Docker で運用する場合は、WordPress 本体を「イメージのタグを上げて入れ替える」のか「WordPress の更新機能で更新する」のかを決めておきます。どちらの方法でも、更新前のバックアップと、ステージングでの確認は同じです。

    📰 出典:WordPress.org Documentation「Updating WordPress」

    また、サンプルの compose.yaml では、管理画面からテーマ・プラグインのファイルを編集する機能を DISALLOW_FILE_EDIT で止めています。管理者のアカウントが乗っ取られたときの被害を小さくするための設定で、本番でも有効にしておくことをおすすめします。

    動作確認の方法

    第0回・第2回の手順の後、プラグインをビルドしてから確認しました(筆者の環境で確認済みです)。ロールとライターの確認は、たとえば次のコマンドで行えます。

    docker compose run --rm wpcli wp role list --fields=name,role
    docker compose run --rm wpcli wp cap list curation_writer
    docker compose run --rm wpcli wp user create writer1 writer1@example.com --role=curation_writer --porcelain
    docker compose run --rm wpcli wp post create --post_title=ライターの記事 --post_status=publish --user=<ライターのユーザーID> --porcelain
    docker compose run --rm wpcli wp post get <作られた記事ID> --field=post_status    # pending になる

    確認できたことは次のとおりです。

    • ロール一覧に「ライター」「編集長」が追加され、ライターの権限は read・edit_posts・delete_posts・upload_files だけ
    • ライターを指定して wp post create --post_status=publish --user=<ライター> を実行すると、記事は「レビュー待ち」になる。管理者を指定した場合は公開される
    • ライターのアプリケーションパスワードで REST API から公開しようとすると 403。レビュー待ちでの提出と画像のアップロードは成功する
    • レビュー待ちになると、管理者と編集長(執筆者本人を除く)あてに通知が作られる
    • 編集長が REST API で、出典名・URL・確認日に不備のある引用元カードを含む記事を公開しようとすると 400 で、問題点の一覧が返る。下書き保存は成功し、不備のない記事は公開できる。監修者だけを設定して監修日がない記事も 400
    • ヘッドレスブラウザで編集長としてブロックエディターから公開すると、公開前チェックのエラーが表示され、記事は下書きのまま
    • backup.sh → docker compose down -v → docker compose up -d → restore.sh で、記事(レビュー待ちを含む)・ユーザー・ロール・画像・日本語化がすべて元に戻る

    つまずきやすい点・セキュリティ上の注意

    • 権限の棚卸し:退職・契約終了した書き手のアカウントや、使われていない管理者アカウントは定期的に削除・権限変更します。アプリケーションパスワードも同様です。
    • 通知メールが届かない:多くのサーバーでは、WordPress 標準のメール送信は迷惑メール扱いや不達になりがちです。送信の仕組みを決めて、実際に届くことを確認します。
    • バックアップの保管と保存期間:同じサーバーにしかないバックアップは、サーバー障害で一緒に失われます。何世代残すか、誰がアクセスできるかも決めます。
    • ロールの変更は既存ユーザーに影響する:ロールの権限を変えると、そのロールの全員に反映されます。変更はステージングで確認してから行います。

    連載のまとめ:全12回の振り返り

    この連載では、WordPress 6.8 の標準機能と、子テーマ1つ・小さな自作プラグイン1つで、キュレーションメディアを組み立ててきました。

    回タイトル主に作ったもの
    0キュレーションメディアの要件と「低品質まとめ」の教訓 ― Docker で WordPress 6.8 の土台を作るDocker 環境、子テーマ・プラグインの雛形、編集方針
    1theme.json でデザイントークンを定義する(子テーマの基本)色・文字・余白、スタイルバリエーション
    2カテゴリ・タグ・「特集」― タクソノミー設計特集タクソノミー、分類のルール
    3記事・まとめ・ランキングのテンプレートとパターン3種類の記事テンプレート、初期パターン
    4「引用元カード」ブロック ― 著作権法第32条の引用を仕組みで守る動的ブロック、必須項目の警告
    5「まとめリスト」と「比較表」をパターンとブロックスタイルで作るまとめリスト、比較表、スマホ対応
    6著者・監修者プロフィールを表示する(E-E-A-T の考え方)著者ボックス、監修パネル
    7人気記事ランキングと関連記事を小さなプラグインで作る閲覧数の REST API、ランキング・関連記事
    8目次と構造化データ(JSON-LD: Article / BreadcrumbList / ItemList)目次、パンくず、JSON-LD
    9OGP・SNS カードと「広告・PR表記」― ステマ規制への対応OGP、PR 表記、rel=”sponsored”
    10表示速度の改善 ― 画像サイズ・キャッシュ・計測画像の sizes、キャッシュ設定、計測
    11権限・編集フロー・運用 ― 下書きレビュー、バックアップ、更新(本記事)ロール、公開前チェック、バックアップと復元

    振り返ると、どの回にも共通する考え方がありました。

    • 見た目は子テーマ、機能はプラグイン:テーマを替えても残すべきもの(特集、引用元カード、PR 表記、構造化データ、ロール)はプラグインに置いた
    • 品質は仕組みで支える:出典の書き忘れ、PR 表記の付け忘れ、監修日の入力漏れを、ブロックの入力欄・自動検出・公開前チェックで防ぐ。ただし最終判断は人が行う
    • 表示とデータを同じところから作る:パンくずと構造化データ、目次と見出しの id のように、ずれが起きない作りにする
    • 保証できないことは保証しない:構造化データはリッチリザルトを、PR 表記は適法性を、閲覧数は正確さを保証しない。その前提を発注者と共有する

    本番公開までに残っている作業

    連載のサンプルは「仕組みを理解するための最小構成」です。実際にサイトを公開するまでには、次の作業が残っています。

    項目決めること・やること
    ホスティングの選択レンタルサーバー・マネージド WordPress・クラウドのどれにするか。ページキャッシュ・CDN・バックアップ機能・PHP と MySQL のバージョン・ステージング環境の有無(第10回)
    ドメインと HTTPSドメインの取得・管理者、SSL 証明書の更新
    バックアップ自動化の方法、保存先、保存期間、復元の練習の頻度
    更新WordPress 本体・テーマ・プラグインの更新の担当と頻度、ステージングでの確認項目。サンプルは特定のバージョンに固定しているが、本番では更新し続ける
    セキュリティ管理者の二要素認証、ログインの保護、不要なアカウントとプラグインの削除、監視
    メール送信通知メールや問い合わせフォームの送信方法
    法務・運用ルールプライバシーポリシー(閲覧数の計測、アクセス解析を含む)、引用ルール、PR 表記の文言、編集ルール

    発注者向けメモ:保守契約で「誰がいつ何をするか」を明文化する

    公開後の運用は、毎月・毎年続くコストです。発注時には、機能の一覧だけでなく、次の点を保守契約(または運用の取り決め)に書いておきましょう。

    • 更新:WordPress 本体・テーマ・プラグインを、誰が、どの頻度で、どこで確認してから更新するか。緊急のセキュリティ更新はどう扱うか
    • バックアップと復旧:何を、どこに、どのくらいの期間残すか。障害時に誰が、どのくらいの時間で復旧するか。復元の練習をするか
    • 権限の管理:アカウントの発行・削除の手順、権限の棚卸しの頻度
    • 編集フロー:誰が書き、誰がレビューし、誰が公開するか。公開前チェックの項目を増やすときの手続き

    工数が増えるのは、承認の段階を増やす場合(例:法務の確認を必須にする)、複数サイトをまとめて運用する場合、24時間の監視や短時間での復旧を求める場合です。

    打ち合わせでは、次のように聞いてみてください。

    • 「バックアップから実際に復元できることを、いつ、どのように確認していますか?」
    • 「WordPress やプラグインのセキュリティ更新が出たとき、何日以内に、どんな手順で適用しますか?」
    • 「ライターが誤って公開してしまうことは、仕組みとして防げていますか?」

    まとめ

    第11回では、権限・編集フロー・運用を扱いました。

    • 独自ロール「ライター」は公開できず、公開しようとしてもレビュー待ちになる。通知の送り先は権限で決める
    • 公開時には引用元カードの必須項目と監修日を自動でチェックし、不備があれば理由を表示して止める
    • バックアップはデータベースと uploads などを対象にし、環境を削除してからの復元まで確認する
    • 更新はバックアップ → ステージングで確認 → 本番の順で行い、本番ではセキュリティ更新を止めない

    全12回にわたってお読みいただき、ありがとうございました。連載のコードは、機能ごとに小さく分けてあります。自社のメディアで使う機能から、少しずつ取り入れてみてください。

    この連載の記事一覧

    この記事は連載「WordPressで作るキュレーションメディア」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。

    システム制作・運用・保守のお問い合わせはこちら

      お問い合わせ


      よかったらシェアしてね!
      • URLをコピーしました!
      • URLをコピーしました!

      この記事を書いた人

      株式会社THIRD HERO代表取締役 朝野貴朗
      Webシステム開発を中心に、toC向けサービスサイトの運営、ツール開発などを行ってまいりました。

      目次