WP_Comment::get_children

Advertisement

Summery Summery

Get the children of a comment.

Syntax Syntax

WP_Comment::get_children( array $args = array() )

Parameters Parameters

$args

(array) (Optional) Array of arguments used to pass to get_comments() and determine format.

  • 'format'
    (string) Return value format. 'tree' for a hierarchical tree, 'flat' for a flattened array. Default 'tree'.
  • 'status'
    (string) Comment status to limit results by. Accepts 'hold' (comment_status=0), 'approve' (comment_status=1), 'all', or a custom comment status. Default 'all'.
  • 'hierarchical'
    (string) Whether to include comment descendants in the results. 'threaded' returns a tree, with each comment's children stored in a children property on the WP_Comment object. 'flat' returns a flat array of found comments plus their children. Pass false to leave out descendants. The parameter is ignored (forced to false) when $fields is 'ids' or 'counts'. Accepts 'threaded', 'flat', or false. Default: 'threaded'.
  • 'orderby'
    (string|array) Comment status or array of statuses. To use 'meta_value' or 'meta_value_num', $meta_key must also be defined. To sort by a specific $meta_query clause, use that clause's array key. Accepts 'comment_agent', 'comment_approved', 'comment_author', 'comment_author_email', 'comment_author_IP', 'comment_author_url', 'comment_content', 'comment_date', 'comment_date_gmt', 'comment_ID', 'comment_karma', 'comment_parent', 'comment_post_ID', 'comment_type', 'user_id', 'comment__in', 'meta_value', 'meta_value_num', the value of $meta_key, and the array keys of $meta_query. Also accepts false, an empty array, or 'none' to disable ORDER BY clause.

Default value: array()

Return Return

(WP_Comment[]) Array of WP_Comment objects.

Source Source

File: wp-includes/class-wp-comment.php


			

Advertisement

Changelog Changelog

Changelog
Version Description
4.4.0 Introduced.

Advertisement

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.