Problemen met de weergave aan de frontend

Dit document behandelt problemen met de manier waarop voertuigadvertenties worden weergegeven op de openbare pagina's van een WordPress-site die de ADP Car Market Hub-plugin gebruikt. Het behandelt archiefpagina's, individuele voertuigdetailpagina's, thema-conflicten, permalink-problemen en problemen met het laden van assets.

Wanneer u dit document moet gebruiken

Lees dit document wanneer:

• De voertuigarchiefpagina (/cars/ of de geconfigureerde slug) geen advertenties toont, een 404-fout geeft of niet wordt gevonden.
• Individuele voertuigdetailpagina's niet worden weergegeven of lay-out en styling missen.
• Filters op de archiefpagina niet werken of niet de verwachte resultaten opleveren.
• CSS of JavaScript van de plugin niet wordt geladen op frontend-pagina's.
• Het actieve thema de templates van de plugin overschrijft of hiermee conflicteert.
• Paginering op het archief of een pagina met een geïntegreerde shortcode niet werkt.

Overzicht

De plugin registreert een custom post type (as24ci_car) met de archief-slug cars en biedt twee templatebestanden:

• templates/archive-as24ci_car.php — gebruikt voor de voertuigarchiefpagina.
• templates/single-as24ci_car.php — gebruikt voor individuele voertuigdetailpagina's.

WordPress herkent templates met behulp van de standaard template-hiërarchie. De plugin haakt in op de filters single_template and archive_template. Er wordt eerst gecontroleerd of het actieve thema een aangepaste override biedt (single-as24ci_car.php of archive-as24ci_car.php in de themamap), en gebruikt de eigen template van de plugin als fallback. Dit betekent dat een thema de lay-out volledig kan beheren als het een passend templatebestand bevat.

CSS en JavaScript worden automatisch in de wachtrij geplaatst door het huidige paginatype te detecteren. Op pagina's waar een shortcode wordt gebruikt om het archief in te sluiten, worden assets gedetecteerd via has_shortcode() op basis van de post-inhoud van de pagina.

Systeemvereisten

• Er bestaat ten minste één voertuigpost en deze is gepubliceerd.
• Permalinks zijn ingesteld op iets anders dan "Eenvoudig" (om de archief-routing correct te laten werken). Ga naar Instellingen → Permalinks en kies een andere optie dan de standaardinstelling "Eenvoudig", en klik vervolgens op Wijzigingen opslaan.
• De plugin is actief en er zijn geen fatale PHP-fouten aanwezig (controleer Gereedschap → Sitegezondheid of het PHP-foutenlogboek).

Diagnostische stappen

Stap 1: Permalinks flushen

De meeste 404-fouten op het archief worden veroorzaakt door verouderde permalink-regels. Dit is het eerste wat u moet proberen wanneer het voertuigarchief of individuele pagina's een 404-fout retourneren.

1. Ga naar Instellingen → Permalinks in de WordPress-beheeromgeving.
2. Klik op Wijzigingen opslaan zonder instellingen te wijzigen. Hiermee worden de herschrijfregels opnieuw opgebouwd.
3. Bezoek de URL van het voertuigarchief (meestal /cars/) en controleer of deze laadt.

Stap 2: Bevestig de URL van het voertuigarchief

De plugin registreert de CPT met de archief-slug cars. De archief-URL is doorgaans:

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

Als WordPress in een submap is geïnstalleerd, of als de permalink-structuur een voorvoegsel gebruikt, zal de archief-URL dat weerspiegelen. Gebruik get_post_type_archive_link('as24ci_car') (via WP-CLI of een testfragment) om de exacte URL te bevestigen.

Stap 3: Controleer of het CPT-archief is ingeschakeld

Het custom post type is geregistreerd met has_archive = true. Als WordPress niet naar het archief routeert, controleer dan het volgende:

1. Permalinks zijn niet ingesteld op "Eenvoudig". Eenvoudige permalinks schakelen de routing van het CPT-archief uit.
2. Geen enkele caching-plugin serveert een verouderde 404-respons voor de archief-URL. Leeg de cache na het flushen van de permalinks.
3. Geen enkele .htaccess-regel of serverconfiguratie blokkeert de archief-URL.

Stap 4: Controleer op thema-conflicten

Als het archief of de individuele template onjuist wordt weergegeven, kan een thema-conflict de oorzaak zijn:

1. Schakel tijdelijk over naar een standaard WordPress-thema (zoals Twenty Twenty-Four) en bezoek het voertuigarchief en een individuele voertuigpagina.
2. Als de pagina's correct worden weergegeven met het standaardthema, veroorzaakt uw actieve thema een conflict.
3. Veelvoorkomende oorzaken: het actieve thema biedt een eigen archive-as24ci_car.php- of single-as24ci_car.php-template die verouderd of incompatibel is; het thema genereert een onjuiste HTML-structuur rond de inhoud; de CSS van het thema conflicteert met de stijlen van de plugin.

Stap 5: Controleer of CSS en JavaScript worden geladen

Als het voertuigarchief of de individuele pagina niet-gestylede inhoud of niet-werkende interactieve elementen (filter-dropdowns, galerij, lightbox) toont:

1. Open de pagina in een browser en bekijk de paginabron of gebruik de ontwikkelaarstools van de browser (tabblad Netwerk).
2. Controleer of de stylesheets van de plugin aanwezig zijn: - Op archiefpagina's: as24ci-archive.css - Op individuele voertuigpagina's: as24ci-single.css
3. Als deze ontbreken: - Controleer of de pagina correct wordt herkend als het CPT-archief of een individuele CPT-post. - Als u een shortcode gebruikt om het archief op een gewone pagina in te sluiten, controleer dan of de shortcode [as24ci_archive] in de post-inhoud van de pagina staat (niet in een widget, template-onderdeel of aangepast veld dat buiten the_content om wordt verwerkt). Assets worden gedetecteerd door de post-inhoud te lezen met has_shortcode(). - Als een prestatie- of minificatie-plugin scripts samenvoegt of uitstelt, kan dit de JavaScript van de plugin verstoren. Test met die plugin uitgeschakeld.
4. Controleer of geen enkele andere plugin of thema wp_dequeue_style of wp_dequeue_script aanroept voor plugin-assets.

Stap 6: Controleer de werking van de archieffilters

Het voertuigarchief ondersteunt filterparameters die via de URL-query-string worden doorgegeven (bijv. ?make=volkswagen&fuel_type=diesel). Als filters niet werken:

1. Controleer of de filterwidgets worden weergegeven (ze worden gegenereerd door de archieftemplate).
2. Controleer of het specifieke filter is ingeschakeld in de Filter- of Layout Manager-instellingen van de plugin. Uitgeschakelde filters verschijnen niet en hun GET-parameters worden genegeerd.
3. Controleer of er geen caching-laag is die een gecachte versie van de archiefpagina serveert, ongeacht de query-parameters. De meeste caching-plugins moeten zo worden geconfigureerd dat pagina's met query-strings niet worden gecacht.

Stap 7: Onderzoek pagineringsproblemen

Als de paginering op de archiefpagina niet werkt (klikken op pagina 2 geeft dezelfde resultaten):

1. Controleer of de permalink-structuur niet op "Eenvoudig" staat.
2. Op pagina's met een geïntegreerde shortcode gebruikt de paginering de query-parameters ?paged=2 (of ?page=2). Controleer of er geen omleiding is die deze parameters verwijdert.
3. Op de echte CPT-archief-URL verwerkt WordPress de paginering standaard. Flush de permalinks als dit niet werkt.

Stap 8: Controleer op PHP-fouten

Een fatale PHP-fout of waarschuwing kan de pagina-uitvoer geruisloos verstoren of een gedeeltelijke weergave veroorzaken:

1. Schakel de debug-modus van WordPress tijdelijk in door dit toe te voegen aan wp-config.php: ``php define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false ); ``
2. Bezoek de probleem-pagina en controleer wp-content/debug.log op fouten.
3. Schakel de debug-modus na het onderzoek weer uit.

Configuratiereferentie

Operationele opmerkingen

• De templatebestanden van de plugin bevinden zich in de map templates/ van de plugin. Bewerk deze bestanden niet rechtstreeks, aangezien updates uw wijzigingen zullen overschrijven. Om templates aan te passen, kopieert u ze naar uw actieve themamap en bewerkt u de kopie daar.
• De archieftemplate haalt filterwaarden op met behulp van WordPress-taxonomieën (as24ci_brand, as24ci_model, as24ci_fuel_type, enz.) en een aangepaste databasetabel (wp_as24_vehicles) voor numerieke velden zoals prijs en kilometerstand.
• Als de archiefpagina is ingesloten met de shortcode [as24ci_archive] op een standaard WordPress-pagina, mag de pagina geen eigen query-loop of inhoud hebben die interfereert met de globale variabele $wp_query. De shortcode vervangt tijdelijk $wp_query tijdens het renderen en herstelt deze daarna.
• Dynamische CSS (ontwerpinstellingen zoals kleuren) wordt inline in de <head>-tag gegenereerd via een wp_head-actie met prioriteit 99.

Probleemoplossing

Gerelateerde documenten

• Overzicht probleemoplossing
• Problemen met shortcodes
• Fouten bij het importeren van afbeeldingen
• Toegangsrechtenfouten