Documentatie · Frontend-handleiding

PDF-datasheet

Dit document behandelt de PDF-datasheet (voertuigexposé) functie van de ADP Car Market Hub WordPress Plugin: hoe bezoekers er toegang toe krijgen, wat deze bevat en hoe deze wordt geconfigureerd.

Wanneer u dit document moet gebruiken

Lees dit document als u de PDF-datasheet-functie voor het eerst inschakelt, de branding en inhoud ervan configureert, of problemen met de downloadlink of de gegenereerde uitvoer wilt oplossen.

Overzicht

De PDF-datasheet-functie biedt een voor afdrukken geoptimaliseerde voertuigoverzichtspagina die bezoekers in hun browser kunnen openen en kunnen opslaan of afdrukken als PDF met behulp van het ingebouwde afdrukvenster van de browser. Het is geen door de server gegenereerd PDF-bestand; in plaats daarvan is het een zelfstandige HTML-pagina die speciaal door de plugin is gerenderd om af te drukken.

Wanneer een bezoeker op de knop "Download PDF" op een voertuigdetailpagina klikt, navigeert de browser naar een speciale URL. De plugin onderschept het verzoek, rendert een volledige zelfstandige HTML-pagina (zonder de WordPress thema-header en -footer) en sluit af. De bezoeker kan vervolgens de functie Bestand → Afdrukken → Opslaan als PDF van de browser gebruiken om het document op te slaan.

Vereisten of randvoorwaarden

De PDF-datasheet-functie moet zijn ingeschakeld in de plugin-instellingen (FEATURE_PDF_DATASHEET). Deze is standaard ingeschakeld.
Het voertuig moet gepubliceerd zijn. Concepten en privéberichten retourneren een 404-fout vanaf het datasheet-eindpunt.
Pretty permalinks moeten zijn ingeschakeld in WordPress om de query-variabele die door de datasheet-URL wordt gebruikt correct te kunnen verwerken.

Stapsgewijze instructies

De PDF-datasheet-functie inschakelen

Open de plugin-instellingen in de WordPress admin.
Zoek de PDF-datasheet functieschakelaar en controleer of deze is ingeschakeld.
Navigeer naar de sectie PDF Manager om branding- en inhoudsvelden te configureren.
Sla de instellingen op.

De knop "Download PDF" verschijnt op alle gepubliceerde voertuigdetailpagina's.

De PDF-datasheet openen als bezoeker

Open een voertuigdetailpagina.
Klik op de knop Download PDF of exposé.
De browser navigeert naar de datasheet-pagina. Deze pagina heeft geen site-header of -footer — deze is specifiek gestyled voor afdrukken.
Gebruik de afdrukfunctie van de browser (Ctrl+P of Cmd+P, of Bestand → Afdrukken) en kies Opslaan als PDF als bestemming.
Pas indien nodig de afdrukinstellingen aan (papierformaat, marges) en sla het bestand op.

Directe toegang tot de datasheet-URL

De datasheet is beschikbaar op:

https://yoursite.com/?as24ci_pdf={post_id}

waarbij {post_id} de numerieke WordPress post-ID van het voertuig is. Deze URL is toegankelijk voor elke bezoeker zonder authenticatie, zolang het voertuig gepubliceerd is.

Configuratierreferentie

Functieschakelaar

Instelling	Optiesleutel	Standaard	Beschrijving
PDF-datasheet inschakelen	`as24ci_feature_pdf_datasheet`	Aan (1)	Toont of verbergt de knop "Download PDF" op voertuigdetailpagina's

PDF Manager-instellingen

De PDF Manager beheert de branding, lay-out en inhoud van de gerenderde datasheet. Instellingen worden opgeslagen als een enkele geserialiseerde array-optie (as24ci_pdf_manager_settings).

Branding:

Instelling	Standaard	Beschrijving
Logo	Geen	Upload een logo-afbeelding om in de header te verschijnen
Bedrijf tonen	Aan	Inclusief de bedrijfsnaam van de verkoper
Adres tonen	Aan	Inclusief het adres van de verkoper
Telefoon tonen	Aan	Inclusief het telefoonnummer van de verkoper
E-mail tonen	Aan	Inclusief het e-mailadres van de verkoper
Website tonen	Uit	Inclusief de website-URL van de verkoper
Primaire kleur	`#0073aa`	Hoofdkleur gebruikt voor koppen en accenten
Accentkleur	`#1a1a1a`	Secundaire kleur

Lay-out:

Instelling	Standaard	Beschrijving
Papierformaat	`A4`	Papierformaat voor afdruklay-out
Aantal afbeeldingen	`1`	Hoeveel voertuigafbeeldingen moeten worden opgenomen in de datasheet
Galerij tonen	Aan	Of de sectie met de afbeeldingengalerij moet worden getoond
Prijsbox tonen	Aan	Of de prijsbox moet worden getoond
Contact tonen	Aan	Of de sectie met contactgegevens van de verkoper moet worden getoond

QR-code:

Instelling	Standaard	Beschrijving
QR tonen	Uit	Voeg een QR-code toe die teruglinkt naar de voertuigdetailpagina op de website

De QR-code wordt gegenereerd met behulp van een openbare externe service (api.qrserver.com). Deze service wordt aangeroepen op het moment dat de datasheet-pagina wordt geladen. Als uw privacybeleid geen externe service-aanroepen voor bezoekers toestaat, moet deze optie uitgeschakeld blijven, of kan de QR-afbeeldings-URL worden vervangen via het as24ci_pdf_qr_image_url filter.

Inhoudsvelden:

De volgende velden kunnen afzonderlijk worden in- of uitgeschakeld in de PDF Manager:

Veldsleutel	Label
`title`	Voertuigtitel
`price`	Prijs
`mileage`	Kilometerstand
`first_reg`	Eerste registratie
`fuel_type`	Brandstoftype
`transmission`	Transmissie
`power`	Vermogen
`body_type`	Carrosserievorm
`exterior_color`	Exterieurkleur
`doors`	Deuren
`seats`	Stoelen
`emission_class`	Emissieklasse
`co2`	CO₂-waarden
`consumption`	Energieverbruik
`equipment`	Uitrustingslijst
`description`	Voertuigbeschrijving
`location`	Locatie
`contact`	Contactgegevens

Alle velden zijn standaard ingeschakeld. Het uitschakelen van een veld verwijdert dit uit de gerenderde datasheet voor alle voertuigen.

Juridische opmerking:

Er kan een aangepaste juridische tekst worden toegevoegd. Deze tekst verschijnt in de footer van de datasheet. Gebruik dit veld voor vereiste juridische disclaimers, prijsvoetnoten of gebruiksvoorwaarden.

Operationele opmerkingen

Het datasheet-eindpunt wordt geactiveerd door de query-variabele as24ci_pdf. De plugin registreert deze variabele bij WordPress via het query_vars filter en onderschept het verzoek in template_redirect.
De gerenderde pagina is een volledig zelfstandig HTML-document. Het maakt geen gebruik van wp_head() of wp_footer(). Alle stijlen zijn inline binnen de pagina opgenomen.
De verkopersinformatie die op de datasheet wordt getoond, wordt gelezen uit de user meta-velden van de auteur van de post (as24ci_seller_display_name, as24ci_seller_email, as24ci_seller_phone, as24ci_seller_address). Als deze velden leeg zijn, worden de weergavenaam en het e-mailadres van de WordPress gebruiker als fallback gebruikt.
Het bezoeken van de datasheet-URL met een ongeldige post-ID retourneert een HTTP 400-fout. Het bezoeken met een geldige ID voor een niet-gepubliceerd voertuig retourneert een HTTP 404-fout.
Pagina-caching-plugins kunnen de datasheet-URL cachen. Om dit te voorkomen, configureert u uw caching-plugin om URL's die de query-parameter as24ci_pdf bevatten uit te sluiten.

Problemen oplossen

De knop "Download PDF" verschijnt niet op voertuigpagina's.

Controleer of de PDF-datasheet-functie is ingeschakeld in de plugin-instellingen.
Controleer de Layout Manager om er zeker van te zijn dat het PDF-downloadelement actief is voor de zone van de enkele voertuigpagina.

De datasheet-URL retourneert een 404-fout.

Controleer of het voertuig is gepubliceerd. Concepten, privéberichten en verwijderde voertuigen retourneren een 404.
Controleer of het post-type overeenkomt met het custom post type van de plugin (as24ci_car).

De datasheet-URL retourneert een 400-fout.

De post-ID in de URL is ongeldig of nul. Controleer of de URL correct wordt gegenereerd.

De datasheet wordt gerenderd zonder logo of branding.

Controleer in de PDF Manager of er een logo-afbeelding is geselecteerd en opgeslagen.
Als het logo niet verschijnt, controleer dan of de attachment-ID die is opgeslagen in de PDF Manager-instellingen verwijst naar een geldige geüploade afbeelding.

De QR-code verschijnt niet op de datasheet.

Controleer of de QR-code-optie is ingeschakeld in de PDF Manager.
De QR-service (api.qrserver.com) wordt aangeroepen wanneer de pagina wordt geladen. Als uw hosting uitgaande HTTP-verzoeken blokkeert of de service tijdelijk niet beschikbaar is, laadt de afbeelding mogelijk niet.
U kunt de QR-afbeeldings-URL vervangen met behulp van het as24ci_pdf_qr_image_url filter. Retourneer een lege string uit het filter om de QR-code volledig te onderdrukken.

De datasheet wordt onjuist gecached door een caching-plugin.

Voeg de query-parameter as24ci_pdf toe aan de lijst met uitgesloten URL's of parameters van uw caching-plugin.