function getActiveChildren($id=0, $sort='menuindex', $dir='', $fields='id, pagetitle, longtitle, description, parent, alias, showinmenu', $limit="", $showhidden=false) {
// returns a two dimensional array of $key=>$value data for active documents only
// $id = id of the document whose children have been requested
// $sort = the field to sort the result by
// $dir = sort direction (ASC|DESC)
// $fields = comma delimited list of fields to be returned for each record
// $limit = maximun number of records to return (default=all)
// $showhidden = setting to [true|1] will override the showinmenu flag setting (default=false)
Sending all parameters, including
$showhidden = true; will bypass the default setting... The
getAllChildren(),
getActiveChildren(), and
getDocuments() API functions are the only three that use this method and all are set to false by default... Oh, yeah, and bacause
getDocument() actually calls
getDocuments(), it uses it too... I agree that it shouldn't and will evaluate which functions will or won't make use of it before the v1.0 release...