From 4a95bfa4c2097a45ead84e6070cea845d8a8c775 Mon Sep 17 00:00:00 2001 From: Sergey Biryukov Date: Sun, 16 Oct 2016 01:10:31 +0000 Subject: [PATCH] Docs: In `get_pages()` and `wp_list_pages()`, note that `post_status` argument can also be an array. Adjust the alignment of default argument values for better readability. Props birgire, desrosj. Fixes #38136. Built from https://develop.svn.wordpress.org/trunk@38798 git-svn-id: http://core.svn.wordpress.org/trunk@38741 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-includes/post-template.php | 66 ++++++++++++++++++++--------------- wp-includes/post.php | 24 ++++++++----- wp-includes/version.php | 2 +- 3 files changed, 54 insertions(+), 38 deletions(-) diff --git a/wp-includes/post-template.php b/wp-includes/post-template.php index 1214129588..9e2b3a09e5 100644 --- a/wp-includes/post-template.php +++ b/wp-includes/post-template.php @@ -1134,40 +1134,48 @@ function wp_dropdown_pages( $args = '' ) { * @param array|string $args { * Array or string of arguments. Optional. * - * @type int $child_of Display only the sub-pages of a single page by ID. Default 0 (all pages). - * @type string $authors Comma-separated list of author IDs. Default empty (all authors). - * @type string $date_format PHP date format to use for the listed pages. Relies on the 'show_date' parameter. - * Default is the value of 'date_format' option. - * @type int $depth Number of levels in the hierarchy of pages to include in the generated list. - * Accepts -1 (any depth), 0 (all pages), 1 (top-level pages only), and n (pages to - * the given n depth). Default 0. - * @type bool $echo Whether or not to echo the list of pages. Default true. - * @type string $exclude Comma-separated list of page IDs to exclude. Default empty. - * @type array $include Comma-separated list of page IDs to include. Default empty. - * @type string $link_after Text or HTML to follow the page link label. Default null. - * @type string $link_before Text or HTML to precede the page link label. Default null. - * @type string $post_type Post type to query for. Default 'page'. - * @type string $post_status Comma-separated list of post statuses to include. Default 'publish'. - * @type string $show_date Whether to display the page publish or modified date for each page. Accepts - * 'modified' or any other value. An empty value hides the date. Default empty. - * @type string $sort_column Comma-separated list of column names to sort the pages by. Accepts 'post_author', - * 'post_date', 'post_title', 'post_name', 'post_modified', 'post_modified_gmt', - * 'menu_order', 'post_parent', 'ID', 'rand', or 'comment_count'. Default 'post_title'. - * @type string $title_li List heading. Passing a null or empty value will result in no heading, and the list - * will not be wrapped with unordered list `