eea/eeacomponents

Adds Einfach E-Auto components to your application. Requires an active subscription.

13.0.0 2024-11-27 17:21 UTC

Requires

• php: >=8.1
• typo3/cms-core: ^12.4

Requires (Dev)

• typo3/testing-framework: ^6.9.0

Replaces

• typo3-ter/eeacomponents: 13.0.0

GPL-2.0-or-later

• Tashko Valkov

README

In dieser Anleitung zeigen wir Ihnen, wie Sie die Komponenten von Einfach E-Auto in eine TYPO3 Website integrieren können. Diese werden über eine TYPO3-Erweiterung eingebunden.

Voraussetzungen

Damit die Einfach E-Auto-TYPO3-Erweiterung bei Ihnen installiert werden kann, benötigen Sie Folgendes:

1. Eine Installation von TYPO3 (Version 12+).
2. Administrator-Rechte für das Backend von TYPO3.
3. Die Quelldatei der Erweiterung.
4. Ihren individuellen Partnercode.

Schritt 1: TYPO3 Erweiterung installieren

Um die benutzerdefinierte Einfach E-Auto-Erweiterung in TYPO3 v11 zu installieren, sollten Sie Composer verwenden.

composer require eea/eeacomponents

Hinweis:

Ab TYPO3 v11.5 werden alle über Composer installierten Erweiterungen automatisch aktiviert, wenn sie installiert sind.

Schritt 2: Erweiterung konfigurieren

Die Erweiterung muss erstmalig konfiguriert werden. Falls Sie Ihre individuellen Zugangsdaten noch nicht erhalten haben, wenden Sie sich bitte an [e-mail] oder Ihren Partnermanager.

Einstellung der Erweiterungen

Die Erweiterung wird über Template-Konstanten konfiguriert. Deshalb müssen Sie sicherstellen, dass diese für die jeweiligen Root-Seiten konfiguriert sind.

• Loggen Sie sich dazu als Administrator in das TYPO3-Backend ein.

Vorbereitung: Template-Konstanten für die Erweiterung aktivieren

• Navigieren Sie sich zum TypoScript Reiter (Site Management > TypoScript und wählen Sie dann die Root-Seite (hier: Congratulations) im Dropdown Menü "TypoScript Datensatz bearbeiten") und klicken dort auf "Den gesamten TypoScript Datensatz bearbeiten".

• Aktivieren Sie dort unter dem Reiter "Erweiterte Optionen" unter dem Punkt "TypoScript-Dateien einbinden" die Konstanten für die Erweiterung. Falls die Erweiterung nicht unter 'Ausgewählte Objekte', sondern unter 'Verfügbare Objekte' aufgeführt wird, aktivieren Sie diese bitte, indem Sie den Eintrag der Erweiterung (EEA Components (eeacomponents)) anklicken und die Änderungen speichern:

Eingeben der CustomerID

• Navigieren Sie sich zum Constant Editor (Site Management > TypoScript und m Dropdown Menü "Konstanten-Editor")

• Im Kategorie-Dropdown-Menü tragen Sie bitte für jedes Plugin der Erweiterung plugin.tx_eeacomponents_* in das Feld CUSTOMER ID (plugin.tx_eeacomponents_[name des plugins].components.customeridnum) die Kundennummer (CustomerID) ein. Speichern Sie anschließend.

• Wiederholen Sie diesen Vorgang für alle Root-Seiten und Komponenten.

Optional: Anzeigen der Staging-Umgebung

Hinweis: Das Anzeigen der Staging-Komponenten sollte niemals in Ihrer Produktionsumgebung durchgeführt werden. Komponenten in der Staging-Umgebung können sich jederzeit ohne Voranmeldung ändern oder aufhören zu funktionieren.

• Fragen Sie bei Ihrem zuständigen Partnermanager die Einfach E-Auto Staging-URI an.

• Im Kategorie-Dropdown-Menü tragen Sie bitte für jedes Plugin der Erweiterung plugin.tx_eeacomponents_*, das Sie in der Staging-Phase sehen möchten, in das Feld SOURCE SCRIPT (Linker Teil der URL) (plugin.tx_eeacomponents_[name des plugins].components.sourcescript) die Staging-URI an.

• Speichern Sie anschließend.

• Wiederholen Sie diesen Vorgang für alle Root-Seiten und Komponenten

Schritt 3: Freischalten der Domains

Um die Komponenten freischalten zu lassen, senden Sie bitte eine E-Mail an Ihren Partnermanager oder [e-mail] mit der/den jeweiligen Domains, auf denen die Erweiterung eingebunden werden soll.

Schritt 4: Einbinden der Komponenten

Die Einfach E-Auto Komponenten können nun ganz bequem überall auf CMS-Seiten eingebunden werden. Dazu müssen Sie auf der jeweiligen Landingpage oder Website die Komponente ein Plugin einfügen.

Dazu unter dem Reiter Plug-Ins den Contenttyp "Allgemeines Plug-In" auswählen. Im Konfigurationsmenü des Plugins dann unter dem Reiter "Plug-In" unter "Ausgewähltes Plug-in" das jeweilige Plugin auswählen und speichern.

Anschließend können Sie, wenn nötig, das Modul per Drag-and-Drop an die gewünschte Stelle ziehen.

Hinweise und Einschränkungen

Bei der Implementierung der Components gibt es eine Einschränkung. In der aktuellen Version ist es lediglich möglich, jeweils nur einen Finder je Seite zu implementieren.

Fertig! Gehen Sie auf die Frontend-Seite Ihrer Typo-3-Seite und die Webkomponente sollte erfolgreich integriert sein.

Wir hoffen, dass Ihnen diese Anleitung geholfen hat. Wenn Sie weitere Fragen haben oder Hilfe benötigen, stehen wir gerne zur Verfügung.

Update der Komponente

Um neue Funktionen bereitzustellen oder Sicherheitsupdates umzusetzen, werden wir die Typo3-Erweiterung in unregelmäßigen Zeiträumen aktualisieren.