ConsoleCommand
2 years ago
Dimension
1 year ago
API.php
1 year ago
AggregatedMetric.php
2 years ago
ArchivedMetric.php
1 year ago
Archiver.php
1 year ago
Categories.php
2 years ago
ComponentFactory.php
2 years ago
ComputedMetric.php
1 year ago
ConsoleCommand.php
1 year ago
Controller.php
1 year ago
ControllerAdmin.php
1 year ago
Dependency.php
1 year ago
LogTablesProvider.php
2 years ago
Manager.php
1 year ago
Menu.php
1 year ago
MetadataLoader.php
1 year ago
Metric.php
1 year ago
PluginException.php
1 year ago
ProcessedMetric.php
1 year ago
ReleaseChannels.php
2 years ago
Report.php
1 year ago
ReportsProvider.php
2 years ago
RequestProcessors.php
2 years ago
Segment.php
1 year ago
SettingsProvider.php
2 years ago
Tasks.php
1 year ago
ThemeStyles.php
2 years ago
ViewDataTable.php
1 year ago
Visualization.php
1 year ago
WidgetsProvider.php
2 years ago
ProcessedMetric.php
83 lines
| 1 | <?php |
| 2 | |
| 3 | /** |
| 4 | * Matomo - free/libre analytics platform |
| 5 | * |
| 6 | * @link https://matomo.org |
| 7 | * @license https://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later |
| 8 | */ |
| 9 | namespace Piwik\Plugin; |
| 10 | |
| 11 | use Piwik\DataTable; |
| 12 | use Piwik\DataTable\Row; |
| 13 | /** |
| 14 | * Base type for processed metrics. A processed metric is a metric that is computed using |
| 15 | * one or more other metrics. |
| 16 | * |
| 17 | * @api |
| 18 | */ |
| 19 | abstract class ProcessedMetric extends \Piwik\Plugin\Metric |
| 20 | { |
| 21 | /** |
| 22 | * The sub-namespace name in a plugin where ProcessedMetrics are stored. |
| 23 | */ |
| 24 | public const COMPONENT_SUBNAMESPACE = 'Columns\\Metrics'; |
| 25 | /** |
| 26 | * Computes the metric using the values in a {@link Piwik\DataTable\Row}. |
| 27 | * |
| 28 | * The computed value should be numerical and not formatted in any way. For example, for |
| 29 | * a percent value, `0.14` should be returned instead of `"14%"`. |
| 30 | * |
| 31 | * @return mixed |
| 32 | */ |
| 33 | public abstract function compute(Row $row); |
| 34 | /** |
| 35 | * Returns the array of metrics that are necessary for computing this metric. The elements |
| 36 | * of the array are metric names. |
| 37 | * |
| 38 | * @return string[] |
| 39 | */ |
| 40 | public abstract function getDependentMetrics(); |
| 41 | /** |
| 42 | * Returns the array of metrics that are necessary for computing this metric, but should not |
| 43 | * be displayed to the user unless explicitly requested. These metrics are intermediate |
| 44 | * metrics that are not really valuable to the user. On a request, if showColumns or hideColumns |
| 45 | * is not used, they will be removed automatically. |
| 46 | * |
| 47 | * @return string[] |
| 48 | */ |
| 49 | public function getTemporaryMetrics() |
| 50 | { |
| 51 | return array(); |
| 52 | } |
| 53 | /** |
| 54 | * Executed before computing all processed metrics for a report. Implementers can return `false` |
| 55 | * to skip computing this metric. |
| 56 | * |
| 57 | * @param Report $report |
| 58 | * @param DataTable $table |
| 59 | * @return bool Return `true` to compute the metric for the table, `false` to skip computing |
| 60 | * this metric. |
| 61 | */ |
| 62 | public function beforeCompute($report, DataTable $table) |
| 63 | { |
| 64 | return \true; |
| 65 | } |
| 66 | /** |
| 67 | * @param Row $row |
| 68 | * @ignore |
| 69 | */ |
| 70 | public function beforeComputeSubtable(Row $row) |
| 71 | { |
| 72 | // empty |
| 73 | } |
| 74 | /** |
| 75 | * @param Row $row |
| 76 | * @ignore |
| 77 | */ |
| 78 | public function afterComputeSubtable(Row $row) |
| 79 | { |
| 80 | // empty |
| 81 | } |
| 82 | } |
| 83 |