Ticket #32246: class-wp-ajax-response.php.patch

wp-includes/class-wp-ajax-response.php

@@ -30 +30 @@
         /**
          * Append to XML response based on given arguments.
          *
-         * The arguments that can be passed in the $args parameter are below. It is
-         * also possible to pass a WP_Error object in either the 'id' or 'data'
-         * argument. The parameter isn't actually optional, content should be given
-         * in order to send the correct response.
+         * @since 2.1.0
          *
-         * 'what' argument is a string that is the XMLRPC response type.
-         * 'action' argument is a boolean or string that acts like a nonce.
-         * 'id' argument can be WP_Error or an integer.
-         * 'old_id' argument is false by default or an integer of the previous ID.
-         * 'position' argument is an integer or a string with -1 = top, 1 = bottom,
-         * html ID = after, -html ID = before.
-         * 'data' argument is a string with the content or message.
-         * 'supplemental' argument is an array of strings that will be children of
-         * the supplemental element.
+         * @param string|array $args {
+         *     Optional. XML response arguments to override defaults.
          *
-         * @since 2.1.0
-         *
-         * @param string|array $args Override defaults.
+         *     @type string          $what         XMLRPC response type. Default is 'object'.
+         *     @type bool            $action       Use nonce. Default is false.
+         *     @type int|WP_Error    $id           The id. Default is '0'.
+         *     @type int|false       $old_id       The previous ID. Default is false.
+         *     @type string          $position     bottom = 1 ; top = -1 ; after = html ID ;
+         *                                         before = -html ID ; Default is 1 (bottom).
+         *     @type string|WP_Error $data         The content or message. Default is empty.
+         *     @type array           $supplemental An array of strings that will be children
+         *                                         of the <supplemental> element.
+         * }
          * @return string XML response.
          */
         public function add( $args = '' ) {
                 $defaults = array(
-                        'what' => 'object', 'action' => false,
-                        'id' => '0', 'old_id' => false,
-                        'position' => 1,
-                        'data' => '', 'supplemental' => array()
+                        'what'         => 'object',
+                        'action'       => false,
+                        'id'           => '0',
+                        'old_id'       => false,
+                        'position'     => 1,
+                        'data'         => '',
+                        'supplemental' => array()
                 );
 
                 $r = wp_parse_args( $args, $defaults );
 
                 $position = preg_replace( '/[^a-z0-9:_-]/i', '', $r['position'] );
-                $id = $r['id'];
-                $what = $r['what'];
-                $action = $r['action'];
-                $old_id = $r['old_id'];
-                $data = $r['data'];
+                $id       = $r['id'];
+                $what     = $r['what'];
+                $action   = $r['action'];
+                $old_id   = $r['old_id'];
+                $data     = $r['data'];
 
                 if ( is_wp_error( $id ) ) {
                         $data = $id;