added export context (#2216)

src/Export/Base/PDFRenderer.php

@@ -9,10 +9,10 @@
 
 namespace App\Export\Base;
 
+use App\Export\ExportContext;
 use App\Export\ExportItemInterface;
 use App\Repository\ProjectRepository;
 use App\Repository\Query\TimesheetQuery;
-use App\Timesheet\UserDateTimeFactory;
 use App\Utils\HtmlToPdfConverter;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\HttpFoundation\ResponseHeaderBag;
@@ -26,10 +26,6 @@ class PDFRenderer
      * @var Environment
      */
     private $twig;
-    /**
-     * @var UserDateTimeFactory
-     */
-    private $dateTime;
     /**
      * @var HtmlToPdfConverter
      */
@@ -46,11 +42,14 @@ class PDFRenderer
      * @var string
      */
     private $template = 'default.pdf.twig';
+    /**
+     * @var array
+     */
+    private $pdfOptions = [];
 
-    public function __construct(Environment $twig, UserDateTimeFactory $dateTime, HtmlToPdfConverter $converter, ProjectRepository $projectRepository)
+    public function __construct(Environment $twig, HtmlToPdfConverter $converter, ProjectRepository $projectRepository)
     {
         $this->twig = $twig;
-        $this->dateTime = $dateTime;
         $this->converter = $converter;
         $this->projectRepository = $projectRepository;
     }
@@ -72,6 +71,18 @@ class PDFRenderer
         return ['decimal' => $decimal];
     }
 
+    public function getPdfOptions(): array
+    {
+        return $this->pdfOptions;
+    }
+
+    public function setPdfOption(string $key, string $value): PDFRenderer
+    {
+        $this->pdfOptions[$key] = $value;
+
+        return $this;
+    }
+
     /**
      * @param ExportItemInterface[] $timesheets
      * @param TimesheetQuery $query
@@ -82,21 +93,33 @@ class PDFRenderer
      */
     public function render(array $timesheets, TimesheetQuery $query): Response
     {
+        $context = new ExportContext();
+        $context->setOption('filename', 'kimai-export.pdf');
+
         $summary = $this->calculateSummary($timesheets);
         $content = $this->twig->render($this->getTemplate(), array_merge([
             'entries' => $timesheets,
             'query' => $query,
-            'now' => $this->dateTime->createDateTime(),
+            // @deprecated since 1.13
+            'now' => new \DateTime('now', new \DateTimeZone(date_default_timezone_get())),
             'summaries' => $summary,
             'budgets' => $this->calculateProjectBudget($timesheets, $query, $this->projectRepository),
             'decimal' => false,
+            'pdfContext' => $context
         ], $this->getOptions($query)));
 
-        $content = $this->converter->convertToPdf($content);
+        $pdfOptions = array_merge($context->getOptions(), $this->getPdfOptions());
+
+        $content = $this->converter->convertToPdf($content, $pdfOptions);
 
         $response = new Response($content);
 
-        $disposition = $response->headers->makeDisposition(ResponseHeaderBag::DISPOSITION_ATTACHMENT, 'kimai-export.pdf');
+        $filename = $context->getOption('filename');
+        if (empty($filename)) {
+            $filename = 'kimai-export.pdf';
+        }
+
+        $disposition = $response->headers->makeDisposition(ResponseHeaderBag::DISPOSITION_ATTACHMENT, $filename);
 
         $response->headers->set('Content-Type', 'application/pdf');
         $response->headers->set('Content-Disposition', $disposition);

src/Export/ExportContext.php

@@ -0,0 +1,37 @@
+<?php
+
+/*
+ * This file is part of the Kimai time-tracking app.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace App\Export;
+
+/**
+ * A simple class that is available in twig renderer context, which can be used to define global renderer options.
+ */
+final class ExportContext
+{
+    private $options = [];
+
+    public function setOption(string $key, string $value): void
+    {
+        $this->options[$key] = $value;
+    }
+
+    public function getOptions(): array
+    {
+        return $this->options;
+    }
+
+    public function getOption(string $key): ?string
+    {
+        if (\array_key_exists($key, $this->options)) {
+            return $this->options[$key];
+        }
+
+        return null;
+    }
+}

src/Export/Renderer/PdfRendererFactory.php

@@ -10,7 +10,6 @@
 namespace App\Export\Renderer;
 
 use App\Repository\ProjectRepository;
-use App\Timesheet\UserDateTimeFactory;
 use App\Utils\HtmlToPdfConverter;
 use Twig\Environment;
 
@@ -20,10 +19,6 @@ final class PdfRendererFactory
      * @var Environment
      */
     private $twig;
-    /**
-     * @var UserDateTimeFactory
-     */
-    private $dateTime;
     /**
      * @var HtmlToPdfConverter
      */
@@ -33,17 +28,16 @@ final class PdfRendererFactory
      */
     private $projectRepository;
 
-    public function __construct(Environment $twig, UserDateTimeFactory $dateTime, HtmlToPdfConverter $converter, ProjectRepository $projectRepository)
+    public function __construct(Environment $twig, HtmlToPdfConverter $converter, ProjectRepository $projectRepository)
     {
         $this->twig = $twig;
-        $this->dateTime = $dateTime;
         $this->converter = $converter;
         $this->projectRepository = $projectRepository;
     }
 
     public function create(string $id, string $template): PDFRenderer
     {
-        $renderer = new PDFRenderer($this->twig, $this->dateTime, $this->converter, $this->projectRepository);
+        $renderer = new PDFRenderer($this->twig, $this->converter, $this->projectRepository);
         $renderer->setId($id);
         $renderer->setTemplate($template);