Contao mit eRecht24 verbinden

[fenepedia/contao-er24-rechtstexte]

Diese Erweiterung ermöglicht die einfache Integration von Impressum und Datenschutzerklärung von eRecht24 in Contao.

Wichtiger Hinweis

Diese Erweiterung benötigt eine aktive Mitgliedschaft bei eRecht24. Nur mit der bezahlten Version können entsprechende API-Schlüssel generiert werden.

Video: So setzt du die Erweiterung ein

1. Voraussetzung

Die Erweiterung stellt lediglich eine Schnittstelle zur Verfügung. Es wird zwingend eine aktive Mitgliedschaft bei eRecht24 benötigt, um entsprechende API-Schlüssel zu generieren. Mehr zur Mitgliedschaft kannst du auf der Bestellseite von eRecht24 erfahren.

2. Installation

Die Erweiterung kann kostenlos über den Contao Manager installiert werden. Suche dazu nach der Erweiterung fenepedia/contao-er24-rechtstexte. Anschließend wie gewohnt das Installtool aufrufen, um die Datenbank zu aktualisieren.

3. API-Schlüssel generieren und Verbindung herstellen

Damit Contao die Texte von eRecht24 abrufen kann, muss ein API-Schlüssel generiert und hinterlegt werden. Dafür gehst du wie folgt vor:

  • Lege im eRecht24 «Projekt Manager für Webseiten» ein Projekt für deine Website an, sofern es noch keines gibt
  • Generiere entsprechende Texte für Impressum und Datenschutz
  • Klicke oben neben dem Projektnamen auf «Synchronisierung einrichten»
  • Klicke auf die Schaltfläche Neuen API-Schlüssel erzeugen
  • Kopieren den API-Schlüssel in die Zwischenablage.
  • Wechsle in das Contao-Backend. In der Seitenstruktur bearbeitest du den Startpunkt deiner Webseite
  • Fügen den API-Schlüssel in das zugehörige Feld eRecht24 API-Schlüssel ein.
  • Klicke abschließend auf Speichern. Die Felder eRecht24 Secret und eRecht24 Client-ID werden nun automatisch erzeugt.

4. Inhaltselement hinzufügen

Um die Rechtstexte im Frontend auszugeben, musst du ein neues Inhaltselement hinzufügen.

  • Gehe im Contao-Backend unter Artikel und öffne eine entsprechende Seite (z. B. Impressum)
  • Füge ein neues Inhaltselement vom Typ eRecht24 Rechtstext ein
  • Wähle innerhalb des Elements den passenden Rechtstext-Typ (z. B. Impressum)
  • Klicke zum Abschluss auf die Schaltfläche Speichern und Schließen

Wiederhole diesen Schritt für weitere Rechtstexte wie die Datenschutzerklärung und Datenschutzerklärung für Social-Media.

Ab sofort sollten die Rechtstexte im Frontend ausgegeben werden.

5. Texte aktualisieren

Die Texte werden nicht automatisch aktualisiert. Die Texte müssen zunächst über den Projekt Manager von eRecht24 neu generiert werden. Anschließend gibt es zwei Möglichkeiten, um die Texte innerhalb von Contao zu aktualisieren:

A) «Synchronisieren-Icon» innerhalb von eRecht24 klicken

Dazu öffnest du das entsprechende Projekt. Anschließend klickst du beim gewünschten Rechtstext auf das «Sync-Icon». Contao bekommt jetzt von eRecht24 eine Info und aktualisiert selbstständig die Texte.

B) Systemwartung von Contao nutzen

Dazu loggst du dich im Backend von Contao ein. Öffne den Menüpunkt «Systemwartung». Hier im Bereich «Daten bereinigen» die Checkbox bei «eRecht24 Rechtstexte-Cache leeren» auswählen und den Button «Daten bereinigen» klicken.

Dadurch wird der Cache geleert und beim nächsten Aufruf der Seite die aktuellen Rechtstexte abgerufen.

6. Mehrsprachigkeit einrichten

Zunächst musst du im Projekt Manager von eRecht24 auch englische Texte generieren lassen. Innerhalb von Contao wird die Sprache der Rechtstexte automatisch über die Sprache in der Root-Seite generiert. Für alle deutschen Seiten «de» wird die deutsche Sprache verwendet. Für alle anderen Sprachen werden die englischen Texte ausgegeben. Der API-Key lässt sich nur auf der Root-Seite eintragen, die mit «Fallback» markiert ist.

7. Tipps und Antworten auf häufige Fragen

Enthält die Erweiterung fertige Rechtstexte für Impressum und die Datenschutzerklärung?

Nein, die Erweiterung stellt lediglich eine Schnittstelle zur eRecht24-API dar. Die entsprechenden Texte müssen über den Projekt Manager von eRecht24 generiert werden.

Kann ich die Erweiterung auch mit dem kostenlosen Generator von eRecht24 nutzen?

Nein, um die Erweiterung zu nutzen, ist eine Premium Mitgliedschaft bei eRecht24 nötig. Nur mit der bezahlten Version und dem Projekt Manager können entsprechende API-Schlüssel generiert werden.

Werden die E-Mail-Adressen gegen Spam geschützt?

In der Regel werden die E-Mail-Adressen automatisch erkannt und mit dem Inserttag {{email::deine-adresse.de}} codiert. Damit werden die E-Mail-Adressen bei der Ausgabe auf der Website codiert und für Bots schwerer auslesbar.

Was passiert, wenn ich im Projekt Manager ein Projekt lösche, für das ich die Erweiterung nutze?

Mit dem Löschen des Projektes im Projekt Manager wird automatisch auch der API-Schlüssel gelöscht. Die Contao-Installation, die mit diesem API-Schlüssel verknüpft wurde, kann nun keine Aktualisierungen mehr von eRecht24 empfangen. Der letzte Stand der Rechtstexte wird dann als Fallbacklösung ausgegeben.

Du hast ein Problem oder dir fehlt eine Funktion?

Bitte kontaktiere dazu nicht den Support von eRecht24. Die Erweiterung wird von uns betreut und weiterentwickelt. Bitte erstelle bei Fragen oder Funktionswünschen direkt ein neues Ticket bei GitHub.

Wie kann ich die H1-Überschrift oder einen anderen Text anpassen?

Die schnellste Möglichkeit ist das Template ce_er24_legal_text.html5 zu bearbeiten und hier die Ausgabe mit «Suchen und Ersetzen» zu überschreiben. Dazu kannst du die PHP-Funktion str_replace() verwenden.

Beispiel, um die H1 zu ersetzen:

<?= str_replace("<h1>Impressum</h1>", "<h1>Mein neuer Text</h1>", $this->document)  ?>

Wenn du das Template nicht anpassen möchtest, dann kannst du auch den Hook parseFrontendTemplate verwenden.