Documentazione · Riferimento amministratore
Riferimento Mapping
Questo documento è un riferimento per la schermata Mapping del plugin ADP Car Market Hub (Car Market Hub → Mapping). Spiega come i campi AutoScout24 in entrata vengono mappati in WordPress, cosa è possibile personalizzare per ciascun campo e come esportare o ripristinare la configurazione.
Quando utilizzare questo documento
Leggi questo documento quando desideri rinominare un campo che appare nel frontend, nascondere un campo che non deve essere mostrato ai visitatori o verificare la mappatura tra i campi sorgente AutoScout24 e le meta chiavi WordPress utilizzate dai template del plugin.
Panoramica
Ogni veicolo importato da AutoScout24 viene memorizzato come articolo as24ci_car in WordPress, con i campi sorgente scritti in meta chiavi dedicate dell'articolo. La schermata Mapping mostra tale mappatura sotto forma di una serie di tabelle raggruppate. Per ogni campo è possibile:
- Visualizzare il nome del campo AS24 originale e la meta chiave WordPress sottostante.
- Personalizzare l'Etichetta (Label) che i template utilizzano per quel campo.
- Attivare o disattivare lo stato Visibile del campo per nasconderlo dal frontend.
Una scheda separata Equipaggiamento e funzionalità elenca tutti i codici di equipaggiamento supportati (memorizzati come array serializzato in una singola meta chiave) con gli stessi controlli per Etichetta e Visibile. Una scheda Esporta e Ripristina consente di eseguire il backup della configurazione in formato JSON o CSV, oppure di ripristinare tutte le modifiche ai valori predefiniti del plugin.
Requisiti o prerequisiti
- Autorizzazione a gestire il plugin (la stessa capacità utilizzata altrove in Car Market Hub).
- Almeno un veicolo importato, in modo che le modifiche alle etichette e alla visibilità siano visibili sul frontend.
Istruzioni passo dopo passo
Personalizzare l'etichetta di un campo o nascondere un campo
- Apri Car Market Hub → Mapping.
- Facoltativamente, digita nel campo Cerca campi per filtrare le righe in tutti i gruppi in base al nome del campo, all'etichetta o alla meta chiave. Mentre digiti, la barra di ricerca mostra un conteggio in tempo reale (N corrispondenze) delle righe corrispondenti.
- Nella tabella del gruppo pertinente, modifica la colonna Etichetta per il campo che desideri rinominare. I valori vuoti utilizzeranno l'etichetta tradotta predefinita.
- Utilizza l'interruttore Visibile per nascondere il campo dai template del frontend.
- Fai clic su Salva impostazioni di mappatura in fondo alla sezione. Le modifiche vengono applicate immediatamente al successivo caricamento della pagina frontend.
Personalizzare i codici di equipaggiamento / funzionalità
- Scorri fino alla scheda Equipaggiamento e funzionalità.
- Modifica la colonna Etichetta per qualsiasi codice di funzionalità che desideri visualizzare con un nome diverso.
- Disattiva l'interruttore Visibile per qualsiasi codice di funzionalità che non deve essere mostrato.
- Fai clic su Salva impostazioni di mappatura.
Esportare la mappatura corrente
- Apri la scheda Esporta e Ripristina.
- Fai clic su Esporta JSON o Esporta CSV per scaricare un'istantanea della configurazione di mappatura corrente, incluse le personalizzazioni delle etichette e della visibilità.
Ripristinare tutte le personalizzazioni
- Apri la scheda Esporta e Ripristina.
- Fai clic su Ripristina predefiniti. Tutte le etichette personalizzate e le modifiche alla visibilità verranno rimosse; ogni campo tornerà alla sua etichetta predefinita integrata e al suo stato di visibilità originale.
Riferimento di configurazione
Gruppi di campi
La scheda dei campi standard è organizzata nei seguenti gruppi logici (ciascun gruppo elenca i campi AS24 che contiene e una breve descrizione):
- Identificazione e stato — identificatori principali, riferimenti del venditore, timestamp e flag di stato dell'annuncio.
- Base veicolo / tipo — marca, modello, identificatori della versione, dettagli di certificazione, categoria del veicolo.
- Carrozzeria e dimensioni — stile carrozzeria, colore esterno e interno, posti a sedere, numero di porte, dimensioni fisiche comprese le misure del bagagliaio.
- Motore e trasmissione — tipo di carburante, sistema di trazione, trasmissione, cilindrata, configurazione dei cilindri, dati sulla potenza erogata.
- Consumi, emissioni ed energia — consumo di carburante e gas (urbano / extraurbano / combinato), emissioni di CO₂, classe di emissione standard, etichetta energetica.
- Elettrificazione e ricarica — capacità della batteria, stato di salute (SOH), prezzo di noleggio, autonomia elettrica, tipi di connettori di ricarica AC/DC, potenze nominali, tempi di ricarica.
- Chilometraggio e immatricolazione — condizioni del veicolo, data di prima immatricolazione, lettura del contachilometri, stato dell'ispezione.
- Peso, traino e carico utile — peso a vuoto, peso lordo del veicolo, capacità di carico utile, limite di traino frenato.
- Prezzo e garanzia — prezzo di vendita, prezzo di listino del produttore, dettagli completi sulla garanzia (tipo, durata, copertura chilometrica).
- Descrizione e media — testo di anteprima dell'annuncio, descrizione completa, campi della galleria fotografica.
Controlli per singolo campo
| Colonna | Note |
|---|---|
| Campo AS24 | Il nome del campo AutoScout24 originale (sola lettura). |
| Etichetta | Modificabile. Vuoto = etichetta tradotta predefinita. Lunghezza massima: 120 caratteri. Le righe con un'etichetta personalizzata salvata mostrano un badge personalizzato. |
| Meta chiave WordPress | La chiave post-meta sotto la quale è memorizzato il valore (sola lettura). |
| Visibile | Interruttore. Se disattivato, i template salteranno questo campo anche se il veicolo importato contiene dati per esso. |
Esporta e Ripristina
| Azione | Note |
|---|---|
| Esporta JSON | Genera un file JSON contenente le personalizzazioni salvate. |
| Esporta CSV | Genera un file CSV con gli stessi dati. |
| Ripristina predefiniti | Rimuove l'intera opzione delle personalizzazioni; ogni campo torna al suo valore predefinito integrato. |
Note operative
- Tutte le personalizzazioni sono memorizzate in una singola opzione WordPress, non nei singoli post meta. Ciò significa che le modifiche si applicano istantaneamente a tutti i veicoli importati senza dover reimportare i dati.
- Il salvataggio del modulo memorizza lo stato visibile per ogni campo conosciuto. Qualsiasi elemento non presente nel modulo viene trattato come visibile per impostazione predefinita.
- Le etichette dei campi sono pronte per la traduzione. Se il tuo sito è in una lingua diversa dall'inglese, la colonna Etichetta mostra il valore predefinito tradotto fino a quando non imposti una personalizzazione.
- La schermata di mappatura non modifica il modo in cui i dati vengono importati; controlla solo come i dati memorizzati vengono etichettati e se appaiono sul frontend. Per modificare quali immagini o dati vengono scaricati, consulta il Riferimento a importazione e limiti.
- Nascondere un campo qui influisce anche sulla visibilità del campo configurata per zona nel Layout Manager, poiché entrambi i livelli devono consentire un campo affinché questo venga visualizzato.
Risoluzione dei problemi
- Una modifica dell'etichetta non appare. Verifica di aver fatto clic su Salva impostazioni di mappatura nella stessa scheda e che l'eventuale cache del frontend o della CDN sia stata svuotata.
- Un campo è ancora nascosto dopo averlo abilitato. Controlla il Layout Manager: il blocco o la zona corrispondente deve includere a sua volta il campo.
- Il download dell'esportazione è vuoto o fallisce. Assicurati che nessun altro plugin stia intercettando le richieste
admin-post.phpe che l'utente disponga dei permessi di gestione. Il percorso CSV utilizza lo streamphp://outputdi PHP; alcuni host restrittivi potrebbero bloccarlo. Verifica nella versione corrente del plugin prima di pubblicare. - Il ripristino dei valori predefiniti non ha prodotto effetti. Il ripristino rimuove solo le personalizzazioni. Se le etichette appaiono ancora personalizzate, potresti avere un file di traduzione attivo che sovrascrive l'etichetta predefinita.
- Le modifiche alle etichette degli equipaggiamenti non vengono mostrate su un veicolo. Quel veicolo potrebbe essere stato importato prima che il campo dell'equipaggiamento venisse popolato, oppure il codice della funzionalità è nascosto in Equipaggiamento e funzionalità. Ricontrolla l'interruttore Visibile e reimporta il veicolo se necessario (consulta il Riferimento importatore veicoli).