Release 2.30 (#5345)

- added missing InvoiceTemplate company, title) field validator
- graceful fallback for missing working-contract mode
- improve email test command (use configured MAIL_FROM)
- additional form types for simple usage in SystemConfiguration and UserPreferences
- allow to extend the working time query via event

src/Form/DataTransformer/EntityByIdTransformer.php

@@ -0,0 +1,38 @@
+<?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\Form\DataTransformer;
+
+use Doctrine\ORM\EntityRepository;
+use Symfony\Component\Form\DataTransformerInterface;
+
+final class EntityByIdTransformer implements DataTransformerInterface // @phpstan-ignore missingType.generics
+{
+    public function __construct(private readonly EntityRepository $repository) // @phpstan-ignore missingType.generics
+    {
+    }
+
+    public function transform(mixed $value): mixed
+    {
+        if (is_numeric($value)) {
+            return $this->repository->find($value);
+        }
+
+        return $value;
+    }
+
+    public function reverseTransform(mixed $value): mixed
+    {
+        if (\is_object($value) && method_exists($value, 'getId') && $value->getId() !== null) {
+            return (string) $value->getId();
+        }
+
+        return $value;
+    }
+}

src/Form/Type/ActivityByIdType.php

@@ -0,0 +1,32 @@
+<?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\Form\Type;
+
+use App\Form\DataTransformer\EntityByIdTransformer;
+use App\Repository\ActivityRepository;
+use Symfony\Component\Form\AbstractType;
+use Symfony\Component\Form\FormBuilderInterface;
+
+final class ActivityByIdType extends AbstractType
+{
+    public function __construct(private readonly ActivityRepository $repository)
+    {
+    }
+
+    public function buildForm(FormBuilderInterface $builder, array $options): void
+    {
+        $builder->addModelTransformer(new EntityByIdTransformer($this->repository));
+    }
+
+    public function getParent(): string
+    {
+        return ActivityType::class;
+    }
+}

src/Form/Type/CustomerByIdType.php

@@ -0,0 +1,32 @@
+<?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\Form\Type;
+
+use App\Form\DataTransformer\EntityByIdTransformer;
+use App\Repository\CustomerRepository;
+use Symfony\Component\Form\AbstractType;
+use Symfony\Component\Form\FormBuilderInterface;
+
+final class CustomerByIdType extends AbstractType
+{
+    public function __construct(private readonly CustomerRepository $repository)
+    {
+    }
+
+    public function buildForm(FormBuilderInterface $builder, array $options): void
+    {
+        $builder->addModelTransformer(new EntityByIdTransformer($this->repository));
+    }
+
+    public function getParent(): string
+    {
+        return CustomerType::class;
+    }
+}

src/Form/Type/ProjectByIdType.php

@@ -0,0 +1,32 @@
+<?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\Form\Type;
+
+use App\Form\DataTransformer\EntityByIdTransformer;
+use App\Repository\ProjectRepository;
+use Symfony\Component\Form\AbstractType;
+use Symfony\Component\Form\FormBuilderInterface;
+
+final class ProjectByIdType extends AbstractType
+{
+    public function __construct(private readonly ProjectRepository $repository)
+    {
+    }
+
+    public function buildForm(FormBuilderInterface $builder, array $options): void
+    {
+        $builder->addModelTransformer(new EntityByIdTransformer($this->repository));
+    }
+
+    public function getParent(): string
+    {
+        return ProjectType::class;
+    }
+}

src/Form/Type/TeamByIdType.php

@@ -0,0 +1,32 @@
+<?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\Form\Type;
+
+use App\Form\DataTransformer\EntityByIdTransformer;
+use App\Repository\TeamRepository;
+use Symfony\Component\Form\AbstractType;
+use Symfony\Component\Form\FormBuilderInterface;
+
+final class TeamByIdType extends AbstractType
+{
+    public function __construct(private readonly TeamRepository $repository)
+    {
+    }
+
+    public function buildForm(FormBuilderInterface $builder, array $options): void
+    {
+        $builder->addModelTransformer(new EntityByIdTransformer($this->repository));
+    }
+
+    public function getParent(): string
+    {
+        return TeamType::class;
+    }
+}

src/Form/Type/UserByIdType.php

@@ -0,0 +1,32 @@
+<?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\Form\Type;
+
+use App\Form\DataTransformer\EntityByIdTransformer;
+use App\Repository\UserRepository;
+use Symfony\Component\Form\AbstractType;
+use Symfony\Component\Form\FormBuilderInterface;
+
+final class UserByIdType extends AbstractType
+{
+    public function __construct(private readonly UserRepository $repository)
+    {
+    }
+
+    public function buildForm(FormBuilderInterface $builder, array $options): void
+    {
+        $builder->addModelTransformer(new EntityByIdTransformer($this->repository));
+    }
+
+    public function getParent(): string
+    {
+        return UserType::class;
+    }
+}