Installare e aggiornare il modulo

Il modulo PrestaOne collega la tua installazione PrestaShop all'app mobile. Prima installalo nel negozio, poi collega ogni telefono dalla pagina Connessioni e accessi del modulo.

Ti serve un account amministratore PrestaShop che possa installare e configurare moduli. L'account dell'app PrestaOne è un account separato: la password del back office non serve per accedere all'app.

Prima di installare

• Verifica che il negozio usi una versione di PrestaShop supportata: 1.7.8 o successiva della serie 1.7, 8 o 9. L'hosting deve soddisfare i requisiti PHP della tua versione di PrestaShop e il minimo del modulo, PHP 7.4, con le estensioni necessarie, tra cui cURL, JSON, Mbstring e OpenSSL.
• Apri il negozio pubblico tramite HTTPS. L'indirizzo da inserire nell'app è quello pubblico del negozio, non l'indirizzo privato di accesso al back office.
• Fai un backup dei file e del database del negozio prima di modificare i moduli installati. Conservalo finché non hai verificato l'installazione.
• Usa un solo contesto negozio. PrestaOne non supporta ufficialmente la funzione Multinegozio di PrestaShop. Collegare più negozi indipendenti nell'app è un'altra funzione: in quel caso installa il modulo separatamente in ciascun negozio.

Installa lo ZIP in PrestaShop

1. Sul computer apri Download di PrestaOne e scarica lo ZIP del modulo. Se hai ottenuto il modulo da un marketplace, usa il pacchetto fornito con il tuo acquisto. Non modificare lo ZIP.
2. Nel back office del negozio apri Moduli → Gestione Moduli e scegli Carica un modulo. I nomi dei menu possono variare leggermente tra le versioni di PrestaShop.
3. Seleziona lo ZIP scaricato e attendi che PrestaShop finisca il caricamento e l'installazione. Il caricamento completato non è l'ultimo controllo: PrestaShop deve confermare che l'installazione è riuscita.
4. Trova PrestaOne Mobile Bridge in Gestione Moduli e scegli Configura. Verifica che il modulo sia attivo.
5. Nel modulo apri Avanzate ed espandi Server diagnostics. Controlla i requisiti del server. Se uno non è soddisfatto, segnala quel requisito esatto al tuo hosting prima di provare a collegare un telefono.

Il modulo ha le sue schede all'interno di PrestaShop. Usa questi nomi per seguire il resto della documentazione. Ingrandisci ↗

A questo punto è normale vedere Non collegato: l'installazione crea la parte lato negozio, ma nessun telefono è ancora collegato. Prosegui con Collegare il negozio all'app.

Verifica l'installazione prima di collegare

Riapri la configurazione del modulo da Gestione Moduli. La pagina deve caricare le sue schede e mostrare l'opzione per collegare l'app mobile. Perché i controlli di collegamento funzionino, nel browser deve essere attivo JavaScript.

Apri anche una normale pagina del negozio. L'installazione del modulo non deve impedire ai visitatori di navigare o di completare il checkout. Un negozio che si apre correttamente non dimostra però che il collegamento o la live chat funzionino: hanno le loro verifiche.

Se l'installazione non riesce, annota il testo esatto dell'errore. Un limite di caricamento dei file, un'estensione PHP mancante e un errore di configurazione del modulo richiedono soluzioni diverse. Controlla Avanzate → Server diagnostics se disponibile; altrimenti invia l'errore al tuo hosting o all'assistenza PrestaOne.

Aggiorna un'installazione esistente

L'aggiornamento mantiene l'installazione esistente ed esegue i passaggi di aggiornamento del modulo. Non disinstallare il modulo per aggiornarlo. La disinstallazione elimina i dati del modulo, comprese le conversazioni della chat, i dati del recupero carrelli, le statistiche e le impostazioni di connessione.

1. Annota la versione installata in Gestione Moduli e fai un backup dei file e del database del negozio.
2. Scarica lo ZIP ufficiale più recente. Usa l'azione di aggiornamento o caricamento dei moduli di PrestaShop sull'installazione PrestaOne esistente.
3. Attendi l'esito dell'aggiornamento, poi riapri Configura. Verifica che le connessioni e le impostazioni dei servizi esistenti siano ancora presenti.
4. Nell'app aggiorna il negozio collegato e apri un ordine o un prodotto per confermare che i dati del negozio si caricano.
5. Se usi la live chat, controlla il widget sul negozio. Se usi il recupero carrelli, controlla la campagna salvata e lo stato del servizio. La sola connessione dell'app non verifica questi servizi.

Se PrestaShop segnala un aggiornamento non riuscito, conserva il backup e i dettagli dell'errore. Non disinstallare e reinstallare più volte. Se l'app indica esplicitamente che la versione del modulo non è più supportata, aggiorna il modulo prima di riprovare la connessione.

Se il modulo è installato ma non si collega

Usa Collegare il negozio all'app per la procedura di collegamento completa. Per un errore specifico, usa Risolvere problemi di connessione e di servizio.

Dietro un CDN o un reverse proxy, il negozio pubblico può usare HTTPS mentre PHP vede una connessione HTTP interna. In questo caso segui la guida al reverse proxy. Non tirare a indovinare gli indirizzi dei proxy e non disattivare le protezioni HTTPS solo per far sparire un errore.