WP_Ajax_Response

8#[AllowDynamicProperties]9class WP_Ajax_Response {10	/**11	 * Store XML responses to send.12	 *13	 * @since 2.1.014	 * @var array15	 */16	public $responses = array();17 18	/**19	 * Constructor - Passes args to WP_Ajax_Response::add().20	 *21	 * @since 2.1.022	 *23	 * @see WP_Ajax_Response::add()24	 *25	 * @param string|array $args Optional. Will be passed to add() method.26	 */27	public function __construct( $args = '' ) {28		if ( ! empty( $args ) ) {29			$this->add( $args );30		}31	}32 33	/**34	 * Appends data to an XML response based on given arguments.35	 *36	 * With `$args` defaults, extra data output would be:37	 *38	 *     <response action='{$action}_$id'>39	 *      <$what id='$id' position='$position'>40	 *          <response_data><![CDATA[$data]]></response_data>41	 *      </$what>42	 *     </response>43	 *44	 * @since 2.1.045	 *46	 * @param string|array $args {47	 *     Optional. An array or string of XML response arguments.48	 *49	 *     @type string          $what         XML-RPC response type. Used as a child element of `<response>`.50	 *                                         Default 'object' (`<object>`).51	 *     @type string|false    $action       Value to use for the `action` attribute in `<response>`. Will be52	 *                                         appended with `_$id` on output. If false, `$action` will default to53	 *                                         the value of `$_POST['action']`. Default false.54	 *     @type int|WP_Error    $id           The response ID, used as the response type `id` attribute. Also55	 *                                         accepts a `WP_Error` object if the ID does not exist. Default 0.56	 *     @type int|false       $old_id       The previous response ID. Used as the value for the response type57	 *                                         `old_id` attribute. False hides the attribute. Default false.58	 *     @type string          $position     Value of the response type `position` attribute. Accepts 1 (bottom),59	 *                                         -1 (top), HTML ID (after), or -HTML ID (before). Default 1 (bottom).60	 *     @type string|WP_Error $data         The response content/message. Also accepts a WP_Error object if the61	 *                                         ID does not exist. Default empty.62	 *     @type array           $supplemental An array of extra strings that will be output within a `<supplemental>`63	 *                                         element as CDATA. Default empty array.64	 * }65	 * @return string XML response.66	 */67	public function add( $args = '' ) {68		$defaults = array(69			'what'         => 'object',70			'action'       => false,71			'id'           => '0',72			'old_id'       => false,73			'position'     => 1,74			'data'         => '',75			'supplemental' => array(),76		);77 78		$parsed_args = wp_parse_args( $args, $defaults );79 80		$position = preg_replace( '/[^a-z0-9:_-]/i', '', $parsed_args['position'] );81		$id       = $parsed_args['id'];82		$what     = $parsed_args['what'];83		$action   = $parsed_args['action'];84		$old_id   = $parsed_args['old_id'];85		$data     = $parsed_args['data'];86 87		if ( is_wp_error( $id ) ) {