WP_Ajax_Response::add( string|array $args = '' ): string

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 ) ) {88			$data = $id;89			$id   = 0;90		}91 92		$response = '';93		if ( is_wp_error( $data ) ) {94			foreach ( (array) $data->get_error_codes() as $code ) {95				$response  .= "<wp_error code='$code'><![CDATA[" . $data->get_error_message( $code ) . ']]></wp_error>';96				$error_data = $data->get_error_data( $code );97				if ( ! $error_data ) {98					continue;99				}100				$class = '';101				if ( is_object( $error_data ) ) {102					$class      = ' class="' . get_class( $error_data ) . '"';103					$error_data = get_object_vars( $error_data );104				}105 106				$response .= "<wp_error_data code='$code'$class>";107 108				if ( is_scalar( $error_data ) ) {109					$response .= "<![CDATA[$error_data]]>";110				} elseif ( is_array( $error_data ) ) {111					foreach ( $error_data as $k => $v ) {112						$response .= "<$k><![CDATA[$v]]></$k>";113					}114				}115 116				$response .= '</wp_error_data>';117			}118		} else {119			$response = "<response_data><![CDATA[$data]]></response_data>";120		}121 122		$s = '';123		if ( is_array( $parsed_args['supplemental'] ) ) {124			foreach ( $parsed_args['supplemental'] as $k => $v ) {125				$s .= "<$k><![CDATA[$v]]></$k>";126			}127			$s = "<supplemental>$s</supplemental>";128		}129 130		if ( false === $action ) {131			$action = $_POST['action'];132		}133		$x  = '';134		$x .= "<response action='{$action}_$id'>"; // The action attribute in the xml output is formatted like a nonce action.135		$x .= "<$what id='$id' " . ( false === $old_id ? '' : "old_id='$old_id' " ) . "position='$position'>";136		$x .= $response;137		$x .= $s;138		$x .= "</$what>";139		$x .= '</response>';140 141		$this->responses[] = $x;142		return $x;143	}