wp_send_json_success:WordPress私的マニュアル

を
から

WordPress私的マニュアル : トップ
クラス
グローバル変数・定数
コラム
関数

ユーティリティ（126）
操作する（102）

wp_send_json_success

(3.5.0以降)
wp_send_json_success - Ajaxリクエストの成功レスポンスとしてJSON情報を返す

説明

void wp_send_json_success( mixed $response, int $status_code = null )

AJAXリクエストの成功レスポンスとしてJSON情報を返す。

パラメータ

$data
データ内容を指定（省略時は、null）。
$status_code
[4.7.0]HTTPステータスコードを指定（省略時はnull）。

返り値

この関数内で終了するため、何も返さない。

注意

レスポンスの内容は、次の通り。

/* $dataが省略された場合 */
array( 'success' => true );

/* $dataが指定された場合 */
array( 'success' => true, 'data' => $data );

[4.7.0]パラメータ$status_codeが指定された場合は先にステータスヘッダーを出力してからJSON内容を出力する。

使用例

成功レスポンスを返す。
<?php wp_send_json_success(); ?>
変数$dataを添えて成功レスポンスを返す。
<?php wp_send_json_success( $data ); ?>

フィルター

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

アクション

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

ソースファイル

/wp-includes/functions.php

参考

Code Reference: wp_send_json_success

お勧めコンテンツ

投稿記事でrubyタグを使えるようにする（前編）（2012年1月25日登録）

rubyなどのルビ関連タグはIEの独自サポートから始まり、少し前のChrome/Safariが追随して利用できるようになっている。Firefoxはいまだにサポートしていないのだが、それなりに代替表示されるので、投稿記事で使えるようにしてみた。

もうquery_postsは呼ばない（2011年9月27日登録）

トップページやカテゴリーページで標準の条件に少し手を加えた投稿情報を表示するケースがある。そんな時、テンプレートファイルの先頭でquery_posts関数を呼び出して投稿情報を再抽出していたのだが、フィルター処理をうまく使えばquery_posts関数を呼び出さなくても大丈夫みたいだ。

投稿内容に応じてwpautopを制御する（2013年8月13日登録）

投稿内容を表示するthe_content関数では、wpautop関数がフィルターの1つとして呼び出され、改行をbrタグに変換したり、pタグで調整したりする。この機能自体は便利なのだが、きちんとデザインされたHTMLソースを流し込んだ場合はこの機能は好ましくない。そんなわけで、記事内容に応じてwpautop関数を制御できないか考えてみた。

ショートコードを含んだページを表示する前に何か処理する（2014年5月28日登録）

固定ページまたは投稿ページに独自のフォームを埋め込む。入力→登録の2段階のフォームなら著名なプラグイン「Contact Form 7」を利用すればいいのだが、クライアントの依頼は入力→確認→登録の3段階で組み込む要素が特化していたので、独自の実装方法を考えることになった。

投稿ページにキーワード検索ウィジェットを追加する（2012年6月2日登録）

「投稿の編集」ページで記事を編集していると、関連する投稿記事を検索したくなることがある。そんな時、「投稿一覧」ページに戻って「キーワード検索」を行えばいいのだが、そのひと手間がちょっとだけ煩わしい。