PDF-Datenblatt

Dieses Dokument behandelt 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 Funktion Datei → Drucken → Als PDF speichern des Browsers nutzen, um das Dokument zu speichern.

Anforderungen oder Voraussetzungen

• Die PDF-Datenblatt-Funktion muss in den Plugin-Einstellungen aktiviert sein (FEATURE_PDF_DATASHEET). Sie ist standardmäßig 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 „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-Adminbereich die Plugin-Einstellungen.
2. Suchen Sie den Schalter für die Funktion PDF-Datenblatt und bestätigen Sie, 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“ wird auf allen veröffentlichten Fahrzeug-Detailseiten angezeigt.

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 gestaltet.
4. Verwenden Sie die Druckfunktion des Browsers (Strg+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 verfügbar:

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.

Konfigurationsreferenz

Funktions-Schalter

PDF Manager Einstellungen

Der PDF Manager steuert das Branding, das Layout und den Inhalt des gerenderten Datenblatts. Die Einstellungen werden als eine einzige 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äßig aktiviert. Das Deaktivieren eines Feldes entfernt es aus dem gerenderten Datenblatt für alle Fahrzeuge.

Rechtlicher Hinweis:

Es kann ein benutzerdefinierter rechtlicher Hinweistext hinzugefügt werden. Dieser Text erscheint in der Fußzeile des Datenblatts. Verwenden Sie dieses Feld für erforderliche rechtliche Hinweise, Preis-Fußnoten 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 (inlined).
• 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.

• Bestätigen Sie, 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 404 zurück.
• Überprüfen Sie, ob der Beitragstyp mit dem benutzerdefinierten Beitragstyp (CPT) 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 Logobild ausgewählt und gespeichert wurde.
• Wenn das Logo nicht angezeigt wird, überprüfen Sie, ob die in den PDF Manager-Einstellungen gespeicherte Medien-ID auf ein gültiges hochgeladenes Bild verweist.

Der QR-Code wird nicht auf dem Datenblatt angezeigt.

• Bestätigen Sie, 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 mithilfe des Filters as24ci_pdf_qr_image_url ersetzen. Geben Sie eine leere Zeichenfolge 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