wp_revisions_to_keep

説明

int wp_revisions_to_keep( WP_Post $post )
投稿情報のリビジョン数を取得する。

パラメータ

  • $post
    投稿情報を指定。

返り値

投稿情報のリビジョン数を返す。


注意

保持するリビジョン数(数値またはtrue)を定義する WP_POST_REVISIONSを参照している。この定数がwp-config.php内で定義されている場合はその値が有効となり、定義されていない場合はtrueが定義される。WP_POST_REVISIONSがtrueの場合、この関数内ではリビジョン数が-1となる。

パラメータ$postの投稿タイプが'revisions'をサポートしていない場合、リビジョン数はWP_POST_REVISIONSの値に関わらず0となる。

[5.8.0]'wp_revisions_to_keep'フィルターの後に"wp_{$post->post_type}_revisions_to_keep"フィルター('wp_post_revisions_to_keep'や'wp_page_revisions_to_keep'など)が追加される。


使用例

  • 投稿情報のリビジョン数を取得する。
    $num = wp_revisions_to_keep( $post );

フィルター

[3.6.0]リビジョン数を返す前に'wp_revisions_to_keep'フィルターを呼び出す。パラメータ$numにはリビジョン数が、$postには本関数が受け取った内容が格納されている。
return (int) $num = apply_filters( 'wp_revisions_to_keep', $num, $post );
[5.8.0]'wp_revisions_to_keep'フィルターの後に"wp_{$post->post_type}_revisions_to_keep"フィルターを呼び出す。パラメータ$numにはリビジョン数が、$postには本関数が受け取った内容が格納されている。
$num = apply_filters( "wp_{$post->post_type}_revisions_to_keep", $num, $post );

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/revision.php

最終更新 : 2023年04月04日 11:31



お勧め

投稿一覧に独自リンクを追加する(2013年10月16日 更新)

管理者ページの「投稿一覧」や「固定ページ一覧」の各投稿記事はマウスポインタを移動すると、「編集」や「クイック編集」といったリンクが表示される。このリンクに独自のリンクを追加する方法を調べてみた。

更新ボタンの横にスピナーを実装する(2019年5月14日 更新)

WordPressの管理画面ではAJAXを使って何らかの処理を行う際、数秒間の空き時間にアイコンがクルクル回る「スピナー」を表示しているところがある。今作っているプラグインでこの「スピナー」を使いたくなったので、実装方法を調べてみた。

ブロックエディターをちょっとだけカスタマイズしてみる(2021年11月3日 更新)

ブロックエディターで投稿を編集していると「ここは〇〇だったらいいのにな」と思うところがある。今回は、そんな気になるところをいくつか(自分好みに)調整してみた。

Login rebuilder 2.3.0の新機能を紹介(2018年5月27日 更新)

プラグイン「Login rebuilder」はログイン時の履歴(ログ)や不正なログインページへのアクセス履歴を保存している。これらの履歴情報はダッシュボートで確認できるが、バージョン2.3.0においてそれぞれがダウンロードできるようになった。

メディア(attachment)を拡張してより便利に活用する(2014年5月22日 更新)

「メディア(attachment)」は、標準ではカテゴリもタグもカスタムフィールドもない。投稿と親子関係を作って利用することが前提だからともいえるが、メディアをもっと便利に活用するために、それらの付加情報を絞り込みの材料として利用できないか調べてみた。