Files
VITEC-website/packages/vitec/Classes/Command/MarketDummyImageCommand.php
Oliver Rasche 1011162bb1 Backend module: CSV import for the VITEC domain models
New "VITEC Import" module under Web: one import page per domain model
(v1: Market, Solution, Product - registry-driven, adding a model is one
config entry). Workflow: upload a CSV (delimiter and encoding are
auto-detected, including German-Excel semicolon/Windows-1252), map CSV
columns to DB fields, persist the mapping per model together with the
identity field used for matching (new table tx_vitec_import_mapping,
no TCA - pure tool configuration), review a unified list of CSV rows
matched against the DB records (new / update with differing fields /
unchanged / db-only), then apply the checked rows through DataHandler.

Each importable row carries an editable JSON payload textarea - what
is written is the textarea content, not the raw CSV, so editors can
fix values right in the review step. The parsed CSV travels through
the form as a hidden JSON field: no session state, no temp files.
Importable fields are derived from TCA at runtime (scalar types only;
files, categories and other relations are excluded - a flat CSV
cannot carry them). Payloads are whitelisted against that field list
on apply; new records require a storage pid (prefilled from existing
records). BE user permissions apply via DataHandler.

The module ships its own CSS (backend-import.css, loaded only by
this module) using the frontend button palette from _vitec.scss:
orange #f47937 for primary actions, navy #26358c for secondary
actions and structure. The stray <h2>Hi</h2> debug leftover in the
shared backend layout is removed (also affects the OG Image module).

A fourth tab "SEO Research" handles the recurring keyword-research
CSV. It is deliberately not an import mask - the file carries research
only (no meta title/description yet). Each upload is persisted as a
delivery (tx_vitec_seo_research, never deleted) and evaluated: diff
against the previous delivery keyed by URL, a structure check of the
CSV tree against TYPO3 (pages by slug path; market/solution/product
rows against the domain tables, matched by slug then normalized
title), and the three work lists from the SEO flags (quick wins by
GSC impressions, shared terms grouped by keyword, already ranking).
CsvReader now deduplicates repeated header names, which that CSV has.

New CLI command vitec:create-markets: creates the market records the
structure check reports as missing, sourced from the stored delivery
and matched through the same SeoResearchService - what the module
lists is what the command creates. Each market gets a sys_category of
the same title, found anywhere under the auto-detected market category
root or created; sub-market categories are created under the parent
market's category, so the category tree carries the hierarchy the
flat market model cannot. Idempotent, dry-run first.

New CLI commands vitec:create-markets and vitec:market-dummy-image.
create-markets creates the market records the structure check reports
as missing (root detection three-staged: option, auto-detect, find or
create a "Markets" category). market-dummy-image assigns a shared
placeholder (white logo on brand navy, fileadmin/placeholders/) to
every market without an image - one sys_file for all, replacing the
file restyles every placeholder at once. Both idempotent.

Deliberately out of v1: import log with three-way compare (protection
against overwriting manual edits), images/relations, multiple saved
mappings per model.
2026-08-10 14:56:19 +02:00

127 lines
5.1 KiB
PHP

<?php
declare(strict_types=1);
namespace Evomedien\Vitec\Command;
use Doctrine\DBAL\ParameterType;
use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Output\OutputInterface;
use TYPO3\CMS\Core\Core\Bootstrap;
use TYPO3\CMS\Core\Database\ConnectionPool;
use TYPO3\CMS\Core\DataHandling\DataHandler;
use TYPO3\CMS\Core\Resource\File;
use TYPO3\CMS\Core\Resource\ResourceFactory;
use TYPO3\CMS\Core\Utility\GeneralUtility;
/**
* Assigns the VITEC placeholder image (logo on brand navy) to every market
* record that has no image yet - so cards and detail pages never render
* imageless while the editors are still collecting real market imagery.
*
* The placeholder file lives at fileadmin/placeholders/ and is referenced,
* not copied: all imageless markets share one sys_file, and replacing that
* file later restyles every placeholder at once. Records that already have
* an image reference are never touched. Idempotent - re-running skips
* markets that got their reference in an earlier run.
*
* vendor/bin/typo3 vitec:market-dummy-image --dry-run
* vendor/bin/typo3 vitec:market-dummy-image
*/
#[AsCommand(
name: 'vitec:market-dummy-image',
description: 'Assign the placeholder image to every market without an image'
)]
final class MarketDummyImageCommand extends Command
{
private const TABLE = 'tx_vitec_domain_model_market';
private const DEFAULT_FILE = 'fileadmin/placeholders/vitec-market-placeholder.png';
protected function configure(): void
{
$this->addOption('file', null, InputOption::VALUE_REQUIRED, 'Placeholder image path', self::DEFAULT_FILE);
$this->addOption('dry-run', null, InputOption::VALUE_NONE, 'Report only');
}
protected function execute(InputInterface $input, OutputInterface $output): int
{
Bootstrap::initializeBackendAuthentication();
$dryRun = (bool)$input->getOption('dry-run');
$path = (string)$input->getOption('file');
try {
$file = GeneralUtility::makeInstance(ResourceFactory::class)->retrieveFileOrFolderObject($path);
} catch (\Throwable $e) {
$file = null;
}
if (!$file instanceof File) {
$output->writeln(sprintf('<error>Placeholder not found in FAL: %s</error>', $path));
return Command::FAILURE;
}
$output->writeln(sprintf('Placeholder: %s (sys_file %d)', $file->getIdentifier(), $file->getUid()));
// Markets that already have an image reference.
$qb = GeneralUtility::makeInstance(ConnectionPool::class)->getQueryBuilderForTable('sys_file_reference');
$withImage = $qb->select('uid_foreign')->from('sys_file_reference')
->where(
$qb->expr()->eq('tablenames', $qb->createNamedParameter(self::TABLE, ParameterType::STRING)),
$qb->expr()->eq('fieldname', $qb->createNamedParameter('image', ParameterType::STRING)),
$qb->expr()->eq('deleted', 0)
)
->executeQuery()->fetchFirstColumn();
$withImage = array_flip(array_map('intval', $withImage));
$qb = GeneralUtility::makeInstance(ConnectionPool::class)->getQueryBuilderForTable(self::TABLE);
$markets = $qb->select('uid', 'pid', 'title')->from(self::TABLE)
->where($qb->expr()->eq('deleted', 0))
->orderBy('title', 'ASC')
->executeQuery()->fetchAllAssociative();
$assigned = 0;
$skipped = 0;
foreach ($markets as $market) {
$uid = (int)$market['uid'];
if (isset($withImage[$uid])) {
$skipped++;
continue;
}
if ($dryRun) {
$output->writeln(sprintf(' ASSIGN placeholder -> %s (uid %d)', $market['title'], $uid));
$assigned++;
continue;
}
$dataHandler = GeneralUtility::makeInstance(DataHandler::class);
$dataHandler->start([
'sys_file_reference' => [
'NEWref' => [
'uid_local' => $file->getUid(),
'pid' => (int)$market['pid'],
],
],
self::TABLE => [
(string)$uid => ['image' => 'NEWref'],
],
], []);
$dataHandler->process_datamap();
if ($dataHandler->errorLog !== []) {
$output->writeln(sprintf(' <error>%s: %s</error>', $market['title'], implode(' | ', $dataHandler->errorLog)));
continue;
}
$output->writeln(sprintf(' <info>assigned -> %s (uid %d)</info>', $market['title'], $uid));
$assigned++;
}
$output->writeln('');
$output->writeln(sprintf(
'%s: %d assigned, %d already had an image.',
$dryRun ? 'DRY-RUN - would be' : 'Done',
$assigned,
$skipped
));
return Command::SUCCESS;
}
}