この記事は最後に更新してから1年以上経過しています。
説明
過去の投稿情報を記録するリビジョン機能をカスタム投稿タイプで利用しようと思い作りこみしていたが、思惑通りの動きにならなかった。リビジョン機能は投稿情報の更新前の内容を記録するものと勝手に思い込んでいたのだが、どうやらそれは間違いだった。
リビジョンはどこで作られるのか
リビジョン機能を調べていくと、 wp_insert_post関数の'post_updated'アクションに指定された wp_save_post_revision関数で作られていた。'post_updated'アクションが実行されるタイミングは既存の投稿データを更新した後でその投稿データを元にして、親ID（post_parent）を元となる投稿のIDに、投稿タイプ（post_type）を'revision'に、投稿ステータスを'inherit'にするなど、いくつかの変更を行ってから保存していた。
実際に管理者ページにログインし、新規投稿にてタイトルに'revison check'を、本文に'start!'を入力して公開。その投稿データを確認した。
+-----+---------------+--------------+-------------+-----------+---------------------+
| ID | post_title | post_content | post_parent | post_type | post_date |
+-----+---------------+--------------+-------------+-----------+---------------------+
| 377 | revison check | start! | 0 | post | 2018-09-15 11:14:23 |
+-----+---------------+--------------+-------------+-----------+---------------------+
続いてこの投稿データのリビジョンデータを確認。タイトルと本文は元の投稿データのままである。
+-----+---------------+--------------+-------------+-----------+---------------------+
| ID | post_title | post_content | post_parent | post_type | post_date |
+-----+---------------+--------------+-------------+-----------+---------------------+
| 378 | revison check | start! | 377 | revision | 2018-09-15 11:14:23 |
+-----+---------------+--------------+-------------+-----------+---------------------+
投稿編集ページに戻って本文に'1!'を追加して「公開」ボタンをクリックし、さらに'2!'を追加して「公開」ボタンをクリック。この状態でリビジョンデータを確認した。以下の通り、2つのリビジョンデータが追加されている。
+-----+---------------+--------------+-------------+-----------+---------------------+
| ID | post_title | post_content | post_parent | post_type | post_date |
+-----+---------------+--------------+-------------+-----------+---------------------+
| 380 | revison check | start! 1! 2! | 377 | revision | 2018-09-15 11:17:50 |
| 379 | revison check | start! 1! | 377 | revision | 2018-09-15 11:17:38 |
| 378 | revison check | start! | 377 | revision | 2018-09-15 11:14:23 |
+-----+---------------+--------------+-------------+-----------+---------------------+
今度は投稿編集ページからリビジョンページに移り、1つ前の'1!'を追加した状態に戻してみた。ちなみにプラグインで特定のリビジョンデータに戻す場合は wp_restore_post_revision関数が利用できる。
+-----+---------------+--------------+-------------+-----------+---------------------+
| ID | post_title | post_content | post_parent | post_type | post_date |
+-----+---------------+--------------+-------------+-----------+---------------------+
| 381 | revison check | start! 1! | 377 | revision | 2018-09-15 19:49:47 |
| 380 | revison check | start! 1! 2! | 377 | revision | 2018-09-15 17:14:50 |
| 379 | revison check | start! 1! | 377 | revision | 2018-09-15 17:14:38 |
| 378 | revison check | start! | 377 | revision | 2018-09-15 11:14:23 |
+-----+---------------+--------------+-------------+-----------+---------------------+
データベースを確認してみると、2つ目のリビジョンデータである投稿IDが379のデータは残ったまま、新たに投稿IDが381のリビジョンデータが追加されている。リビジョンを前の状態に戻した場合、ほぼ同じ内容のデータを重複して保持することは意識しておいた方がよいだろう。
リビジョン機能を使用する上で注意すること
ここで想定しているケースはプラグインでリビジョン機能を使いたいカスタム投稿タイプで、ポイントは次の通りである。
- カスタム投稿タイプ登録時、supportsプロパティに'revisions'を含める。
- リビジョンが作成されるのはwp_insert_post関数で投稿データが更新された場合のみであり、新規登録時には作成されない。
- リビジョンデータは更新後の投稿データをもとに作成される。
特に2番目は意識しておいた方がよく、初めからリビジョンデータを残す場合はまずwp_insert_post関数で空のデータを登録し、投稿した投稿IDに対して本番データを更新する手順となる。これをやらないと初めのリビジョンデータが残らない。というか、実際にこれをやってしまったので備忘録として残しておく。
最終更新 : 2018年09月17日 14:46
関連
お勧め
count_users（2019年3月1日 更新）
array count_users( [ string $strategy = 'time' [, int $site_id = null ] ] )
役割別のユーザ数を取得する。
wp_embed_defaults（2011年12月1日 更新）
array wp_embed_defaults( )
投稿記事中に埋め込む動画などのサイズを取得する。
the_posts_navigation（2019年9月25日 更新）
void the_posts_navigation( [ array $args = array() ] )
アーカイブページ向けのナビゲーションを表示する。
show_admin_bar（2012年1月5日 更新）
void show_admin_bar( bool $show )
ツールバー（admin bar）を強制的に表示／非表示する。
wp_spam_comment（2013年9月6日 更新）
bool wp_spam_comment( $comment_id )
コメントをスパムにする。