Problemen met de PDF-datasheet

Dit document behandelt problemen met de print-geoptimaliseerde voertuigdatasheet-functie van de ADP Car Market Hub plugin, inclusief toegang, weergave, ontbrekende gegevens, afbeeldingen, instellingen en het genereren van QR-codes.

Wanneer u dit document moet gebruiken

Lees dit document wanneer:

• De datasheet-URL (?as24ci_pdf={post_id}) een 404-fout of een lege pagina retourneert.
• De datasheet-pagina opent, maar sommige velden, afbeeldingen of secties ontbreken.
• De knop of link "Datasheet afdrukken" niet verschijnt op de voertuigdetailpagina's.
• De instellingen van de PDF Manager niet worden toegepast op de gegenereerde datasheet.
• De QR-code ontbreekt of een foutafbeelding toont.

Overzicht

De PDF-datasheet-functie genereert een zelfstandige, voor afdrukken geoptimaliseerde HTML-pagina voor elk voertuig. De pagina is geen echt PDF-bestand — het is een HTML-document met print-CSS dat de bezoeker (of browserautomatisering) naar PDF converteert met de functie Afdrukken → Opslaan als PDF van de browser. Er is geen PHP PDF-bibliotheek vereist.

De datasheet is toegankelijk via een query-variabele die aan de home-URL van de site wordt toegevoegd:

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

Waarbij {post_id} de numerieke WordPress post-ID van het voertuig is. De pagina wordt alleen gegenereerd voor gepubliceerde as24ci_car posts. Concepten, prullenbak-posts of posts van een ander type retourneren een 404-fout.

De functie is standaard uitgeschakeld. Deze moet expliciet worden ingeschakeld in de plugin-instellingen voordat deze op verzoeken reageert.

Systeemvereisten

• De plugin moet actief zijn.
• De PDF-datasheet-functie moet zijn ingeschakeld in de plugin-instellingen (de hoofdschakelaar bevindt zich op het tabblad Design & Styles; configuratie op templateniveau bevindt zich op het tabblad PDF Manager).
• WordPress permalinks moeten functioneel zijn (standaard of aangepast).
• De voertuigpost moet de status publish hebben.
• De bezoekende browser moet CSS-print-stylesheets ondersteunen om bij het afdrukken een goed geformatteerde PDF te produceren.

Diagnostische stappen

Stap 1: Bevestig dat de functie is ingeschakeld

De PDF-datasheet-functie is standaard uitgeschakeld bij nieuwe installaties.

1. Ga naar het plugin-beheer en open de instellingen voor Features of Design & Styles.
2. Zoek naar de schakelaar PDF-datasheet.
3. Schakel deze in en sla de wijzigingen op.
4. Wis na het inschakelen de WordPress permalink-cache door naar Instellingen → Permalinks te gaan en op Wijzigingen opslaan te klikken.

Stap 2: Controleer de post-ID en status van het voertuig

Het URL-formaat is ?as24ci_pdf={post_id}. Als u de verkeerde post-ID gebruikt, of als het voertuig niet is gepubliceerd, ontvangt u een foutmelding:

• Een ongeldige (niet-numerieke of negatieve) post-ID retourneert HTTP 400 ("Invalid vehicle ID").
• Een post die niet bestaat, niet van het type as24ci_car is, of niet is gepubliceerd, retourneert HTTP 404 ("Vehicle not found or not published").

Om de juiste post-ID te vinden:

1. Ga naar het bewerkingsscherm van het voertuig in het WordPress beheer.
2. De post-ID verschijnt in de URL: ?post=12345.
3. Test de datasheet-URL: https://your-site.com/?as24ci_pdf=12345.

Stap 3: Controleer of de query-variabele is geregistreerd

De datasheet gebruikt de WordPress query-variabele as24ci_pdf. Als een andere plugin of een ander thema conflicteert met aangepaste query-variabelen of deze ongedaan maakt, kan het zijn dat de datasheet niet wordt geactiveerd.

1. Wis na het inschakelen van de functie de permalinks (Instellingen → Permalinks → Wijzigingen opslaan).
2. Als de URL nog steeds niet werkt, controleer dan of een beveiligings- of caching-plugin onbekende query-parameters uit verzoeken verwijdert.

Stap 4: Diagnose van ontbrekende velden of secties

De PDF Manager-instellingen (opgeslagen in de optie as24ci_pdf_manager_settings) bepalen welke velden en secties op de datasheet verschijnen. Als er velden ontbreken:

1. Ga naar het tabblad PDF Manager in het beheer.
2. Controleer de selectievakjes bij Inhoudsvelden. Elk veld dat niet is aangevinkt, verschijnt niet op de datasheet.
3. Controleer de sectie Lay-out op schakelaars zoals Galerij tonen, Prijsbox tonen en Contactgegevens tonen.
4. Sla de instellingen op en laad de datasheet opnieuw.

Als een veld is ingeschakeld in de PDF Manager maar nog steeds niet verschijnt, heeft het voertuig mogelijk geen gegevens voor dat veld. Als het voertuig bijvoorbeeld is geïmporteerd zonder prijs, wordt het prijsveld niet weergegeven, zelfs niet als het is ingeschakeld.

Stap 5: Diagnose van ontbrekende afbeeldingen

De datasheet gebruikt afbeeldingen uit twee meta-velden:

• _as24ci_image_ids — afbeeldingen geïmporteerd uit de API.
• _as24ci_manual_image_ids — handmatig geüploade afbeeldingen.

De datasheet toont maximaal 5 afbeeldingen, ongeacht de instelling Aantal afbeeldingen in de PDF Manager. Als er afbeeldingen ontbreken:

1. Bevestig dat de afbeeldingen zijn geïmporteerd. Ga naar het bewerkingsscherm van het voertuig in WordPress en controleer de Media-metabox of de galerijsectie.
2. Controleer of de schakelaar Galerij tonen is ingeschakeld in de PDF Manager-instellingen.
3. Als het voertuig een uitgelichte afbeelding heeft ingesteld maar geen geïmporteerde afbeeldingen, gebruikt de datasheet de uitgelichte afbeelding als terugvaloptie.
4. Controleer of de WordPress Mediabibliotheek-items voor de afbeeldingen niet zijn verwijderd of beschadigd.

Stap 6: Controleer de QR-code

De QR-code is optioneel en is standaard uitgeschakeld. Indien ingeschakeld, gebruikt de datasheet de openbare QR-code API op https://api.qrserver.com/v1/create-qr-code/ om een afbeelding te genereren. Dit is een externe service waarvoor geen authenticatie vereist is.

Als de QR-code niet verschijnt:

1. Controleer of de schakelaar QR-code tonen is ingeschakeld in de PDF Manager-instellingen.
2. Controleer of de gepubliceerde URL van het voertuig geen autoscout24. in de host bevat — de plugin onderdrukt de QR-code bewust wanneer de voertuig-URL verwijst naar het AutoScout24 domein.
3. Controleer of de server uitgaande internettoegang heeft tot api.qrserver.com op poort 443. In beperkte hostingomgevingen kan dit verzoek worden geblokkeerd.
4. De URL van de QR-code-afbeelding kan worden vervangen met behulp van het filter as24ci_pdf_qr_image_url. Als een aanpassing de afbeelding onderdrukt (door een lege string te retourneren), controleer dan uw actieve thema en plugins op dit filter.

Stap 7: Controleer de verkopersinformatie

De contactgegevens van de verkoper op de datasheet worden gelezen uit de user meta-velden van de auteur van de post:

Als er contactgegevens ontbreken:

1. Ga naar Gebruikers in het WordPress beheer en open het profiel van de auteur van de post.
2. Controleer of de profielvelden van de verkoper zijn ingevuld.
3. Als de sectie met profielvelden van de verkoper niet zichtbaar is, controleer dan of de klasse Seller_Profile_Fields actief is (aangestuurd door de plugin-bootstrap).

Configuratiereferentie — PDF Manager-instellingen

De PDF Manager-instellingen worden opgeslagen in de optie as24ci_pdf_manager_settings als een geserialiseerde array. Ze worden beheerd op het tabblad PDF Manager in het beheer.

Branding

Lay-out

QR-code

Inhoudsvelden

De volgende velden kunnen afzonderlijk worden getoond of verborgen. Ze zijn allemaal standaard ingeschakeld.

Juridische opmerking

Een vrij tekstveld dat onderaan de datasheet wordt toegevoegd. Accepteert platte tekst. Handig voor juridische disclaimers of algemene verkoopvoorwaarden.

Operationele opmerkingen

• De datasheet-pagina wordt gegenereerd als een zelfstandig HTML-document. Deze maakt geen gebruik van de WordPress thema-header of -footer. Thema-CSS, zijbalken en navigatie-elementen zijn niet van toepassing.
• Voertuiggegevens worden gelezen uit de aangepaste {prefix}as24_vehicles databasetabel met een terugval naar WordPress post-meta. Als de aangepaste tabel niet bestaat (bijvoorbeeld bij een beschadigde of gemigreerde installatie), kunnen sommige velden terugvallen op post-meta-waarden.
• Het beschrijvingsveld gebruikt de samenvatting van de post als deze is ingesteld; anders worden de eerste 150 woorden van de post-inhoud gebruikt.
• De datasheet-URL gebruikt een query-variabele (geen herschrijfregel), dus deze werkt op zowel aangepaste permalinks als standaard (?p=) permalink-structuren.
• Er is geen authenticatie vereist om de datasheet te bekijken. Elke bezoeker met de URL heeft toegang voor elk gepubliceerd voertuig. Als toegangsbeperking vereist is, moet dit op hosting- of CDN-niveau worden geïmplementeerd.

Probleemoplossing

Gerelateerde documenten

• Fouten bij het importeren van afbeeldingen
• Problemen met weergave aan de frontend
• Toegangsrechtenfouten