COMING SOON - is currently under development

Globale Variablen

Mit T3S Vars pflegst du Firma, Adresse, Telefon, E-Mail und weitere Angaben einmal in den Site Settings – und nutzt sie überall auf der Website als Platzhalter.

Redakteure schreiben im Text einfach T3Solution oder +49 175 8251430‬ oder wählen die Variable im Editor aus einem Dropdown. Im Frontend steht dann der aktuelle Wert – Telefonnummern, E-Mail-Adressen und Websites werden automatisch verlinkt. Ändert sich eine Angabe, passt du sie an einer Stelle an, und die ganze Website ist aktuell.

Dazu kommt ein fertiges Content Element „Adresse“ mit vier Layouts, schema.org-Auszeichnung, optionalen Icons und Google Maps inklusive 2-Klick-Lösung.

Auf einen Blick

  • Extension-Key:t3s_vars
  • Composer:t3s/vars
  • Version: 1.0.0
  • TYPO3: 14.3+
  • PHP: 8.2+
  • RTE: CKEditor 5
  • Datenbank: keine eigenen Tabellen oder Felder
  • Theme: keine Theme-Extension nötig

Was T3S Vars kann

Installation

Die Extension per Composer installieren:

composer require t3s/vars
vendor/bin/typo3 cache:flush

Im Classic-Mode installierst du t3s_vars über den Extension Manager. Ein Datenbank-Update ist nicht nötig.

Danach das Site Set „T3S Vars - Globale Variablen“ (t3s/vars) in der Site einbinden – unter Sites → Setup → Site bearbeiten → Sets oder in der Site-Konfiguration:

dependencies:
  - t3s/vars

Werte pflegen

Alle Angaben pflegst du unter Sites → Setup → Settings bearbeiten in der Kategorie „Globale Variablen“ – pro Site getrennt. Zu jedem Feld zeigt das Backend einen Hilfetext mit Format und Beispiel.

PlatzhalterSettingVerlinkung
Web Developer/FreelancerBeruf / Tätigkeit–
Helmut HackbarthInhaber / Ansprechpartner–
T3SolutionFirma–
Rodenbecker Str. 126Straße–
Anschriftenzusatz–
32427 / MindenPLZ / Ort–
DeutschlandLand–
+49 175 8251430‬ / Telefon / Faxtel:
info(de)t3solution.deE-Mailmailto: mit Spamschutz
https://www.t3solutin.deWebsiteURL, neuer Tab
DE126033027USt-IdNr.–
Google-Maps- / Business-Profil-LinkRouten-Button

Eigene Variablen legst du in einem eigenen Site Set an – jeder Schlüssel mit dem Präfix vars. wird automatisch zum Platzhalter und erscheint im Editor-Dropdown:

settings:
  vars.opening:
    label: 'Öffnungszeiten'
    category: vars
    type: string
    default: 'Mo–Fr 8–16 Uhr'

Im Editor (RTE)

Platzhalter tippen oder über den Button „Variablen“ in der CKEditor-Toolbar einfügen. Das Dropdown zeigt alle Variablen mit Wert – in derselben Reihenfolge wie im Adress-Element.

SchreibweiseAusgabe
+49 175 8251430‬Link, falls als Link-Schlüssel konfiguriert, sonst Text
+49 175 8251430‬immer reiner Text – z. B. innerhalb eines Links
{{unbekannt}}bleibt stehen – Tippfehler fallen sofort auf

Welche Schreibweise wo

WoSchreibweise
RTE / TextT3Solution
Fluid-Template<vars:get key="company" />
Überschriften (Header-Partial)<vars:replace link="0">…</vars:replace>
PAGEVIEW-Template{site.settings.vars.company}
TypoScript{$vars.company}

Der Fluid-Namespace vars ist global registriert. {$vars.…} funktioniert nur in TypoScript, z. B. für Meta-Tags:

page.meta.author = {$vars.company}

Content Element „Adresse“

Im Wizard unter Standard → Adresse (globale Variablen). Die Daten kommen direkt aus den Site Settings – änderst du dort etwas, sind alle Adress-Elemente aktuell. Ausgegeben wird ein <address> mit schema.org-Auszeichnung (Organization, PostalAddress, vatID …), leere Werte werden ausgelassen.

LayoutDarstellung
KompaktBeruf und Inhaber, Firma und Anschrift, Kontaktzeilen mit Routen-Link, USt-IdNr. – in klar getrennten Blöcken
Kompakt (Adresse & Karte)wie Kompakt, darunter die Google-Karte in voller Breite
Split (Kontakt + Karte)zweispaltig ab 992 px: links Subheader, Header, „Unternehmenssitz“, „Direktkontakt“ und Button „Route auf Google Maps planen“, rechts die Karte
Split (nur Kontakt, ohne Karte)wie Split, immer ohne Karte

Das Layout wird im vorhandenen Feld pi_flexform gespeichert – die Extension braucht kein eigenes Datenbankfeld. Header, Rahmen und Abstände kommen vom Layout Default der Content Elemente. Abstände und Farben lassen sich per CSS-Variable anpassen:

.t3s-address {
  --t3s-address-gap: 1.5rem;
  --t3s-address-item-gap: 1rem;
  --t3s-address-vat-gap: 3rem;
}

Icons: Ist EXT:iconpack mit Font Awesome (fa5, fa6 oder fa7) installiert, erscheinen Icons statt „Telefon:“, „E-Mail:“, „Web:“. Ohne iconpack bleiben die Beschriftungen – nichts zu konfigurieren.

Google Maps

SettingInhalt
Google-Maps- / Business-Profil-Link (vars.maps)Teilen-Link deines Google-Business-Profils () – für den Button „Route auf Google Maps planen“
Google-Maps-Einbettungs-URL (t3sVars.mapsEmbed)Google Maps → Teilen → Karte einbetten → HTML kopieren: die src-URL oder den ganzen <iframe>-Code einfügen. Erforderlich für die Layouts mit Karte.
Karte erst nach Klick laden (t3sVars.mapsConsent)2-Klick-Lösung: Vor dem Klick auf „Karte laden“ werden keine Daten an Google übertragen (Standard: an)

Verwende den Teilen-Link deines Business-Profils statt einer reinen Adresssuche. Zusammen mit identischen NAP-Daten (Name, Adresse, Telefon) auf Website und Profil ist das ein unterstützendes Local-SEO-Signal.

Hinweise

  • Cache: Nach Änderung der Werte den Frontend-Cache leeren – ersetzte Texte werden mit der Seite gecacht.
  • Platzhalter nicht verlinken: Innerhalb eines Links {{phone:text}} verwenden, sonst entstehen verschachtelte Links.
  • Schreibweise exakt:{{ company }} mit Leerzeichen wird nicht ersetzt.
  • Überschriften laufen nicht über parseFunc – dafür das Header-Partial mit <vars:replace> überschreiben.
  • Content Security Policy: Bei aktiver CSP frame-src www.google.com für die Karte erlauben.
  • RTE-Button abschaltbar unter Extension Configuration → t3s_vars → rteButton.

Release notes v1.0.0 - als PDF-Datei