PDF-Datenblatt

Dieses Dokument beschreibt die PDF-Datenblatt-Funktion (Fahrzeugexposé) des ADP Car Market Hub WordPress Plugins: wie Besucher darauf zugreifen, was es enthält und wie es konfiguriert wird.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie die PDF-Datenblatt-Funktion zum ersten Mal aktivieren, ihr Branding und ihre Inhalte konfigurieren oder Probleme mit dem Download-Link oder der gerenderten Ausgabe beheben möchten.

Übersicht

Die PDF-Datenblatt-Funktion bietet eine druckoptimierte Fahrzeug-Zusammenfassungsseite, die Besucher in ihrem Browser öffnen und über den integrierten Druckdialog des Browsers als PDF speichern oder ausdrucken können. Es handelt sich nicht um eine serverseitig generierte PDF-Datei, sondern um eine eigenständige HTML-Seite, die vom Plugin speziell für den Druck gerendert wird.

Wenn ein Besucher auf einer Fahrzeug-Detailseite auf die Schaltfläche "PDF herunterladen" klickt, navigiert der Browser zu einer speziellen URL. Das Plugin fängt die Anfrage ab, rendert eine vollständige, eigenständige HTML-Seite (ohne den Header und Footer des WordPress Themes) und beendet die Ausführung. Der Besucher kann dann die Browserfunktion Datei → Drucken → Als PDF speichern nutzen, um das Dokument zu sichern.

Anforderungen oder Voraussetzungen

• Die PDF-Datenblatt-Funktion muss in den Plugin-Einstellungen aktiviert sein (FEATURE_PDF_DATASHEET). Sie ist standardmässig aktiviert.
• Das Fahrzeug muss veröffentlicht sein. Entwürfe und private Beiträge geben am Datenblatt-Endpunkt einen 404-Fehler zurück.
• In WordPress müssen sprechende Permalinks (Pretty Permalinks) aktiviert sein, damit die von der Datenblatt-URL verwendete Abfragevariable korrekt verarbeitet werden kann.

Schritt-für-Schritt-Anleitung

PDF-Datenblatt-Funktion aktivieren

1. Öffnen Sie im WordPress Admin-Bereich die Plugin-Einstellungen.
2. Suchen Sie den Schalter für die PDF-Datenblatt-Funktion und stellen Sie sicher, dass er aktiviert ist.
3. Navigieren Sie zum Bereich PDF Manager, um Branding- und Inhaltsfelder zu konfigurieren.
4. Speichern Sie die Einstellungen.

Die Schaltfläche "PDF herunterladen" erscheint nun auf allen veröffentlichten Fahrzeug-Detailseiten.

Als Besucher auf das PDF-Datenblatt zugreifen

1. Öffnen Sie eine Fahrzeug-Detailseite.
2. Klicken Sie auf die Schaltfläche PDF herunterladen oder Exposé.
3. Der Browser navigiert zur Datenblatt-Seite. Diese Seite hat keinen Website-Header oder -Footer – sie ist speziell für den Druck formatiert.
4. Nutzen Sie die Druckfunktion des Browsers (Ctrl+P bzw. Cmd+P oder Datei → Drucken) und wählen Sie Als PDF speichern als Ziel.
5. Passen Sie bei Bedarf die Druckeinstellungen an (Papierformat, Ränder) und speichern Sie die Datei.

Direkt auf die Datenblatt-URL zugreifen

Das Datenblatt ist unter folgender Adresse erreichbar:

https://yoursite.com/?as24ci_pdf={post_id}

wobei {post_id} die numerische WordPress Beitrags-ID des Fahrzeugs ist. Diese URL ist für jeden Besucher ohne Authentifizierung zugänglich, solange das Fahrzeug veröffentlicht ist.

Konfigurations-Referenz

Funktions-Schalter

PDF Manager Einstellungen

Der PDF Manager steuert das Branding, das Layout und den Inhalt des gerenderten Datenblatts. Die Einstellungen werden als einzelne serialisierte Array-Option gespeichert (as24ci_pdf_manager_settings).

Branding:

Layout:

QR-Code:

Der QR-Code wird über einen öffentlichen Drittanbieter-Dienst generiert (api.qrserver.com). Dieser Dienst wird beim Laden der Datenblatt-Seite aufgerufen. Wenn Ihre Datenschutzerklärung keine externen Dienstaufrufe für Besucher zulässt, sollte diese Option deaktiviert bleiben, oder die QR-Bild-URL kann über den Filter as24ci_pdf_qr_image_url ersetzt werden.

Inhaltsfelder:

Die folgenden Felder können im PDF Manager einzeln aktiviert oder deaktiviert werden:

Alle Felder sind standardmässig aktiviert. Das Deaktivieren eines Feldes entfernt es aus dem gerenderten Datenblatt für alle Fahrzeuge.

Rechtlicher Hinweis:

Ein benutzerdefinierter rechtlicher Hinweis kann hinzugefügt werden. Dieser Text erscheint in der Fusszeile des Datenblatts. Verwenden Sie dieses Feld für erforderliche rechtliche Hinweise, Preis-Fussnoten oder Nutzungsbedingungen.

Betriebliche Hinweise

• Der Datenblatt-Endpunkt wird durch die Abfragevariable as24ci_pdf ausgelöst. Das Plugin registriert diese Variable in WordPress über den Filter query_vars und fängt die Anfrage in template_redirect ab.
• Die gerenderte Seite ist ein vollständiges, eigenständiges HTML-Dokument. Es verwendet weder wp_head() noch wp_footer(). Alle Styles sind direkt in der Seite eingebunden (inline).
• Die auf dem Datenblatt angezeigten Verkäuferinformationen werden aus den User-Meta-Feldern des Beitragsautors ausgelesen (as24ci_seller_display_name, as24ci_seller_email, as24ci_seller_phone, as24ci_seller_address). Wenn diese Felder leer sind, werden der Anzeigename und die E-Mail des WordPress-Benutzers als Fallback verwendet.
• Der Aufruf der Datenblatt-URL mit einer ungültigen Beitrags-ID gibt einen HTTP-400-Fehler zurück. Der Aufruf mit einer gültigen ID für ein nicht veröffentlichtes Fahrzeug gibt einen HTTP-404-Fehler zurück.
• Page-Caching-Plugins können die Datenblatt-URL zwischenspeichern. Um dies zu verhindern, konfigurieren Sie Ihr Caching-Plugin so, dass URLs, die den Abfrageparameter as24ci_pdf enthalten, ausgeschlossen werden.

Fehlerbehebung

Die Schaltfläche "PDF herunterladen" erscheint nicht auf den Fahrzeugseiten.

• Vergewissern Sie sich, dass die PDF-Datenblatt-Funktion in den Plugin-Einstellungen aktiviert ist.
• Überprüfen Sie den Layout Manager, um sicherzustellen, dass das PDF-Download-Element für die Zone der einzelnen Fahrzeugseite aktiv ist.

Die Datenblatt-URL gibt einen 404-Fehler zurück.

• Überprüfen Sie, ob das Fahrzeug veröffentlicht ist. Entwürfe, private Beiträge und gelöschte Fahrzeuge geben einen 404-Fehler zurück.
• Überprüfen Sie, ob der Beitragstyp mit dem benutzerdefinierten Beitragstyp (Custom Post Type) des Plugins übereinstimmt (as24ci_car).

Die Datenblatt-URL gibt einen 400-Fehler zurück.

• Die Beitrags-ID in der URL ist ungültig oder Null. Überprüfen Sie, ob die URL korrekt generiert wird.

Das Datenblatt wird ohne Logo oder Branding gerendert.

• Bestätigen Sie im PDF Manager, dass ein Logo-Bild ausgewählt und gespeichert wurde.
• Wenn das Logo nicht angezeigt wird, überprüfen Sie, ob die in den PDF Manager-Einstellungen gespeicherte Attachment-ID auf ein gültiges, hochgeladenes Bild verweist.

Der QR-Code erscheint nicht auf dem Datenblatt.

• Vergewissern Sie sich, dass die QR-Code-Option im PDF Manager aktiviert ist.
• Der QR-Dienst (api.qrserver.com) wird beim Laden der Seite aufgerufen. Wenn Ihr Hosting ausgehende HTTP-Anfragen blockiert oder der Dienst vorübergehend nicht verfügbar ist, wird das Bild möglicherweise nicht geladen.
• Sie können die QR-Bild-URL über den Filter as24ci_pdf_qr_image_url ersetzen. Geben Sie einen leeren String aus dem Filter zurück, um den QR-Code vollständig zu unterdrücken.

Das Datenblatt wird von einem Caching-Plugin fälschlicherweise zwischengespeichert.

• Fügen Sie den Abfrageparameter as24ci_pdf zur Liste der ausgeschlossenen URLs oder Parameter Ihres Caching-Plugins hinzu.

Verwandte Dokumente

• Fahrzeug-Detailseiten
• Standort und Öffnungszeiten