Release 1.6.2 (#1289)

* include user teams in user entity
* prevent unauthorized access via API
* improve teamlead permission handling in team timesheets
* add team data to user entity
* add security tests
* highlight menu for invoice template copy
* unified handling of invoice data across all templates
* access to the current users data in invoice templates
* permission improvement in invoice form
* allow to skip record rows
* allow to add new invoice locations without overwriting the global ones
* allow to order user preferences
* change permission for normal users with access to view_other_timesheets
* properly validate invoice template field length
* allow to replace multiple variables in cell values text
* upgraded office invoice template
* doctrine deprecation fix
* upgrade phpoffice/phpword
* fix future begin check for default rounding rules
* dashboard widget counter: respect visibility and teams - fixes #1161
* fix future begin check for default rounding rules
* added new events for pre and post invoice rendering
* fix permission issue for users without team seeing all records
* prevent error in spreadsheet renderer for empty invoices

src/Invoice/InvoiceFormatter.php

@@ -0,0 +1,55 @@
+<?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\Invoice;
+
+/**
+ * @internal this is subject to change
+ */
+interface InvoiceFormatter
+{
+    /**
+     * @param \DateTime $date
+     * @return mixed
+     */
+    public function getFormattedDateTime(\DateTime $date);
+
+    /**
+     * @param \DateTime $date
+     * @return mixed
+     */
+    public function getFormattedTime(\DateTime $date);
+
+    /**
+     * @param int $amount
+     * @param string|null $currency
+     * @return mixed
+     */
+    public function getFormattedMoney($amount, $currency);
+
+    /**
+     * @param \DateTime $date
+     * @return mixed
+     */
+    public function getFormattedMonthName(\DateTime $date);
+
+    /**
+     * @param int $seconds
+     * @return mixed
+     */
+    public function getFormattedDuration($seconds);
+
+    /**
+     * @param int $seconds
+     * @return mixed
+     */
+    public function getFormattedDecimalDuration($seconds);
+
+    public function getCurrencySymbol(string $currency): string;
+}