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 copre 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 pulita).
• Convalidando che un'installazione eseguita da terze parti (agenzia, fornitore 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 i seguenti punti prima di iniziare l'installazione. La maggior parte dei problemi riscontrati durante l'installazione deriva dal mancato completamento 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, né decomprimerlo e 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 ogni scheda di amministrazione eccetto Settings rimarrà bloccata 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 i 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. Vedi Requisiti di API, rete e SSL.
• Account amministratore. Per installare, attivare e configurare il plugin è necessario un utente WordPress con la funzionalità manage_options (in genere il ruolo administrator).
• 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 convalidare il plugin prima su una copia di staging, per poi trasferire la configurazione in produzione. Vedi Staging to Live Migration.
• 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-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 nella parte superiore della 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 completamento 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 fornitore 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 fornitore 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 una notifica 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 di WordPress o PHP richieste dal plugin.
• 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 sottostante e prova nuovamente 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; il file del plugin stesso è registrato come ADP Car Market Hub). Passa il mouse sopra la voce per vedere le voci di sottomenu disponibili, tra cui Dashboard, Settings, Universal Import, Car Importer, Import & Limits, Tools, System & Help, Logs e altre.
2. Link di azione del plugin. In Plugin → Plugin installati, la riga di ADP Car Market Hub dovrebbe ora mostrare un link License activation e un link Settings oltre a Disattiva. License activation apre la pagina delle Impostazioni ancorata alla scheda di attivazione della licenza; Settings apre la pagina delle Impostazioni del plugin.
3. Rendering della pagina delle impostazioni. Apri Car Market Hub → Settings. La pagina dovrebbe caricarsi senza avvisi PHP, errori fatali o avvisi di risorse mancanti. La scheda License Activation dovrebbe apparire nella parte superiore della pagina, seguita da General Settings (valuta predefinita) e da una scheda ridotta Data sources & API connections con un pulsante Manage data sources. Le credenziali API non vengono più inserite qui; risiedono in Car Market Hub → Universal Import, dove la sorgente AutoScout24 mostra i campi API Base URL, Seller ID, Client ID e Client Secret (vuoti su un'installazione pulita). Su un'installazione pulita, le altre schede del plugin mostrano una schermata "Licenza richiesta" finché non viene attivata una licenza.
4. System & Help. Apri Car Market Hub → System & Help. La pagina dovrebbe mostrare i controlli dell'ambiente (PHP, JSON, OpenSSL, cURL, GD/Imagick, caricamenti) con badge di stato in stile semaforo. Un'installazione pulita 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 Welcome to ADP Car Market Hub appare nella parte superiore di ogni pagina di amministrazione di WordPress. L'avviso fornisce due pulsanti:

• Start Setup Wizard apre la First Setup Wizard, un flusso in sette passaggi (licenza, modalità, profilo del concessionario, AutoScout24, pagine, funzionalità, fine). L'attivazione della licenza è il primo passaggio obbligatorio; i passaggi rimanenti sono facoltativi.
• Skip for now 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 è appena stato registrato e la procedura guidata non è ancora stata completata o saltata. Gli aggiornamenti del plugin che non attivano una nuova attivazione da zero 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 copre solo l'installazione. I seguenti punti si applicano specificamente alla fase di installazione/attivazione:

• Slug e cartella del plugin. Il nome della cartella previsto è 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 set 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 predispone 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. Vedi Access Control and Capabilities.
• 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 amministrativo di un nuovo ZIP o sostituzione tramite SFTP della cartella del plugin). Mantieni invariati lo slug e il nome della cartella del plugin in modo da preservare le impostazioni, i veicoli e i lead. Effettua sempre un backup recente prima di aggiornare in produzione.
• Disattivazione. La disattivazione del plugin disabilita le sue funzionalità ma mantiene nel database i veicoli importati, le opzioni, i lead e i dati analitici. Il plugin rimuove i suoi dati solo al momento della disinstallazione, e solo quando la corrispondente impostazione di pulizia è abilitata. Vedi Uninstall and Data Cleanup.
• 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 installare in un ambiente multisito.
• Disciplina di produzione. Le installazioni in produzione dovrebbero seguire una procedura di rilascio documentata: backup → installazione in staging → convalida → installazione in produzione → nuova verifica. Vedi Staging to Live Migration.

---

Risoluzione dei problemi

Se il problema persiste dopo questi controlli, raccogli la diagnostica descritta nella Lista di controllo per le informazioni di supporto prima di contattare il supporto.

Documenti correlati

• Lista di controllo pre-installazione
• Requisiti tecnici di sistema
• Requisiti di API, rete e SSL
• Prima configurazione
• Configurazione delle credenziali API
• Test di connessione
• Lista di controllo per la messa in linea
• Riferimento per l'importazione universale
• Migrazione da staging a live