Oliver Rasche
1011162bb1
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.
202 lines
9.4 KiB
HTML
202 lines
9.4 KiB
HTML
<html xmlns:f="http://typo3.org/ns/TYPO3/CMS/Fluid/ViewHelpers"
|
|
data-namespace-typo3-fluid="true">
|
|
|
|
<f:layout name="Backend/Default" />
|
|
|
|
<f:section name="main">
|
|
|
|
<div class="module-docheader-bar module-docheader-bar-navigation">
|
|
<div class="module-docheader-bar-column-left">
|
|
<h2 class="t3js-title-inlineedit">VITEC Import — SEO Research</h2>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Tabs -->
|
|
<ul class="nav nav-tabs" style="margin-bottom:1rem;">
|
|
<f:for each="{models}" as="m">
|
|
<li class="nav-item">
|
|
<a class="nav-link" href="{f:be.uri(route: 'web_vitecimport', parameters: {model: m.key})}">{m.label}</a>
|
|
</li>
|
|
</f:for>
|
|
<li class="nav-item">
|
|
<a class="nav-link active" href="{f:be.uri(route: 'web_vitecimport.seo')}">SEO Research</a>
|
|
</li>
|
|
</ul>
|
|
|
|
<!-- Upload -->
|
|
<div class="card" style="margin-bottom:1rem;">
|
|
<div class="card-body">
|
|
<form action="{f:be.uri(route: 'web_vitecimport.seo_upload')}" method="post" enctype="multipart/form-data" class="row row-cols-auto align-items-center g-2">
|
|
<div class="col">
|
|
<input type="file" name="csvfile" accept=".csv,text/csv" class="form-control" required="required" />
|
|
</div>
|
|
<div class="col">
|
|
<button type="submit" class="btn btn-primary">Store delivery</button>
|
|
</div>
|
|
<div class="col form-text">
|
|
Every upload is kept as a delivery and compared against the previous one.
|
|
</div>
|
|
</form>
|
|
</div>
|
|
</div>
|
|
|
|
<f:if condition="{latest}">
|
|
|
|
<p class="text-muted">
|
|
Latest delivery: <strong>{latest.filename}</strong>,
|
|
<f:format.date format="d.m.Y H:i">@{latest.crdate}</f:format.date>
|
|
({analysis.structure.pages.total} rows)
|
|
<f:if condition="{previous}">
|
|
— compared against <f:format.date format="d.m.Y H:i">@{previous.crdate}</f:format.date>
|
|
</f:if>
|
|
</p>
|
|
|
|
<!-- Diff -->
|
|
<f:if condition="{analysis.diff}">
|
|
<div class="card" style="margin-bottom:1rem;">
|
|
<div class="card-header"><strong>Changes since previous delivery</strong></div>
|
|
<div class="card-body">
|
|
<f:if condition="{analysis.diff.added}">
|
|
<p><strong>New pages ({analysis.diff.added -> f:count()})</strong></p>
|
|
<ul><f:for each="{analysis.diff.added}" as="line"><li>{line}</li></f:for></ul>
|
|
</f:if>
|
|
<f:if condition="{analysis.diff.removed}">
|
|
<p><strong>Removed pages ({analysis.diff.removed -> f:count()})</strong></p>
|
|
<ul><f:for each="{analysis.diff.removed}" as="line"><li>{line}</li></f:for></ul>
|
|
</f:if>
|
|
<f:if condition="{analysis.diff.changed}">
|
|
<p><strong>Changed rows ({analysis.diff.changed -> f:count()})</strong></p>
|
|
<ul><f:for each="{analysis.diff.changed}" as="line"><li>{line}</li></f:for></ul>
|
|
</f:if>
|
|
<f:if condition="!{analysis.diff.added} && !{analysis.diff.removed} && !{analysis.diff.changed}">
|
|
<p class="text-muted">No differences.</p>
|
|
</f:if>
|
|
</div>
|
|
</div>
|
|
</f:if>
|
|
|
|
<!-- Structure check -->
|
|
<div class="card" style="margin-bottom:1rem;">
|
|
<div class="card-header"><strong>Structure check — CSV vs. TYPO3</strong></div>
|
|
<div class="card-body">
|
|
|
|
<p>
|
|
<span class="vitec-badge vitec-badge-update">Pages: {analysis.structure.pages.found} / {analysis.structure.pages.total} exist</span>
|
|
<span class="vitec-badge vitec-badge-update">Markets: {analysis.structure.market.matched} / {analysis.structure.market.total}</span>
|
|
<span class="vitec-badge vitec-badge-update">Solutions: {analysis.structure.solution.matched} / {analysis.structure.solution.total}</span>
|
|
<span class="vitec-badge vitec-badge-update">Products: {analysis.structure.product.matched} / {analysis.structure.product.total}</span>
|
|
</p>
|
|
<p class="form-text">
|
|
Markets/Solutions: every row below the section root, including sub-markets and
|
|
sub-solutions. Products: level x.y and deeper (the top product rows are
|
|
categories). Matching: record slug against the last URL segment, falling back
|
|
to a normalized title comparison. The Page Ref column shows the hierarchy.
|
|
</p>
|
|
|
|
<div class="row">
|
|
<f:for each="{analysis.structure}" key="area" as="check">
|
|
<f:if condition="{area} != 'pages'">
|
|
<div class="col-md-4">
|
|
<h4 style="text-transform:capitalize;">{area}</h4>
|
|
<f:if condition="{check.both}">
|
|
<p><strong>Both in CSV and TYPO3 ({check.both -> f:count()})</strong></p>
|
|
<ul>
|
|
<f:for each="{check.both}" as="pair">
|
|
<li><code>{pair.ref}</code> {pair.name} <small class="text-muted">→ uid {pair.uid} ({pair.title})</small></li>
|
|
</f:for>
|
|
</ul>
|
|
</f:if>
|
|
<f:if condition="{check.missing}">
|
|
<p><strong>Missing in TYPO3 ({check.missing -> f:count()})</strong></p>
|
|
<ul>
|
|
<f:for each="{check.missing}" as="row">
|
|
<li><code>{row.ref}</code> {row.name}</li>
|
|
</f:for>
|
|
</ul>
|
|
</f:if>
|
|
<f:if condition="{check.extra}">
|
|
<p><strong>Only in TYPO3 ({check.extra -> f:count()})</strong></p>
|
|
<ul>
|
|
<f:for each="{check.extra}" as="rec">
|
|
<li>{rec.title} <small class="text-muted">uid {rec.uid}</small></li>
|
|
</f:for>
|
|
</ul>
|
|
</f:if>
|
|
<f:if condition="!{check.missing} && !{check.extra}">
|
|
<p class="text-muted">Complete match — every CSV row has its record and vice versa.</p>
|
|
</f:if>
|
|
</div>
|
|
</f:if>
|
|
</f:for>
|
|
</div>
|
|
|
|
<f:if condition="{analysis.structure.pages.missing}">
|
|
<details>
|
|
<summary><strong>Pages missing in TYPO3 ({analysis.structure.pages.missing -> f:count()})</strong></summary>
|
|
<ul>
|
|
<f:for each="{analysis.structure.pages.missing}" as="row">
|
|
<li><code>{row.url}</code> — {row.name}</li>
|
|
</f:for>
|
|
</ul>
|
|
</details>
|
|
</f:if>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Quick wins -->
|
|
<div class="card" style="margin-bottom:1rem;">
|
|
<div class="card-header"><strong>Quick wins</strong> <span class="vitec-badge vitec-badge-new">{analysis.quickWins -> f:count()}</span></div>
|
|
<div class="card-body">
|
|
<table class="table table-striped table-sm">
|
|
<thead><tr><th>Page</th><th>Primary keyword</th><th>Vol (Global)</th><th>GSC Pos</th><th>GSC Impr.</th></tr></thead>
|
|
<tbody>
|
|
<f:for each="{analysis.quickWins}" as="row">
|
|
<tr>
|
|
<td>{row.name}<br /><small class="text-muted">{row.url}</small></td>
|
|
<td>{row.primary}</td>
|
|
<td>{row.volGlobal}</td>
|
|
<td>{row.gscPos}</td>
|
|
<td>{row.gscImpr}</td>
|
|
</tr>
|
|
</f:for>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Shared terms -->
|
|
<div class="card" style="margin-bottom:1rem;">
|
|
<div class="card-header"><strong>Shared terms (cannibalization risk)</strong> <span class="vitec-badge vitec-badge-info">{analysis.sharedTerms -> f:count()}</span></div>
|
|
<div class="card-body">
|
|
<f:for each="{analysis.sharedTerms}" as="group">
|
|
<p style="margin-bottom:4px;"><strong>{group.keyword}</strong></p>
|
|
<ul>
|
|
<f:for each="{group.pages}" as="row">
|
|
<li>{row.name} <small class="text-muted">{row.url}</small></li>
|
|
</f:for>
|
|
</ul>
|
|
</f:for>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Already ranking -->
|
|
<div class="card" style="margin-bottom:1rem;">
|
|
<div class="card-header"><strong>Already ranking</strong> <span class="vitec-badge vitec-badge-unchanged">{analysis.alreadyRanking -> f:count()}</span></div>
|
|
<div class="card-body">
|
|
<ul>
|
|
<f:for each="{analysis.alreadyRanking}" as="row">
|
|
<li>{row.name} <small class="text-muted">{row.url}</small> — {row.primary} (GSC Pos {row.gscPos})</li>
|
|
</f:for>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
|
|
</f:if>
|
|
|
|
<f:if condition="!{latest}">
|
|
<p class="text-muted">No delivery stored yet - upload the keyword research CSV above.</p>
|
|
</f:if>
|
|
|
|
</f:section>
|
|
</html>
|