Documentazione · Requisiti di sistema

Requisiti tecnici di sistema

Introduzione

ADP Car Market Hub è un plugin per WordPress che collega un sito WordPress all'API di AutoScout24 e trasforma l'inventario dei veicoli del concessionario in contenuti nativi di WordPress (custom post type as24ci_car con tassonomie dei veicoli, pagine di archivio, template per singolo veicolo, lead, analisi e altro ancora).

Questo documento fornisce una panoramica tecnica di alto livello su tutto ciò di cui un gestore di siti ha bisogno per pianificare, installare ed eseguire il plugin in produzione. Consolida i requisiti relativi a WordPress, hosting, PHP e database che sono documentati in dettaglio nelle altre pagine di questa sezione.

Quando utilizzare questo documento

Utilizza questo documento se stai:

  • Valutando se un ambiente di hosting WordPress esistente può eseguire ADP Car Market Hub.
  • Specificando un nuovo ambiente di hosting o una configurazione di staging/produzione per il sito di una concessionaria.
  • Eseguendo un controllo tecnico preliminare prima di installare o attivare il plugin.
  • Redigendo una scheda tecnica interna dei "requisiti di sistema" per un cliente o per il team di sviluppo.

Per maggiori dettagli su ciascun argomento, segui i link nella sezione Documenti correlati.

Panoramica

Ad alto livello, ADP Car Market Hub è un plugin autonomo per WordPress con queste caratteristiche architetturali:

  • Distribuzione: Plugin standard per WordPress, installato in wp-content/plugins/ e attivato dall'amministrazione di WordPress.
  • Intestazioni del plugin: Requires at least: 6.2, Requires PHP: 8.1 (definite nel file principale del plugin e in readme.txt).
  • Namespace PHP: Tutte le classi risiedono nel namespace AS24CI\ e vengono caricate automaticamente da includes/ e includes/admin/.
  • Custom post type: as24ci_car, con 15 tassonomie di veicoli (marca, tipo di carrozzeria, tipo di carburante, cambio, ecc.) per il filtraggio nativo in WordPress.
  • Tabelle di database personalizzate: Create all'attivazione tramite dbDelta() per veicoli, eventi analitici e avvisi di ricerca salvati. Le tabelle standard di WordPress (wp_posts, wp_postmeta, wp_term_*, wp_options) vengono utilizzate per tutto il resto.
  • API esterne: Chiamate HTTPS in uscita verso l'API ufficiale di AutoScout24 (obbligatoria) e verso l'endpoint gestito di Google Gemini (generativelanguage.googleapis.com) quando l'AI Assistant è abilitato.
  • Pianificazione: Pianificatore WP-Cron integrato con intervalli aggiuntivi, oltre a un endpoint REST protetto da token (/as24ci/v1/cron-import) per attivare le importazioni da un cron del server esterno.
  • Elaborazione in background: Le importazioni vengono eseguite in batch, una coda di immagini gestisce gli allegati in modo asincrono e un blocco di importazione (transiente, TTL di 40 minuti) impedisce l'esecuzione di cron sovrapposti.
  • Libreria multimediale: Le immagini dei veicoli vengono importate come allegati standard di WordPress in wp-content/uploads/, con conversione WebP opzionale.
  • Log: I file di log gestiti dal plugin vengono scritti in wp-content/uploads/as24ci-logs/ con rotazione a 10 MB e conservazione di 7 giorni.

Il plugin include una scheda "Sistema e Supporto" / Stato di salute all'interno dell'area amministrativa che esegue gli stessi controlli ambientali descritti in questo documento e mostra badge a semaforo, rappresentando il punto di partenza consigliato per qualsiasi convalida in produzione.

Requisiti

I valori seguenti riflettono ciò che il plugin richiede effettivamente in base alle sue intestazioni e al suo codice. Laddove il plugin verifica solo la presenza "disponibile / mancante" senza una versione specifica, questo documento segue lo stesso approccio e indica il vincolo come raccomandazione piuttosto che come minimo rigido.

Requisiti rigidi

  • WordPress: 6.2 o superiore (Requires at least: 6.2 nell'intestazione del plugin e readme.txt). Testato fino a WordPress 6.9.
  • PHP: 8.1 o superiore (Requires PHP: 8.1 nell'intestazione del plugin, readme.txt e composer.json).
  • Database: Un database supportato da WordPress (MySQL o MariaDB) nella versione supportata dalla tua release di WordPress. Il plugin utilizza $wpdb, dbDelta() e query parametrizzate; non richiede una propria versione specifica del database.
  • Estensioni PHP: openssl, curl, mbstring, json e una tra gd o imagick. La scheda Sistema e Supporto contrassegna l'ambiente come "Requisiti non soddisfatti" se una di queste è mancante.
  • HTTPS in uscita: Il server web deve essere in grado di effettuare chiamate HTTPS in uscita verso https://api.autoscout24.com (e verso https://generativelanguage.googleapis.com quando l'AI Assistant è abilitato).
  • Cron: Un meccanismo di pianificazione funzionante — o il WP-Cron integrato di WordPress, oppure un vero e proprio processo cron a livello di sistema operativo che attivi WP-Cron o l'endpoint cron REST del plugin.
  • Filesystem: Una directory di caricamento di WordPress scrivibile (wp-content/uploads/) per le immagini e per la directory dei log del plugin (wp-content/uploads/as24ci-logs/).
  • Accesso amministratore: Un utente WordPress con manage_options per installare e configurare il plugin; il plugin fornisce poi una funzionalità personalizzata (manage_as24_imports) e un ruolo "AS24 Editor" per la gestione quotidiana delegata.

Consigliati (non imposti nel codice)

  • PHP: Un ramo PHP 8.x attualmente supportato (8.2 o 8.3) per le migliori prestazioni a lungo termine e per la sicurezza.
  • memory_limit: ≥ 256 MB (la scheda Stato di salute segnala 128–255 MB come "accettabile" e < 128 MB como "troppo basso").
  • max_execution_time: ≥ 120 s per importazioni con molte immagini (la scheda Stato di salute segnala 30–60 s come accettabile, < 30 s come troppo basso, 0 = illimitato come ideale).
  • upload_max_filesize / post_max_size: Abbastanza grandi da contenere comodamente una singola immagine del veicolo ad alta risoluzione (8–16 MB è il valore tipico).
  • ZipArchive: Disponibile — utilizzato per i pacchetti di esportazione. Non strettamente richiesto per le importazioni.
  • ionCube Loader: La scheda Sistema e Supporto rileva ionCube Loader e segnala se è attivo. Le attuali versioni del plugin non sono codificate, quindi il loader non è un requisito rigido oggi; viene mostrato per compatibilità futura poiché una futura versione codificata potrebbe richiederlo. Se il tuo host può abilitare ionCube Loader per la tua versione di PHP, farlo evita qualsiasi riconfigurazione successiva.
  • TLS: Uno stack TLS moderno (TLS 1.2 o 1.3) sul lato in uscita in modo che le chiamate HTTPS a AutoScout24 e al servizio gestito Gemini abbiano successo senza soluzioni alternative manuali per i certificati.
  • Permalink personalizzati: Abilitati (qualsiasi impostazione diversa da "Semplice") in modo che gli URL dell'archivio veicoli e del singolo veicolo siano ottimizzati per la SEO.

Configurazione di produzione consigliata

Una tipica installazione di produzione si presenta così:

  • Stack: Hosting gestito per WordPress o un server LAMP/LEMP dedicato con PHP 8.1+ FPM, Nginx o Apache e MySQL 8 / MariaDB 10.6+.
  • WordPress: Ultima versione stabile di WordPress sul ramo di supporto a lungo termine attivo, con aggiornamenti automatici in background abilitati per le versioni minori.
  • Limiti PHP: memory_limit = 256M (o superiore), max_execution_time = 300, max_input_vars = 3000 per gestire comodamente moduli di mappatura di grandi dimensioni.
  • Spazio di archiviazione: Almeno diversi GB di spazio libero su disco in wp-content/uploads/ per ospitare le immagini dei veicoli. Prevedi circa 5–25 MB per veicolo a seconda del numero di immagini e dell'uso di WebP.
  • Cron: Disabilita WP-Cron al caricamento della pagina (define( 'DISABLE_WP_CRON', true );) e attiva wp-cron.php (o l'endpoint cron REST) da un vero cron del sistema operativo ogni 5–15 minuti per importazioni prevedibili.
  • Backup: Backup giornalieri esterni all'host dell'intero database WordPress e della directory wp-content/uploads/.
  • Staging: Un sito di staging separato (con la propria sandbox AutoScout24 o credenziali di sola lettura, ove possibile) per testare gli aggiornamenti del plugin e le modifiche alla mappatura dei campi prima di passarli in produzione.
  • Monitoraggio: Monitoraggio di base dell'uptime sull'URL dell'archivio pubblico e su /wp-cron.php (o sull'endpoint cron REST), oltre ad avvisi sulla crescita del registro degli errori di PHP.
  • Email: Una rotta di posta transazionale affidabile (plugin SMTP o MTA fornito dall'hosting) in modo che i lead dei moduli di contatto, le prenotazioni dei test drive e le email di double opt-in per gli avvisi di ricerca vengano recapitati.

Note operative

  • La scheda "Sistema e Supporto" del plugin nell'amministrazione di WordPress riproduce ogni controllo presente in questo documento con i valori in tempo reale del sito in esecuzione. Utilizzala dopo ogni modifica a WordPress, PHP o hosting.
  • Tutte le importazioni sono idempotenti: l'esecuzione ripetuta di un'importazione non duplica mai un veicolo, poiché il plugin effettua la corrispondenza sugli ID di AutoScout24 e utilizza gli hash del contenuto e delle immagini per il rilevamento delle modifiche.
  • La coda delle immagini limita intenzionalmente il numero di immagini scaricate per ogni ciclo di cron per evitare timeout di PHP. Su un sito nuovo, le prime esecuzioni del cron appariranno "incomplete" fino a quando la coda non sarà svuotata: questo è il comportamento previsto, non un errore.
  • La modalità Sincronizzazione completa elimina in modo permanente le auto locali (e le relative immagini) che non esistono più nell'elenco remoto di AutoScout24. Assicurati che i backup siano attivi prima di abilitarla in produzione.
  • Il plugin non bypassa il modello di utenti, funzionalità o nonce di WordPress. I plugin di sicurezza avanzati, DISALLOW_FILE_EDIT e le configurazioni di reverse-proxy sono tutti compatibili.
  • Il plugin scrive i propri log e li ruota a 10 MB. Non richiede e non sostituisce un registro degli errori a livello di server.

Risoluzione dei problemi

  • Badge "Requisiti non soddisfatti" nella scheda Sistema e Supporto: Confronta l'elenco con i Requisiti sopra indicati e correggi l'elemento mancante (in genere un'estensione PHP mancante o una versione di PHP/WordPress troppo bassa).
  • Le importazioni vanno in timeout o si interrompono a metà: Aumenta max_execution_time e memory_limit, riduci la dimensione del batch di veicoli per cron nella scheda Importazione e Limiti e assicurati che la coda delle immagini sia abilitata.
  • I veicoli vengono importati ma le immagini no: Verifica che wp-content/uploads/ sia scrivibile, che GD o Imagick siano installati e che ci sia abbastanza spazio libero su disco.
  • Il cron non si avvia: Se l'host disabilita WP-Cron, configura un cron a livello di sistema operativo per chiamare wp-cron.php o l'endpoint REST protetto da token.
  • Il controllo della connessione fallisce: La scheda Sistema e Supporto e la scheda Strumenti eseguono una piccola richiesta di annunci AutoScout24. Un errore di solito indica credenziali API errate, un Seller ID mancante o un firewall che blocca l'HTTPS in uscita verso l'host AutoScout24.
  • Errore 404 sui permalink nelle pagine dei veicoli: Salva nuovamente le impostazioni dei permalink di WordPress per svuotare le regole di riscrittura dopo aver attivato il plugin.

Documenti correlati