Probleme bei der Frontend-Anzeige

Dieses Dokument behandelt Probleme mit der Darstellung von Fahrzeugdaten auf den öffentlich zugänglichen Seiten einer WordPress-Website, die das ADP Car Market Hub-Plugin verwendet. Es befasst sich mit Archivseiten, einzelnen Fahrzeugdetailseiten, Theme-Konflikten, Permalink-Problemen und Problemen beim Laden von Assets.

Wann Sie dieses Dokument lesen sollten

Lesen Sie dieses Dokument, wenn:

• Die Fahrzeug-Archivseite (/cars/ oder der konfigurierte Slug) keine Fahrzeuge anzeigt, einen 404-Fehler ausgibt oder nicht gefunden wird.
• Einzelne Fahrzeugdetailseiten nicht angezeigt werden oder Layout und Styling fehlen.
• Filter auf der Archivseite nicht funktionieren oder nicht die erwarteten Ergebnisse liefern.
• Plugin-CSS oder -JavaScript auf den Frontend-Seiten nicht geladen wird.
• Das aktive Theme die Plugin-Templates überschreibt oder mit ihnen kollidiert.
• Die Seitennummerierung (Pagination) auf dem Archiv oder einer per Shortcode eingebetteten Übersichtsseite nicht funktioniert.

Übersicht

Das Plugin registriert einen Custom Post Type (as24ci_car) mit dem Archiv-Slug cars und stellt zwei Template-Dateien bereit:

• templates/archive-as24ci_car.php — wird für die Fahrzeug-Archivseite verwendet.
• templates/single-as24ci_car.php — wird für die einzelnen Fahrzeugdetailseiten verwendet.

WordPress löst Templates mithilfe der Standard-Template-Hierarchie auf. Das Plugin klinkt sich in die Filter single_template und archive_template ein. Es prüft zuerst, ob das aktive Theme ein eigenes Override bereitstellt (single-as24ci_car.php oder archive-as24ci_car.php im Theme-Verzeichnis), und verwendet das plugin-eigene Template als Fallback. Das bedeutet, dass ein Theme das Layout vollständig steuern kann, wenn es eine passende Template-Datei bereitstellt.

CSS und JavaScript werden automatisch geladen, indem der aktuelle Seitentyp erkannt wird. Auf Seiten, auf denen ein Shortcode zum Einbetten des Archivs verwendet wird, werden Assets über has_shortcode() im Beitragsinhalt der Seite erkannt.

Voraussetzungen

• Mindestens ein Fahrzeug-Beitrag existiert und ist veröffentlicht.
• Die Permalinks sind auf eine andere Option als "Einfach" eingestellt (damit das Routing des Archivs korrekt funktioniert). Gehen Sie zu Einstellungen → Permalinks und wählen Sie eine andere Option als die Standardeinstellung "Einfach", und klicken Sie dann auf Änderungen speichern.
• Das Plugin ist aktiv und es liegen keine fatalen PHP-Fehler vor (überprüfen Sie dies unter Werkzeuge → Website-Zustand oder im PHP-Fehlerprotokoll).

Diagnoseschritte

Schritt 1: Permalinks neu speichern

Die meisten 404-Fehler auf dem Archiv werden durch veraltete Permalink-Regeln verursacht. Dies ist das Erste, was Sie versuchen sollten, wenn das Fahrzeugarchiv oder die Detailseiten einen 404-Fehler zurückgeben.

1. Gehen Sie im WordPress-Adminbereich zu Einstellungen → Permalinks.
2. Klicken Sie auf Änderungen speichern, ohne Einstellungen zu ändern. Dadurch werden die Rewrite-Regeln neu generiert.
3. Rufen Sie die URL des Fahrzeugarchivs auf (normalerweise /cars/) und prüfen Sie, ob sie geladen wird.

Schritt 2: URL des Fahrzeugarchivs überprüfen

Das Plugin registriert den CPT mit dem Archiv-Slug cars. Die Archiv-URL lautet normalerweise:

https://your-site.example.com/cars/

Wenn WordPress in einem Unterverzeichnis installiert ist oder die Permalink-Struktur ein Präfix verwendet, spiegelt die Archiv-URL dies wider. Verwenden Sie get_post_type_archive_link('as24ci_car') (über WP-CLI oder ein Test-Snippet), um die genaue URL zu ermitteln.

Schritt 3: Prüfen, ob das CPT-Archiv aktiviert ist

Der Custom Post Type wird mit has_archive = true registriert. Wenn WordPress nicht zum Archiv weiterleitet, prüfen Sie Folgendes:

1. Die Permalinks dürfen nicht auf "Einfach" eingestellt sein. Einfache Permalinks deaktivieren das Routing für CPT-Archive.
2. Kein Caching-Plugin liefert eine veraltete 404-Antwort für die Archiv-URL aus. Leeren Sie den Cache nach dem Neuspeichern der Permalinks.
3. Keine .htaccess-Regel oder Serverkonfiguration blockiert die Archiv-URL.

Schritt 4: Auf Theme-Konflikte prüfen

Wenn das Archiv- oder Detail-Template fehlerhaft dargestellt wird, kann ein Theme-Konflikt die Ursache sein:

1. Wechseln Sie vorübergehend zu einem Standard-WordPress-Theme (wie Twenty Twenty-Four) und rufen Sie das Fahrzeugarchiv sowie eine Fahrzeugdetailseite auf.
2. Wenn die Seiten mit dem Standard-Theme korrekt angezeigt werden, verursacht Ihr aktives Theme einen Konflikt.
3. Häufige Ursachen: Das aktive Theme stellt ein eigenes archive-as24ci_car.php- oder single-as24ci_car.php-Template bereit, das veraltet oder inkompatibel ist; das Theme gibt eine fehlerhafte HTML-Struktur um den Inhalt herum aus; das CSS des Themes kollidiert mit den Styles des Plugins.

Schritt 5: Laden von CSS und JavaScript überprüfen

Wenn das Fahrzeugarchiv oder die Detailseite ungestylte Inhalte oder nicht funktionierende interaktive Elemente (Filter-Dropdowns, Galerie, Lightbox) anzeigt:

1. Öffnen Sie die Seite im Browser und betrachten Sie den Quelltext oder nutzen Sie die Entwicklertools des Browsers (Netzwerk-Tab).
2. Überprüfen Sie, ob die Stylesheets des Plugins vorhanden sind: - Auf Archivseiten: as24ci-archive.css - Auf Fahrzeugdetailseiten: as24ci-single.css
3. Falls diese fehlen: - Stellen Sie sicher, dass die Seite korrekt als CPT-Archiv oder als einzelner CPT-Beitrag erkannt wird. - Wenn Sie einen Shortcode verwenden, um das Archiv auf einer normalen Seite einzubetten, stellen Sie sicher, dass sich der Shortcode [as24ci_archive] im Beitragsinhalt der Seite befindet (nicht in einem Widget, Template-Teil oder einem benutzerdefinierten Feld, das ausserhalb von the_content verarbeitet wird). Assets werden erkannt, indem der Beitragsinhalt mit has_shortcode() ausgelesen wird. - Wenn ein Performance- oder Minifizierungs-Plugin Skripte zusammenfasst oder verzögert lädt, kann dies das JavaScript des Plugins beeinträchtigen. Testen Sie dies mit deaktiviertem Performance-Plugin.
4. Stellen Sie sicher, dass kein anderes Plugin oder Theme wp_dequeue_style oder wp_dequeue_script für die Plugin-Assets aufruft.

Schritt 6: Verhalten der Archiv-Filter überprüfen

Das Fahrzeugarchiv unterstützt Filterparameter, die über die URL-Query-Strings übergeben werden (z. B. ?make=volkswagen&fuel_type=diesel). Wenn Filter nicht funktionieren:

1. Stellen Sie sicher, dass die Filter-Widgets angezeigt werden (sie werden vom Archiv-Template gerendert).
2. Stellen Sie sicher, dass der spezifische Filter in den Einstellungen für Filter oder den Layout Manager des Plugins aktiviert ist. Deaktivierte Filter werden nicht angezeigt und ihre GET-Parameter werden ignoriert.
3. Stellen Sie sicher, dass keine Caching-Ebene eine zwischengespeicherte Version der Archivseite unabhängig von den Query-Parametern ausliefert. Die meisten Caching-Plugins müssen so konfiguriert werden, dass Seiten mit Query-Strings vom Caching ausgeschlossen werden.

Schritt 7: Probleme mit der Seitennummerierung untersuchen

Wenn die Seitennummerierung (Pagination) auf der Archivseite nicht funktioniert (das Klicken auf Seite 2 liefert dieselben Ergebnisse):

1. Stellen Sie sicher, dass die Permalink-Struktur nicht auf "Einfach" eingestellt ist.
2. Auf per Shortcode eingebetteten Archivseiten verwendet die Seitennummerierung die Query-Parameter ?paged=2 (oder ?page=2). Stellen Sie sicher, dass keine Weiterleitung diese Parameter entfernt.
3. Auf der echten CPT-Archiv-URL verwaltet WordPress die Seitennummerierung nativ. Speichern Sie die Permalinks neu, falls diese fehlerhaft ist.

Schritt 8: Auf PHP-Fehler prüfen

Ein fataler PHP-Fehler oder eine Warnung kann die Seitenausgabe unbemerkt abbrechen oder zu einer unvollständigen Darstellung führen:

1. Aktivieren Sie vorübergehend den Debug-Modus von WordPress, indem Sie Folgendes in die wp-config.php einfügen: ``php define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false ); ``
2. Rufen Sie die fehlerhafte Seite auf und prüfen Sie wp-content/debug.log auf Fehler.
3. Deaktivieren Sie den Debug-Modus nach der Untersuchung wieder.

Konfigurationsreferenz

Betriebliche Hinweise

• Die Template-Dateien des Plugins befinden sich im Verzeichnis templates/ des Plugins. Bearbeiten Sie diese Dateien nicht direkt, da Aktualisierungen Ihre Änderungen überschreiben. Um Templates anzupassen, kopieren Sie diese in Ihr aktives Theme-Verzeichnis und bearbeiten Sie die Kopie dort.
• Das Archiv-Template löst Filterwerte über WordPress-Taxonomien (as24ci_brand, as24ci_model, as24ci_fuel_type usw.) und eine benutzerdefinierte Datenbanktabelle (wp_as24_vehicles) für numerische Felder wie Preis und Kilometerstand auf.
• Wenn die Archivseite mithilfe des Shortcodes [as24ci_archive] auf einer Standard-WordPress-Seite eingebettet ist, darf die Seite keine eigene Query-Schleife oder Inhalte aufweisen, die mit der globalen Variable $wp_query kollidieren. Der Shortcode ersetzt $wp_query während des Renderings vorübergehend und stellt sie danach wieder her.
• Dynamisches CSS (Design-Einstellungen wie Farben) wird inline im <head>-Tag über eine wp_head-Aktion mit der Priorität 99 ausgegeben.

Fehlerbehebung

Verwandte Dokumente

• Fehlerbehebung — Übersicht
• Shortcode-Probleme
• Fehler beim Bildimport
• Berechtigungsfehler