Umstieg von Plugin v2

Das frühere Plugin v2 (eingebunden mit window.PTP_TRANSLATE_CONFIG) verband Übersetzungen in Fremdsprachen mit DeepL, Einfache Sprache und Leichte Sprache. Das Leichte Sprache Plugin ersetzt nur den Teil für Leichte Sprache.

Alte Einbindung vollständig entfernen

Die früheren Plugins und ihre Skript-Adressen betreiben wir nicht mehr, ihre Buttons funktionieren nicht. Entfernen Sie das alte Skript-Tag und die alte Konfiguration aus Ihren Vorlagen.

In drei Schritten

1. Altes Skript-Tag und window.PTP_TRANSLATE_CONFIG entfernen.

2. Die neue Zeile einfügen (Einbindung):

   <script src="https://leichtesprache.participaite.de/plugin/leichte-sprache.js" data-site="IHRE-KENNUNG" defer></script>

3. Einstellungen aus dem Teil LS übernehmen, soweit Sie sie noch brauchen. Viele sind überflüssig, weil das Plugin den Inhaltsbereich selbst findet.

Zuordnung der Optionen

Plugin v2 (LS: { … })	Leichte Sprache Plugin	Hinweis
enabled	entfällt	Ist das Skript eingebunden, ist das Plugin aktiv.
targetElementSelector	data-content / contentSelector	Meist nicht mehr nötig, der Inhaltsbereich wird automatisch erkannt.
buttonPlacement.type	data-placement / placement	floating, inside, above, neu ist none (kein Button).
buttonPlacement.position	data-position / position	Gleiche Werte.
buttonPlacement.offset (x, y)	data-offset / offset	Als Attribut data-offset="20,20".
buttonPlacement.buttonContainer	data-button / buttonTarget	CSS-Selektor des Elements für den Button.
buttonPlacement.buttonInsidePosition	data-button-at / buttonAt	start oder end.
buttonPlacement.zIndex	data-z-index / zIndex
accentColor	data-accent / accent
skipSelectors	data-skip / skipSelectors	Als Attribut eine Selektorliste mit Kommas.
skipTextSelectors	data-skip-text / skipText	Gleiche Form tag|Text.
noTranslateUrls, noTranslateHandles	data-skip-urls / skipUrls	Beide Listen werden zu einer. Ausgenommen ist jede Seite, deren Adresse einen der Teile enthält.
metaInfos	entfällt	Das Modell liest den Zusammenhang aus der Seite selbst.
Teile translator und EAS	entfällt	Nicht Teil dieses Plugins.
ptpTranslate.translateTo()	window.LeichteSprache.enable(), disable(), toggle()	Siehe JavaScript-API.

Alte Namen weiterverwenden

Sie können den Teil LS Ihrer alten Konfiguration auch einfach verschieben. In window.LS_PLUGIN_CONFIG versteht das Plugin die alten Namen targetElementSelector, accentColor, skipSelectors, skipTextSelectors, noTranslateUrls, noTranslateHandles und buttonPlacement mit type, position, offset, buttonContainer, buttonInsidePosition und zIndex. enabled und metaInfos ignoriert es. Stehen alte und neue Namen nebeneinander, gilt der neue.

Vorher mit Plugin v2:

<script>
  window.PTP_TRANSLATE_CONFIG = {
    translator: { enabled: true, sourceLang: "de", targetLangs: [{ code: "en" }] },
    LS: {
      enabled: true,
      targetElementSelector: "article.content",
      buttonPlacement: { type: "above" },
      accentColor: "#00507d",
      skipSelectors: [".werbung"],
      noTranslateUrls: ["/formulare/"]
    }
  };
</script>
<!-- altes Skript-Tag -->

Nachher:

<script>
  window.LS_PLUGIN_CONFIG = {
    site: "IHRE-KENNUNG",
    targetElementSelector: "article.content",
    buttonPlacement: { type: "above" },
    accentColor: "#00507d",
    skipSelectors: [".werbung"],
    noTranslateUrls: ["/formulare/"]
  };
</script>
<script src="https://leichtesprache.participaite.de/plugin/leichte-sprache.js" defer></script>

Oder kürzer, nur mit Attributen:

<script src="https://leichtesprache.participaite.de/plugin/leichte-sprache.js"
        data-site="IHRE-KENNUNG" data-placement="above" data-accent="#00507d"
        data-skip=".werbung" data-skip-urls="/formulare/" defer></script>

Markierungen und Gestaltung

Die Klassen ptp-simplify-skip, ptp-translate-skip und no-plugin-translation wirken weiter. Für neue Stellen empfehlen wir class="ls-skip" oder translate="no" (Inhalte ausnehmen).

Die alten CSS-Haken gibt es nicht mehr. Den Button gestalten Sie über die Akzentfarbe, CSS-Variablen und ::part() oder als eigenes Element mit data-button (Gestaltung).

Vom Simplify Plugin (v1)

Die noch ältere Konfiguration window.PTP_CONFIG liest das Plugin nicht. Übertragen Sie die Werte wie oben. Anders hießen dort buttonFloatingPosition (jetzt data-position), offsetX und offsetY (jetzt data-offset="x,y") und customButtonContainerSelector (jetzt data-button). Die Klasse ptp-skip aus v1 erkennt das Plugin nicht mehr. Ersetzen Sie sie durch ls-skip oder ergänzen Sie data-skip=".ptp-skip". Das Styling über #ptpButton entfällt.