jjsm01/kimai2
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

Invoices: show only custom documents in upload form (#1786)

Browse Source
This commit is contained in:
Kevin Papst
2020-06-19 18:31:08 +02:00
committed by GitHub
parent 470a6b30e0
commit 381f46cdd8
16 changed files with 222 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
src/Controller/InvoiceController.php
View File

@@ -284,29 +284,34 @@ final class InvoiceController extends AbstractController
*/
public function uploadDocumentAction(Request $request, string $projectDirectory, InvoiceDocumentRepository $documentRepository)
{
$dir = $documentRepository->getCustomInvoiceDirectory();
$invoiceDir = $projectDirectory . DIRECTORY_SEPARATOR . $dir;
$dir = $documentRepository->getUploadDirectory();
$invoiceDir = $dir;
// do not execute realpath, as it will return an empty string if the invoice directory is NOT existing!
if ($invoiceDir[0] !== '/') {
$invoiceDir = $projectDirectory . DIRECTORY_SEPARATOR . $dir;
}
$canUpload = true;
$form = null;
if (!file_exists($invoiceDir)) {
@mkdir($invoiceDir);
@mkdir($invoiceDir, 0777);
}
if (!file_exists($invoiceDir)) {
$this->flashError(sprintf('Invoice directory is not existing and could not be created: %s', $dir));
$canUpload = false;
}
if (!is_writable($invoiceDir)) {
$this->flashError(sprintf('Invoice directory cannot be written: %s', $dir));
if (!is_dir($invoiceDir)) {
$this->flashError(sprintf('Invoice directory "%s" is not existing and could not be created.', $dir));
$canUpload = false;
} elseif (!is_writable($invoiceDir)) {
$this->flashError(sprintf('Invoice directory "%s" cannot be written.', $dir));
$canUpload = false;
}
$form = $this->createForm(InvoiceDocumentUploadForm::class, null, [
'action' => $this->generateUrl('admin_invoice_document_upload', []),
'method' => 'POST'
]);
if ($canUpload) {
$form = $this->createForm(InvoiceDocumentUploadForm::class, null, [
'action' => $this->generateUrl('admin_invoice_document_upload', []),
'method' => 'POST'
]);
$form->handleRequest($request);
if ($form->isSubmitted() && $form->isValid()) {
@@ -334,8 +339,8 @@ final class InvoiceController extends AbstractController
}
return $this->render('invoice/document_upload.html.twig', [
'form' => (null !== $form) ? $form->createView() : null,
'documents' => $this->service->getDocuments(),
'form' => $form->createView(),
'documents' => $this->service->getDocuments(true),
'baseDirectory' => $projectDirectory . DIRECTORY_SEPARATOR,
]);
}

2
src/DataFixtures/CustomerFixtures.php
View File

@@ -13,7 +13,7 @@ use App\Entity\Activity;
use App\Entity\Customer;
use App\Entity\Project;
use Doctrine\Bundle\FixturesBundle\Fixture;
use Doctrine\Common\Persistence\ObjectManager;
use Doctrine\Persistence\ObjectManager;
use Faker\Factory;
use Faker\Generator;

3
src/DataFixtures/InvoiceFixtures.php
View File

@@ -11,7 +11,7 @@ namespace App\DataFixtures;
use App\Entity\InvoiceTemplate;
use Doctrine\Bundle\FixturesBundle\Fixture;
use Doctrine\Common\Persistence\ObjectManager;
use Doctrine\Persistence\ObjectManager;
use Faker\Factory;
use Faker\Generator;
@@ -86,6 +86,7 @@ class InvoiceFixtures extends Fixture
// name, title, renderer, calculator, numberGenerator, company, vat, dueDays, address, paymentTerms
return [
['Invoice (PDF)', 'Invoice', 'default-pdf', 'default', 'default', $faker->company, 16, 10, $paymentTerms],
['Invoice (HTML)', 'Company name', 'default', 'default', 'default', $faker->company, 19, 30, $paymentTerms],
['Freelancer (HTML, short)', 'Invoice', 'freelancer', 'short', 'default', $faker->company, 19, 14, $paymentTerms_de],
['Timesheet (HTML)', 'Timesheet', 'timesheet', 'default', 'default', $faker->company, 19, 7, $paymentTerms_alt],

2
src/DataFixtures/TagFixtures.php
View File

@@ -11,7 +11,7 @@ namespace App\DataFixtures;
use App\Entity\Tag;
use Doctrine\Bundle\FixturesBundle\Fixture;
use Doctrine\Common\Persistence\ObjectManager;
use Doctrine\Persistence\ObjectManager;
use Faker\Factory;
/**

2
src/DataFixtures/TeamFixtures.php
View File

@@ -14,7 +14,7 @@ use App\Entity\Team;
use App\Entity\User;
use Doctrine\Bundle\FixturesBundle\Fixture;
use Doctrine\Common\DataFixtures\DependentFixtureInterface;
use Doctrine\Common\Persistence\ObjectManager;
use Doctrine\Persistence\ObjectManager;
use Faker\Factory;
/**

2
src/DataFixtures/TimesheetFixtures.php
View File

@@ -18,7 +18,7 @@ use App\Entity\UserPreference;
use App\Timesheet\Util;
use Doctrine\Bundle\FixturesBundle\Fixture;
use Doctrine\Common\DataFixtures\DependentFixtureInterface;
use Doctrine\Common\Persistence\ObjectManager;
use Doctrine\Persistence\ObjectManager;
use Faker\Factory;
/**

2
src/DataFixtures/UserFixtures.php
View File

@@ -12,7 +12,7 @@ namespace App\DataFixtures;
use App\Entity\User;
use App\Entity\UserPreference;
use Doctrine\Bundle\FixturesBundle\Fixture;
use Doctrine\Common\Persistence\ObjectManager;
use Doctrine\Persistence\ObjectManager;
use Faker\Factory;
use Symfony\Component\Security\Core\Encoder\UserPasswordEncoderInterface;

3
src/DependencyInjection/Configuration.php
View File

@@ -11,6 +11,7 @@ namespace App\DependencyInjection;
use App\Entity\Customer;
use App\Entity\User;
use App\Repository\InvoiceDocumentRepository;
use App\Timesheet\Rounding\RoundingInterface;
use App\Widget\Type\CompoundRow;
use App\Widget\Type\Counter;
@@ -215,7 +216,7 @@ class Configuration implements ConfigurationInterface
->scalarPrototype()->end()
->defaultValue([
'var/invoices/',
'templates/invoice/renderer/'
InvoiceDocumentRepository::DEFAULT_DIRECTORY
])
->end()
->arrayNode('documents')

37
src/Form/InvoiceDocumentUploadForm.php
View File

@@ -9,14 +9,28 @@
namespace App\Form;
use App\Repository\InvoiceDocumentRepository;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\FileType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\HttpFoundation\File\UploadedFile;
use Symfony\Component\OptionsResolver\OptionsResolver;
use Symfony\Component\Validator\Constraints\Callback;
use Symfony\Component\Validator\Constraints\File;
use Symfony\Component\Validator\Context\ExecutionContextInterface;
class InvoiceDocumentUploadForm extends AbstractType
{
/**
* @var InvoiceDocumentRepository
*/
private $repository;
public function __construct(InvoiceDocumentRepository $repository)
{
$this->repository = $repository;
}
/**
* {@inheritdoc}
*/
@@ -37,12 +51,33 @@ class InvoiceDocumentUploadForm extends AbstractType
'application/vnd.oasis.opendocument.spreadsheet',
],
'mimeTypesMessage' => 'This file type is not allowed',
])
]),
new Callback([$this, 'validateDocument'])
],
])
;
}
public function validateDocument($value, ExecutionContextInterface $context)
{
if (!($value instanceof UploadedFile)) {
return;
}
$name = $value->getClientOriginalName();
foreach ($this->repository->findBuiltIn() as $document) {
if ($document->getName() !== $name) {
continue;
}
$context->buildViolation('This invoice document cannot be used, please rename the file and upload it again.')
->setTranslationDomain('validators')
->setCode('kimai-invoice-document-upload-01')
->addViolation();
}
}
/**
* {@inheritdoc}
*/

7
src/Invoice/ServiceInvoice.php
View File

@@ -134,10 +134,15 @@ final class ServiceInvoice
/**
* Returns an array of invoice renderer, which will consist of a unique name and a controller action.
*
* @param bool $customOnly
* @return InvoiceDocument[]
*/
public function getDocuments(): array
public function getDocuments(bool $customOnly = false): array
{
if ($customOnly) {
return $this->documents->findCustom();
}
return $this->documents->findAll();
}

100
src/Repository/InvoiceDocumentRepository.php
View File

@@ -14,6 +14,8 @@ use Symfony\Component\Finder\Finder;
final class InvoiceDocumentRepository
{
public const DEFAULT_DIRECTORY = 'templates/invoice/renderer/';
/**
* @var array
*/
@@ -21,12 +23,48 @@ final class InvoiceDocumentRepository
public function __construct(array $directories)
{
$this->documentDirs = $directories;
foreach ($directories as $directory) {
$this->addDirectory($directory);
}
}
public function addDirectory(string $directory)
{
$this->documentDirs[] = $directory;
return $this;
}
public function removeDirectory(string $directory)
{
if (($key = array_search($directory, $this->documentDirs)) !== false) {
unset($this->documentDirs[$key]);
}
return $this;
}
/**
* @deprecated since 1.10 - will be removed with 2.0 - use getCustomInvoiceDirectory() instead
*/
public function getCustomInvoiceDirectory(): string
{
return $this->documentDirs[0];
return $this->getUploadDirectory();
}
public function getUploadDirectory(): string
{
// reverse the array, as bundles can register invoice directories a well (as prepend extensions)
// and then the first entries are the directories from the bundles and not the default ones registered in Kimai
foreach (array_reverse($this->documentDirs) as $dir) {
if ($dir === self::DEFAULT_DIRECTORY) {
continue;
}
return $dir;
}
throw new \Exception('Unknown upload directory');
}
public function findByName(string $name): ?InvoiceDocument
@@ -41,21 +79,71 @@ final class InvoiceDocumentRepository
}
/**
* Returns an array of invoice renderer, which will consist of a unique name and a controller action.
* Returns an array of all custom invoice documents.
*
* @return InvoiceDocument[]
*/
public function findCustom()
{
$paths = [];
foreach ($this->documentDirs as $dir) {
if ($dir === self::DEFAULT_DIRECTORY) {
continue;
}
$paths[] = $dir;
}
return $this->findByPaths($paths);
}
/**
* Returns an array of all original Kimai documents.
*
* @return InvoiceDocument[]
*/
public function findBuiltIn()
{
foreach ($this->documentDirs as $dir) {
if ($dir === self::DEFAULT_DIRECTORY) {
return $this->findByPaths([$dir]);
}
}
return [];
}
/**
* Returns an array of invoice documents.
*
* @return InvoiceDocument[]
*/
public function findAll()
{
return $this->findByPaths($this->documentDirs);
}
/**
* Returns an array of invoice documents.
*
* @return InvoiceDocument[]
*/
private function findByPaths(array $paths)
{
$base = \dirname(\dirname(__DIR__)) . DIRECTORY_SEPARATOR;
$documents = [];
foreach ($this->documentDirs as $searchPath) {
if (!is_dir($base . $searchPath)) {
foreach ($paths as $searchPath) {
$searchDir = $searchPath;
if ($searchDir[0] !== '/') {
$searchDir = $base . $searchPath;
}
if (!is_dir($searchDir)) {
continue;
}
$finder = Finder::create()->ignoreDotFiles(true)->files()->in($base . $searchPath)->name('*.*');
$finder = Finder::create()->ignoreDotFiles(true)->files()->in($searchDir)->name('*.*');
foreach ($finder->getIterator() as $file) {
$doc = new InvoiceDocument($file);
// the first found invoice document wins