/** * Traverses a DataTable tree using an array of labels and returns the row * it finds or false if it cannot find one, and the number of segments of * the path successfully walked. * * If $missingRowColumns is supplied, the specified path is created. When * a subtable is encountered w/o the queried label, a new row is created * with the label, and a subtable is added to the row. * * @param array $path The path to walk. An array of label values. * @param array|false $missingRowColumns * The default columns to use when creating new arrays. * If this parameter is supplied, new rows will be * created if labels cannot be found. * @param int $maxSubtableRows The maximum number of allowed rows in new * subtables. * @return array First element is the found row or false. Second element is * the number of path segments walked. If a row is found, this * will be == to count($path). Otherwise, it will be the index * of the path segment that we could not find. */ public function walkPath($path, $missingRowColumns = false, $maxSubtableRows = 0) { $pathLength = count($path); $table = $this; $next = false; for ($i = 0; $i < $pathLength; ++$i) { $segment = $path[$i]; $next = $table->getRowFromLabel($segment); if ($next === false) { // if there is no table to advance to, and we're not adding missing rows, return false if ($missingRowColumns === false) { return array(false, $i); } else { $row = new Piwik_DataTable_Row_DataTableSummary(); $row->setColumns(array('label' => $segment) + $missingRowColumns); $next = $table->addRow($row); if ($next !== $row) { // Summary row, has no metadata $next->deleteMetadata(); return array($next, $i); } } } $table = $next->getSubtable(); if ($table === false) { // if the row has no table (and thus no child rows), and we're not adding // missing rows, return false if ($missingRowColumns === false) { return array(false, $i); } else { if ($i != $pathLength - 1) { $table = new Piwik_DataTable(); $table->setMaximumAllowedRows($maxSubtableRows); $next->setSubtable($table); // Summary row, has no metadata $next->deleteMetadata(); } } } } return array($next, $i); }
/** * Initializes the DataTables created by the archiveDay function. */ private function initActionsTables() { $this->actionsTablesByType = array(); foreach (self::$actionTypes as $type) { $dataTable = new Piwik_DataTable(); $dataTable->setMaximumAllowedRows(Piwik_Actions_ArchivingHelper::$maximumRowsInDataTableLevelZero); $this->actionsTablesByType[$type] = $dataTable; } }