Guida all'installazione

Questa guida descrive come installare e attivare il plugin ADP Car Market Hub WordPress su un sito WordPress e come verificare che l'installazione sia andata a buon fine prima di procedere con qualsiasi ulteriore configurazione.

Non tratta le credenziali API o la configurazione dell'importazione: questi argomenti sono trattati in Prima configurazione, Configurazione delle credenziali API e Test di connessione.

Quando utilizzare questo documento

Utilizza questo documento se stai:

• Installando ADP Car Market Hub su un nuovo sito WordPress per la prima volta.
• Reinstallando il plugin su un sito esistente (ad esempio dopo una migrazione del server o una ricostruzione da zero).
• Verificando che un'installazione eseguita da terze parti (agenzia, provider di hosting, IT interno) sia stata completata correttamente.
• Preparando una procedura di installazione documentata per la consegna a un cliente.

Il pubblico di riferimento è un amministratore WordPress con accesso completo al back-office e, laddove si utilizzi l'installazione tramite SFTP, con le credenziali del file system per il server di destinazione.

Prima di iniziare

Verifica quanto segue prima di iniziare l'installazione. La maggior parte dei problemi riscontrati durante l'installazione deriva dal mancato soddisfacimento di uno di questi prerequisiti.

• Pacchetto del plugin. Un archivio ZIP firmato del plugin ADP Car Market Hub fornito da AD Promotion o dal tuo canale di distribuzione. Non rinominare l'archivio e non decomprimerlo per poi ricomprimerlo.
• Chiave di licenza. La tua chiave di licenza ADP Car Market Hub, fornita da AD Promotion. Il plugin si installa e si attiva anche senza di essa, ma tutte le schede di amministrazione eccetto Impostazioni rimarranno bloccate da una schermata "Licenza richiesta" finché la licenza non viene attivata. L'attivazione della licenza è trattata in Prima configurazione.
• Ambiente WordPress. Un'installazione funzionante di WordPress che soddisfi i requisiti minimi del plugin:
• WordPress 6.2 o superiore (Requires at least: 6.2 nell'intestazione del plugin).
• PHP 8.1 o superiore (Requires PHP: 8.1 nell'intestazione del plugin e composer.json).
• Un database supportato da WordPress (MySQL o MariaDB).
• Estensioni PHP openssl, curl, mbstring, json e una tra gd o imagick.
• Una directory di caricamento scrivibile (wp-content/uploads/). Consulta Requisiti tecnici di sistema per tutti i dettagli.
• Connettività HTTPS in uscita. Il server web deve essere in grado di raggiungere l'host API di AutoScout24 che configurerai in seguito. Consulta Requisiti API, di rete e SSL.
• Account amministratore. È richiesto un utente WordPress con la funzionalità manage_options (in genere il ruolo administrator) per installare, attivare e configurare il plugin.
• Backup. Un backup recente e ripristinabile del sito WordPress, inclusi il database e wp-content/. Le installazioni in produzione dovrebbero sempre disporre di un backup recente prima di installare o attivare qualsiasi plugin.
• Ambiente di staging (consigliato). Per i siti in produzione si raccomanda caldamente di installare e verificare il plugin prima su una copia di staging, per poi trasferire la configurazione in produzione. Consulta Migrazione da staging a live.
• Lista di controllo pre-installazione. Segui i passaggi della Lista di controllo pre-installazione per confermare la prontezza dell'hosting, di PHP, del database e della rete.

Istruzioni passo dopo passo

Sono supportati due percorsi di installazione:

• Opzione A — Caricamento del file ZIP tramite l'amministrazione di WordPress (consigliato per la maggior parte degli ambienti).
• Opzione B — Caricamento manuale tramite SFTP (consigliato quando l'amministrazione di WordPress non consente il caricamento di plugin, quando l'ambiente di hosting impone file system in sola lettura per l'utente amministratore o quando si installa come parte di una pipeline di distribuzione).

Utilizza un percorso o l'altro; non eseguirli entrambi contemporaneamente.

Opzione A — Installazione tramite l'amministrazione di WordPress (caricamento ZIP)

1. Accedi a WordPress come amministratore.
2. Nel menu di amministrazione a sinistra, apri Plugin → Aggiungi nuovo.
3. Fai clic su Carica plugin in alto nella pagina.
4. Fai clic su Scegli file e seleziona l'archivio ZIP di ADP Car Market Hub.
5. Fai clic su Installa ora e attendi che WordPress carichi e decomprima l'archivio.
6. Al termine del caricamento, fai clic su Attiva plugin.

Se il caricamento fallisce a causa di un errore di dimensione o di memoria, si tratta normalmente di un limite lato server (upload_max_filesize, post_max_size, memory_limit o una restrizione del web application firewall). Risolvi il limite con il tuo provider di hosting o utilizza l'Opzione B.

Opzione B — Installazione manuale tramite SFTP

1. Decomprimi l'archivio ZIP di ADP Car Market Hub sul tuo computer locale. Dovresti ottenere una singola cartella denominata adp-car-market-hub/ contenente i file del plugin.
2. Connettiti al server WordPress tramite SFTP (o SSH) con un account che possa scrivere in wp-content/plugins/.
3. Carica l'intera cartella adp-car-market-hub/ all'interno di wp-content/plugins/ in modo che il percorso finale sia wp-content/plugins/adp-car-market-hub/.
4. Verifica che wp-content/plugins/adp-car-market-hub/adp-car-market-hub.php esista sul server. WordPress identifica il plugin tramite questo file principale.
5. Accedi a WordPress come amministratore.
6. Apri Plugin → Plugin installati, individua ADP Car Market Hub nell'elenco e fai clic su Attiva.

Non modificare manualmente i permessi dei file del plugin a meno che il tuo provider di hosting non lo richieda esplicitamente. Il plugin non ha bisogno di accesso in scrittura alla propria directory.

Verifiche di attivazione

Dopo aver fatto clic su Attiva, WordPress dovrebbe mostrare un avviso di successo e ADP Car Market Hub dovrebbe apparire nell'elenco dei plugin attivi.

Se l'attivazione è bloccata, WordPress mostra un messaggio che ne descrive il motivo. Le cause più comuni sono:

• Il sito non soddisfa le versioni minime richieste dal plugin per WordPress o PHP.
• Manca un'estensione PHP richiesta.
• Esiste ancora su disco un'installazione precedente e incompleta del plugin.
• I permessi dei file su wp-content/plugins/ impediscono a WordPress di finalizzare l'attivazione.

Risolvi il problema di fondo e prova a ripetere l'attivazione. Il plugin non modifica i temi o altri plugin durante l'attivazione.

Verifiche post-attivazione

Esegui queste verifiche subito dopo un'attivazione andata a buon fine. Esse confermano che il plugin è stato caricato correttamente ed è pronto per la configurazione.

1. Menu di amministrazione. Conferma che una nuova voce di menu di primo livello Car Market Hub sia visibile nella barra laterale di amministrazione di WordPress (il nome visualizzato del plugin nel menu è abbreviato, mentre il file del plugin stesso è registrato come ADP Car Market Hub). Passa il mouse sopra la voce per vedere le sotto-voci disponibili, tra cui Dashboard, Impostazioni, Car Importer, Importazione e Limiti, Strumenti, Sistema e Aiuto, Log e altre.
2. Link di azione del plugin. In Plugin → Plugin installati, la riga di ADP Car Market Hub dovrebbe ora mostrare un link Attivazione licenza e un link Impostazioni oltre a Disattiva. Attivazione licenza apre la pagina delle Impostazioni ancorata alla scheda di Attivazione della licenza; Impostazioni apre la pagina delle Impostazioni del plugin.
3. Rendering della pagina Impostazioni. Apri Car Market Hub → Impostazioni. La pagina dovrebbe caricarsi senza avvisi PHP, errori fatali o avvisi di risorse mancanti. La scheda Attivazione della licenza dovrebbe apparire nella parte superiore della pagina, e i campi URL di base dell'API, Seller ID, Client ID, Client Secret e Valuta predefinita dovrebbero essere visibili e vuoti (su una nuova installazione). Su una nuova installazione, le altre schede del plugin mostrano una schermata "Licenza richiesta" finché non viene attivata una licenza.
4. Sistema e Aiuto. Apri Car Market Hub → Sistema e Aiuto. La pagina dovrebbe mostrare i controlli dell'ambiente (PHP, JSON, OpenSSL, cURL, GD/Imagick, caricamenti) con badge di stato in stile semaforo. Una nuova installazione che soddisfa i requisiti non dovrebbe mostrare badge rossi; un'estensione mancante o una directory non scrivibile verranno segnalate qui. Risolvi eventuali problemi prima di continuare.
5. Nessun errore fatale nei log. Conferma che il log di debug di WordPress (se abilitato) e il log degli errori del tuo hosting non mostrino errori fatali correlati al plugin. Il plugin mantiene il proprio file di log in wp-content/uploads/as24ci-logs/, che verrà creato automaticamente al primo utilizzo.

Se una qualsiasi di queste verifiche fallisce, non procedere con i passaggi di configurazione. Risolvi prima il problema o ripristina l'ultimo backup recente.

Avviso della procedura guidata di prima configurazione

Dopo la prima attivazione del plugin, un avviso di amministrazione intitolato Benvenuto in ADP Car Market Hub appare nella parte superiore di ogni pagina di amministrazione di WordPress. L'avviso fornisce due pulsanti:

• Avvia procedura guidata apre la Procedura guidata di prima configurazione, un flusso in sette passaggi (licenza, modalità, profilo del rivenditore, AutoScout24, pagine, funzionalità, fine). L'attivazione della licenza è il primo passaggio obbligatorio; i passaggi rimanenti sono facoltativi.
• Salta per ora chiude l'avviso. La procedura guidata rimane raggiungibile dalla Dashboard e da Car Market Hub → Tools.

L'avviso non è un reindirizzamento forzato. Appare solo quando il timestamp della prima attivazione è stato appena registrato e la procedura guidata non è stata ancora completata o saltata. Gli aggiornamenti del plugin che non avviano una nuova attivazione non mostrano l'avviso sulle installazioni esistenti. La procedura guidata è facoltativa ma consigliata; tutto ciò che offre può essere configurato anche manualmente tramite le normali schede di amministrazione.

Note di configurazione

Questo documento tratta solo l'installazione. I seguenti punti si applicano specificamente alla fase di installazione/attivazione:

• Slug e cartella del plugin. Il nome previsto per la cartella è adp-car-market-hub. La ridenominazione della cartella non è supportata e influirà sulla capacità di WordPress di gestire gli aggiornamenti.
• Custom post type e tassonomie. All'attivazione, il plugin registra il custom post type as24ci_car e un insieme di tassonomie per i veicoli. Si tratta di elementi tecnici e non richiedono una configurazione manuale.
• Tabelle di database personalizzate. Il plugin crea le proprie tabelle di database all'attivazione tramite dbDelta() (ad esempio per gli eventi di analisi e gli avvisi di ricerca salvati). Non è richiesto alcun SQL manuale.
• Funzionalità e ruolo personalizzati. Il plugin fornisce una propria funzionalità e un ruolo delegato utilizzato per la gestione quotidiana. L'installazione e la configurazione iniziali devono comunque essere eseguite da un amministratore completo di WordPress. Consulta Controllo degli accessi e funzionalità.
• Nessuna importazione di dati all'attivazione. L'attivazione non importa alcun veicolo né contatta AutoScout24. Le importazioni iniziano solo dopo che le credenziali sono state configurate e viene avviata un'importazione.

Note operative

• Aggiornamenti. I futuri aggiornamenti del plugin devono essere applicati tramite lo stesso canale utilizzato per l'installazione (caricamento da amministrazione di un nuovo ZIP o sostituzione tramite SFTP della cartella del plugin). Mantieni invariati lo slug del plugin e il nome della cartella in modo da preservare le impostazioni, i veicoli e i lead. Esegui sempre un backup recente prima di aggiornare in produzione.
• Disattivazione. La disattivazione del plugin ne disabilita le funzionalità ma mantiene nel database i veicoli importati, le opzioni, i lead e i dati di analisi. Il plugin rimuove i suoi dati solo al momento della disinstallazione, e solo quando la corrispondente impostazione di pulizia è abilitata. Consulta Disinstallazione e pulizia dei dati.
• Multisito. ADP Car Market Hub è destinato ad essere attivato sul singolo sito che deve mostrare l'inventario dei veicoli, non a livello di rete. Verifica con il tuo amministratore di hosting / di rete prima di installarlo in un ambiente multisito.
• Rigore in produzione. Le installazioni in produzione dovrebbero seguire una procedura di rilascio documentata: backup → installazione in staging → verifica → installazione in produzione → nuova verifica. Consulta Migrazione da staging a live.

---

Risoluzione dei problemi

Se il problema persiste dopo queste verifiche, raccogli le informazioni diagnostiche descritte nella Lista di controllo delle informazioni di supporto prima di contattare l'assistenza.

Documenti correlati

• Lista di controllo pre-installazione
• Requisiti tecnici di sistema
• Requisiti API, di rete e SSL
• Prima configurazione
• Configurazione delle credenziali API
• Test di connessione
• Lista di controllo per la messa online
• Migrazione da Staging a Live