Protected Shops
Protected Shops im Backend
Protected Shops synchronisiert Rechtstexte pro Shop, legt Dokumentzeilen an und schreibt aktive Dokumente in die zugeordneten Zielseiten.
Voraussetzungen und Zugriff
Die Seite ist nur nutzbar, wenn das Protected-Shops-Modul aktiv ist und das Backend-Recht fuer Protected-Shops-Rechtstexte vorhanden ist. Ist das Modul nicht aktiv, zeigt das Backend nur einen Aktivierungshinweis und bricht die Seite ab.
- Bereich: Protected Shops liegt im Rechtstexte-Bereich neben Trusted Shops, Haendlerbund und SofortIdent.
- Shop-Kontext: Oben wird der Multishop gewaehlt. Alle Shop-ID- und Dokumentdaten werden fuer diese Shop-Instanz geladen.
- Datenbasis: Ein ProtectedShops-Datensatz speichert mindestens
multishop_idundps_shop_id. Dokumente liegen als einzelne ProtectedShopsDocument-Datensaetze darunter.
Shop-ID speichern
Das Formular psform speichert die Shop-ID fuer den ausgewaehlten Multishop. Das Backend aktualisiert einen vorhandenen Datensatz oder legt bei neuer Konfiguration einen ProtectedShops-Datensatz an.
| Backend-Feld | Zweck | Wirkung |
|---|---|---|
ps_shop_id | Shop-ID von Protected Shops. | Wird bei API-Anfragen als ShopId uebergeben. Ohne gueltige ID koennen keine Dokumentinformationen oder Dokumentinhalte abgerufen werden. |
multishop_id | Shop-Zuordnung. | Wird aus der Shop-Auswahl uebernommen und entscheidet, welche statischen Texte, dynamischen Inhalte und Mailvorlagen aktualisiert werden. |
Nach dem Speichern ruft das Backend sofort Dokumentinformationen ab. Neue Dokumenttypen werden als Dokumentzeilen angelegt. Erkennt das Backend neuere Dokumentdaten, wird new_version gesetzt.
Dokumenttabelle
Die Dokumentliste ist eine feste BsTable mit setNoSetup. Spalten koennen hier nicht per Tabellen-Setup ein- oder ausgeblendet werden.
| Spalte | Backend-Felder | Bedeutung |
|---|---|---|
| Aktiv | id, status | Checkbox je Dokument. Ein Klick schaltet den Status per Ajax direkt um. Nur aktive Dokumente werden beim Abruf in den Shop uebernommen. |
| Bezeichnung | type | Dokumenttyp von Protected Shops, zum Beispiel Impressum, AGB, Widerruf oder weitere Rechtstexte. |
| Zielseite | site, type | Auswahl der Zielseite. Fuer Impressum ist das Ziel fest auf Impressum gesetzt. Andere Typen koennen einer dynamischen Inhaltsseite zugeordnet werden. |
| Letzte Synchronisation | last_time, synchro_status | Zeigt den letzten Dokumentstand und ein Statussymbol. Gruen bedeutet erfolgreiche Synchronisation, rot bedeutet nicht erfolgreiche Synchronisation. |
| Optionen | id, new_version | Enthaelt die Zeilenaktion Synchronisieren. Bei neuer Version erscheint zusaetzlich ein gelbes Warnsymbol. |
Zielseiten und Status
Die Zielseiten-Auswahl wird beim Aendern als Formular abgesendet. Das Backend speichert die Zuordnung direkt am Dokumentdatensatz.
- Impressum: Wird immer dem statischen Impressumsbereich des ausgewaehlten Shops zugeordnet.
- AGB und Widerruf: HTML-Inhalte werden in die gewaehlte dynamische Inhaltsseite geschrieben. Zusaetzlich wird eine PDF-Version geladen und an der Bestellbestaetigungs-Mailvorlage hinterlegt.
- Weitere Dokumenttypen: HTML-Inhalte werden in die gewaehlte dynamische Inhaltsseite geschrieben.
- Keine Zielseite: Das Dokument bleibt sichtbar, wird aber nicht in eine Inhaltsseite uebernommen.
Zeilenaktionen
Die Optionsspalte enthaelt pro Dokument die Aktion Synchronisieren. Die Aktion laedt das einzelne Dokument ueber die Protected-Shops-API neu.
- Ist das Dokument deaktiviert, bricht die Dokumentuebernahme ohne Import ab.
- Ist das Dokument aktiv und eine Zielseite vorhanden, wird HTML in die passende statische oder dynamische Seite geschrieben.
- Bei AGB und Widerruf wird zusaetzlich eine PDF-Datei fuer die Bestellbestaetigungs-Mail aktualisiert.
- Nach erfolgreichem Abruf werden
last_time,new_versionundsynchro_statusam Dokument aktualisiert.
Automatische Aktualisierung
Es gibt einen Cron-Abruf fuer Protected Shops. Er prueft alle ProtectedShops-Datensaetze mit gefuellter Shop-ID, ruft Dokumentinformationen ab und erkennt neuere Versionen.
auto: Nur wenn dieses Feld aktiv ist und das Dokument selbst aktiv ist, uebernimmt der Cron neue Dokumentversionen automatisch.auto_intervall: Ist als Datenfeld vorhanden, wird im aktuellen sichtbaren Backendformular aber nicht gepflegt.- Ohne automatische Uebernahme: Neue Versionen werden markiert, damit die Zeile im Backend mit Warnsymbol auffaellt.
auto oder auto_intervall. Wenn automatische Uebernahme genutzt wird, muss diese Einstellung ausserhalb dieser sichtbaren Seite gesetzt sein.Pruefschritte nach Einrichtung
- Richtigen Multishop auswaehlen.
- Protected-Shops-Shop-ID speichern.
- Nach dem Speichern pruefen, ob Dokumentzeilen angelegt oder als neue Version markiert wurden.
- Pro Dokument Aktiv-Status und Zielseite pruefen.
- Ein Dokument testweise synchronisieren und die Zielseite sowie die Bestellbestaetigungs-Mailanhaenge pruefen.