wp_trash_post

(2.9.0以降)
wp_trash_post - 投稿情報をゴミ箱に入れる

説明

mixed wp_trash_post( [ int $post_id = 0 ] )
投稿情報をゴミ箱に入れる。

パラメータ

  • $post_id
    投稿情報IDを指定（省略時は0）。

返り値

ゴミ箱に入れた場合はその投稿情報を返す。投稿情報が見つからなかった場合はnull、すでにゴミ箱に入っている場合はfalseを返す。

注意

EMPTY_TRASH_DAYS（デフォルトは30）が0の場合、ゴミ箱には入れず、wp_delete_post関数を呼び出して投稿情報を削除する。

使用例

  • 投稿IDが10の投稿情報をゴミ箱に入れる。
    <?php wp_trash_post( 10 ); ?>

フィルター

実行するフィルターはありません。

アクション

ゴミ箱に入れる前、wp_trash_postアクションを実行する。
do_action('wp_trash_post', $post_id);
ゴミ箱に入れた後、trashed_postアクションを実行する。
do_action('trashed_post', $post_id);

ソースファイル

/wp-includes/post.php

関連

参考

Code Reference: wp_trash_post

お勧めコンテンツ

さくらのVPSでKUSANAGI#3（2017年5月18日 登録）

今回は「前回」の続き。http（80番）をクローズ、そのほかに行った調整作業について整理する。

Somewhere search box：プラグイン作ってみました（2012年12月24日 登録）

投稿済みの記事を修正する際、毎回「投稿一覧」に戻るのは面倒だ、そんなことを感じて作ったのがこのプラグインです。また1.2.0では投稿内容（本文、カテゴリーや投稿タグ、カスタムフィールド）を複製するリンクを投稿一覧ページと投稿編集ページに追加、1.3.0では投稿タイトルのみの検索をサポートしました。

Paste JSON text：プラグイン作ってみました（2012年1月19日 登録）

動作検証用のサーバーと本番サーバーで投稿データの同期作業（コピー＆ペースト）を支援するプラグインです。動作検証用のサーバーで投稿記事をJSONテキストに変換してクリップボードにコピー。本番サーバーの新規投稿ページでクリップボードにコピーしたJSONテキストをペーストして、投稿記事のコピー＆ペーストを実現します。複数サーバー間で投稿記事の同期を行っている方は、お試しあれ。

カテゴリー専用の投稿一覧と新規投稿メニューを追加する（2012年1月23日 登録）

サイト更新の1クリックを省くため、特定カテゴリーの投稿に対して同じようにメニューを追加してみた。カスタム投稿タイプの専用投稿メニューみたいな感じである。

タイトルのみをキーワード検索する（2014年4月3日 登録）

WordPressのキーワード検索は、投稿タイトルと本文のどちらかに指定したキーワードが含まれているかを調べるわけだが、時々タイトルだけとか、逆に本文だけ検索したいケースがある。

最終更新日時 : 2012-09-13 22:51