Support Revolution: configurazione e aiuto

Segui i passaggi in Avvio rapido.

Apri Support > Departments. Modifica i reparti multilingua installati, le descrizioni, lo stato di attivazione e l'ordine. Apri Support > Settings per le impostazioni qui sotto. Salva dopo averle modificate.

Generale

• Use Support Revolution as the shop's contact page. Predefinito: attivo. Indirizza la pagina di contatto del negozio al form di contatto del modulo, così gli invii diventano ticket. Controlla questa impostazione prima di attivare il modulo su un negozio pubblico.

• Ticket Prefix. Controlla il prefisso usato nei riferimenti dei ticket, come SR-000001; predefinito: SR. Impostalo in Support -> Settings -> General.

• Auto-Close After. Chiude automaticamente i ticket resolved dopo questo numero di giorni di inattività; predefinito: 14. Imposta 0 per disattivare la chiusura automatica.

• Max Attachment Size. Imposta la dimensione massima di caricamento per allegato in MB; predefinito: 10.

• Allowed File Types. Imposta l'elenco delle estensioni consentite per gli allegati, separate da virgole; predefinito: jpg,jpeg,png,gif,pdf,doc,docx,xls,xlsx,txt,zip,rar.

• Default Department. Seleziona il reparto usato quando un ticket viene creato senza un valore per il reparto; predefinito: 0.

• Allow Guest Tickets. Consente ai visitatori non autenticati di creare ticket di assistenza; predefinito: 1.

• Include in Sitemap. Aggiunge gli URL della knowledge base tramite l'hook gSitemapAppendUrls; predefinito: 1.

• Article Author. Predefinito: vuoto. Inserisci il nome da indicare come autore negli articoli della knowledge base e nei relativi dati strutturati. Se il campo è vuoto, viene indicato il negozio.

La modifica di Ticket Prefix influisce sui nuovi riferimenti generati. Ad esempio, HELP produce riferimenti come HELP-000001. Mantieni il riferimento atteso nell'oggetto delle risposte, così l'importazione delle e-mail può trovare la conversazione.

Per limitare maggiormente gli allegati, imposta Max Attachment Size su 5 e Allowed File Types su jpg,jpeg,png,pdf,txt. Si applicano anche i limiti di caricamento e delle richieste del server. Concedi al server web l'accesso in scrittura a upload/mprsupportrevolution/, nella directory di caricamento del negozio, per gli allegati dei ticket.

Notifiche e-mail

• Support Email. Imposta l'indirizzo di risposta dell'assistenza e il destinatario delle notifiche amministratore; predefinito: vuoto, con utilizzo dell'e-mail del negozio come alternativa.
• Notify Admin on New Ticket. Invia un'e-mail all'indirizzo dell'assistenza quando viene creato un nuovo ticket; predefinito: 1.
• Notify Admin on Customer Reply. Invia un'e-mail all'indirizzo dell'assistenza quando un cliente risponde; predefinito: 1.
• Notify Customer on New Ticket. Invia al cliente la conferma di creazione del ticket; predefinito: 1.
• Notify Customer on Admin Reply. Invia un'e-mail al cliente quando il personale pubblica una risposta non interna; predefinito: 1.
• Notify Customer on Close. Invia un'e-mail al cliente quando un ticket viene chiuso; predefinito: 1.

Usa la configurazione e-mail del negozio per verificare la consegna. Support Email fornisce l'indirizzo di risposta e il destinatario delle notifiche dell'assistenza, usando l'e-mail del negozio come alternativa. Il servizio e-mail usa i template nella directory mails/ del modulo. Le variabili passate dal relativo template possono includere {customer_name}, {ticket_reference}, {message} e {ticket_url}. Le variabili disponibili dipendono dal template e-mail.

Recupero IMAP

• Enable IMAP Fetching. Attiva il controllo periodico della casella e-mail quando l'estensione PHP IMAP è disponibile; predefinito: 0.
• IMAP Host. Imposta il nome host del server IMAP; predefinito: vuoto.
• IMAP Port. Imposta la porta del server IMAP; predefinito: 993.
• Encryption. Imposta la modalità di crittografia IMAP; predefinito: ssl. I valori accettati sono ssl, tls e none.
• IMAP Username. Imposta il nome utente per l'accesso IMAP; predefinito: vuoto.
• IMAP Password. Imposta la password per l'accesso IMAP; predefinito: vuoto. Lasciando il campo vuoto durante il salvataggio, mantieni la password attualmente memorizzata.
• IMAP Folder. Imposta la cartella della casella e-mail da monitorare; predefinito: INBOX.
• Poll Interval. Predefinito: 5 minuti. L'attività pianificata condivisa usa questo valore, con un minimo di un minuto.
• Skip Auto-Replies and Bounces. Predefinito: attivo. Preferenza salvata; il recupero pianificato della posta non usa questa impostazione per saltare le e-mail automatiche.
• Honor Server Spam Verdict. Predefinito: attivo. Preferenza salvata; il recupero pianificato della posta non usa questa impostazione per saltare i messaggi contrassegnati come spam.
• Blocked Senders. Predefinito: vuoto. Memorizza indirizzi e-mail o @domains separati da virgole; il recupero pianificato della posta non applica questo elenco di blocco.
• Max Emails per Sender per Hour. Predefinito: 10. Zero disattiva il limite; il recupero pianificato della posta non lo applica.

Inserisci una casella e-mail dedicata, ad esempio host imap.example.com, porta 993, Encryption ssl, nome utente support@example.com e cartella INBOX. Imposta la password della casella e salva. Se lasci vuoto il campo della password, viene mantenuta quella memorizzata.

Il recupero pianificato della posta richiede l'estensione PHP IMAP e l'attivazione di Enable IMAP Fetching. Senza l'estensione, il recupero pianificato rimane disattivato.

Vengono elaborati solo i messaggi non letti. Un riferimento corrispondente, come [SR-000001], collega il messaggio a un ticket esistente. I messaggi senza un ticket corrispondente creano un ticket con origine email. Gli allegati in arrivo non vengono importati. Il recupero pianificato non verifica se il mittente corrisponde all'e-mail del ticket e non applica i filtri mittente indicati sopra.

Apri Support > Contact form. Il sottomenu contiene Dashboard, Forms, Fields, Submissions e Configuration. L'installazione crea un modulo di contatto predefinito se non è presente. Seleziona il negozio corretto, controlla i campi e invialo una volta dal negozio prima di usarlo come pagina di contatto pubblica.

Usa Use Support Revolution as the shop's contact page nelle impostazioni dell'assistenza per decidere quale sistema gestisce la pagina di contatto. Controlla l'invio risultante sia in Contact form > Submissions sia in Support > Tickets. I permessi di accesso dei dipendenti a questi controller determinano chi può gestire i moduli di contatto e visualizzare gli invii.

Moduli di contatto e campi

In Forms, modifica Internal Name, il campo multilingua Form Title, Description, Success Message, Email Subject e GDPR Label. La creazione automatica genera Default Contact Form con il titolo inglese Contact us, una conferma del messaggio di contatto e un'etichetta di consenso per i dati personali. Traduci e sostituisci questi testi per il tuo negozio.

I valori predefiniti dei nuovi modelli di modulo di contatto sono Send Admin Email attivo, Admin Email vuoto, Send Customer Confirmation attivo, Enable Honeypot attivo, Enable Time Check attivo, Min Submit Time 3 secondi, GDPR Checkbox attivo e Active attivo. Controllali per ogni modulo di contatto. I ticket creati dall'assistenza usano il servizio e-mail dell'assistenza e gli interruttori delle notifiche in Support > Settings; gli interruttori generici delle e-mail di contatto non sostituiscono quelli dei ticket.

In Fields, scegli Form, traduci Label, Placeholder e Description, quindi imposta Field Name, Field Type, Required, Options, Position e Active. Per un campo di selezione, usa un'opzione per riga. Il modulo di contatto predefinito ha i campi obbligatori Full Name, Email Address, Subject e Message, con Phone Number facoltativo. Mantieni i nomi interni subject e message se vuoi che questi valori vengano associati all'oggetto e al messaggio del ticket. Gli altri valori vengono aggiunti come testo con etichette.

Impostazioni del modulo di contatto

Il pacchetto di contatto condiviso memorizza le proprie impostazioni separatamente da quelle dei ticket. Apri Contact form > Configuration e controlla:

Theme styles usa i valori condivisi del tema rilevato. I valori predefiniti specifici per il contatto includono Form spacing 20px, WhatsApp color #25D366 e le ombre normali/rialzate delle schede del pacchetto. Modificali dopo aver controllato il modulo di contatto visualizzato.

Usa Dashboard e Submissions per controllare l'attività di contatto e il ticket collegato a un invio. Dopo aver modificato le impostazioni antispam, prova un messaggio consentito e un invio rifiutato.

URL cron del front office del modulo

Copia l'URL completo dal pannello Cron Job in Support > Settings. Ha questa forma:

https://your-shop.com/module/mprsupportrevolution/cron?token=YOUR_SUPPORT_CRON_TOKEN

Usa il CRON_TOKEN del modulo, generato come sequenza di 32 caratteri esadecimali durante l'installazione della configurazione. Regenerate Token invalida il vecchio URL, quindi aggiorna il pianificatore dopo questa operazione.

Il front controller esegue il controllo IMAP, se consentito, e la chiusura automatica ogni volta che lo richiami. Non applica autonomamente gli intervalli delle attività condivise. Ad esempio, richiamalo ogni cinque minuti se questa è la frequenza di controllo che hai scelto. La chiusura automatica riguarda i ticket risolti più vecchi di Auto-Close After; zero la disattiva.

Esecutore CLI condiviso

Se usi il pianificatore MPR comune, il suo punto di ingresso CLI è:

php /var/www/html/modules/mprsupportrevolution/cron.php --token=YOUR_SHARED_MPR_CRON_TOKEN --max-tasks=20 --max-seconds=55 --context=cron

Sostituisci il percorso di installazione e usa il token cron condiviso della tua configurazione cron MPR. È diverso dal token dell'URL dell'assistenza. L'esecutore convalida il valore globale TOKEN di mprcron, generato come sequenza di 64 caratteri esadecimali quando necessario. Può eseguire le attività giunte a scadenza di più moduli MPR tramite il pianificatore condiviso.

Le attività dell'assistenza sono il controllo IMAP secondo Poll Interval, la chiusura automatica dei ticket risolti ogni 3600 secondi e il controllo delle modifiche alla cache della knowledge base ogni 300 secondi. Una chiamata CLI ogni minuto consente al pianificatore di rispettare questi intervalli. Controlla i risultati e gli errori delle attività dopo la prima esecuzione.

I clienti aprono My Tickets dal proprio account. Con le route predefinite, possono consultare i ticket su /my-support, crearli su /my-support/create e aprirli su /my-support/ticket/{id_ticket}. Usa i link generati per includere il prefisso del negozio e della lingua.

Il modulo di creazione raccoglie oggetto, reparto, messaggio, allegati facoltativi e consenso GDPR. I nuovi ticket iniziano con priorità media. Per i clienti autenticati viene usata l'identità dell'account. Gli ospiti inseriscono nome ed e-mail se Allow Guest Tickets è attivo. I link dei ticket ospite includono un token privato. Mantieni il link completo quando verifichi l'accesso degli ospiti.

Apri Support > Dashboard per conteggi, riepiloghi per stato e messaggi recenti. Usa Support > Tickets per filtrare per riferimento, cliente, e-mail, stato, priorità, reparto, assegnatario, numero di messaggi e date. Apri un ticket per rispondere, aggiungere una nota interna, allegare file, cambiare stato o priorità e assegnare un dipendente. L'assegnazione di un ticket aperto lo porta a in_progress.

Gli stati sono open, in_progress, waiting, resolved e closed. Le priorità sono low, medium, high e urgent. Non esiste un editor per aggiungere valori personalizzati di stato o priorità. Le note interne restano nel back office. I ticket chiusi non mostrano il modulo di risposta del cliente.

Concedi ai dipendenti solo i permessi per ticket e reparti necessari al loro lavoro. Controlla una nota interna da un account cliente per confermare che sia nascosta.

Il modulo fornisce una knowledge base pubblica con route localizzate per categorie e articoli, monitoraggio delle visualizzazioni, feedback sull'utilità, output canonical/SEO e contributi alla sitemap. Nel menu amministrativo del modulo non è presente un editor per categorie o articoli. Pubblica i contenuti tramite il tuo flusso di pubblicazione esistente.

Le route tipiche sono:

/knowledge-base
/knowledge-base/{category}
/knowledge-base/{category}/{article}

Il segmento di base viene preso dalla categoria CMS localizzata con ID 5, quando disponibile. I segmenti URL alternativi usano l'ID lingua: 1 knowledge-base, 2 wissensdatenbank, 3 base-de-connaissances, 4 baza-wiedzy, 5 base-di-conoscenza e 6 base-de-conocimientos. Una diversa disposizione degli ID lingua può quindi cambiare il segmento alternativo visualizzato. Segui i link generati invece di presumere una corrispondenza tra codice ISO e segmento URL.

L'indicizzazione degli articoli segue l'impostazione di indicizzazione della categoria. Gli articoli 46 e 52 sono sempre esclusi dall'indicizzazione. Gli articoli indicizzabili possono generare dati strutturati di tipo articolo. Include in Sitemap abilita gli URL idonei tramite gSitemapAppendUrls; un generatore di sitemap compatibile deve utilizzare questo hook.

1. Invia un ticket di prova come cliente e, se l'opzione è attiva, come ospite. Verifica la notifica amministratore, la conferma al cliente e il link privato dell'ospite.
2. Rispondi dal back office. Verifica l'e-mail del cliente e la conversazione. Aggiungi una nota interna e controlla che rimanga privata.
3. Prova un allegato consentito e un file troppo grande o non consentito. Controlla i limiti di caricamento PHP se il file consentito non viene caricato.
4. Invia un'e-mail non letta con un riferimento di prova, richiama il pianificatore scelto e controlla che venga gestita una sola volta. Se non viene recuperata alcuna e-mail, controlla disponibilità dell'estensione, credenziali, cartella, stato non letto e token.
5. Risolvi un ticket di prova e controlla nell'output del pianificatore l'elaborazione della chiusura automatica. Non ridurre un'impostazione di inattività in produzione solo per testare vecchi ticket.
6. Apri i contenuti esistenti della knowledge base in ogni lingua. Controlla la generazione delle route e l'idoneità alla sitemap separatamente dalle pagine dei ticket.

Se un URL cron restituisce Invalid token, copialo nuovamente dal pannello corretto. Un token dell'URL dell'assistenza non autentica l'esecutore CLI condiviso. Se la casella si connette ma un messaggio rimane fuori dalla conversazione, controlla il prefisso del riferimento e lo stato non letto. Se la conferma al cliente non arriva, controlla Notify Customer on New Ticket, la configurazione e-mail e i log di consegna della posta.

Usa questi percorsi di override dei template nel tema attivo:

themes/your-theme/modules/mprsupportrevolution/views/templates/front/ticket_create.tpl
themes/your-theme/modules/mprsupportrevolution/views/templates/front/ticket_view.tpl
themes/your-theme/modules/mprsupportrevolution/views/templates/front/tickets_list.tpl
themes/your-theme/modules/mprsupportrevolution/views/templates/hook/displayCustomerAccount.tpl

Inserisci il CSS nel foglio di stile personalizzato del tema. Carica il CSS tramite le impostazioni dei fogli di stile del tema. I selettori utili sono #mprsupportrevolution-link, .mpr-support, .mpr-support__hero, .mpr-support__card, .mpr-support__status--open, .mpr-support__status--in_progress, .mpr-support__status--waiting, .mpr-support__status--resolved, .mpr-support__status--closed, .mpr-support__message--staff e .mpr-support__message--customer.

Disattiva il modulo in Gestione moduli per interrompere la sua integrazione nel negozio. Prima di disinstallarlo, esegui il backup di ticket, messaggi, allegati, moduli di contatto, invii, contenuti della knowledge base e impostazioni. Rimuovi o aggiorna i cron job. La disinstallazione rimuove attività pianificate, pagine amministrative, configurazione e tabelle del database del modulo. I file degli allegati memorizzati rimangono dopo la disinstallazione; esaminali separatamente dopo averne eseguito il backup.