Ticket #38136: get_pages.diff

src/wp-includes/post.php

@@ -4372 +4372 @@
  * @param array|string $args {
  *     Optional. Array or string of arguments to retrieve pages.
  *
- *     @type int          $child_of     Page ID to return child and grandchild pages of. Note: The value
- *                                      of `$hierarchical` has no bearing on whether `$child_of` returns
- *                                      hierarchical results. Default 0, or no restriction.
- *     @type string       $sort_order   How to sort retrieved pages. Accepts 'ASC', 'DESC'. Default 'ASC'.
- *     @type string       $sort_column  What columns to sort pages by, comma-separated. Accepts 'post_author',
- *                                      'post_date', 'post_title', 'post_name', 'post_modified', 'menu_order',
- *                                      'post_modified_gmt', 'post_parent', 'ID', 'rand', 'comment_count'.
- *                                      'post_' can be omitted for any values that start with it.
- *                                      Default 'post_title'.
- *     @type bool         $hierarchical Whether to return pages hierarchically. If false in conjunction with
- *                                      `$child_of` also being false, both arguments will be disregarded.
- *                                      Default true.
- *     @type array        $exclude      Array of page IDs to exclude. Default empty array.
- *     @type array        $include      Array of page IDs to include. Cannot be used with `$child_of`,
- *                                      `$parent`, `$exclude`, `$meta_key`, `$meta_value`, or `$hierarchical`.
- *                                      Default empty array.
- *     @type string       $meta_key     Only include pages with this meta key. Default empty.
- *     @type string       $meta_value   Only include pages with this meta value. Requires `$meta_key`.
- *                                      Default empty.
- *     @type string       $authors      A comma-separated list of author IDs. Default empty.
- *     @type int          $parent       Page ID to return direct children of. Default -1, or no restriction.
- *     @type string|array $exclude_tree Comma-separated string or array of page IDs to exclude.
- *                                      Default empty array.
- *     @type int          $number       The number of pages to return. Default 0, or all pages.
- *     @type int          $offset       The number of pages to skip before returning. Requires `$number`.
- *                                      Default 0.
- *     @type string       $post_type    The post type to query. Default 'page'.
- *     @type string       $post_status  A comma-separated list of post status types to include.
- *                                      Default 'publish'.
+ *     @type int                $child_of     Page ID to return child and grandchild pages of. Note: The value
+ *                                            of `$hierarchical` has no bearing on whether `$child_of` returns
+ *                                            hierarchical results. Default 0, or no restriction.
+ *     @type string             $sort_order   How to sort retrieved pages. Accepts 'ASC', 'DESC'. Default 'ASC'.
+ *     @type string             $sort_column  What columns to sort pages by, comma-separated. Accepts 'post_author',
+ *                                            'post_date', 'post_title', 'post_name', 'post_modified', 'menu_order',
+ *                                            'post_modified_gmt', 'post_parent', 'ID', 'rand', 'comment_count'.
+ *                                            'post_' can be omitted for any values that start with it.
+ *                                            Default 'post_title'.
+ *     @type bool               $hierarchical Whether to return pages hierarchically. If false in conjunction with
+ *                                           `$child_of` also being false, both arguments will be disregarded.
+ *                                            Default true.
+ *     @type array              $exclude      Array of page IDs to exclude. Default empty array.
+ *     @type array              $include      Array of page IDs to include. Cannot be used with `$child_of`,
+ *                                            `$parent`, `$exclude`, `$meta_key`, `$meta_value`, or `$hierarchical`.
+ *                                            Default empty array.
+ *     @type string             $meta_key     Only include pages with this meta key. Default empty.
+ *     @type string             $meta_value   Only include pages with this meta value. Requires `$meta_key`.
+ *                                            Default empty.
+ *     @type string             $authors      A comma-separated list of author IDs. Default empty.
+ *     @type int                $parent       Page ID to return direct children of. Default -1, or no restriction.
+ *     @type string|array       $exclude_tree Comma-separated string or array of page IDs to exclude.
+ *                                            Default empty array.
+ *     @type int                $number       The number of pages to return. Default 0, or all pages.
+ *     @type int                $offset       The number of pages to skip before returning. Requires `$number`.
+ *                                            Default 0.
+ *     @type string             $post_type    The post type to query. Default 'page'.
+ *     @type string|array       $post_status  A comma-separated list or array of post status types to include.
+ *                                            Default 'publish'.
  * }
  * @return array|false List of pages matching defaults or `$args`.
  */
@@ -4408 +4408 @@
         global $wpdb;
 
         $defaults = array(
-                'child_of' => 0, 'sort_order' => 'ASC',
-                'sort_column' => 'post_title', 'hierarchical' => 1,
-                'exclude' => array(), 'include' => array(),
-                'meta_key' => '', 'meta_value' => '',
-                'authors' => '', 'parent' => -1, 'exclude_tree' => array(),
-                'number' => '', 'offset' => 0,
-                'post_type' => 'page', 'post_status' => 'publish',
+                'child_of'      => 0, 
+                'sort_order'    => 'ASC',
+                'sort_column'   => 'post_title', 
+                'hierarchical'  => 1,
+                'exclude'       => array(), 
+                'include'       => array(),
+                'meta_key'      => '', 
+                'meta_value'    => '',
+                'authors'       => '', 
+                'parent'        => -1, 
+                'exclude_tree'  => array(),
+                'number'        => '', 
+                'offset'        => 0,
+                'post_type'     => 'page', 
+                'post_status'   => 'publish',
         );
 
         $r = wp_parse_args( $args, $defaults );