Bedienung für Shop-Betreiber

Diese Anleitung richtet sich an Shop-Betreiber und OXID-Admin-Benutzer ohne Server- oder Programmierzugriff. Installation und technische Updates sind unter Installation für Agenturen beschrieben.

Wo sich das Modul befindet

Article2Pdf arbeitet an zwei Stellen:

• Im Shop: Auf jeder Artikel-Detailseite steht der Button „PDF Datenblatt“. Er öffnet das Datenblatt in einem neuen Browser-Tab. Bei Varianten-Artikeln wird das Datenblatt der gewählten Variante erzeugt. CMS-Seiten lassen sich ebenfalls als PDF ausgeben.

• Im Admin: Am Artikel-Datensatz (Artikel verwalten ‣ Artikel ‣ Stamm) und am CMS-Datensatz (Kundeninformation ‣ CMS-Seiten) steht der Link „PDF ablegen“, der die Datei auf dem Server speichert.

Die Moduleinstellungen erreichen Sie unter Erweiterungen ‣ Module über den Eintrag „eComStyle.de: Article2Pdf“ im Tab Einstell. in den Gruppen „Grundeinstellungen“, „Abspeichern“ und „Bilder“.

Moduleinstellungen

Grundeinstellungen

Einstellung	Wirkung
Template für Artikeldatenblatt	Vorlage für das Artikel-PDF. Standard article_pdf, Tabellenform article_table.
Template für CMS-Ausgabe	Vorlage für CMS-Seiten, Standard content_pdf.
Eigene CSS, einen Style je Zeile	CSS-Anweisungen, die zusätzlich in das PDF-Template übernommen werden – eine Angabe je Zeile.
PDF-Button über den Tabs (nur OXID 6)	Platziert den PDF-Button oberhalb der Tabs statt als eigenen Tab; im Azure-Theme erforderlich.

Abspeichern

Einstellung	Wirkung
Ablageordner für PDFs	Ordner, in dem erzeugte PDFs auf dem Server abgelegt werden, vorgegeben out/media. Der Ordner muss vorhanden und beschreibbar sein. Leer lassen deaktiviert die Ablage.
PDFs auch bei Frontend-Aufruf ablegen	Aktiviert (Standard): Auch der Aufruf über den Shop-Button legt die Datei im Ablageordner ab. Deaktiviert: Die Ablage erfolgt nur über den Admin-Link „PDF ablegen“.
Abgelegte PDF im Frontend anzeigen	Aktiviert (Standard): Liegt eine gültige Datei im Ablageordner, wird sie direkt ausgeliefert statt neu erzeugt – spart Rechenleistung. Deaktiviert: Jedes PDF wird bei jedem Aufruf neu generiert.
Gültigkeitszeitraum in Tagen	Nach dieser Zahl von Tagen (Vorgabe 7) wird eine abgelegte PDF beim nächsten Aufruf mit aktuellem Datenstand neu erzeugt.

Bilder

Einstellung	Wirkung
Shoplogo-Dateiname	Dateiname inklusive Endung eines eigenen PDF-Logos, abgelegt im Modul-Asset-Ordner. Leer lassen, um das normale Shoplogo zu verwenden.
Entfernte Bilder zulassen	Kann helfen, wenn Bilder aus externen Quellen in der Langbeschreibung im PDF fehlen.
Alle Bilder in das base64-Format umwandeln	Aktiviert (Standard): Bilder werden eingebettet, was die Kompatibilität des PDF-Renderers verbessert.
Bilder aus der Artikel-Langbeschreibung entfernen	Aktiviert: Bilder innerhalb des Langbeschreibungs-Textes werden im PDF weggelassen.

Schnellstart

1. Öffnen Sie eine Artikel-Detailseite im Shop und klicken Sie auf „PDF Datenblatt“ – das PDF öffnet sich in einem neuen Tab.

2. Prüfen Sie Inhalt und Aussehen: Titel, Artikelnummer, Preis, Beschreibung, technische Daten und Bilder.

3. Möchten Sie das Datenblatt dauerhaft bereitstellen, öffnen Sie den Artikel im Admin und wählen Sie „PDF ablegen“.

4. Hinterlegen Sie bei Bedarf ein eigenes Logo oder eigene CSS-Anweisungen in den Moduleinstellungen.

Ablauf aus Kundensicht

Der Kunde öffnet eine Artikelseite und klickt auf „PDF Datenblatt“. Je nach Einstellung erhält er eine frisch erzeugte Datei oder – wenn eine noch gültige Datei im Ablageordner liegt – direkt die gespeicherte Version. Bei Varianten wählt er zuerst die Variante; das Datenblatt enthält dann deren Daten.

Empfohlene Arbeitsweise

• Lassen Sie die Ablage mit Gültigkeitszeitraum aktiv: Die PDFs bleiben aktuell, ohne bei jedem Aufruf neu berechnet zu werden.

• Legen Sie PDFs für wichtige Artikel gezielt über den Admin-Link ab – so steuern Sie den Zeitpunkt der Erzeugung selbst.

• Nach Preis- oder Textänderungen an einem Artikel die abgelegte PDF durch einen erneuten Aufruf von „PDF ablegen“ aktualisieren.

• Testen Sie eigene CSS-Anweisungen zuerst an einem einzelnen Artikel.

Grenzen und Hinweise

• Das Modul erzeugt Datenblätter für Artikel und CMS-Seiten; es ersetzt keine Rechnungs- oder Katalogerstellung.

• Bereits abgelegte PDFs zeigen den Stand ihrer Erzeugung; sie werden erst nach Ablauf des Gültigkeitszeitraums automatisch erneuert.

• Der Ablageordner wird nicht automatisch bereinigt – alte Dateien sind bei Bedarf manuell zu entfernen.

• Bei sehr langen oder komplex formatierten Beschreibungen kann die PDF-Darstellung vom Shop-Layout abweichen.

Prüfung vor dem Live-Betrieb

• Ein Artikel-PDF über den Shop-Button erzeugt und geprüft.

• Ein CMS-PDF über den PDF-Aufruf der CMS-Seite geprüft.

• Der Admin-Link „PDF ablegen“ speichert eine Datei im Ablageordner.

• Ein Varianten-Artikel liefert das Datenblatt der Variante.

• Ein B2B-Testkonto zeigt Nettopreise im PDF.

Häufige Anwenderfragen

Der PDF-Button fehlt auf der Artikelseite

Das Modul ist nicht aktiv oder der Shopcache wurde nicht geleert. Prüfen Sie Erweiterungen ‣ Module und leeren Sie den Cache.

Im PDF fehlen Bilder

Aktivieren Sie in der Gruppe „Bilder“ die Option „Entfernte Bilder zulassen“ und prüfen Sie, ob „Alle Bilder in das base64-Format umwandeln“ aktiviert ist. Bilder, die in der Langbeschreibung enthalten sind, lassen sich über die Option „Bilder aus der Artikel- Langbeschreibung entfernen“ kontrollieren.

Es wird eine veraltete PDF-Datei ausgeliefert

Die abgelegte Datei ist noch innerhalb des Gültigkeitszeitraums gültig. Erzeugen Sie die PDF über den Admin-Link „PDF ablegen“ neu oder kürzen Sie den Gültigkeitszeitraum in den Einstellungen.

Das PDF-Layout soll angepasst werden

Nutzen Sie die Einstellung „Eigene CSS“ für einfache Anpassungen. Für weitergehende Änderungen stehen eigene Templates zur Verfügung – wenden Sie sich dafür an Ihre Agentur.