PDF datasheet

Questo documento copre la funzionalità PDF datasheet (scheda veicolo) del plugin ADP Car Market Hub WordPress: come i visitatori vi accedono, cosa contiene e come viene configurata.

Quando utilizzare questo documento

Leggi questo documento se stai abilitando la funzionalità PDF datasheet per la prima volta, se ne stai configurando il branding e i contenuti, o se stai risolvendo problemi con il link di download o l'output generato.

Panoramica

La funzionalità PDF datasheet fornisce una pagina di riepilogo del veicolo ottimizzata per la stampa che i visitatori possono aprire nel proprio browser e salvare o stampare come PDF utilizzando la finestra di dialogo di stampa integrata del browser. Non si tratta di un file PDF generato dal server; è invece una pagina HTML indipendente renderizzata dal plugin specificamente per la stampa.

Quando un visitatore fa clic sul pulsante "Scarica PDF" nella pagina di dettaglio di un veicolo, il browser naviga verso un URL speciale. Il plugin intercetta la richiesta, renderizza una pagina HTML indipendente completa (senza l'header e il footer del tema WordPress) ed esce. Il visitatore può quindi utilizzare la funzione del browser File → Stampa → Salva come PDF per salvare il documento.

Requisiti o prerequisiti

• La funzionalità PDF datasheet deve essere abilitata nelle impostazioni del plugin (FEATURE_PDF_DATASHEET). È abilitata per impostazione predefinita.
• Il veicolo deve essere pubblicato. Le bozze e gli articoli privati restituiscono un errore 404 dall'endpoint della scheda tecnica.
• I permalink personalizzati devono essere abilitati in WordPress affinché la variabile di query utilizzata dall'URL della scheda tecnica venga elaborata correttamente.

Istruzioni passo-passo

Abilitare la funzionalità PDF datasheet

1. Nell'amministrazione di WordPress, apri le impostazioni del plugin.
2. Individua l'interruttore della funzionalità PDF Datasheet e conferma che sia abilitato.
3. Naviga nella sezione PDF Manager per configurare il branding e i campi di contenuto.
4. Salva le impostazioni.

Il pulsante "Scarica PDF" apparirà su tutte le pagine di dettaglio dei veicoli pubblicati.

Accedere al PDF datasheet come visitatore

1. Apri la pagina di dettaglio di un veicolo.
2. Fai clic sul pulsante Scarica PDF o scheda veicolo.
3. Il browser naviga verso la pagina della scheda tecnica. Questa pagina non ha l'header o il footer del sito — è formattata specificamente per la stampa.
4. Utilizza la funzione di stampa del browser (Ctrl+P o Cmd+P, oppure File → Stampa) e scegli Salva come PDF come destinazione.
5. Regola le impostazioni di stampa se necessario (formato carta, margini) e salva il file.

Accedere direttamente all'URL della scheda tecnica

La scheda tecnica è disponibile all'indirizzo:

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

dove {post_id} è l'ID numerico dell'articolo WordPress del veicolo. Questo URL è accessibile a qualsiasi visitatore senza autenticazione, purché il veicolo sia pubblicato.

Riferimento di configurazione

Interruttore della funzionalità

Impostazioni del PDF Manager

Il PDF Manager controlla il branding, il layout e il contenuto della scheda tecnica renderizzata. Le impostazioni sono memorizzate come un'unica opzione di array serializzato (as24ci_pdf_manager_settings).

Branding:

Layout:

Codice QR:

Il codice QR viene generato utilizzando un servizio di terze parti pubblico (api.qrserver.com). Questo servizio viene chiamato nel momento in care viene caricata la pagina della scheda tecnica. Se la tua politica sulla privacy non consente chiamate a servizi esterni per i visitatori, questa opzione dovrebbe rimanere disabilitata, oppure l'URL dell'immagine QR può essere sostituito tramite il filtro as24ci_pdf_qr_image_url.

Campi di contenuto:

I seguenti campi possono essere abilitati o disabilitati singolarmente nel PDF Manager:

Tutti i campi sono abilitati per impostazione predefinita. La disabilitazione di un campo lo rimuove dalla scheda tecnica renderizzata per tutti i veicoli.

Note legali:

È possibile aggiungere un testo personalizzato per le note legali. Questo testo appare nel piè di pagina della scheda tecnica. Utilizza questo campo per le dichiarazioni di non responsabilità legali richieste, le note a piè di pagina sui prezzi o le condizioni d'uso.

Note operative

• L'endpoint della scheda tecnica è attivato dalla variabile di query as24ci_pdf. Il plugin registra questa variabile con WordPress tramite il filtro query_vars e intercetta la richiesta in template_redirect.
• La pagina renderizzata è un documento HTML indipendente completo. Non utilizza wp_head() o wp_footer(). Tutti gli stili sono incorporati in linea all'interno della pagina.
• Le informazioni sul venditore mostrate sulla scheda tecnica vengono lette dai campi meta utente dell'autore dell'articolo (as24ci_seller_display_name, as24ci_seller_email, as24ci_seller_phone, as24ci_seller_address). Se questi campi sono vuoti, il nome visualizzato e l'email dell'utente WordPress vengono utilizzati come fallback.
• Visitando l'URL della scheda tecnica con un ID articolo non valido si restituisce un errore HTTP 400. Visitando con un ID valido per un veicolo non pubblicato si restituisce un errore HTTP 404.
• I plugin di caching delle pagine potrebbero memorizzare nella cache l'URL della scheda tecnica. Per evitare ciò, configura il tuo plugin di caching per escludere gli URL contenenti il parametro di query as24ci_pdf.

Risoluzione dei problemi

Il pulsante "Scarica PDF" non appare sulle pagine dei veicoli.

• Conferma che la funzionalità PDF datasheet sia abilitata nelle impostazioni del plugin.
• Controlla il Layout Manager per assicurarti che l'elemento di download del PDF sia attivo per la zona della pagina del singolo veicolo.

L'URL della scheda tecnica restituisce un errore 404.

• Verifica che il veicolo sia pubblicato. Le bozze, gli articoli privati e i veicoli eliminati restituiscono 404.
• Verifica che il tipo di articolo corrisponda al custom post type del plugin (as24ci_car).

L'URL della scheda tecnica restituisce un errore 400.

• L'ID dell'articolo nell'URL non è valido o è pari a zero. Verifica che l'URL venga generato correttamente.

La scheda tecnica viene renderizzata senza logo o branding.

• Nel PDF Manager, conferma che un'immagine del logo sia stata selezionata e salvata.
• Se il logo non appare, verifica che l'ID dell'allegato memorizzato nelle impostazioni del PDF Manager punti a un'immagine caricata valida.

Il codice QR non appare sulla scheda tecnica.

• Conferma che l'opzione del codice QR sia abilitata nel PDF Manager.
• Il servizio QR (api.qrserver.com) viene chiamato al caricamento della pagina. Se il tuo hosting blocca le richieste HTTP in uscita o il servizio è temporaneamente non disponibile, l'immagine potrebbe non caricarsi.
• Puoi sostituire l'URL dell'immagine QR utilizzando il filtro as24ci_pdf_qr_image_url. Restituisci una stringa vuota dal filtro per sopprimere completamente il codice QR.

La scheda tecnica viene memorizzata nella cache in modo errato da un plugin di caching.

• Aggiungi il parametro di query as24ci_pdf all'elenco degli URL o dei parametri esclusi del tuo plugin di caching.

Documenti correlati

• Pagine di dettaglio del veicolo
• Sede e orari di apertura