dashboards-8.x-1.0-beta10/modules/dashboards_matomo/src/Plugin/Dashboard/OsVersion.php

<?php

namespace Drupal\dashboards_matomo\Plugin\Dashboard;

use Drupal\dashboards\Plugin\DashboardBase;

/**
 * Show account info.
 *
 * @Dashboard(
 *   id = "matomo_os",
 *   label = @Translation("Operating systems."),
 *   category = @Translation("Matomo"),
 * )
 */
class OsVersion extends MatomoBase {

  /**
   * Lazy build callback.
   *
   * @param \Drupal\dashboards\Plugin\DashboardBase $plugin
   *   Matomo base plugin.
   * @param array $configuration
   *   Configuration.
   */
  public static function lazyBuild(DashboardBase $plugin, array $configuration): array {
    if (!($plugin instanceof MatomoBase)) {
      return [];
    }
    try {
      $response = $plugin->query('DevicesDetection.getOsFamilies', [
        'filter_limit' => 20,
        'period' => $configuration['period'],
        'date' => $plugin->getDateTranslated($configuration['date']),
        'flat' => 1,
      ]);

      if (empty($response)) {
        $plugin->setEmpty(TRUE);
        return $plugin->renderChart($configuration);
      }

      $plugin->buildDateRows($response, $plugin->t('Time'), ['nb_visits']);
      $plugin->setChartType($configuration['chart_type']);
      return $plugin->renderChart($configuration);
    }
    catch (\Exception $ex) {
      return [
        '#markup' => $plugin->t('Error occurred: @error', ['@error' => $ex->getMessage()]),
        '#cache' => [
          'max-age' => 0,
        ],
      ];
    }
  }

}