Documentazione · Note di rilascio

Limitazioni note

Questo documento riassume le limitazioni note del plugin ADP Car Market Hub nella versione corrente.

Quando utilizzare questo documento

Leggere questo documento quando si pianifica un'installazione, quando si prepara una nota informativa sui rischi per il cliente o quando si risolvono problemi relativi a comportamenti che potrebbero essere una limitazione documentata piuttosto che un bug.

L'analisi tecnica dettagliata si trova in Known Limitations And Open Risks. Questa pagina è un riepilogo più breve destinato ai lettori delle note di rilascio.

Panoramica

Il plugin è basato sui meccanismi standard di WordPress (custom post types, tassonomie, tabelle personalizzate, WP-Cron, REST e AJAX). La maggior parte delle limitazioni deriva da queste scelte di progettazione e dai servizi di terze parti con cui il plugin può opzionalmente integrarsi.

Le informazioni seguenti descrivono il comportamento osservato nel codice sorgente corrente. Verificare ciascun punto con la versione corrente del plugin prima di citarlo in un contratto con il cliente.

Limitazioni operative

Dipendenza da WP-Cron. Le importazioni pianificate, la coda delle immagini, la coda di AI Assistant e la pulizia della cronologia di analytics dipendono tutte dall'attivazione di WP-Cron. WP-Cron è guidato dalle richieste e potrebbe essere in ritardo o non attivarsi affatto su siti a basso traffico. Utilizzare un cron di sistema reale (chiamando wp-cron.php o l'endpoint REST cron-import) per un comportamento prevedibile.
Blocchi di concorrenza. Le esecuzioni dell'importatore e della coda delle immagini utilizzano blocchi transienti (as24ci_cron_import_running, as24ci_image_queue_running). Se un worker si interrompe (errore fatale PHP, timeout dell'hosting), il blocco può sopravvivere al processo. I blocchi obsoleti vengono cancellati automaticamente alla scadenza del TTL; la cancellazione manuale è necessaria solo se si desidera forzare un'esecuzione anticipata.
Budget di memoria e runtime. Importazioni molto grandi (migliaia di veicoli per esecuzione o veicoli con molte immagini) possono superare i limiti di memoria PHP o di max_execution_time su host condivisi. Regolare di conseguenza la modalità cron e i limiti di veicoli e immagini per singola esecuzione.
Modifiche manuali ai campi importati. I campi gestiti dall'importatore possono essere sovrascritti dall'importazione successiva. Utilizzare il livello di override manuale o lo slot della galleria manuale per i contenuti che devono sopravvivere alle reimportazioni.
Modalità inline a singola immagine per importazioni cron. Con la coda delle immagini abilitata (impostazione predefinita consigliata), solo la prima immagine per veicolo viene scaricata inline durante un'importazione cron. Le immagini rimanenti vengono elaborate dal worker asincrono. Se il worker non è in esecuzione, tali immagini non appariranno finché non verrà eseguito.

Limitazioni di sicurezza e accesso

Le credenziali sono memorizzate in wp_options. Il Client Secret di AutoScout24 e il segreto condiviso del webhook sono memorizzati crittografati a riposo, e il token cron è memorizzato come hash HMAC unidirezionale; le altre impostazioni e i valori delle opzioni sono memorizzati come opzioni ordinarie. Trattare i backup del database come contenenti segreti e ruotare le credenziali dopo qualsiasi sospetta compromissione. La chiave API Gemini gestita utilizzata da AI Assistant non viene inserita o memorizzata come opzione di WordPress: viene fornita centralmente tramite la API Platform di ADP Car Market Hub e recapitata al sito come credenziale crittografata e vincolata alla licenza. I clienti non inseriscono né vedono mai questa chiave.
Dipendenza dalle capability. Le pagine di amministrazione del plugin richiedono la capability manage_as24_imports (assegnata agli amministratori per impostazione predefinita). I plugin di gestione dei ruoli che rimuovono questa capability bloccheranno l'accesso degli amministratori all'amministrazione del plugin.
Gli endpoint REST pubblici sono disattivati per impostazione predefinita e dovrebbero essere abilitati solo se i loro consumatori sono noti. Gli endpoint dei preferiti e di analytics sono pubblici per progettazione quando le relative funzionalità sono abilitate, ma applicano la validazione dell'input.

Limitazioni di privacy e conformità

Analytics è opt-in ma, una volta abilitato, registra le interazioni dei visitatori in una tabella personalizzata. La modalità di richiesta del consenso è disponibile, ma l'impostazione predefinita è di consentire quando nessuna integrazione del consenso è collegata al filtro as24ci_analytics_consent_check. Verificare la gestione del consenso per la propria giurisdizione prima di abilitare analytics.
I Search Alerts memorizzano dati personali (e-mail e criteri di ricerca). La tabella as24ci_search_agents viene eliminata al momento della disinstallazione, ma i clienti devono comunque soddisfare i propri obblighi di cancellazione su richiesta durante il normale funzionamento.
AI Assistant trasmette i dati del veicolo all'endpoint Gemini gestito. Quando abilitato, i prompt e il contesto dell'annuncio vengono inviati alla configurazione gestita di Google Gemini in ADP Car Market Hub. Esaminare il trattamento dei dati applicabile e i termini contrattuali per la configurazione AI gestita prima di abilitare le funzionalità AI in produzione.
I codici QR delle schede PDF utilizzano un servizio di terze parti per impostazione predefinita. Sostituirlo con un generatore self-hosted tramite il filtro as24ci_pdf_qr_image_url se le richieste esterne nei documenti stampabili non sono accettabili.
La consegna delle e-mail utilizza wp_mail(). Il raggiungimento del destinatario da parte di una notifica dipende dal mailer configurato e da fattori esterni di recapitabilità. Il plugin registra un flag di miglior tentativo ma non garantisce la consegna.

Dipendenze esterne

Disponibilità delle API di AutoScout24. Gli errori di rete e le interruzioni del provider vengono mostrati come esecuzioni non riuscite nei log di importazione; l'assenza di dati in entrata significa che non ci saranno nuovi veicoli anche con WP-Cron attivo come da pianificazione.
Generazione PDF guidata dal browser. Il PDF datasheet si affida al motore di stampa del browser del visitatore. La precisione del layout varia tra i diversi browser.
Endpoint AI gestito. Soggetto ai limiti di frequenza di Google Gemini, alla deprecazione dei modelli e alle variazioni di prezzo al di fuori del controllo del plugin.
Ricevitori webhook. Interruzioni persistenti del ricevitore possono causare la perdita di eventi; il plugin tenta nuovamente le consegne non riuscite per un numero limitato di volte. Progettare i ricevitori in modo che siano idempotenti e che inviino una conferma rapidamente.

Avvertenze sulla documentazione

Questa documentazione descrive il comportamento osservato nel codice sorgente corrente. Laddove il codice sorgente non consenta una risposta conclusiva, il testo utilizza una formulazione prudente come "verificare con la versione corrente del plugin prima di pubblicare".
Gli identificatori dei modelli predefiniti, le lingue supportate e i valori predefiniti delle opzioni possono cambiare tra le versioni. Quando si pubblica materiale rivolto ai clienti, copiare i valori dal codice sorgente corrente del plugin anziché da questo documento alla lettera.

Mitigazioni

Configurare un cron di sistema esterno per chiamare wp-cron.php o l'endpoint REST cron-import per isolare il lavoro pianificato dal basso traffico.
Configurare backup esterni del database con crittografia e controlli di accesso appropriati.
Associare il plugin a un'integrazione SMTP o di posta transazionale per notifiche affidabili dei lead.
Utilizzare un ambiente di staging per convalidare i prompt dell'AI, i modelli PDF e i ricevitori webhook prima di applicare le modifiche in produzione.
Verificare quali ruoli possiedono manage_as24_imports e quali servizi di terze parti sono connessi.