Captron
Redakteurshandbuch für Captron
Spezifikationstabelle
Zeigt eine zweispaltige Tabelle mit Bezeichnung und Wert – zum Beispiel für technische Produktdaten wie Betriebsspannung, Gewicht oder Abmessungen.
Wann verwenden?
Immer dann, wenn Sie eine Liste von Eigenschaften mit jeweils einer Bezeichnung und einem Wert übersichtlich darstellen möchten, etwa technische Daten auf einer Produkt- oder Detailseite. Die Inhalte tragen Sie hier von Hand ein – dieses Element bezieht keine Daten automatisch aus dem Produktkatalog.
Schritt für Schritt
- Klicken Sie links im Seitenbaum auf die Seite, auf der die Tabelle erscheinen soll.
- Klicken Sie in der gewünschten Spalte auf + Inhalt.
- Wechseln Sie im Auswahldialog zum Reiter Custom und wählen Sie Spezifikationstabelle aus.
- Tragen Sie optional eine Overline (kurze Überzeile) ein.
- Tragen Sie die Überschrift ein.
- Tragen Sie den Tabellen-Titel ein (erscheint direkt über der Tabelle, mit Unterstrich).
- Klicken Sie unter Zeilen auf Neuer Datensatz, um eine Tabellenzeile hinzuzufügen.
- Füllen Sie in der neuen Zeile die Felder Bezeichnung und Wert aus.
- Wiederholen Sie die letzten beiden Schritte für jede weitere Zeile.
- Klicken Sie oben auf Speichern und prüfen Sie das Ergebnis über die Vorschau.
Felder im Überblick
| Feld | Pflicht? | Hinweis |
|---|---|---|
| Overline | Nein | Kurze Überzeile über der Überschrift. Rich-Text-Feld – einzelne Wörter lassen sich z. B. hervorheben. |
| Überschrift | Nein | Haupttitel des Elements, erscheint groß über der Tabelle. Rich-Text-Feld – einzelne Wörter lassen sich z. B. hervorheben oder einfärben. |
| Tabellen-Titel | Nein | Titel direkt über der Tabelle, z. B. „Technische Daten“. |
| Zeilen | Nein | Beliebig viele Tabellenzeilen; jede Zeile besteht aus Bezeichnung und Wert. |
| Zeilen → Bezeichnung | Ja, pro Zeile | Linke Spalte, z. B. „Betriebsspannung“. |
| Zeilen → Wert | Ja, pro Zeile | Rechte Spalte, z. B. „DC 24 V“. Mehrzeilige Werte sind möglich. |
Häufige Fragen
Kann ich die Reihenfolge der Zeilen ändern?
Ja – ziehen Sie die Zeilen im Bearbeitungsdialog per Drag & Drop am Griff-Symbol in die gewünschte Reihenfolge.
Muss ich Overline und Tabellen-Titel ausfüllen?
Nein, beide Felder sind optional. Lassen Sie sie leer, wenn die Tabelle keine zusätzliche Überzeile oder keinen eigenen Titel braucht.
Warum sehe ich meine Änderung nicht auf der Website?
Meist ist die Seite noch im Zwischenspeicher. Klicken Sie oben rechts auf das Blitz-Symbol und wählen Sie Cache dieser Seite leeren, dann laden Sie die Website neu.
Hero
Der Aufmacher-Bereich ganz oben auf einer Seite: dunkler Hintergrund mit Farbverlauf, Überzeile, große Überschrift, Fließtext und ein optionaler Button. Meist das erste, was Besucher auf einer Seite sehen.
Wann verwenden?
Für den obersten Bereich einer Seite, wenn Sie einen prägnanten Einstieg mit Überschrift und optional einem Button zu einer weiterführenden Seite brauchen. Für reine Bild-Text-Kombinationen weiter unten auf der Seite nutzen Sie stattdessen ein anderes Inhaltselement.
Schritt für Schritt
- Klicken Sie links im Seitenbaum auf die Seite, auf der der Hero erscheinen soll.
- Klicken Sie in der gewünschten Spalte auf + Inhalt.
- Wechseln Sie im Auswahldialog zum Reiter Custom und wählen Sie Hero aus.
- Tragen Sie optional eine Überzeile ein (kurzer Text vor der Überschrift, in Türkis mit einem kleinen Strich davor).
- Tragen Sie die Überschrift ein.
- Tragen Sie optional einen Text und Links ein.
- Möchten Sie einen Button anzeigen: Tragen Sie sowohl Button-Text als auch Button-Link ein.
- Klicken Sie oben auf Speichern und prüfen Sie das Ergebnis über die Vorschau.
Seit Kurzem hat der Hero eine neue Optik: dunkler Hintergrund mit einem Farbverlauf (Türkis/Flieder) statt des früheren weißen Hintergrunds, dazu eine dekorative Grafik im Hintergrund. Die Überzeile erscheint in Türkis mit einem kleinen Strich davor. Das erklärt, warum die Vorschau im Backend anders aussieht als bisher gewohnte Elemente.
Felder im Überblick
| Feld | Pflicht? | Hinweis |
|---|---|---|
| Überzeile | Nein | Kurzer Text vor der Überschrift, erscheint türkis mit einem kleinen Strich davor. Rich-Text-Feld – einzelne Wörter lassen sich z. B. hervorheben. |
| Überschrift | Nein | Haupttitel des Elements, erscheint groß und weiß. |
| Text und Links | Nein | Fließtext unterhalb der Überschrift. Rich-Text-Feld mit Links. |
| Button-Text | Nein | Beschriftung des Buttons, z. B. „Mehr erfahren“. |
| Button-Link | Nein | Ziel des Buttons (Seite, Datei, externe URL oder E-Mail). |
Häufige Fragen
Ich habe nur den Button-Text ausgefüllt, aber es erscheint kein Button. Warum?
Der Button erscheint nur, wenn beide Felder – Button-Text und Button-Link – gefüllt sind. Es gibt keinen automatischen Ersatztext für den fehlenden Link. Tragen Sie zusätzlich ein Ziel im Feld Button-Link ein.
Muss ich Überzeile, Text und Button ausfüllen?
Nein, alle Felder außer der Überschrift sind optional. Lassen Sie sie leer, wenn der Hero schlicht bleiben soll.
Warum sehe ich meine Änderung nicht auf der Website?
Meist ist die Seite noch im Zwischenspeicher. Klicken Sie oben rechts auf das Blitz-Symbol und wählen Sie Cache dieser Seite leeren, dann laden Sie die Website neu.
Card
Eine einzelne Karte mit Bild, Überschrift, Text und einem optionalen Button. Wird meist mehrfach nebeneinander genutzt, z. B. in einem dreispaltigen Raster.
Wann verwenden?
Für kompakte, in sich geschlossene Inhalte, die in einem Raster nebeneinander stehen sollen – z. B. Leistungen, Vorteile oder Themenübersichten mit Bild, kurzem Text und optionalem Link zu einer weiterführenden Seite. Für den obersten Bereich einer Seite nutzen Sie stattdessen den Hero.
Schritt für Schritt
- Klicken Sie links im Seitenbaum auf die Seite, auf der die Card erscheinen soll.
- Klicken Sie in der gewünschten Spalte auf + Inhalt.
- Wechseln Sie im Auswahldialog zum Reiter Custom und wählen Sie Card aus.
- Laden Sie optional ein Bild hoch, das oben zentriert angezeigt wird.
- Tragen Sie optional eine Headline der Card ein.
- Tragen Sie optional einen Text ein, z. B. eine Aufzählung.
- Möchten Sie einen Button anzeigen: Tragen Sie sowohl Button-Text als auch Button-Link ein.
- Klicken Sie oben auf Speichern und prüfen Sie das Ergebnis über die Vorschau.
Felder im Überblick
| Feld | Pflicht? | Hinweis |
|---|---|---|
| Bild | Nein | Bild der Card, wird oben zentriert angezeigt (ein Bild). |
| Headline der Card | Nein | Überschrift der Card. |
| Text | Nein | Rich-Text-Inhalt, z. B. eine Aufzählung. |
| Button-Text | Nein | Beschriftung des Buttons, z. B. „Mehr erfahren“. |
| Button-Link | Nein | Ziel des Buttons (Seite, Datei, externe URL oder E-Mail). |
Häufige Fragen
Ich habe nur den Button-Text ausgefüllt, aber es erscheint kein Button. Warum?
Der Button erscheint nur, wenn beide Felder – Button-Text und Button-Link – gefüllt sind. Es gibt keinen automatischen Ersatztext für den fehlenden Link. Tragen Sie zusätzlich ein Ziel im Feld Button-Link ein.
Muss ich Bild, Text und Button ausfüllen?
Nein, alle Felder der Card sind optional. Lassen Sie sie leer, wenn die Karte schlicht bleiben soll.
Warum sehe ich meine Änderung nicht auf der Website?
Meist ist die Seite noch im Zwischenspeicher. Klicken Sie oben rechts auf das Blitz-Symbol und wählen Sie Cache dieser Seite leeren, dann laden Sie die Website neu.
Accordion
Ein dunkler Bereich mit einer festen Überzeile/Überschrift/Text-Einleitung oben und einer Liste aufklappbarer Einträge darunter. Klickt man auf einen Eintrag, klappt sein Text auf – wie bei häufig gestellten Fragen.
Wann verwenden?
Für mehrere zusammengehörige Punkte, bei denen nur der erste dauerhaft sichtbar sein soll und die übrigen erst auf Klick ihren Text zeigen – z. B. „Warum wir?“-Argumente oder häufige Fragen. Für eine reine Frage-Antwort-Liste ohne Einleitungstext oben eignet sich das Element ebenfalls, lassen Sie dann Überzeile/Überschrift/Text einfach leer.
Wichtig: Aufbau des Elements
Das Element besteht aus zwei Bereichen, die unterschiedlich funktionieren:
- Oben, immer sichtbar: Überzeile, Überschrift und Text und Links. Das ist der feste Einstiegstext des Elements – vergleichbar mit dem ersten, bereits aufgeklappten Punkt.
- Darunter, aufklappbar: die Einträge. Jeder Eintrag zeigt zunächst nur seinen Text als Titel; erst ein Klick öffnet den zugehörigen Inhalt.
Möchten Sie z. B. vier Punkte „Warum Punkt 1“ bis „Warum Punkt 4“ zeigen, tragen Sie „Warum Punkt 1“ als Überschrift ein (mit Text in Text und Links) und legen „Warum Punkt 2“ bis „Warum Punkt 4“ als drei separate Einträge an.
Schritt für Schritt
- Klicken Sie links im Seitenbaum auf die Seite, auf der das Accordion erscheinen soll.
- Klicken Sie in der gewünschten Spalte auf + Inhalt.
- Wechseln Sie im Auswahldialog zum Reiter Custom und wählen Sie Accordion aus.
- Tragen Sie optional eine Überzeile ein (kurzer Text, erscheint türkis mit einem kleinen Strich davor).
- Tragen Sie optional die Überschrift des ersten, immer sichtbaren Punkts ein.
- Tragen Sie optional den Text und Links dazu ein.
- Möchten Sie darunter einen Button anzeigen, siehe den Abschnitt „Button im Text und Links einfügen“ weiter unten.
- Klicken Sie im Bereich Einträge auf Neuer Eintrag, um einen aufklappbaren Punkt hinzuzufügen.
- Tragen Sie im neuen Eintrag den Text ein (erscheint als klickbarer Titel).
- Tragen Sie die Textarea ein (erscheint erst, wenn der Eintrag aufgeklappt wird).
- Wiederholen Sie die beiden letzten Schritte für jeden weiteren Punkt.
- Klicken Sie oben auf Speichern und prüfen Sie das Ergebnis über die Vorschau.
Das Accordion hat immer einen dunklen Hintergrund mit Farbverlauf-Streifen über die volle Bildschirmbreite – dafür müssen Sie nichts einstellen. Die Überzeile erscheint türkis mit einem kleinen Strich davor, die Überschrift groß und weiß, der Text und Links gedämpft hell. Geschlossene Einträge sind gedämpft hell dargestellt, der gerade geöffnete Eintrag erscheint kräftig weiß mit einem Minus-Symbol statt Plus.
Button im „Text und Links“ einfügen
Das Element hat kein eigenes Button-Feld wie z. B. der Hero. Einen Button erzeugen Sie stattdessen direkt im Feld Text und Links:
- Markieren Sie im Feld Text und Links das Wort oder den kurzen Text, der zum Button werden soll.
- Klicken Sie in der Werkzeugleiste auf das Link-Symbol und wählen Sie das Linkziel (Seite, Datei, externe URL oder E-Mail).
- Wechseln Sie im Link-Dialog zum Reiter Erweitert.
- Wählen Sie bei CSS-Klasse den Eintrag „btn-primary btn“.
- Übernehmen Sie den Link. Der Text erscheint jetzt als türkis-blauer Button mit Pfeil-Symbol.
Dieselbe Vorgehensweise funktioniert in jedem Rich-Text-Feld des Projekts, nicht nur beim Accordion.
Felder im Überblick
| Feld | Pflicht? | Hinweis |
|---|---|---|
| Überzeile | Nein | Kurzer Text vor der Überschrift, erscheint türkis mit einem kleinen Strich davor. |
| Überschrift | Nein | Titel des immer sichtbaren ersten Bereichs, erscheint groß und weiß. |
| Text und Links | Nein | Fließtext des immer sichtbaren ersten Bereichs. Rich-Text-Feld – hier können Sie auch einen Button einfügen, siehe oben. |
| Einträge | Mind. 1 empfohlen | Liste der aufklappbaren Punkte. Jeder Eintrag hat ein Feld Text (Titel, immer sichtbar) und Textarea (Inhalt, erscheint erst nach dem Aufklappen). |
Häufige Fragen
Warum ist mein erster Punkt anders als die übrigen – er hat keinen Klick-Pfeil und ist nicht zum Zuklappen?
Das ist so gewollt: Überzeile, Überschrift und Text und Links sind der feste, immer sichtbare Einstieg des Elements – kein Eintrag zum Auf- und Zuklappen. Wenn Sie stattdessen einen Punkt haben möchten, der wie alle anderen auf- und zuklappbar ist, tragen Sie ihn stattdessen ganz normal als weiteren Eintrag im Bereich Einträge ein und lassen Sie Überschrift/Text und Links oben leer.
Ich habe einen Link mit CSS-Klasse „btn-primary btn“ gesetzt, aber es erscheint kein Button. Warum?
Prüfen Sie, ob der Link tatsächlich über den Link-Dialog gesetzt wurde (nicht nur farbig markierter Text) und ob im Reiter Erweitert wirklich die CSS-Klasse „btn-primary btn“ ausgewählt ist. Speichern Sie danach erneut und prüfen Sie die Vorschau.
Muss ich Überzeile, Überschrift und Text und Links ausfüllen?
Nein, alle drei Felder sind optional. Lassen Sie sie leer, wenn das Accordion direkt mit der Liste der Einträge beginnen soll.
Warum sehe ich meine Änderung nicht auf der Website?
Meist ist die Seite noch im Zwischenspeicher. Klicken Sie oben rechts auf das Blitz-Symbol und wählen Sie Cache dieser Seite leeren, dann laden Sie die Website neu.
Produktimport
Das Backend-Modul „Produktimport“ startet den Abgleich der Produktdaten aus dem PIM-System manuell. Zusätzlich läuft der Import automatisch nach einem festen Zeitplan, den ein Administrator einmalig einrichtet.
Import manuell auslösen (Redakteure)
Das Modul finden Sie im Backend-Menü unter Content → Produktimport.
- Klicken Sie im Backend-Menü links auf Content und dann auf Produktimport.
- Prüfen Sie oben auf der Seite die Statusanzeige (siehe Tabelle unten, „Statusanzeige verstehen“).
- Klicken Sie auf Import jetzt starten, um den Abgleich mit dem PIM-System sofort auszuführen.
- Warten Sie, bis die Seite neu lädt. Bei sehr vielen Produkten kann das einige Minuten dauern — die Seite bleibt so lange am Laden, es gibt keine separate Fortschrittsanzeige.
- Nach Abschluss erscheint oben eine Meldung mit dem Ergebnis: Erfolg oder Fehler, sowie die Anzahl Neu, Geändert, Unverändert, Reaktiviert und Versteckt.
Statusanzeige verstehen
| Anzeige | Bedeutung |
|---|---|
| „Kein Import aktiv. Es wurde bisher noch kein Import ausgeführt.“ | Es ist noch nie ein Import gelaufen. Import jetzt starten ist bedienbar. |
| „Kein Import aktiv. Zuletzt: HH:MM“ | Der letzte Import ist beendet, aktuell läuft keiner. Import jetzt starten ist bedienbar. |
| „Import läuft seit HH:MM“ | Ein Import läuft gerade. Import jetzt starten ist deaktiviert — es kann nie ein zweiter Import gleichzeitig gestartet werden. |
| „Lock verwaist (seit HH:MM) — kann gelöst werden“ | Ein Lauf gilt als hängengeblieben (länger als die eingestellte Wartezeit, standardmäßig 60 Minuten, ohne erkennbaren Fortschritt). Zusätzlich erscheint der Button Lock lösen. |
Lock lösen gibt einen hängengebliebenen Import wieder frei, damit ein neuer Import gestartet werden kann. Nutzen Sie diesen Button nur, wenn Sie wirklich sicher sind, dass gerade kein Import mehr läuft (z. B. weil der Server währenddessen neu gestartet wurde). Läuft der Import doch noch im Hintergrund, wird er durch „Lock lösen“ nicht abgebrochen — nur die Anzeige wird verfrüht freigegeben.
Automatischer Import einrichten (Administratoren, einmalig)
Damit die Produktdaten regelmäßig ohne manuelles Zutun aktualisiert werden, richtet ein Administrator einmalig eine Aufgabe im Scheduler ein.
- Klicken Sie im Backend-Menü links auf System und dann auf Scheduler.
- Klicken Sie oben auf + Neue Aufgabe hinzufügen.
- Wählen Sie als Aufgabentyp Execute console command.
- Wählen Sie als Befehl faft3-products:import aus.
- Aktivieren Sie zusätzlich die Option/Checkbox --lenient-lock. Das ist wichtig: Ohne diese Option meldet der Scheduler einen automatischen Lauf fälschlicherweise als „fehlgeschlagen“, sobald er zufällig mit einem manuell gestarteten Import zusammenfällt. Mit aktiviertem --lenient-lock wird dieser Fall stattdessen sauber übersprungen.
- Tragen Sie unter „Häufigkeit“ das gewünschte Zeitintervall ein (z. B. stündlich oder täglich). Das Intervall wird ausschließlich hier im Scheduler gepflegt, an keiner anderen Stelle.
- Klicken Sie auf Speichern.
Alternative: Import per Konsole (Administratoren)
Statt über den Scheduler kann ein Administrator den Import auch direkt über die Kommandozeile des Servers anstoßen:
vendor/bin/typo3 faft3-products:import— importiert alle konfigurierten PIM-Kanäle (Sprachen).vendor/bin/typo3 faft3-products:import --channel de— importiert nur den Kanal „de“.
Läuft bereits ein anderer Import — egal ob über das Backend-Modul, den Scheduler oder eine andere Konsolensitzung — bricht der Befehl mit einer Meldung ähnlich „Import läuft bereits (seit HH:MM)“ ab, statt den laufenden Import zu stören.
Technischer Hinweis zu Laufzeit/Timeouts (Administratoren)
Der Button Import jetzt starten im Backend-Modul führt den Import synchron innerhalb desselben Web-Requests aus — die Seite wartet, bis der gesamte Abgleich fertig ist. Bei rund 5.000 Produkten kann das an serverseitige Zeitlimits stoßen:
max_execution_time(PHP)request_terminate_timeout(PHP-FPM)fastcgi_read_timeoutbzw. andere Proxy-Timeouts (z. B. nginx)
Diese Werte liegen außerhalb der Anwendung selbst und müssen bei Bedarf serverseitig erhöht werden — prüfen Sie die tatsächlich eingestellten Werte der Zielumgebung. Für sehr große oder wiederkehrende Importläufe ist der Weg über den Scheduler-Task bzw. die Konsole robuster als der Backend-Button, da dabei keine Web-Request-Zeitlimits greifen.
Häufige Fragen
Was passiert, wenn ich während eines laufenden Imports auf „Import jetzt starten“ klicke?
Der Button ist deaktiviert, solange ein Import läuft — ein zweiter, gleichzeitiger Import ist nicht möglich. Warten Sie, bis die Statusanzeige wieder „Kein Import aktiv“ zeigt.
Wann sollte ich „Lock lösen“ verwenden?
Nur, wenn die Statusanzeige „Lock verwaist“ zeigt und Sie sicher sind, dass tatsächlich kein Import mehr läuft (z. B. nach einem Serverneustart während eines Imports). Im Normalfall gibt sich ein Lock nach Abschluss des Imports selbst wieder frei.
Warum bricht der Import über die Konsole manchmal sofort mit einer Fehlermeldung ab?
Das bedeutet, dass bereits ein anderer Import läuft — über das Backend-Modul, den Scheduler oder eine andere Konsolensitzung. Es kann nie mehr als ein Import gleichzeitig laufen. Warten Sie, bis der laufende Import fertig ist, und starten Sie danach erneut.
Ändert der Import etwas an meinen eigenen Inhalten (Layout, Zusatzcontent)?
Nein. Der Import überschreibt ausschließlich die aus dem PIM stammenden Produktdaten. Von Ihnen gepflegte Felder wie die Layout-Variante oder Zusatzcontent am Produkt bleiben bei jedem Import unangetastet.
Import-Protokoll einsehen
Unterhalb des Buttons Import jetzt starten zeigt das Modul eine Tabelle „Import-Protokoll“ mit den letzten rund 50 Import-Läufen — sowohl den manuell gestarteten als auch den automatischen (Scheduler) Läufen. Ältere Einträge werden nach der eingestellten Aufbewahrungsdauer automatisch gelöscht (standardmäßig nach 90 Tagen).
| Spalte | Bedeutung |
|---|---|
| Zeitpunkt | Datum und Uhrzeit, zu der der Lauf gestartet wurde. |
| Dauer (s) | Wie lange der Lauf gedauert hat, in Sekunden. |
| Ergebnis | Zeigt Erfolg, Fehler oder Abgebrochen als farbiges Kennzeichen. |
| Neu / Geändert / Unverändert / Reaktiviert / Versteckt / Fehler | Anzahl der Produkte, die in diesem Lauf jeweils neu angelegt, aktualisiert, unverändert geblieben, wieder sichtbar gemacht, versteckt oder mit einem Fehler übersprungen wurden. |
| Details | Klicken Sie auf Kanal-Details anzeigen, um weitere technische Angaben zu diesem Lauf aufzuklappen (z. B. welcher Sprachkanal betroffen war). |
Mail-Benachrichtigung bei Fehlern
Schlägt ein Import fehl, nachdem der vorherige Lauf noch erfolgreich war, verschickt das System automatisch eine E-Mail mit den Fehlerdetails an die hinterlegten Empfänger. Läuft danach wieder ein Import erfolgreich durch, kommt eine Entwarnungs-Mail. Schlagen mehrere Läufe hintereinander fehl, wird nur beim ersten Fehlschlag eine Mail verschickt — es gibt also keine Mail-Flut, solange das Problem anhält.
Die folgenden Einstellungen werden von einem Administrator einmalig in der Website-Konfiguration hinterlegt, nicht im Backend-Modul selbst:
| Einstellung | Bedeutung |
|---|---|
| notificationRecipients | Liste der E-Mail-Adressen, die Fehler- bzw. Entwarnungs-Mails erhalten. Ist die Liste leer, ist die Benachrichtigung deaktiviert. |
| notificationSenderAddress | Absenderadresse der Benachrichtigungs-Mails. |
| importLogRetentionDays | Wie viele Tage ein Protokoll-Eintrag aufbewahrt wird, bevor er automatisch gelöscht wird (Standard: 90 Tage). |
Warum bekomme ich keine Fehler-Mail, obwohl der Import schon seit Tagen fehlschlägt?
Eine Fehler-Mail wird nur beim Übergang von Erfolg zu Fehler verschickt, damit Sie bei anhaltenden Problemen nicht mit Mails überhäuft werden. Schauen Sie stattdessen in das Import-Protokoll im Backend-Modul, dort sehen Sie jeden einzelnen fehlgeschlagenen Lauf.
Produkt-Detailseite
Jede Produktseite entsteht automatisch aus den Daten, die aus dem PIM-System importiert werden – Sie legen dafür keine eigene Seite an. Am Produkt-Datensatz selbst können Sie aber mehrere Dinge steuern: welche Layout-Variante die Seite verwendet, welchen Text Suchmaschinen als SEO-Beschreibung anzeigen, und welche zusätzlichen verwandten Produkte angezeigt werden.
Layout-Variante wählen
Das Feld Layout-Variante bestimmt Aufbau und Reihenfolge der Produkt-Detailseite. Es stehen genau zwei Varianten zur Auswahl:
| Variante | Wirkung auf die Seite |
|---|---|
| Standard (Voreinstellung) | Kompakter Kopf mit dem Bild neben dem Text. Reihenfolge der Seite: Technische Daten, dann Anwendungen/Vorteile, dann Zusatzcontent, dann Verwandte Produkte – der Zusatzcontent erscheint also weiter unten. |
| Hero (große Bildbühne) | Eine große Bildbühne über die volle Breite direkt unter dem Titel. Der Zusatzcontent erscheint sofort danach, ganz oben – erst danach folgen Technische Daten, Anwendungen/Vorteile und Verwandte Produkte. |
Schritt für Schritt
- Öffnen Sie im Backend den gewünschten Produkt-Datensatz zur Bearbeitung.
- Wechseln Sie zum Reiter Redaktion.
- Wählen Sie im Feld Layout-Variante entweder Standard oder Hero (große Bildbühne).
- Klicken Sie auf Speichern und prüfen Sie das Ergebnis über die Vorschau.
Alle übrigen Inhalte der Produktseite (Produktdaten, Bilder, technische Angaben) stammen aus dem PIM-System und lassen sich hier nicht bearbeiten. Nur die Layout-Variante, die SEO-Beschreibung und der Zusatzcontent liegen in Ihrer Hand – der Import fasst diese Felder nie an.
SEO-Beschreibung pflegen
Das Feld SEO-Beschreibung (Meta-Description) ist der Kurztext, den Google & Co. unter dem Suchergebnis anzeigen (das „Snippet“). Er wird nur für Suchmaschinen und für die Vorschau beim Teilen in Messengern/Social Media verwendet, nicht auf der Seite selbst angezeigt.
- Öffnen Sie im Backend den gewünschten Produkt-Datensatz zur Bearbeitung.
- Wechseln Sie zum Reiter Redaktion.
- Tragen Sie im Feld SEO-Beschreibung (Meta-Description) einen kurzen, aussagekräftigen Text ein – idealerweise 120–160 Zeichen, reiner Text ohne Formatierung.
- Klicken Sie auf Speichern.
- Leeren Sie den Cache der Produktseite (Blitz-Symbol oben rechts), damit die Änderung im Seitenquelltext ankommt.
| Feld | Pflicht? | Hinweis |
|---|---|---|
| SEO-Beschreibung (Meta-Description) | Nein | Reiner Text ohne Formatierung. Bleibt bei jedem Import unangetastet. Leer lassen: dann wird automatisch der Anfang der Produktbeschreibung aus dem PIM verwendet und an einer Wortgrenze auf rund 160 Zeichen gekürzt. |
Sind sowohl die SEO-Beschreibung als auch die Produktbeschreibung aus dem PIM leer, gibt die Seite bewusst gar keine Beschreibung aus – Suchmaschinen erzeugen sich dann selbst ein Snippet aus dem Seiteninhalt. Das ist besser als ein allgemeiner Platzhaltertext.
Verwandte Produkte (redaktionell) pflegen
Auf jeder Produkt-Detailseite erscheinen unten „Verwandte Produkte“ als anklickbare Karten. Diese Liste setzt sich aus zwei Quellen zusammen: dem Zubehör, das automatisch aus dem PIM-System kommt, und den Produkten, die Sie selbst im Feld Verwandte Produkte (redaktionell) eintragen.
- Öffnen Sie im Backend den gewünschten Produkt-Datensatz zur Bearbeitung.
- Wechseln Sie zum Reiter Redaktion.
- Fügen Sie im Feld Verwandte Produkte (redaktionell) ein oder mehrere Produkte hinzu.
- Klicken Sie auf Speichern und prüfen Sie das Ergebnis über die Vorschau.
Wie die Liste zusammengestellt wird
| Feld | Pflicht? | Hinweis |
|---|---|---|
| Verwandte Produkte (redaktionell) | Nein | Zusätzliche verwandte Produkte, unabhängig vom PIM-Zubehör. Wird beim Import nie überschrieben. |
Auf der Seite erscheint zuerst das Zubehör aus dem PIM-System, danach Ihre eigenen Ergänzungen – bereits enthaltene Produkte werden dabei nicht doppelt angezeigt. Ihre Auswahl gilt für das Produkt insgesamt und ändert sich nicht, wenn eine andere Produktvariante gewählt wird. Sind sowohl das PIM-Zubehör als auch Ihre eigene Auswahl leer, zeigt die Seite automatisch andere Produkte derselben Familie als „Verwandte Produkte“ an – Sie müssen also nichts eintragen, damit überhaupt etwas erscheint.
Häufige Fragen
Wird meine Layout-Variante beim nächsten Import zurückgesetzt?
Nein. Der Import überschreibt ausschließlich die aus dem PIM stammenden Produktdaten. Die Layout-Variante, die SEO-Beschreibung und die redaktionellen Verwandten Produkte bleiben bei jedem Import unangetastet.
Was passiert, wenn ich die SEO-Beschreibung leer lasse?
Dann verwendet die Website automatisch den Anfang der aus dem PIM importierten Produktbeschreibung als Vorschautext im Suchergebnis. Nur wenn auch die PIM-Beschreibung leer ist, gibt die Seite bewusst gar keinen Vorschautext aus – Suchmaschinen erzeugen sich dann selbst ein Snippet aus dem Seiteninhalt.
Wird meine SEO-Beschreibung beim nächsten Import überschrieben?
Nein. Das Feld liegt im Reiter Redaktion und wird vom Import nie angefasst, genau wie die Layout-Variante und die redaktionellen Verwandten Produkte.
Wie lang darf die SEO-Beschreibung sein?
Das Feld erlaubt bis zu 320 Zeichen; Suchmaschinen zeigen aber meist nur rund 160 Zeichen an. Halten Sie die wichtigste Aussage daher nach vorne.
Warum sehe ich auf der Seite Verwandte Produkte, obwohl ich das Feld nie ausgefüllt habe?
Entweder liefert das PIM-System bereits Zubehör zu diesem Produkt, oder es greift der automatische Familien-Fallback: Sind PIM-Zubehör und Ihre eigene Auswahl leer, zeigt die Seite stattdessen Produkte derselben Familie.
Kann ich ein Produkt aus dem PIM-Zubehör entfernen, wenn es nicht passt?
Nein, das PIM-Zubehör ist read-only und wird beim Import gesetzt. Sie können aber zusätzliche, eigene Produkte über das Feld „Verwandte Produkte (redaktionell)“ ergänzen.
Warum sehe ich meine Änderung nicht auf der Website?
Meist ist die Seite noch im Zwischenspeicher. Klicken Sie oben rechts auf das Blitz-Symbol und wählen Sie Cache dieser Seite leeren, dann laden Sie die Website neu.
Zentrale SEO-Einstellungen (Administratoren, einmalig)
Zwei Einstellungen wirken auf ALLE Produktseiten gleichzeitig und werden einmalig in den Website-Einstellungen gepflegt (Backend-Modul Site Management > Sites, Reiter Einstellungen).
| Einstellung | Wirkung | Wenn leer |
|---|---|---|
| Markenname für schema.org-Produktdaten | Wird als Marke in die maschinenlesbaren Produktdaten (schema.org) jeder Produkt-Detailseite geschrieben. Suchmaschinen und KI-Assistenten lesen daraus, von welchem Hersteller das Produkt stammt. | Es wird automatisch der zentrale Firmenname aus den Unternehmens-Einstellungen verwendet. |
| Standard-Vorschaubild (og:image) | Vorschaubild beim Teilen einer Produktseite in Social Media oder Messengern, wenn das Produkt selbst kein Bild aus dem PIM hat. Empfohlen: 1200×630 px. | Die Produktseite gibt dann kein Vorschaubild aus; Plattformen zeigen eine reine Textvorschau. |
Änderungen an diesen Einstellungen wirken erst, nachdem der Cache geleert wurde. Beide Werte gelten für alle Produkte gemeinsam – es gibt bewusst kein eigenes Vorschaubild-Feld pro Produkt.
Produktbilder
Produktbilder werden nicht mehr in TYPO3 gespeichert, sondern beim Aufruf einer Seite direkt vom Bildserver des PIM-Systems geladen. Dieses Kapitel erklärt, woher die Bilder kommen, was sich für Sie geändert hat und was zu tun ist, wenn ein Bild einmal nicht angezeigt wird.
Woher die Produktbilder kommen
Produktbilder liegen nicht mehr als Datei in TYPO3, sondern werden bei jedem Seitenaufruf direkt vom Bildserver des PIM-Systems geladen. Das hat einen klaren Vorteil: Ändert sich ein Bild im PIM, ist es auf der Website sofort sichtbar – ohne dass zuvor ein Import laufen muss. Die Bildadresse steht am Bild-Attributwert des Produkts im Feld für den Wert und ist, wie alle PIM-Daten, nicht bearbeitbar.
Was sich für Sie geändert hat
| Früher | Jetzt |
|---|---|
| Am Bild-Attribut gab es ein Bildfeld zum Hochladen/Auswählen | Es gibt kein Bildfeld mehr — nur noch die Bildadresse (nicht bearbeitbar) |
| Produktbilder lagen im Modul „Datei > Dateiliste“ in der Ablage „PIM Produktbilder“ | Produktbilder liegen nicht mehr in TYPO3 und erscheinen nicht mehr in der Dateiliste |
| Der Zeichnungs-Download öffnete eine Datei von dieser Website | Der Zeichnungs-Download öffnet die Datei in einem neuen Tab beim PIM-Anbieter |
| Ein fehlendes Bild hinterließ eine Lücke | Ein nicht ladbares Bild wird durch einen neutralen Platzhalter ersetzt |
Wenn Bilder nicht angezeigt werden
Kann ein Produktbild nicht geladen werden, zeigt die Seite einen neutralen, grauen Platzhalter statt eines kaputten Bildsymbols. Dafür gibt es zwei mögliche Ursachen:
- Der Bildserver des PIM-Anbieters ist insgesamt nicht erreichbar — dann fehlen ALLE Produktbilder gleichzeitig.
- Ein einzelnes Bild wurde im PIM entfernt oder umbenannt — dann fehlt nur dieses eine Bild.
Handlungsanweisung: Fehlen alle Bilder gleichzeitig, prüfen Sie das Import-Protokoll im Modul „Produktimport“ (dort erscheint der betroffene Lauf als Fehler mit einem Hinweis auf die Bildprüfung) und informieren Sie den PIM-Anbieter. Fehlt nur ein einzelnes Bild, korrigieren Sie es im PIM — der nächste Import übernimmt die neue Adresse automatisch.
Stand August 2026 ist der Bildserver des PIM-Anbieters (images.onetimepim.com) gestört und antwortet auf alle Bildadressen mit einem Fehler. Solange das so ist, zeigen alle Produktbilder den Platzhalter. Die Störung liegt beim Anbieter, nicht an dieser Website.
Für Administratoren: Bildprüfung nach dem Import
Nach jedem Import prüft das System stichprobenartig, ob eine kleine Auswahl von Produktbild-Adressen erreichbar ist. Sind ALLE geprüften Adressen unerreichbar, gilt das als starkes Indiz für einen Ausfall des Bildservers: der Lauf wird im Import-Protokoll als Fehler geführt und die Benachrichtigungs-Mail wird verschickt. Ist dagegen nur ein Teil der geprüften Adressen unerreichbar, wird der Lauf bewusst NICHT als Fehler markiert — sonst würde jedes einzelne defekte Bild im PIM eine Fehler-Mail auslösen.
| Einstellung | Bedeutung |
|---|---|
| faft3_products.cdnImageSampleSize | Wie viele Produktbild-Adressen nach jedem Import stichprobenartig auf Erreichbarkeit geprüft werden (Standard: 5). Sind ALLE geprüften Adressen unerreichbar, wird der Import-Lauf im Protokoll als Fehler geführt und die Benachrichtigungs-Mail verschickt. Der Wert 0 schaltet die Prüfung ab. Es werden nie alle Bilder geprüft. |
Häufige Fragen
Warum kann ich am Produkt kein eigenes Bild hochladen?
Produktbilder gehören zu den PIM-Daten; die Datenhoheit liegt beim PIM. Ein in TYPO3 hochgeladenes Bild würde beim nächsten Import ohnehin nicht berücksichtigt. Nehmen Sie Änderungen bitte im PIM vor.
Ich habe im PIM ein Bild ausgetauscht — warum sehe ich es noch nicht?
Wenn sich die Bildadresse nicht geändert hat, ist das neue Bild sofort sichtbar (evtl. Browser-Cache leeren). Hat sich die Adresse geändert, wird sie erst mit dem nächsten Import übernommen.
Sind die Produktbilder jetzt langsamer?
Nein. Der Bildserver liefert automatisch die passende Bildgröße und ein modernes Bildformat für das jeweilige Gerät.
Warum öffnet der Zeichnungs-Download einen neuen Tab bei einer fremden Adresse?
Die Datei liegt beim PIM-Anbieter, nicht mehr auf dieser Website. Der Hinweis „öffnet in neuem Tab“ steht neben dem Link.
Produktliste (Content-Element)
Die Produktliste ist ein normales Inhaltselement und kann auf jeder Seite eingefügt werden – nicht nur auf der Seite „Produkte". Sie zeigt eine Kartenübersicht ausgewählter Produkte, wahlweise mit Live-Filter und Suche.
Auf der Seite „Produkte" liegt bereits eine Instanz dieses Elements – sie wurde beim letzten technischen Update automatisch angelegt. Bitte löschen Sie dieses Element dort nicht; sonst ist die Seite leer. Das Feld „Überschrift" wurde dabei bewusst leer gelassen – möchten Sie dort eine Überschrift zeigen, tragen Sie den Text selbst ein.
Wann verwenden?
- Um eine Auswahl von Produkten – ganz oder nach Familie/Attributen eingeschränkt – auf einer beliebigen Seite zu zeigen.
- Um eine handverlesene Produktauswahl in fester Reihenfolge zu präsentieren (z. B. „Unsere Bestseller").
- Um Besuchern auf einer Seite eine durchsuchbare, filterbare Produktübersicht anzubieten.
Schritt für Schritt
- Klicken Sie links im Seitenbaum auf die Seite, auf der die Liste erscheinen soll.
- Klicken Sie in der gewünschten Spalte auf + Inhalt.
- Wechseln Sie im Auswahldialog zum Reiter Custom und wählen Sie Produktliste aus.
- Füllen Sie die Felder wie unten beschrieben aus.
- Klicken Sie auf Speichern und prüfen Sie das Ergebnis über die Vorschau.
Felder im Überblick
| Feld | Bedeutung |
|---|---|
| Ueberschrift | Leer lassen, wenn keine Überschrift erscheinen soll – es wird kein Standardtext eingesetzt. Für die Übersichtsseite /produkte muss der Redakteur hier selbst einen Text eintragen, wenn eine Überschrift gewünscht ist. |
| Ueberschriften-Ebene | Ebene 1 nur verwenden, wenn die Liste der Hauptinhalt der Seite ist. Auf allen anderen Seiten Ebene 2 oder tiefer. |
| Familien / Kategorien | Beschränkt die Liste auf die gewählten Produktfamilien. Leer = keine Beschränkung. Auswählbar sind nur Familien der zweiten Ebene. Wird ignoriert, sobald unter „Manuelle Produktauswahl" mindestens ein Produkt gewählt ist. |
| Attribut-Auswahl (Attribut + Werte) | Je Zeile ein Attribut mit seinen Werten. Mehrere Zeilen werden UND-verknüpft, Werte innerhalb einer Zeile ODER-verknüpft. Auswählbar sind nur Attribute, die am Attribut-Datensatz als Filter freigegeben und vom Typ Mehrfachauswahl sind (siehe Kapitel „Produktliste, Filter und Suche"). Wird ignoriert, sobald unter „Manuelle Produktauswahl" mindestens ein Produkt gewählt ist. |
| Manuelle Produktauswahl | Überschreibt Familien- und Attribut-Auswahl. Die Reihenfolge in diesem Feld ist die Ausgabereihenfolge. Auswählbar sind nur konfigurierbare Produkte – Varianten erscheinen in der Liste grundsätzlich nicht. |
| Maximale Anzahl | 0 oder leer = keine Begrenzung. Wirkt nur, wenn Pagination ausgeschaltet ist, und immer NACH einer Besucher-Filterung. |
| Pagination anzeigen | An: volle Seitenblätterung, die maximale Anzahl wird ignoriert. Aus: Teaser-Modus mit maximaler Anzahl. |
| Sortierung | Name A–Z oder Name Z–A. Wirkungslos bei manueller Produktauswahl. |
| Filter und Suche anzeigen | Blendet Suchfeld und Filter-Panel ein. Besucher können damit nur innerhalb der oben gewählten Vorauswahl weiter einschränken. |
Wichtig: Manuelle Auswahl hat Vorrang. Sobald mindestens ein Produkt unter „Manuelle Produktauswahl" gewählt ist, werden die Einstellungen bei Familien/Kategorien, Attribut-Auswahl und Sortierung ignoriert. Es gilt ausschließlich die Reihenfolge, in der die Produkte im Feld „Manuelle Produktauswahl" stehen.
Ueberschriften-Ebene richtig wählen. Ebene 1 (H1) darf pro Seite nur einmal vorkommen. Auf der Seite „Produkte" trägt die dort platzierte Liste bereits Ebene 1. Setzen Sie die Ueberschriften-Ebene auf jeder anderen Seite auf 2 oder tiefer, damit keine zweite H1 entsteht.
Limit und Pagination
„Maximale Anzahl" und „Pagination anzeigen" lassen sich unabhängig voneinander einstellen. Es gilt:
| Pagination anzeigen | Maximale Anzahl | Ergebnis |
|---|---|---|
| An | gesetzt | Volle Seitenblätterung – die maximale Anzahl wird ignoriert. |
| An | leer | Volle Seitenblätterung. |
| Aus | gesetzt | Teaser mit genau der eingetragenen Anzahl Produkte, ohne Seitenblätterung. |
| Aus | leer | Teaser ohne Begrenzung – es werden jedoch höchstens 500 Produkte ausgegeben. |
Ohne Pagination werden höchstens 500 Produkte ausgegeben, auch wenn „Maximale Anzahl" leer bleibt. Die maximale Anzahl greift immer NACH einer Besucher-Filterung – bei aktivem Filter und Suche zählt also die dann noch übrig gebliebene, gefilterte Trefferliste.
Mehrere Listen auf einer Seite
Sie dürfen mehrere Produktlisten-Elemente auf derselben Seite einfügen – auch mehrere gleichzeitig mit aktiviertem Filter und Suche. Jede Liste merkt sich ihren eigenen Filter-, Such- und Seitenzustand getrennt in der Adresszeile; das Bedienen einer Liste wirkt sich nicht auf die andere aus.
Filter und Suche
Ist „Filter und Suche anzeigen" aktiviert, können Besucher innerhalb der oben getroffenen Vorauswahl (Familien/Kategorien bzw. Attribut-Auswahl) weiter einschränken – nicht darüber hinaus. Welche Produkteigenschaften dabei überhaupt als Filter zur Auswahl stehen, steuert weiterhin das Häkchen „Als Filter anbieten" am jeweiligen Attribut-Datensatz, siehe Kapitel „Produktliste, Filter und Suche".
Häufige Fragen
Kann ich die Produktliste auf mehreren Seiten gleichzeitig verwenden?
Ja. Fügen Sie das Element einfach auf jeder gewünschten Seite erneut ein und konfigurieren Sie es dort unabhängig.
Warum ändert sich meine Attribut-Auswahl nicht, obwohl ich manuell Produkte gewählt habe?
Sobald mindestens ein Produkt manuell gewählt ist, gilt ausschließlich diese Auswahl in ihrer eingetragenen Reihenfolge – Familien-, Attribut- und Sortier-Einstellungen werden dann ignoriert.
Darf ich auf der Seite „Produkte" eine zweite Ueberschriften-Ebene-1-Liste einfügen?
Nein. Auf jeder Seite darf nur eine Ueberschrift der Ebene 1 vorkommen. Da die dort bereits vorhandene Liste Ebene 1 trägt, muss jede weitere Liste auf dieser Seite Ebene 2 oder tiefer verwenden.
Produktliste, Filter und Suche
Die Seite „Produkte" enthält bereits eine Instanz des Inhaltselements Produktliste (siehe Kapitel „Produktliste (Content-Element)"), auf der Besucher alle Produkte als Kartenübersicht sehen. Sie können darin suchen, nach Kategorien und ausgewählten Produkteigenschaften filtern und über Seitenzahlen blättern. Jeder Filterzustand hat eine eigene Adresse, die man kopieren und weitergeben kann.
Wann nutze ich es?
- Wenn Sie steuern möchten, welche Produkteigenschaften als Filter angeboten werden.
- Wenn Sie zusätzliche Inhalte unter der Liste pflegen möchten.
Eine Produkteigenschaft als Filter anbieten
- Klicken Sie links im Menü auf Liste.
- Wählen Sie im Seitenbaum den Ordner mit den Produktdaten.
- Öffnen Sie die Tabelle Attribut-Definition und klicken Sie den gewünschten Eintrag an.
- Wechseln Sie auf den Reiter Redaktion.
- Setzen Sie das Häkchen bei Als Filter anbieten.
- Speichern Sie.
„Wenn aktiv, erscheint dieses Attribut im Filter-Panel der Produktliste. Nur die Werttypen Mehrfachauswahl, Ja/Nein und Messbereich sind filterbar. Dieses Feld wird vom PIM-Import nie überschrieben."
Wichtig: Ein freigegebener Filter erscheint im Filter-Bereich erst, nachdem ein Besucher eine Kategorie ausgewählt hat — und nur, wenn die Produkte dieser Kategorie zu dieser Eigenschaft überhaupt Werte haben.
Was Besucher auf der Seite sehen
- Suchfeld „Produkte durchsuchen" — durchsucht Produktname, Beschreibung und Artikelnummer, auch die Artikelnummern der Varianten.
- Schaltfläche „Filter öffnen", die den Filter-Bereich einblendet.
- Kategorien als Ankreuzfelder im Filter-Bereich.
- Aktive Filter als anklickbare Chips über der Liste, mit „Alle zurücksetzen" daneben.
- Eine Trefferzahl („… Produkte gefunden").
- Seitenzahlen zum Blättern.
- Bei keinem Treffer die Meldung „Keine Produkte gefunden".
Zusätzliche Inhalte auf der Produktseite
Die Produktliste ist inzwischen ein normales Inhaltselement (siehe Kapitel „Produktliste (Content-Element)") und liegt bereits auf dieser Seite. Ober- und unterhalb davon können Sie wie auf jeder anderen Seite weitere Inhaltselemente pflegen.
Wichtig: Verwenden Sie auf dieser Seite keine weitere Überschrift der ersten Ebene (H1) — die Hauptüberschrift „Produkte" gehört bereits der hier platzierten Liste (deren Feld „Ueberschriften-Ebene" ist auf 1 gesetzt). Nutzen Sie in Ihren übrigen Inhaltselementen Überschriften ab der zweiten Ebene (H2).
Felder im Überblick
| Feld | Reiter | Bedeutung |
|---|---|---|
| Als Filter anbieten | Redaktion | Wenn aktiv, erscheint diese Eigenschaft im Filter-Bereich der Produktliste. |
| Sortierung | Redaktion | Legt die Reihenfolge der Filter im Filter-Bereich fest (kleinere Zahl steht oben). |
| Alle übrigen Felder | PIM-Daten | Kommen aus dem PIM und werden bei jedem Abgleich überschrieben. |
Für Administratoren: Produkte pro Seite ändern
Die Anzahl der Produkte pro Listenseite ist die Einstellung „Produkte pro Listenseite" (faft3_products.listPageSize) in den Website-Einstellungen; Standard ist 24. Der Wert wird in den Website-Einstellungen gepflegt, eine Programmierung ist nicht nötig.
Häufige Fragen
Ich habe ein Häkchen gesetzt, sehe den Filter aber nicht.
Der Filter erscheint erst nach Auswahl einer Kategorie, und nur wenn Produkte dieser Kategorie Werte dazu haben. Prüfen Sie zusätzlich, ob der Cache geleert wurde.
Kann ich Text-Eigenschaften als Filter anbieten?
Nein, nur Mehrfachauswahl, Ja/Nein und Messbereich lassen sich als Filter anbieten.
Verliert der Abgleich mit dem PIM meine Filter-Häkchen?
Nein, dieses Feld wird nie überschrieben.
Kann ich einen gefilterten Zustand verschicken?
Ja, kopieren Sie einfach die Adresse aus der Adresszeile.
Warum sehe ich meine Änderung nicht auf der Website?
Meist ist die Seite noch im Zwischenspeicher. Klicken Sie oben rechts auf das Blitz-Symbol und wählen Sie Cache dieser Seite leeren, dann laden Sie die Website neu.
News-Liste
Das Inhaltselement News-Liste zeigt eine Übersicht Ihrer News-Beiträge. Über das Feld Template Layout im Reiter Template bestimmen Sie, wie diese Übersicht aussieht.
Layout wählen
| Layout | Wirkung auf die Seite |
|---|---|
| Default (Voreinstellung) | Dreispaltiges Kartenraster mit Bild, Datum, Kategorie, Titel, Anrisstext und Autor. |
| Liste (gestapelt) | Beiträge untereinander in einer schmalen Liste statt im Kartenraster. |
| Hover Cards | Dunkle Bildkacheln; der Anrisstext erscheint erst, wenn man mit der Maus darüberfährt. |
| Storys | Dreispaltiges Kartenraster ohne Datum, Kategorie und Autor: nur Bild, Titel und ein kurzer Anrisstext – die ganze Karte ist anklickbar. |
Schritt für Schritt
- Öffnen Sie im Backend das Inhaltselement News-Liste zur Bearbeitung.
- Wechseln Sie zum Reiter Template.
- Wählen Sie im Feld Template Layout die gewünschte Option, zum Beispiel Storys.
- Klicken Sie auf Speichern und prüfen Sie das Ergebnis über die Vorschau.
Häufige Fragen
Warum sehe ich bei „Storys“ kein Datum und keine Kategorie mehr?
Das Layout „Storys“ zeigt bewusst nur Bild, Titel und kurzen Anrisstext – das entspricht dem gewünschten Karten-Design. Datum, Kategorie und Autor bleiben am Beitrag erhalten, werden in diesem Layout aber nicht angezeigt.
Warum sehe ich meine Änderung nicht auf der Website?
Meist ist die Seite noch im Zwischenspeicher. Klicken Sie oben rechts auf das Blitz-Symbol und wählen Sie Cache dieser Seite leeren, dann laden Sie die Website neu.
Aktuelle News (Content-Element)
Das Inhaltselement Aktuelle News zeigt die neuesten Beiträge aus einem News-Ordner als kleine Karten – zum Beispiel drei aktuelle Meldungen auf der Startseite. Jede Karte zeigt automatisch das Beitragsbild aus dem News-Beitrag; Kategorie, Autor und Datum werden weiterhin nicht angezeigt. Ist bei einer Karte eine Detailseite hinterlegt, ist die gesamte Karte anklickbar und führt direkt zum vollständigen Beitrag.
Wann verwenden?
- Um auf der Startseite oder einer anderen Seite auf die neuesten News-Beiträge hinzuweisen, ohne eine vollständige News-Liste einzubinden.
- Für einen kompakten „Aktuelles"-Teaser mit fester Anzahl Karten.
Schritt für Schritt
- Klicken Sie links im Seitenbaum auf die Seite, auf der die Karten erscheinen sollen.
- Klicken Sie in der gewünschten Spalte auf + Inhalt.
- Wechseln Sie im Auswahldialog zum Reiter Custom und wählen Sie Aktuelle News aus.
- Wählen Sie im Feld News-Ordner den Ordner, in dem Ihre News-Beiträge liegen.
- Tragen Sie bei Bedarf eine Überschrift ein und passen Sie die Anzahl News an.
- Klicken Sie auf Speichern und prüfen Sie das Ergebnis über die Vorschau.
Felder im Überblick
| Feld | Pflicht? | Hinweis |
|---|---|---|
| Overline | Nein | Kurze Überzeile über der Überschrift. |
| Überschrift | Nein | Erscheint über den Karten. Bleibt das Feld leer, wird keine Überschrift angezeigt. |
| News-Ordner | Ja | Ordner, in dem die News-Beiträge liegen. Ohne diese Auswahl bleibt der Bereich leer. |
| Anzahl News | Nein | Wie viele Karten angezeigt werden. Voreinstellung: 3. |
| Detailseite (optional) | Nein | Seite mit dem News-Detail-Plugin. Ohne Auswahl werden die Karten ohne Link angezeigt. |
News-Ordner nicht vergessen. Ohne gewählten News-Ordner bleibt der Bereich komplett leer – es erscheint keine Fehlermeldung im Frontend.
Häufige Fragen
Warum sind meine Karten nicht anklickbar?
Solange im Feld „Detailseite (optional)" keine Seite eingetragen ist, ist die ganze Karte bewusst nicht anklickbar. Tragen Sie dort die Seite mit dem News-Detail-Plugin ein, damit ein Klick auf eine beliebige Stelle der Karte zum vollständigen Beitrag führt.
Warum sehe ich weniger als drei Karten?
Es werden nur Beiträge angezeigt, die im gewählten Ordner tatsächlich vorhanden und sichtbar sind (nicht versteckt, nicht zeitlich gesperrt). Liegen weniger passende Beiträge vor, erscheinen entsprechend weniger Karten.
Warum sehe ich meine Änderung nicht auf der Website?
Meist ist die Seite noch im Zwischenspeicher. Klicken Sie oben rechts auf das Blitz-Symbol und wählen Sie Cache dieser Seite leeren, dann laden Sie die Website neu.
Karriereseite & Stellenanzeigen
Die Karriereseite listet Ihre offenen Stellen als Kacheln auf und verlinkt jede Kachel auf eine eigene Stellenanzeige-Unterseite. Die Übersicht entsteht über das Inhaltselement Job/Stellenangebote, die einzelne Stellenanzeige über eine normale Unterseite mit dem Seitenlayout Jobs Detail.
Wann verwenden?
Immer dann, wenn eine neue Stelle veröffentlicht werden soll. Für allgemeine Karriere-Inhalte (z. B. „Warum bei uns arbeiten?“, Benefits, Teamfotos) nutzen Sie stattdessen die üblichen Inhaltselemente auf der Karriere-Startseite selbst – nur die einzelnen Stellenanzeigen laufen über dieses Muster.
Schritt 1: Neue Stellenanzeige-Seite anlegen
- Klicken Sie im Seitenbaum mit der rechten Maustaste auf die Seite Karriere und wählen Sie Neue Seite anlegen (alternativ: Seite anlegen und per Ziehen unter „Karriere“ einsortieren).
- Tragen Sie im Feld Seitentitel die Stellenbezeichnung ein, z. B. „Servicetechniker (m/w/d)“.
- Der Assistent zeigt anschließend einen Schritt Seitenlayout, in dem Sie direkt den Eintrag Jobs Detail auswählen können – die Hinweismeldung zu den drei zusätzlichen Feldern erscheint hier genauso wie im normalen Bearbeitungsformular.
- Falls Sie das Seitenlayout im Assistenten nicht gesetzt haben (oder bei einer bereits bestehenden Seite): Wechseln Sie zum Reiter Erscheinungsbild und wählen Sie im Feld Backend-Layout den Eintrag Jobs Detail. Nach der Auswahl erscheint kurz eine Hinweismeldung, die erklärt, dass die drei Felder Arbeitsort, Anstellung und Beginn erst nach dem Speichern sichtbar werden. Unter dem Auswahlfeld steht außerdem ein Hilfetext, der erklärt, dass das Seitenlayout normalerweise von der übergeordneten Seite vererbt wird und Sie hier nur bei einer bewusst abweichenden Darstellung (z. B. „Jobs Detail“ oder eine Produktseite) eingreifen müssen.
- Wechseln Sie zum Reiter Allgemein und füllen Sie die Felder Arbeitsort, Anstellung und Beginn aus (diese drei Felder erscheinen nur, wenn das Backend-Layout „Jobs Detail“ ausgewählt ist).
- Tragen Sie im Feld Untertitel eine kurze Kachel-Beschreibung ein (1–2 Sätze) – dieser Text erscheint später auf der Kachel der Karriere-Übersicht.
- Klicken Sie auf Speichern.
- Fügen Sie auf der neuen Seite über + Inhalt ein Inhaltselement Text mit der eigentlichen Stellenbeschreibung (Aufgaben, Profil, Angebot) ein und speichern Sie.
| Feld | Pflicht? | Hinweis |
|---|---|---|
| Seitentitel | Ja | Erscheint als Überschrift der Stellenanzeige und als Titel der Kachel auf der Karriere-Übersicht. |
| Untertitel | Nein | Kurzer Anreißertext, erscheint nur auf der Kachel der Übersicht, nicht auf der Stellenanzeige selbst. |
| Backend-Layout | Ja | Muss auf Jobs Detail stehen, sonst erscheinen Arbeitsort/Anstellung/Beginn nicht und die Seite wird nicht wie eine Stellenanzeige dargestellt. |
| Arbeitsort | Nein | Freitext, z. B. „Musterstadt“ oder „Remote“. Erscheint mit Symbol in der Kopfzeile der Stellenanzeige und auf der Kachel. |
| Anstellung | Nein | Freitext, z. B. „Vollzeit“, „Teilzeit“ oder „Werkstudent“. Erscheint mit Symbol in der Kopfzeile und auf der Kachel. |
| Beginn | Nein | Datum, ab wann die Stelle zu besetzen ist. Erscheint mit Symbol in der Kopfzeile und auf der Kachel. |
Schritt 2: Stellenanzeige auf der Karriereseite verlinken
Damit eine Stellenanzeige auf der Übersichtsseite erscheint, muss sie im Inhaltselement Job/Stellenangebote ausgewählt sein.
- Öffnen Sie die Seite Karriere im Seitenbaum.
- Öffnen Sie zur Bearbeitung das vorhandene Inhaltselement Job/Stellenangebote (oder legen Sie über + Inhalt ein neues an, Reiter „Typischer Seiteninhalt“).
- Fügen Sie im Feld Job einfügen die gewünschte(n) Stellenanzeige-Seite(n) hinzu. Die Reihenfolge im Feld bestimmt die Reihenfolge der Kacheln.
- Wählen Sie im Feld Teaser-Variante zwischen Ohne Bild und Mit Bild (für „Mit Bild“ muss die Stellenanzeige-Seite ein Seitenmedium/Bild hinterlegt haben).
- Klicken Sie auf Speichern und prüfen Sie das Ergebnis über die Vorschau.
| Feld | Pflicht? | Hinweis |
|---|---|---|
| Überzeile | Nein | Kleiner Text oberhalb der Überschrift, z. B. „Offene Stellen“. |
| Überschrift | Nein | Überschrift oberhalb der Job-Kacheln, z. B. „Unsere aktuellen Stellenangebote“. |
| Teaser-Variante | Ja | „Ohne Bild“ zeigt reine Text-Kacheln, „Mit Bild“ zeigt zusätzlich das Seitenmedium der jeweiligen Stellenanzeige. |
| Job einfügen | Ja | Auswahl der Stellenanzeige-Seiten, die als Kacheln erscheinen sollen. Ohne Auswahl bleibt der Bereich leer. |
Ein Beispiel für dieses Muster finden Sie bereits im Seitenbaum: die Seite Karriere mit drei Beispiel-Stellenanzeigen. Titel, Untertitel, Arbeitsort, Anstellung, Beginn und die Aufgabenbeschreibung sind dort bewusst mit „[Platzhalter]“ markiert und müssen vor der Veröffentlichung durch echte Inhalte ersetzt werden.
Häufige Fragen
Ich sehe die Felder „Arbeitsort“, „Anstellung“ und „Beginn“ nicht – warum?
Diese Felder werden nur eingeblendet, wenn im Reiter „Erscheinungsbild“ das Backend-Layout Jobs Detail ausgewählt ist. Prüfen Sie diese Einstellung zuerst.
Zusätzlich gilt: Die drei Felder erscheinen nicht sofort beim Umstellen des Backend-Layouts, sondern erst, nachdem Sie die Seite einmal gespeichert haben. Beim Umstellen auf „Jobs Detail“ weist Sie eine kurze Meldung rechts oben darauf hin. Klicken Sie also zuerst auf Speichern und wechseln Sie dann zum Reiter „Allgemein“.
Wie ändere ich die Reihenfolge der Stellenanzeigen auf der Übersicht?
Öffnen Sie das Inhaltselement „Job/Stellenangebote“ auf der Karriereseite und ändern Sie die Reihenfolge der Einträge im Feld „Job einfügen“ – die Kacheln erscheinen in derselben Reihenfolge.
Eine Stelle ist nicht mehr aktuell – muss ich die Seite löschen?
Nein. Entfernen Sie die Seite stattdessen aus dem Feld „Job einfügen“ auf der Karriereseite, oder verstecken Sie die Stellenanzeige-Seite direkt im Seitenbaum (Rechtsklick auf die Seite → „Deaktivieren“). So bleibt die Seite erhalten, ist aber weder verlinkt noch aufrufbar.
Kontaktformular
Ein fertiges Kontaktformular, das Sie auf jeder Seite einfügen können. Besucher tragen Unternehmen, Name, E-Mail-Adresse und optional eine Nachricht ein – nach dem Absenden geht die Anfrage per E-Mail an das Team, und der Besucher sieht eine Bestätigungsmeldung.
Wann verwenden?
Immer dann, wenn Besucher Sie direkt über die Website kontaktieren sollen – typischerweise auf der Kontaktseite. Die Felder des Formulars sind fest vorgegeben; Sie wählen nur aus, auf welcher Seite das Formular erscheint.
Formular auf einer Seite einfügen
- Klicken Sie links im Seitenbaum auf die Seite, auf der das Formular erscheinen soll.
- Klicken Sie in der gewünschten Spalte auf + Inhalt.
- Wählen Sie im Auswahldialog im Reiter Formulare das Element Formular aus.
- Wählen Sie im Reiter Plug-In unter Formulardefinition den Eintrag Kontaktformular aus.
- Klicken Sie oben auf Speichern und prüfen Sie das Ergebnis über die Vorschau.
Diese Felder sehen Besucher
| Feld | Pflicht? | Hinweis |
|---|---|---|
| Unternehmen | Ja | Firmenname des Absenders. |
| Vorname | Ja | Steht am Bildschirm neben dem Nachnamen (auf dem Smartphone untereinander). |
| Nachname | Ja | |
| Ja | Wird automatisch auf gültiges E-Mail-Format geprüft. | |
| Ihre Nachricht an uns | Nein | Freies Textfeld für die Anfrage. |
Unter den Feldern zeigt das Formular automatisch den Hinweis „* Pflichtfeld“ sowie den Datenschutz-Hinweis mit Link zur Datenschutzerklärung – beides müssen Sie nicht selbst pflegen.
Was passiert nach dem Absenden?
- Die Anfrage wird per E-Mail an die hinterlegte Empfängeradresse geschickt (Betreff: „Neue Kontaktanfrage über das Kontaktformular“).
- Der Besucher sieht eine Bestätigungsmeldung: „Vielen Dank für Ihre Nachricht …“
- Lässt der Besucher ein Pflichtfeld leer oder gibt eine ungültige E-Mail-Adresse ein, erscheint eine Fehlermeldung direkt am betroffenen Feld – abgeschickt wird erst, wenn alles ausgefüllt ist.
Häufige Fragen
Kann ich die Felder des Formulars selbst ändern?
Sie können das Formular im Backend-Modul Formulare ansehen. Änderungen an Feldern, Empfängeradresse oder Texten stimmen Sie bitte mit Ihrer Agentur ab – das Formular ist Teil der Website-Programmierung und wird dort zentral gepflegt, damit Design und Funktion erhalten bleiben.
An welche E-Mail-Adresse gehen die Anfragen?
Die Empfängeradresse ist zentral im Formular hinterlegt. Wenn Anfragen an eine andere Adresse gehen sollen, geben Sie Ihrer Agentur Bescheid.
Warum sehe ich das Formular nicht auf der Website?
Meist ist die Seite noch im Zwischenspeicher. Klicken Sie oben rechts auf das Blitz-Symbol und wählen Sie Cache dieser Seite leeren, dann laden Sie die Website neu.
Visual Editor
Mit dem Visual Editor bearbeiten Sie Texte direkt auf der Seite, genau so, wie Besucher sie später sehen – ohne den Umweg über ein Formular.
Wo finde ich die Ansicht?
- Klicken Sie links im Seitenbaum auf die gewünschte Seite.
- Klicken Sie im Modulmenü unter Content auf Seiteninhalt (steht direkt über Seitenansicht).
Die Seite wird nun so angezeigt wie im Frontend. Über Seitenansicht im selben Menü wechseln Sie jederzeit zurück zur bisherigen, listenbasierten Bearbeitung.
Was kann ich direkt auf der Seite bearbeiten?
Klicken Sie in einen Text, um ihn zu bearbeiten. Das funktioniert bei:
- einfachen Texten (z. B. Überschriften, kurze Beschriftungen)
- formatierten Texten (Rich-Text, z. B. Fließtexte mit Fett, Kursiv oder Aufzählungen)
Nicht direkt auf der Seite bearbeitbar sind: Auswahlfelder (z. B. Layout-Varianten), Bilder und Dateien, Verknüpfungen/Links sowie Felder, die zu einem anderen Datensatz gehören (z. B. Angaben zu einem verknüpften Projekt). Öffnen Sie in diesen Fällen das gewohnte Bearbeitungsformular über das Bearbeiten-Symbol des Inhaltselements.
Inhaltselemente hinzufügen, verschieben und löschen
Auch das erledigen Sie direkt auf der Seite: Neue Inhaltselemente fügen Sie über die +-Schaltflächen zwischen bzw. innerhalb der Bereiche ein, bestehende verschieben Sie per Ziehen (Drag & Drop) an eine andere Stelle, und über das Kontextmenü eines Elements löschen Sie es.
Wann brauche ich weiterhin das klassische Formular?
Für alles, was der Visual Editor nicht direkt anbietet – zum Beispiel Auswahlfelder, Bilder, Verknüpfungen, Übersetzungen oder Berechtigungen – bleibt das klassische Bearbeitungsformular die richtige Stelle. Öffnen Sie es wie gewohnt über die Seitenansicht oder über das Bearbeiten-Symbol eines Inhaltselements.
Häufige Fragen
Warum kann ich einen Text nicht anklicken?
Nicht jeder Text ist direkt editierbar. Auswahlfelder, Bild- und Dateiangaben sowie Felder anderer Datensätze (z. B. Projektangaben) öffnen weiterhin nur über das klassische Formular.
Sieht der formatierte Text beim Bearbeiten genauso aus wie später auf der Website?
Ja, der Visual Editor zeigt Rich-Text-Felder mit derselben Formatierung wie im Frontend.
Kann ich im Visual Editor auch Übersetzungen bearbeiten oder Berechtigungen ändern?
Nein, dafür nutzen Sie weiterhin das klassische Formular bzw. die entsprechenden Backend-Module.
Handbuch-Kachel im Dashboard
Auf dem Dashboard – der Startseite des Backends – können Sie eine Kachel mit einem direkten Link zu diesem Redakteurshandbuch anzeigen lassen.
Wann verwenden?
Richten Sie diese Kachel einmalig ein, wenn Sie oder Ihre Kolleginnen und Kollegen schnell und ohne Suchen an das Handbuch kommen möchten – direkt beim Anmelden im Backend.
Schritt für Schritt
- Öffnen Sie das Backend und klicken Sie links im Menü auf Dashboard.
- Klicken Sie oben rechts auf Widget hinzufügen.
- Wählen Sie die Gruppe Dokumentation.
- Klicken Sie auf CAPTRON Handbuch.
- Die Kachel erscheint auf Ihrem Dashboard. Ein Klick auf den Button Handbuch öffnen öffnet dieses Handbuch in einem neuen Tab.
Schneller: fertiges Dashboard mit Vorlage anlegen
Statt die Kacheln einzeln hinzuzufügen, können Sie ein komplett vorbereitetes Dashboard in einem Schritt anlegen:
- Öffnen Sie das Backend und klicken Sie links im Menü auf Dashboard.
- Klicken Sie oben auf Dashboard hinzufügen (bzw. auf das Plus-Symbol neben den Dashboard-Reitern).
- Wählen Sie die Vorlage CAPTRON Standard-Dashboard.
- Vergeben Sie einen Namen und bestätigen Sie. Das neue Dashboard enthält bereits die Kacheln CAPTRON Handbuch, Erste Schritte mit TYPO3, Lesezeichen und Über TYPO3.
Im selben Auswahldialog steht außerdem die Vorlage CAPTRON Admin-Dashboard zur Verfügung, mit administrativen Kacheln (TYPO3-Sicherheitshinweise, TYPO3-Neuigkeiten, Fehler im System-Log sowie letzte und fehlgeschlagene Backend-Anmeldungen).
Sie können danach jederzeit weitere Kacheln hinzufügen oder vorhandene entfernen – die Vorlage legt nur den Startzustand fest.
Für Administratoren: Die Ziel-Adresse des Buttons lässt sich unter Admin-Werkzeuge > Einstellungen > Extension-Konfiguration > faft3_package im Feld Handbuch-URL ändern – zum Beispiel, sobald das Handbuch auf einer eigenen Adresse veröffentlicht wird. Bleibt das Feld leer, öffnet der Button die mitgelieferte Fassung dieses Handbuchs. Aktuell zeigt der Button auf https://handbuch.902868.jweiland-hosting.de/.
Häufige Fragen
Ich sehe die Kachel nicht in der Liste unter „Widget hinzufügen“ – was tue ich?
Prüfen Sie, ob Sie in der Gruppe Dokumentation nachsehen. Ist die Kachel bereits auf Ihrem Dashboard, wird sie in der Liste nicht erneut angeboten.
Der Button öffnet eine leere oder falsche Seite – was mache ich?
Wenden Sie sich an einen Administrator: Vermutlich ist unter der Extension-Konfiguration eine falsche Adresse eingetragen.
Ändert sich mein bestehendes Dashboard, wenn die Vorlage angepasst wird?
Nein. Die Vorlage wird nur beim Anlegen eines neuen Dashboards angewendet. Bereits vorhandene Dashboards bleiben unverändert.