Probleme mit dem PDF-Datenblatt

Dieses Dokument behandelt Probleme mit der druckoptimierten Fahrzeugdatenblatt-Funktion des ADP Car Market Hub-Plugins, einschliesslich Zugriff, Darstellung, 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) über die browserinterne Funktion "Drucken → Als PDF speichern" in ein PDF umwandelt. Es ist keine PHP-PDF-Bibliothek erforderlich.

Der Zugriff auf das Datenblatt erfolgt über eine Query-Variable, die an die Homepage-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ässig deaktiviert. Sie muss in den Plugin-Einstellungen explizit aktiviert werden, bevor sie auf Anfragen reagiert.

Anforderungen

• Das Plugin muss aktiv sein.
• Der Schalter für die PDF-Datenblatt-Funktion 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).
• WordPress-Permalinks müssen funktionieren (einfache oder sprechende Permalinks).
• 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, dass die Funktion aktiviert ist

Die PDF-Datenblatt-Funktion ist bei Neuinstallationen standardmässig 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: Fahrzeug-Post-ID und Status überprüfen

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 den HTTP-Fehler 400 ("Invalid vehicle ID") zurück.
• Ein Beitrag, der nicht existiert, nicht vom Typ as24ci_car ist oder nicht veröffentlicht ist, gibt den HTTP-Fehler 404 ("Vehicle not found or not published") zurück.

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, ob die Query-Variable registriert ist

Das Datenblatt verwendet die WordPress-Query-Variable as24ci_pdf. Wenn ein anderes Plugin oder Theme benutzerdefinierte Query-Variablen deregistriert oder damit kollidiert, 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 herausfiltert.

Schritt 4: Fehlende Felder oder Abschnitte diagnostizieren

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 angekreuzt ist, erscheint nicht auf dem Datenblatt.
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: Fehlende Bilder diagnostizieren

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 Anzahl Bilder im PDF Manager. Wenn Bilder fehlen:

1. Bestätigen Sie, dass die Bilder importiert wurden. Gehen Sie im WordPress-Adminbereich zur Bearbeitungsseite des Fahrzeugs und überprüfen Sie die Medien-Metabox oder den Bereich der Bildergalerie.
2. Bestätigen Sie, dass der Schalter Galerie anzeigen in den PDF Manager-Einstellungen 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: QR-Code überprüfen

Der QR-Code ist optional und standardmässig 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 PDF Manager-Einstellungen 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 Bild-URL des QR-Codes kann über den Filter as24ci_pdf_qr_image_url ersetzt 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 überprüfen

Die Kontaktinformationen 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, bestätigen Sie, dass die Klasse Seller_Profile_Fields aktiv ist (gesteuert durch den Plugin-Bootstrap).

Konfigurationsreferenz — PDF Manager-Einstellungen

Die PDF Manager-Einstellungen 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ässig aktiviert.

Rechtlicher Hinweis

Ein Freitextfeld, das ganz unten auf dem Datenblatt angefügt wird. Akzeptiert einfachen Text. Nützlich für rechtliche Hinweise oder Standard-Verkaufsbedingungen.

Betriebliche Hinweise

• 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 werden nicht angewendet.
• Fahrzeugdaten werden aus der benutzerdefinierten Datenbanktabelle {prefix}as24_vehicles gelesen, mit einem Fallback auf das WordPress-Post-Meta. Wenn die benutzerdefinierte Tabelle nicht existiert (beispielsweise bei einer fehlerhaften oder migrierten Installation), fallen einige Felder auf die 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