Ticket #13937: add_meta_box.diff

wp-admin/includes/template.php

@@ -2761 +2761 @@
 /**
  * Add a meta box to an edit form.
  *
+ * The list of arguments is below:
+ *              'id' (string) String for use in the 'id' attribute of tags.
+ *              'title' (string) Title of the meta box.
+ *              'callback' (callback) Function that fills the box with the desired content. The function should echo its output.
+ *              'callback_args' (array) A list of arguments to pass to the callback.
+ *              'page' (string) The type of edit page on which to show the box (post, page, link).
+ *              'context' (string) The context within the page where the boxes should show ('normal', 'advanced').
+ *              'priority' (string) The priority within the context where the boxes should show ('high', 'low').
+ *
  * @since 2.5.0
  *
- * @param string $id String for use in the 'id' attribute of tags.
- * @param string $title Title of the meta box.
- * @param string $callback Function that fills the box with the desired content. The function should echo its output.
- * @param string $page The type of edit page on which to show the box (post, page, link).
- * @param string $context The context within the page where the boxes should show ('normal', 'advanced').
- * @param string $priority The priority within the context where the boxes should show ('high', 'low').
+ * @param string|array $args List of arguments
  */
-function add_meta_box($id, $title, $callback, $page, $context = 'advanced', $priority = 'default', $callback_args=null) {
+function add_meta_box( $args ) {
+
+        $argc = func_num_args();
+
+        if ( $argc > 1 ) {
+                _deprecated_argument( __FUNCTION__, '3.1', __('Passing individual arguments is deprecated. Use an associative array of arguments instead.') );
+
+                $argv = func_get_args();
+
+                $args = array();
+                foreach ( array( 'id', 'title', 'callback', 'page', 'context', 'priority', 'callback_args' ) as $i => $name ) {
+                        if ( $i < $argc )
+                                $args[ $name ] = $argv[ $i ];
+                        else
+                                break;
+                }
+        }
+
+        $defaults = array(
+                'id' => '',
+                'title' => '',
+                'callback' => '',
+                'callback_args' => null,
+                'page' => '',
+                'context' => 'advanced',
+                'priority' => 'default',
+        );
+
+        extract( wp_parse_args( $args, $defaults ), EXTR_SKIP );
+
         global $wp_meta_boxes;
 
         if ( !isset($wp_meta_boxes) )