Probleme mit dem PDF-Datenblatt

Dieses Dokument behandelt Probleme mit der druckoptimierten Fahrzeugdatenblatt-Funktion des ADP Car Market Hub-Plugins, einschließlich Zugriff, Rendering, fehlender Daten, Bilder, Einstellungen und der Generierung von QR-Codes.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn:

• Die Datenblatt-URL (?as24ci_pdf={post_id}) einen 404-Fehler oder eine leere Seite zurückgibt.
• Die Datenblattseite geöffnet wird, aber einige Felder, Bilder oder Abschnitte fehlen.
• Die Schaltfläche oder der Link "Datenblatt drucken" auf den Fahrzeugdetailseiten nicht angezeigt wird.
• Die Einstellungen des PDF Managers nicht auf das gerenderte Datenblatt angewendet werden.
• Der QR-Code fehlt oder ein Fehlerbild anzeigt.

Übersicht

Die PDF-Datenblatt-Funktion rendert eine eigenständige, druckoptimierte HTML-Seite für jedes Fahrzeug. Die Seite ist keine echte PDF-Datei — es handelt sich um ein HTML-Dokument, das mit Print-CSS gestaltet ist und das der Besucher (oder eine Browser-Automatisierung) mithilfe der browserinternen Funktion "Drucken → Als PDF speichern" in ein PDF konvertiert. Es ist keine PHP-PDF-Bibliothek erforderlich.

Der Zugriff auf das Datenblatt erfolgt über eine Query-Variable, die an die Start-URL der Website angehängt wird:

https://your-site.com/?as24ci_pdf={post_id}

Wobei {post_id} die numerische WordPress-Post-ID des Fahrzeugs ist. Die Seite wird nur für veröffentlichte as24ci_car-Beiträge gerendert. Entwürfe, in den Papierkorb verschobene Beiträge oder Beiträge eines anderen Typs geben einen 404-Fehler zurück.

Die Funktion ist standardmäßig deaktiviert. Sie muss in den Plugin-Einstellungen explizit aktiviert werden, bevor sie auf Anfragen reagiert.

Systemvoraussetzungen

• Das Plugin muss aktiv sein.
• Die Option PDF-Datenblatt muss in den Plugin-Einstellungen aktiviert sein (der Hauptschalter befindet sich auf dem Tab Design & Styles; die Konfiguration auf Template-Ebene erfolgt auf dem Tab PDF Manager).
• Die WordPress-Permalinks müssen funktionieren (einfach oder sprechend).
• Der Fahrzeug-Beitrag muss den Status publish haben.
• Der aufrufende Browser muss CSS-Print-Stylesheets unterstützen, um beim Drucken ein gut formatiertes PDF zu erzeugen.

Diagnoseschritte

Schritt 1: Bestätigen Sie, dass die Funktion aktiviert ist

Die PDF-Datenblatt-Funktion ist bei Neuinstallationen standardmäßig deaktiviert.

1. Gehen Sie in die Plugin-Administration und öffnen Sie die Einstellungen für Features oder Design & Styles.
2. Suchen Sie nach dem Schalter für das PDF-Datenblatt.
3. Aktivieren Sie ihn und speichern Sie die Änderungen.
4. Leeren Sie nach dem Aktivieren den WordPress-Permalink-Cache, indem Sie auf Einstellungen → Permalinks gehen und auf Änderungen speichern klicken.

Schritt 2: Überprüfen Sie die Fahrzeug-Post-ID und den Status

Das URL-Format lautet ?as24ci_pdf={post_id}. Wenn Sie die falsche Post-ID verwenden oder das Fahrzeug nicht veröffentlicht ist, erhalten Sie eine Fehlermeldung:

• Eine ungültige (nicht-numerische oder negative) Post-ID gibt HTTP 400 zurück ("Ungültige Fahrzeug-ID").
• Ein Beitrag, der nicht existiert, nicht vom Typ as24ci_car ist oder nicht veröffentlicht wurde, gibt HTTP 404 zurück ("Fahrzeug nicht gefunden oder nicht veröffentlicht").

So finden Sie die richtige Post-ID:

1. Gehen Sie im WordPress-Adminbereich zur Bearbeitungsseite des Fahrzeugs.
2. Die Post-ID wird in der URL angezeigt: ?post=12345.
3. Testen Sie die Datenblatt-URL: https://your-site.com/?as24ci_pdf=12345.

Schritt 3: Überprüfen Sie, ob die Query-Variable registriert ist

Das Datenblatt verwendet die WordPress-Query-Variable as24ci_pdf. Wenn ein anderes Plugin oder Theme eigene Query-Variablen deregistriert oder Konflikte verursacht, wird das Datenblatt möglicherweise nicht aufgerufen.

1. Leeren Sie nach dem Aktivieren der Funktion die Permalinks (Einstellungen → Permalinks → Änderungen speichern).
2. Wenn die URL immer noch nicht funktioniert, prüfen Sie, ob ein Sicherheits- oder Caching-Plugin unbekannte Query-Parameter aus den Anfragen entfernt.

Schritt 4: Diagnose fehlender Felder oder Abschnitte

Die Einstellungen des PDF Managers (gespeichert in der Option as24ci_pdf_manager_settings) steuern, welche Felder und Abschnitte auf dem Datenblatt erscheinen. Wenn Felder fehlen:

1. Gehen Sie zum Admin-Tab PDF Manager.
2. Überprüfen Sie die Kontrollkästchen unter Inhaltsfelder. Jedes Feld, das nicht angehakt ist, wird auf dem Datenblatt nicht angezeigt.
3. Überprüfen Sie den Abschnitt Layout auf Schalter wie "Galerie anzeigen", "Preisfeld anzeigen" und "Kontaktinformationen anzeigen".
4. Speichern Sie die Einstellungen und laden Sie das Datenblatt neu.

Wenn ein Feld im PDF Manager aktiviert ist, aber dennoch nicht erscheint, hat das Fahrzeug möglicherweise keine Daten für dieses Feld. Wenn das Fahrzeug beispielsweise ohne Preis importiert wurde, wird das Preisfeld auch dann nicht gerendert, wenn es aktiviert ist.

Schritt 5: Diagnose fehlender Bilder

Das Datenblatt verwendet Bilder aus zwei Meta-Feldern:

• _as24ci_image_ids — über die API importierte Bilder.
• _as24ci_manual_image_ids — manuell hochgeladene Bilder.

Das Datenblatt zeigt maximal 5 Bilder an, unabhängig von der Einstellung Bildanzahl im PDF Manager. Wenn Bilder fehlen:

1. Bestätigen Sie, dass Bilder importiert wurden. Gehen Sie zur Bearbeitungsseite des Fahrzeugs in WordPress und überprüfen Sie die Medien-Metabox oder den Bereich der Bildergalerie.
2. Bestätigen Sie, dass der Schalter Galerie anzeigen in den Einstellungen des PDF Managers aktiviert ist.
3. Wenn für das Fahrzeug ein Beitragsbild (Featured Image) festgelegt ist, aber keine importierten Bilder vorhanden sind, verwendet das Datenblatt das Beitragsbild als Fallback.
4. Überprüfen Sie, ob die Einträge in der WordPress-Mediathek für die Bilder nicht gelöscht oder beschädigt sind.

Schritt 6: Überprüfen Sie den QR-Code

Der QR-Code ist optional und standardmäßig deaktiviert. Wenn er aktiviert ist, verwendet das Datenblatt die öffentliche QR-Code-API unter https://api.qrserver.com/v1/create-qr-code/, um ein Bild zu generieren. Dies ist ein externer Dienst, der keine Authentifizierung erfordert.

Wenn der QR-Code nicht angezeigt wird:

1. Bestätigen Sie, dass der Schalter QR-Code anzeigen in den Einstellungen des PDF Managers aktiviert ist.
2. Bestätigen Sie, dass die veröffentlichte URL des Fahrzeugs nicht autoscout24. im Host enthält — das Plugin unterdrückt den QR-Code absichtlich, wenn die Fahrzeug-URL auf die Domain AutoScout24 verweist.
3. Bestätigen Sie, dass der Server ausgehenden Internetzugriff auf api.qrserver.com über Port 443 hat. In restriktiven Hosting-Umgebungen kann diese Anfrage blockiert sein.
4. Die URL des QR-Code-Bildes kann mithilfe des Filters as24ci_pdf_qr_image_url überschrieben werden. Wenn eine Anpassung das Bild unterdrückt (indem sie einen leeren String zurückgibt), überprüfen Sie Ihr aktives Theme und Ihre Plugins auf diesen Filter.

Schritt 7: Verkäuferinformationen prüfen

Die Kontaktdaten des Verkäufers auf dem Datenblatt werden aus den User-Meta-Feldern des Beitragsautors ausgelesen:

Wenn Kontaktinformationen fehlen:

1. Gehen Sie im WordPress-Adminbereich auf Benutzer und öffnen Sie das Profil des Beitragsautors.
2. Überprüfen Sie, ob die Profilfelder des Verkäufers ausgefüllt sind.
3. Wenn der Bereich für die Profilfelder des Verkäufers nicht sichtbar ist, stellen Sie sicher, dass die Klasse Seller_Profile_Fields aktiv ist (gesteuert durch den Plugin-Bootstrap).

Konfigurationsreferenz — PDF Manager-Einstellungen

Die Einstellungen des PDF Managers werden in der Option as24ci_pdf_manager_settings als serialisiertes Array gespeichert. Sie werden im Admin-Tab PDF Manager verwaltet.

Branding

Layout

QR-Code

Inhaltsfelder

Die folgenden Felder können einzeln ein- oder ausgeblendet werden. Alle sind standardmäßig aktiviert.

Rechtlicher Hinweis

Ein Freitextfeld, das ganz unten auf dem Datenblatt angehängt wird. Akzeptiert reinen Text. Nützlich für rechtliche Hinweise oder Standard-Verkaufsbedingungen.

Betriebshinweise

• Die Datenblattseite wird als eigenständiges HTML-Dokument gerendert. Sie verwendet weder den Header noch den Footer des WordPress-Themes. Theme-CSS, Sidebars und Navigationselemente finden keine Anwendung.
• Fahrzeugdaten werden aus der benutzerdefinierten Datenbanktabelle {prefix}as24_vehicles gelesen, mit einem Fallback auf WordPress-Post-Meta. Wenn die benutzerdefinierte Tabelle nicht existiert (z. B. bei einer beschädigten oder migrierten Installation), fallen einige Felder auf Post-Meta-Werte zurück.
• Das Beschreibungsfeld verwendet den Beitragsauszug (Excerpt), falls einer definiert ist; andernfalls werden die ersten 150 Wörter des Beitragsinhalts verwendet.
• Die Datenblatt-URL verwendet eine Query-Variable (keine Rewrite-Rule), sodass sie sowohl mit sprechenden Permalinks als auch mit einfachen (?p=) Permalink-Strukturen funktioniert.
• Es ist keine Authentifizierung erforderlich, um das Datenblatt anzuzeigen. Jeder Besucher mit der URL kann für jedes veröffentlichte Fahrzeug darauf zugreifen. Wenn eine Zugriffsbeschränkung erforderlich ist, muss diese auf Hosting- oder CDN-Ebene implementiert werden.

Fehlerbehebung

Verwandte Dokumente

• Fehler beim Bildimport
• Probleme mit der Frontend-Anzeige
• Berechtigungsfehler