493 lines
16 KiB
PHP
493 lines
16 KiB
PHP
<?php
|
|
/*
|
|
* Copyright (C) 2022 Xibo Signage Ltd
|
|
*
|
|
* Xibo - Digital Signage - http://www.xibo.org.uk
|
|
*
|
|
* This file is part of Xibo.
|
|
*
|
|
* Xibo is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* any later version.
|
|
*
|
|
* Xibo is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Affero General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
* along with Xibo. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
namespace Xibo\Report;
|
|
|
|
use Carbon\Carbon;
|
|
use MongoDB\BSON\UTCDateTime;
|
|
use Psr\Container\ContainerInterface;
|
|
use Symfony\Component\EventDispatcher\EventDispatcher;
|
|
use Xibo\Controller\DataTablesDotNetTrait;
|
|
use Xibo\Entity\ReportForm;
|
|
use Xibo\Entity\ReportResult;
|
|
use Xibo\Entity\ReportSchedule;
|
|
use Xibo\Event\ReportDataEvent;
|
|
use Xibo\Factory\CampaignFactory;
|
|
use Xibo\Factory\DisplayFactory;
|
|
use Xibo\Factory\LayoutFactory;
|
|
use Xibo\Factory\ReportScheduleFactory;
|
|
use Xibo\Helper\ApplicationState;
|
|
use Xibo\Helper\DateFormatHelper;
|
|
use Xibo\Helper\SanitizerService;
|
|
use Xibo\Helper\Translate;
|
|
use Xibo\Support\Exception\GeneralException;
|
|
use Xibo\Support\Exception\NotFoundException;
|
|
use Xibo\Support\Sanitizer\SanitizerInterface;
|
|
|
|
/**
|
|
* Class DisplayAdPlay
|
|
* @package Xibo\Report
|
|
*/
|
|
class DisplayAdPlay implements ReportInterface
|
|
{
|
|
use ReportDefaultTrait, DataTablesDotNetTrait;
|
|
|
|
/**
|
|
* @var CampaignFactory
|
|
*/
|
|
private $campaignFactory;
|
|
|
|
/**
|
|
* @var DisplayFactory
|
|
*/
|
|
private $displayFactory;
|
|
|
|
/**
|
|
* @var LayoutFactory
|
|
*/
|
|
private $layoutFactory;
|
|
|
|
/**
|
|
* @var ReportScheduleFactory
|
|
*/
|
|
private $reportScheduleFactory;
|
|
|
|
/**
|
|
* @var SanitizerService
|
|
*/
|
|
private $sanitizer;
|
|
|
|
/**
|
|
* @var EventDispatcher
|
|
*/
|
|
private $dispatcher;
|
|
|
|
/**
|
|
* @var ApplicationState
|
|
*/
|
|
private $state;
|
|
|
|
/** @inheritdoc */
|
|
public function setFactories(ContainerInterface $container)
|
|
{
|
|
$this->campaignFactory = $container->get('campaignFactory');
|
|
$this->displayFactory = $container->get('displayFactory');
|
|
$this->reportScheduleFactory = $container->get('reportScheduleFactory');
|
|
$this->sanitizer = $container->get('sanitizerService');
|
|
$this->dispatcher = $container->get('dispatcher');
|
|
return $this;
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function getReportChartScript($results)
|
|
{
|
|
return json_encode($results->chart);
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function getReportEmailTemplate()
|
|
{
|
|
return 'display-adplays-email-template.twig';
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function getSavedReportTemplate()
|
|
{
|
|
return 'display-adplays-report-preview';
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function getReportForm()
|
|
{
|
|
return new ReportForm(
|
|
'display-adplays-report-form',
|
|
'displayAdPlay',
|
|
'Connector Reports',
|
|
[
|
|
'fromDateOneDay' => Carbon::now()->subSeconds(86400)->format(DateFormatHelper::getSystemFormat()),
|
|
'toDate' => Carbon::now()->format(DateFormatHelper::getSystemFormat()),
|
|
],
|
|
__('Select a display')
|
|
);
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function getReportScheduleFormData(SanitizerInterface $sanitizedParams)
|
|
{
|
|
$data = [];
|
|
|
|
$data['hiddenFields'] = '';
|
|
$data['reportName'] = 'displayAdPlay';
|
|
|
|
return [
|
|
'template' => 'display-adplays-schedule-form-add',
|
|
'data' => $data
|
|
];
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function setReportScheduleFormData(SanitizerInterface $sanitizedParams)
|
|
{
|
|
$filter = $sanitizedParams->getString('filter');
|
|
$filterCriteria = [
|
|
'filter' => $filter,
|
|
'displayId' => $sanitizedParams->getInt('displayId'),
|
|
'displayIds' => $sanitizedParams->getIntArray('displayIds'),
|
|
];
|
|
|
|
$schedule = '';
|
|
if ($filter == 'daily') {
|
|
$schedule = ReportSchedule::$SCHEDULE_DAILY;
|
|
$filterCriteria['reportFilter'] = 'yesterday';
|
|
} elseif ($filter == 'weekly') {
|
|
$schedule = ReportSchedule::$SCHEDULE_WEEKLY;
|
|
$filterCriteria['reportFilter'] = 'lastweek';
|
|
} elseif ($filter == 'monthly') {
|
|
$schedule = ReportSchedule::$SCHEDULE_MONTHLY;
|
|
$filterCriteria['reportFilter'] = 'lastmonth';
|
|
$filterCriteria['groupByFilter'] = 'byweek';
|
|
} elseif ($filter == 'yearly') {
|
|
$schedule = ReportSchedule::$SCHEDULE_YEARLY;
|
|
$filterCriteria['reportFilter'] = 'lastyear';
|
|
$filterCriteria['groupByFilter'] = 'bymonth';
|
|
}
|
|
|
|
$filterCriteria['sendEmail'] = $sanitizedParams->getCheckbox('sendEmail');
|
|
$filterCriteria['nonusers'] = $sanitizedParams->getString('nonusers');
|
|
|
|
// Return
|
|
return [
|
|
'filterCriteria' => json_encode($filterCriteria),
|
|
'schedule' => $schedule
|
|
];
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function generateSavedReportName(SanitizerInterface $sanitizedParams)
|
|
{
|
|
$saveAs = sprintf(__('%s report for ', ucfirst($sanitizedParams->getString('filter'))));
|
|
|
|
$displayId = $sanitizedParams->getInt('displayId');
|
|
if (!empty($displayId)) {
|
|
// Get display
|
|
try {
|
|
$displayName = $this->displayFactory->getById($displayId)->display;
|
|
$saveAs .= '(Display: '. $displayName . ')';
|
|
} catch (NotFoundException $error) {
|
|
$saveAs .= '(DisplayId: Not Found )';
|
|
}
|
|
}
|
|
|
|
return $saveAs;
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function restructureSavedReportOldJson($result)
|
|
{
|
|
return [
|
|
'periodStart' => $result['periodStart'],
|
|
'periodEnd' => $result['periodEnd'],
|
|
'table' => $result['result'],
|
|
];
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function getSavedReportResults($json, $savedReport)
|
|
{
|
|
// Get filter criteria
|
|
$rs = $this->reportScheduleFactory->getById($savedReport->reportScheduleId, 1)->filterCriteria;
|
|
$filterCriteria = json_decode($rs, true);
|
|
|
|
// Show filter criteria
|
|
$metadata = [];
|
|
|
|
// Get Meta data
|
|
$metadata['periodStart'] = $json['metadata']['periodStart'];
|
|
$metadata['periodEnd'] = $json['metadata']['periodEnd'];
|
|
$metadata['generatedOn'] = Carbon::createFromTimestamp($savedReport->generatedOn)
|
|
->format(DateFormatHelper::getSystemFormat());
|
|
$metadata['title'] = $savedReport->saveAs;
|
|
|
|
// Report result object
|
|
return new ReportResult(
|
|
$metadata,
|
|
$json['table'],
|
|
$json['recordsTotal'],
|
|
$json['chart']
|
|
);
|
|
}
|
|
|
|
/** @inheritDoc */
|
|
public function getResults(SanitizerInterface $sanitizedParams)
|
|
{
|
|
$layoutId = $sanitizedParams->getInt('layoutId');
|
|
$parentCampaignId = $sanitizedParams->getInt('parentCampaignId');
|
|
|
|
// Get campaign
|
|
if (!empty($parentCampaignId)) {
|
|
$campaign = $this->campaignFactory->getById($parentCampaignId);
|
|
}
|
|
|
|
// Display filter.
|
|
try {
|
|
// Get an array of display id this user has access to.
|
|
$displayIds = $this->getDisplayIdFilter($sanitizedParams);
|
|
} catch (GeneralException $exception) {
|
|
// stop the query
|
|
return new ReportResult();
|
|
}
|
|
|
|
//
|
|
// From and To Date Selection
|
|
// --------------------------
|
|
// Our report has a range filter which determines whether the user has to enter their own from / to dates
|
|
// check the range filter first and set from/to dates accordingly.
|
|
$reportFilter = $sanitizedParams->getString('reportFilter');
|
|
|
|
// Use the current date as a helper
|
|
$now = Carbon::now();
|
|
|
|
switch ($reportFilter) {
|
|
case 'today':
|
|
$fromDt = $now->copy()->startOfDay();
|
|
$toDt = $fromDt->copy()->addDay();
|
|
break;
|
|
|
|
case 'yesterday':
|
|
$fromDt = $now->copy()->startOfDay()->subDay();
|
|
$toDt = $now->copy()->startOfDay();
|
|
break;
|
|
|
|
case 'thisweek':
|
|
$fromDt = $now->copy()->locale(Translate::GetLocale())->startOfWeek();
|
|
$toDt = $fromDt->copy()->addWeek();
|
|
break;
|
|
|
|
case 'thismonth':
|
|
$fromDt = $now->copy()->startOfMonth();
|
|
$toDt = $fromDt->copy()->addMonth();
|
|
break;
|
|
|
|
case 'thisyear':
|
|
$fromDt = $now->copy()->startOfYear();
|
|
$toDt = $fromDt->copy()->addYear();
|
|
break;
|
|
|
|
case 'lastweek':
|
|
$fromDt = $now->copy()->locale(Translate::GetLocale())->startOfWeek()->subWeek();
|
|
$toDt = $fromDt->copy()->addWeek();
|
|
break;
|
|
|
|
case 'lastmonth':
|
|
$fromDt = $now->copy()->startOfMonth()->subMonth();
|
|
$toDt = $fromDt->copy()->addMonth();
|
|
break;
|
|
|
|
case 'lastyear':
|
|
$fromDt = $now->copy()->startOfYear()->subYear();
|
|
$toDt = $fromDt->copy()->addYear();
|
|
break;
|
|
|
|
case '':
|
|
default:
|
|
// Expect dates to be provided.
|
|
$fromDt = $sanitizedParams->getDate('fromDt', ['default' => Carbon::now()->subDay()]);
|
|
$fromDt->startOfDay();
|
|
|
|
$toDt = $sanitizedParams->getDate('toDt', ['default' => Carbon::now()]);
|
|
$toDt->endOfDay();
|
|
|
|
// What if the fromdt and todt are exactly the same?
|
|
// in this case assume an entire day from midnight on the fromdt to midnight on the todt (i.e. add a day to the todt)
|
|
if ($fromDt == $toDt) {
|
|
$toDt->addDay();
|
|
}
|
|
|
|
break;
|
|
}
|
|
|
|
$params = [
|
|
'campaignId' => $parentCampaignId,
|
|
'layoutId' => $layoutId,
|
|
'displayIds' => $displayIds,
|
|
'groupBy' => $sanitizedParams->getString('groupBy')
|
|
];
|
|
|
|
// when the reportfilter is wholecampaign take campaign start/end as form/to date
|
|
if (!empty($parentCampaignId) && $sanitizedParams->getString('reportFilter') === 'wholecampaign') {
|
|
$params['fromDt'] = !empty($campaign->getStartDt()) ? $campaign->getStartDt()->format('Y-m-d H:i:s') : null;
|
|
$params['toDt'] = !empty($campaign->getEndDt()) ? $campaign->getEndDt()->format('Y-m-d H:i:s') : null;
|
|
|
|
if (empty($campaign->getStartDt()) || empty($campaign->getEndDt())) {
|
|
return new ReportResult();
|
|
}
|
|
} else {
|
|
$params['fromDt'] = $fromDt->format('Y-m-d H:i:s');
|
|
$params['toDt'] = $toDt->format('Y-m-d H:i:s');
|
|
}
|
|
|
|
// --------
|
|
// ReportDataEvent
|
|
$event = new ReportDataEvent('displayAdPlay');
|
|
|
|
// Set query params for report
|
|
$event->setParams($params);
|
|
|
|
// Dispatch the event - listened by Audience Report Connector
|
|
$this->dispatcher->dispatch($event, ReportDataEvent::$NAME);
|
|
$results = $event->getResults();
|
|
|
|
$result['periodStart'] = $params['fromDt'];
|
|
$result['periodEnd'] = $params['toDt'];
|
|
|
|
$rows = [];
|
|
$labels = [];
|
|
$adPlaysData = [];
|
|
$impressionsData = [];
|
|
$spendData = [];
|
|
$backgroundColor = [];
|
|
|
|
foreach ($results['json'] as $row) {
|
|
// ----
|
|
// Build Chart data
|
|
$labels[] = $row['labelDate'];
|
|
|
|
$backgroundColor[] = 'rgb(34, 207, 207, 0.7)';
|
|
|
|
$adPlays = $row['adPlays'];
|
|
$adPlaysData[] = ($adPlays == '') ? 0 : $adPlays;
|
|
|
|
$impressions = $row['impressions'];
|
|
$impressionsData[] = ($impressions == '') ? 0 : $impressions;
|
|
|
|
$spend = $row['spend'];
|
|
$spendData[] = ($spend == '') ? 0 : $spend;
|
|
|
|
// ----
|
|
// Build Tabular data
|
|
$entry = [];
|
|
|
|
$entry['labelDate'] = $row['labelDate'];
|
|
$entry['adPlays'] = $row['adPlays'];
|
|
$entry['adDuration'] = $row['adDuration'];
|
|
$entry['impressions'] = $row['impressions'];
|
|
$entry['spend'] = $row['spend'];
|
|
|
|
$rows[] = $entry;
|
|
}
|
|
|
|
// Build Chart to pass in twig file chart.js
|
|
$chart = [
|
|
'type' => 'bar',
|
|
'data' => [
|
|
'labels' => $labels,
|
|
'datasets' => [
|
|
[
|
|
'label' => __('Total ad plays'),
|
|
'yAxisID' => 'AdPlay',
|
|
'backgroundColor' => $backgroundColor,
|
|
'data' => $adPlaysData
|
|
],
|
|
[
|
|
'label' => __('Total impressions'),
|
|
'yAxisID' => 'Impression',
|
|
'borderColor' => 'rgba(255,159,64,255)',
|
|
'type' => 'line',
|
|
'fill' => false,
|
|
'data' => $impressionsData
|
|
],
|
|
[
|
|
'label' => __('Total spend'),
|
|
'yAxisID' => 'Spend',
|
|
'borderColor' => 'rgba(255,99,132,255)',
|
|
'type' => 'line',
|
|
'fill' => false,
|
|
'data' => $spendData
|
|
]
|
|
]
|
|
],
|
|
'options' => [
|
|
'scales' => [
|
|
'yAxes' => [
|
|
[
|
|
'id' => 'AdPlay',
|
|
'type' => 'linear',
|
|
'position' => 'left',
|
|
'display' => true,
|
|
'scaleLabel' => [
|
|
'display' => true,
|
|
'labelString' => __('Ad Play(s)')
|
|
],
|
|
'ticks' => [
|
|
'beginAtZero' => true
|
|
]
|
|
], [
|
|
'id' => 'Impression',
|
|
'type' => 'linear',
|
|
'position' => 'right',
|
|
'display' => true,
|
|
'scaleLabel' => [
|
|
'display' => true,
|
|
'labelString' => __('Impression(s)')
|
|
],
|
|
'ticks' => [
|
|
'beginAtZero' => true
|
|
]
|
|
], [
|
|
'id' => 'Spend',
|
|
'type' => 'linear',
|
|
'position' => 'right',
|
|
'display' => true,
|
|
'scaleLabel' => [
|
|
'display' => true,
|
|
'labelString' => __('Spend')
|
|
],
|
|
'ticks' => [
|
|
'beginAtZero' => true
|
|
]
|
|
]
|
|
]
|
|
]
|
|
]
|
|
];
|
|
|
|
// Set Meta data
|
|
$metadata = [
|
|
'periodStart' => $result['periodStart'],
|
|
'periodEnd' => $result['periodEnd'],
|
|
];
|
|
|
|
$recordsTotal = count($rows);
|
|
|
|
// ----
|
|
// Table Only
|
|
// Return data to build chart/table
|
|
// This will get saved to a json file when schedule runs
|
|
return new ReportResult(
|
|
$metadata,
|
|
$rows,
|
|
$recordsTotal,
|
|
$chart,
|
|
$results['error'] ?? null
|
|
);
|
|
}
|
|
}
|