Problemi di visualizzazione del frontend

Questo documento copre i problemi relativi alla modalità di visualizzazione degli annunci di veicoli sulle pagine pubbliche di un sito WordPress che utilizza il plugin ADP Car Market Hub. Tratta le pagine di archivio, le pagine di dettaglio del singolo veicolo, i conflitti con i temi, i problemi di permalink e i problemi di caricamento degli asset.

Quando utilizzare questo documento

Leggi questo documento quando:

• La pagina di archivio dei veicoli (/cars/ o lo slug configurato) non mostra annunci, restituisce un errore 404 o non viene trovata.
• Le pagine di dettaglio del singolo veicolo non vengono visualizzate o presentano problemi di layout e stile.
• I filtri nella pagina di archivio non funzionano o non restituiscono i risultati previsti.
• Il CSS o il JavaScript del plugin non si caricano sulle pagine del frontend.
• Il tema attivo sovrascrive o va in conflitto con i template del plugin.
• La paginazione nell'archivio o in una pagina di annunci incorporata tramite shortcode non funziona.

Panoramica

Il plugin registra un custom post type (as24ci_car) con lo slug di archivio cars e fornisce due file di template:

• templates/archive-as24ci_car.php — utilizzato per la pagina di archivio dei veicoli.
• templates/single-as24ci_car.php — utilizzato per le pagine di dettaglio del singolo veicolo.

WordPress risolve i template utilizzando la gerarchia standard dei template. Il plugin si aggancia ai filtri single_template e archive_template. Verifica prima se il tema attivo fornisce una sovrascrittura personalizzata (single-as24ci_car.php o archive-as24ci_car.php nella directory del tema) e utilizza il template del plugin come fallback. Ciò significa che un tema può controllare completamente il layout se fornisce un file di template corrispondente.

I CSS e i JavaScript vengono accodati automaticamente rilevando il tipo di pagina corrente. Sulle pagine in cui viene utilizzato uno shortcode per incorporare l'archivio, gli asset vengono rilevati tramite has_shortcode() rispetto al contenuto del post della pagina.

Requisiti preliminari

• Esiste almeno un post di veicolo ed è pubblicato.
• I permalink sono impostati su un valore diverso da "Semplice" (affinché l'instradamento dell'archivio funzioni correttamente). Vai su Impostazioni → Permalink e scegli una qualsiasi opzione diversa dall'impostazione predefinita "Semplice", quindi fai clic su Salva le modifiche.
• Il plugin è attivo e non sono presenti errori fatali PHP (controlla Strumenti → Stato del sito o il registro degli errori PHP).

Passaggi diagnostici

Passaggio 1: Rigenera i permalink

La maggior parte degli errori 404 dell'archivio è causata da regole di permalink non aggiornate. Questa è la prima cosa da provare ogni volta che l'archivio dei veicoli o le pagine singole restituiscono un errore 404.

1. Vai su Impostazioni → Permalink nell'amministrazione di WordPress.
2. Fai clic su Salva le modifiche senza modificare alcuna impostazione. Questo ricostruisce le regole di riscrittura.
3. Visita l'URL dell'archivio dei veicoli (in genere /cars/) e conferma che si carichi correttamente.

Passaggio 2: Conferma l'URL dell'archivio dei veicoli

Il plugin registra il CPT con lo slug di archivio cars. L'URL dell'archivio è in genere:

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

Se WordPress è installato in una sottodirectory, o se la struttura dei permalink utilizza un prefisso, l'URL dell'archivio rifletterà tale configurazione. Utilizza get_post_type_archive_link('as24ci_car') (tramite WP-CLI o uno snippet di test) per confermare l'URL esatto.

Passaggio 3: Verifica se l'archivio CPT è abilitato

Il custom post type è registrato con has_archive = true. Se WordPress non reindirizza all'archivio, conferma che:

1. I permalink non siano impostati su "Semplice". I permalink semplici disabilitano l'instradamento dell'archivio CPT.
2. Nessun plugin di cache stia servendo una risposta 404 obsoleta per l'URL dell'archivio. Svuota la cache dopo aver rigenerato i permalink.
3. Nessuna regola .htaccess o configurazione del server stia bloccando l'URL dell'archivio.

Passaggio 4: Verifica la presenza di conflitti con il tema

Se l'archivio o il template singolo vengono visualizzati in modo errato, potrebbe trattarsi di un conflitto con il tema:

1. Passa temporaneamente a un tema predefinito di WordPress (come Twenty Twenty-Four) e visita l'archivio dei veicoli e la pagina di un singolo veicolo.
2. Se le pagine vengono visualizzate correttamente con il tema predefinito, il tuo tema attivo sta causando un conflitto.
3. Cause comuni: il tema attivo fornisce un proprio template archive-as24ci_car.php o single-as24ci_car.php obsoleto o incompatibile; il tema genera una struttura HTML errata attorno al contenuto; il CSS del tema va in conflitto con gli stili del plugin.

Passaggio 5: Verifica che CSS e JavaScript vengano caricati

Se l'archivio dei veicoli o la pagina singola mostrano contenuti privi di stile o elementi interattivi non funzionanti (menu a discesa dei filtri, galleria, lightbox):

1. Apri la pagina in un browser e visualizza il codice sorgente della pagina o utilizza gli strumenti per sviluppatori del browser (scheda Rete).
2. Conferma che i fogli di stile del plugin siano presenti: - Sulle pagine di archivio: as24ci-archive.css - Sulle pagine dei singoli veicoli: as24ci-single.css
3. Se questi mancano: - Conferma che la pagina sia correttamente riconosciuta come archivio CPT o come post CPT singolo. - Se utilizzi uno shortcode per incorporare l'archivio in una pagina normale, conferma che lo shortcode [as24ci_archive] si trovi nel contenuto del post della pagina (non in un widget, in una parte di template o in un campo personalizzato elaborato al di fuori di the_content). Gli asset vengono rilevati leggendo il contenuto del post con has_shortcode(). - Se un plugin di prestazioni o di minificazione concatena o differisce gli script, potrebbe interferire con il JavaScript del plugin. Esegui un test con quel plugin disattivato.
4. Conferma che nessun altro plugin o tema stia chiamando wp_dequeue_style o wp_dequeue_script per gli asset del plugin.

Passaggio 6: Verifica il comportamento dei filtri dell'archivio

L'archivio dei veicoli supporta i parametri di filtro passati tramite la query string dell'URL (ad es. ?make=volkswagen&fuel_type=diesel). Se i filtri non funzionano:

1. Conferma che i widget dei filtri siano visualizzati (vengono renderizzati dal template di archivio).
2. Conferma che lo specifico filtro sia abilitato nelle impostazioni Filtro o Layout Manager del plugin. I filtri disabilitati non appariranno e i loro parametri GET saranno ignorati.
3. Conferma che non vi sia un livello di cache che serva una versione memorizzata della pagina di archivio indipendentemente dai parametri di query. La maggior parte dei plugin di cache deve essere configurata per escludere dalla cache le pagine con query string.

Passaggio 7: Esamina i problemi di paginazione

Se la paginazione nella pagina di archivio non funziona (facendo clic sulla pagina 2 si ottengono gli stessi risultati):

1. Conferma che la struttura dei permalink non sia impostata su "Semplice".
2. Nelle pagine di archivio incorporate tramite shortcode, la paginazione utilizza i parametri di query ?paged=2 (o ?page=2). Conferma che non vi sia alcun reindirizzamento che rimuova questi parametri.
3. Sull'URL dell'archivio CPT reale, WordPress gestisce la paginazione in modo nativo. Rigenera i permalink se non funziona.

Passaggio 8: Controlla la presenza di errori PHP

Un errore fatale o un avviso PHP possono interrompere silenziosamente l'output della pagina o causare un rendering parziale:

1. Abilita temporaneamente la modalità di debug di WordPress aggiungendo a wp-config.php: ``php define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false ); ``
2. Visita la pagina interessata dal problema e controlla wp-content/debug.log per verificare la presenza di errori.
3. Disabilita nuovamente la modalità di debug dopo aver effettuato le verifiche.

Riferimento di configurazione

Note operative

• I file di template del plugin si trovano nella directory templates/ del plugin. Non modificare direttamente questi file, poiché gli aggiornamenti sovrascriveranno le tue modifiche. Per personalizzare i template, copiali nella directory del tuo tema attivo e modifica la copia lì.
• Il template di archivio risolve i valori dei filtri utilizzando le tassonomie di WordPress (as24ci_brand, as24ci_model, as24ci_fuel_type, ecc.) e una tabella di database personalizzata (wp_as24_vehicles) per i campi numerici come prezzo e chilometraggio.
• Se la pagina di archivio è incorporata utilizzando lo shortcode [as24ci_archive] su una pagina standard di WordPress, la pagina non deve avere un proprio ciclo di query o contenuti che interferiscano con la variabile globale $wp_query. Lo shortcode sostituisce temporaneamente $wp_query durante il rendering e lo ripristina successivamente.
• Il CSS dinamico (impostazioni di design come i colori) viene generato inline nel tag <head> tramite un'azione wp_head con priorità 99.

Risoluzione dei problemi

Documenti correlati

• Panoramica sulla risoluzione dei problemi
• Problemi con gli shortcode
• Errori di importazione delle immagini
• Errori di autorizzazione