Problemi con la scheda tecnica PDF

Questo documento copre i problemi relativi alla funzionalità della scheda tecnica del veicolo ottimizzata per la stampa del plugin ADP Car Market Hub, inclusi l'accesso, il rendering, i dati mancanti, le immagini, le impostazioni e la generazione del codice QR.

Quando utilizzare questo documento

Leggere questo documento quando:

• L'URL della scheda tecnica (?as24ci_pdf={post_id}) restituisce un errore 404 o una pagina vuota.
• La pagina della scheda tecnica si apre ma mancano alcuni campi, immagini o sezioni.
• Il pulsante o il link "Stampa scheda tecnica" non appare nelle pagine di dettaglio del veicolo.
• Le impostazioni del PDF Manager non vengono applicate alla scheda tecnica renderizzata.
• Il codice QR è mancante o mostra un'immagine di errore.

Panoramica

La funzionalità PDF Datasheet renderizza una pagina HTML indipendente e ottimizzata per la stampa per ciascun veicolo. La pagina non è un vero file PDF, bensì un documento HTML formattato con CSS di stampa che il visitatore (o l'automazione del browser) converte in PDF utilizzando la funzione di stampa del browser (Stampa → Salva come PDF). Non è richiesta alcuna libreria PDF PHP.

La scheda tecnica è accessibile tramite una variabile di query aggiunta all'URL home del sito:

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

Dove {post_id} è l'ID numerico del post WordPress del veicolo. La pagina viene renderizzata solo per i post as24ci_car pubblicati. Le bozze, i post nel cestino o i post di qualsiasi altro tipo restituiscono un errore 404.

La funzionalità è disattivata per impostazione predefinita. Deve essere esplicitamente abilitata nelle impostazioni del plugin prima di poter rispondere a qualsiasi richiesta.

Requisiti

• Il plugin deve essere attivo.
• L'opzione PDF Datasheet deve essere abilitata nelle impostazioni del plugin (l'interruttore principale si trova nella scheda Design & Styles; la configurazione a livello di template si trova nella scheda PDF Manager).
• I permalink di WordPress devono essere funzionanti (semplici o personalizzati).
• Il post del veicolo deve essere nello stato publish.
• Il browser del visitatore deve supportare i fogli di stile CSS per la stampa per produrre un PDF ben formattato al momento della stampa.

Passaggi diagnostici

Passaggio 1: Confermare che la funzionalità sia abilitata

La funzionalità PDF Datasheet è disattivata per impostazione predefinita sulle nuove installazioni.

1. Andare nell'amministrazione del plugin e aprire le impostazioni Features o Design & Styles.
2. Cercare l'interruttore PDF Datasheet.
3. Abilitarlo e salvare.
4. Dopo l'abilitazione, svuotare la cache dei permalink di WordPress andando su Impostazioni → Permalink e facendo clic su Salva le modifiche.

Passaggio 2: Verificare l'ID e lo stato del post del veicolo

Il formato dell'URL è ?as24ci_pdf={post_id}. Se si utilizza un ID post errato o se il veicolo non è pubblicato, si riceverà un errore:

• Un ID post non valido (non numerico o negativo) restituisce HTTP 400 ("ID veicolo non valido").
• Un post che non esiste, non è di tipo as24ci_car o non è pubblicato restituisce HTTP 404 ("Veicolo non trovato o non pubblicato").

Per trovare l'ID corretto del post:

1. Andare alla schermata di modifica del veicolo nell'amministrazione di WordPress.
2. L'ID del post appare nell'URL: ?post=12345.
3. Testare l'URL della scheda tecnica: https://your-site.com/?as24ci_pdf=12345.

Passaggio 3: Verificare che la variabile di query sia registrata

La scheda tecnica utilizza la variabile di query as24ci_pdf di WordPress. Se un altro plugin o tema annulla la registrazione o va in conflitto con le variabili di query personalizzate, la scheda tecnica potrebbe non attivarsi.

1. Dopo aver abilitato la funzionalità, aggiornare i permalink (Impostazioni → Permalink → Salva le modifiche).
2. Se l'URL continua a non funzionare, verificare se un plugin di sicurezza o di caching sta rimuovendo i parametri di query sconosciuti dalle richieste.

Passaggio 4: Diagnosticare campi o sezioni mancanti

Le impostazioni di PDF Manager (memorizzate nell'opzione as24ci_pdf_manager_settings) controllano quali campi e sezioni appaiono sulla scheda tecnica. Se mancano dei campi:

1. Andare alla scheda di amministrazione PDF Manager.
2. Controllare le caselle di selezione dei Content fields. Qualsiasi campo deselezionato non apparirà sulla scheda tecnica.
3. Esaminare la sezione Layout per verificare gli interruttori come Show Gallery, Show Price Box e Show Contact Information.
4. Salvare le impostazioni e ricaricare la scheda tecnica.

Se un campo è abilitato in PDF Manager ma continua a non apparire, il veicolo potrebbe non avere dati per quel campo. Ad esempio, se il veicolo è stato importato senza un prezzo, il campo del prezzo non verrà renderizzato anche se abilitato.

Passaggio 5: Diagnosticare immagini mancanti

La scheda tecnica utilizza le immagini provenienti da due meta campi:

• _as24ci_image_ids — immagini importate dall'API.
• _as24ci_manual_image_ids — immagini caricate manualmente.

La scheda tecnica mostra un massimo di 5 immagini, indipendentemente dall'impostazione Image Count in PDF Manager. Se mancano delle immagini:

1. Confermare che le immagini siano state importate. Andare alla schermata di modifica del veicolo in WordPress e controllare il metabox Media o la sezione della galleria di immagini.
2. Verificare che l'interruttore Show Gallery sia abilitato nelle impostazioni di PDF Manager.
3. Se il veicolo ha un'immagine in evidenza impostata ma non ha immagini importate, la scheda tecnica utilizzerà l'immagine in evidenza come fallback.
4. Verificare che le voci della Libreria media di WordPress per le immagini non siano state eliminate o danneggiate.

Passaggio 6: Controllare il codice QR

Il codice QR è opzionale ed è disattivato per impostazione predefinita. Quando abilitato, la scheda tecnica utilizza l'API pubblica per codici QR all'indirizzo https://api.qrserver.com/v1/create-qr-code/ per generare un'immagine. Si tratta di un servizio esterno che non richiede autenticazione.

Se il codice QR non appare:

1. Verificare che l'interruttore Show QR Code sia abilitato nelle impostazioni di PDF Manager.
2. Verificare che l'URL pubblicato del veicolo non contenga autoscout24. nell'host — il plugin sopprime intenzionalmente il codice QR quando l'URL del veicolo si risolve sul dominio AutoScout24.
3. Verificare che il server disponga di accesso a Internet in uscita verso api.qrserver.com sulla porta 443. In ambienti di hosting limitati, questa richiesta potrebbe essere bloccata.
4. L'URL dell'immagine del codice QR può essere sostituito utilizzando il filtro as24ci_pdf_qr_image_url. Se una personalizzazione sta sopprimendo l'immagine (restituendo una stringa vuota), controllare il tema attivo e i plugin per questo filtro.

Passaggio 7: Controllare le informazioni del venditore

Le informazioni di contatto del venditore sulla scheda tecnica vengono lette dai campi meta utente dell'autore del post:

Se le informazioni di contatto sono mancanti:

1. Andare su Utenti nell'amministrazione di WordPress e aprire il profilo dell'autore del post.
2. Verificare se i campi del profilo del venditore sono compilati.
3. Se la sezione dei campi del profilo del venditore non è visibile, confermare che la classe Seller_Profile_Fields sia attiva (controllata dal bootstrap del plugin).

Riferimento di configurazione — Impostazioni PDF Manager

Le impostazioni di PDF Manager sono memorizzate nell'opzione as24ci_pdf_manager_settings come array serializzato. Sono gestite nella scheda di amministrazione PDF Manager.

Branding

Layout

Codice QR

Campi di contenuto

I seguenti campi possono essere mostrati o nascosti singolarmente. Tutti sono abilitati per impostazione predefinita.

Note legali

Un campo di testo libero aggiunto in fondo alla scheda tecnica. Accetta testo normale. Utile per dichiarazioni di non responsabilità legale o condizioni standard di vendita.

Note operative

• La pagina della scheda tecnica viene renderizzata come un documento HTML indipendente. Non utilizza l'header o il footer del tema di WordPress. Il CSS del tema, le barre laterali e gli elementi di navigazione non vengono applicati.
• I dati del veicolo vengono letti dalla tabella di database personalizzata {prefix}as24_vehicles con un fallback sul post meta di WordPress. Se la tabella personalizzata non esiste (ad esempio su un'installazione danneggiata o migrata), alcuni campi potrebbero utilizzare i valori del post meta come fallback.
• Il campo della descrizione utilizza l'estratto del post se impostato; in caso contrario, utilizza le prime 150 parole del contenuto del post.
• L'URL della scheda tecnica utilizza una variabile di query (non una regola di riscrittura), quindi funziona sia con i permalink personalizzati sia con le strutture di permalink semplici (?p=).
• Non è richiesto alcun requisito di autenticazione per visualizzare la scheda tecnica. Qualsiasi visitatore con l'URL può accedervi per qualsiasi veicolo pubblicato. Se è necessaria una restrizione di accesso, deve essere implementata a livello di hosting o CDN.

Risoluzione dei problemi

Documenti correlati

• Errori di importazione delle immagini
• Problemi di visualizzazione del frontend
• Errori di autorizzazione