Tutta la documentazione

Issue Tracker — Documentazione

Issues & FAQ Revolution le permette di pubblicare problemi noti, avvisi in stile FAQ, note di compatibilità, correzioni e soluzioni alternative per i prodotti del suo negozio PrestaShop. I clienti possono consultare un hub pubblico Known Issues o una scheda nella pagina prodotto prima di aprire un ticket di supporto.

Funzionalità

  • Hub pubblico Known Issues. Il modulo aggiunge un tracker nel front office all’indirizzo /known-issues per voci in attesa, aperte, risolte, chiuse e che non verranno corrette.
  • Scheda problemi nella pagina prodotto. L’hook displayProductExtraContent aggiunge alle pagine prodotto una scheda Known Issues con il conteggio dei problemi aperti e totali.
  • Gestore problemi nel back office. Il controller AdminMPRIssuesRevolutionIssues fornisce un elenco ricercabile con colonne per prodotto, titolo, stato, gravità, fonte, voti, ETA, attivo e indicizzabile.
  • Schede problema dettagliate. Ogni voce può memorizzare un prodotto, titolo e slug multilingue, descrizione, versioni interessate, passaggi di riproduzione, soluzione alternativa, nota di risoluzione, stato, gravità, segnalazioni ed ETA della correzione.
  • Modulo di segnalazione per i clienti. L’endpoint pubblico di segnalazione salva le segnalazioni inviate come voci in attesa, con protezione CSRF, campo honeypot e limite di 3 invii all’ora per mittente.
  • URL pubblici puliti per i problemi. Le singole pagine problema usano slug leggibili come /known-issues/checkout-validation-error, mentre i vecchi URL basati su ID reindirizzano alla versione pulita.
  • Strumenti per navigare nel tracker. L’hub pubblico include riepiloghi di stato, sezioni recenti per elementi in attesa/aperti/risolti, ricerca, filtro per stato, ordinamento e controlli per elementi per pagina.
  • Controlli SEO. L’hub usa la policy SEO del modulo per robots, hreflang, URL canonici e idoneità alla sitemap; le pagine di dettaglio problema e di segnalazione restano escluse da indicizzazione, hreflang, sitemap e output schema.
  • Integrazione sitemap. L’hook gSitemapAppendUrls può aggiungere l’hub alle sitemap XML quando l’inclusione nella sitemap è attiva.
  • Stili front compatibili con il tema. Il modulo registra il CSS front tramite ThemeDetector ed espone classi stabili come .mprissues-page, .mprissues-wrapper, .mpr-f-item e .mpr-f-badge.
Issue Tracker — Product known issues tab Issue Tracker — Mprissuesrevolution issue detail status and notes

Opzioni di configurazione

Imposti queste opzioni in Improve -> Issues -> Settings -> Configuration.

  • Abilita visualizzazione front. Attiva o disattiva la scheda prodotto e le pagine pubbliche Known Issues; predefinito: 1.
  • Stato predefinito per i nuovi problemi. Imposta se le nuove voci del back office partono come open o resolved; predefinito: open.
  • Consenti agli utenti di segnalare problemi. Mostra il modulo pubblico di segnalazione e salva gli invii validi come segnalazioni in attesa; predefinito: 1.
  • Includi l’hub Known Issues nella sitemap. Consente di aggiungere l’hub tramite l’hook sitemap; predefinito: 1.
  • Consenti l’indicizzazione dell’hub Known Issues. Permette all’hub principale di usare il comportamento SEO index/follow; predefinito: 1.
  • Consenti l’indicizzazione delle singole pagine problema. Campo di configurazione per l’indicizzazione delle pagine problema; predefinito: 0. Nella policy SEO attuale del modulo, le pagine di dettaglio problema restano non indicizzabili e sono escluse da hreflang, sitemap e output schema.
  • Titolo scheda. Imposta il titolo multilingue mostrato nelle schede prodotto; predefinito: Known Issues.
  • Mostra date. Visualizza le date di segnalazione e aggiornamento nelle viste dei problemi nel front office; predefinito: 1.
  • Mostra badge di stato. Visualizza etichette di stato come Pending, Open, Resolved, Closed e Won't fix; predefinito: 1.
  • Nascondi scheda quando vuota. Nasconde la scheda prodotto quando il prodotto non ha problemi pubblici attivi; predefinito: 1.
Issue Tracker — Known issues hub Issue Tracker — Mprissuesrevolution product tab known issues

Esempi di personalizzazione

Valori di configurazione di esempio per un tracker pubblico in cui i clienti possono leggere le voci ma non inviare nuove segnalazioni:

enabled=1
allow_reporting=0
INCLUDE_IN_SITEMAP=1
ISSUES_HUB_INDEXABLE=1
ISSUE_INDEXABLE=0

Esempio di voce problema per il back office:

Product: Checkout module
Title: Checkout button hidden after theme update
URL slug: checkout-button-hidden-after-theme-update
Status: open
Severity: high
Affected module versions: 2.4.0 - 2.5.2
Affected PrestaShop versions: PrestaShop 8.1 - 8.2
Workaround: Disable the theme's custom checkout override until the next module update.
Active: 1
Index this issue page: 0

Esempio di voce risolta:

Status: resolved
Fixed in version: 2.5.20
Resolution note: Fixed compatibility with the updated checkout template.

Valori supportati per stato e gravità:

status: pending, open, resolved, closed, wontfix
severity: low, medium, high, critical
source: admin, user

URL pubblici che può condividere nelle risposte di supporto:

/known-issues
/known-issues/report
/known-issues/checkout-validation-error

Gli stati di richiesta per stato, prodotto, ricerca, ordinamento e paginazione reindirizzano all’URL base dell’hub.

Il titolo della scheda prodotto mostra automaticamente il conteggio dei problemi pubblici aperti e totali:

Known Issues
Known Issues (2/5)

Può modificare lo stile del front office dal CSS del suo tema usando le classi del modulo:

.mprissues-wrapper .mpr-f-badge--open {
  background: #dc2626;
  color: #fff;
}

.mprissues-detail-panel--workaround {
  border-left-color: #d97706;
}

.mprissues-severity--critical {
  color: #b91c1c;
}

Percorsi di override dei template del tema, quando il suo tema richiede markup personalizzato:

/themes/your-theme/modules/mprissuesrevolution/views/templates/hook/product-tab.tpl
/themes/your-theme/modules/mprissuesrevolution/views/templates/front/issues.tpl
/themes/your-theme/modules/mprissuesrevolution/views/templates/front/issue.tpl

L’URL pubblico dell’hub è controllato dalla voce meta PrestaShop installata dal modulo:

page: module-mprissuesrevolution-issues
default URL rewrite: known-issues
default title: Known Issues & Bug Tracker
Issue Tracker — Report issue modal Issue Tracker — Mprissuesrevolution product tab report form

Installazione

  1. Nel suo back office, vada in Modules -> Module Manager.
  2. Faccia clic su Upload a module e selezioni il file ZIP del modulo.
  3. Installi il modulo.
  4. Apra Improve -> Issues per creare o controllare le voci problema.
  5. Apra Settings -> Configuration per impostare visualizzazione, segnalazioni, sitemap e comportamento di indicizzazione.
Issue Tracker — Product issues lazy details Issue Tracker — Mprissuesrevolution public tracker status and highlights

Come funziona

Nel back office crea una voce problema o FAQ, sceglie il prodotto interessato, imposta stato e gravità, quindi aggiunge la spiegazione pubblica, la soluzione alternativa, la versione di correzione o la nota di risoluzione.

I clienti vedono le informazioni in due punti: una scheda Known Issues nella pagina prodotto e l’hub pubblico Known Issues. L’hub mostra conteggi riepilogativi, elementi recenti in attesa, elementi aperti, elementi risolti, ricerca, filtro per stato, ordinamento e link alle singole pagine problema.

Issue Tracker — Mprissuesrevolution admin issue editor

Limiti trasparenti

  • Il modulo pubblica informazioni sui problemi; non rileva automaticamente bug nel suo negozio.
  • Le segnalazioni pubbliche non includono caricamenti di file o screenshot. I clienti che devono inviare allegati devono usare il suo normale canale di supporto.
  • Le segnalazioni inviate vengono salvate come in attesa, quindi qualcuno deve comunque esaminarle prima di trattarle come confermate.
  • Le singole pagine problema restano non indicizzabili secondo la policy SEO del modulo, anche quando nel back office esiste il flag indicizzabile per singolo problema.
  • Ogni problema è collegato a un ID prodotto, quindi il modulo è più adatto a cataloghi di prodotti, moduli o servizi.
  • Per le lingue non predefinite, il contenuto inglese clonato del problema può rimanere nascosto finché il titolo o la descrizione localizzati non differiscono dalla versione della lingua predefinita.
Issue Tracker — Mprissuesrevolution admin issue list filters

FAQ

Issues & FAQ Revolution è visibile ai clienti?
Sì. Quando la visualizzazione front è abilitata, i clienti possono vedere l’hub pubblico Known Issues e la scheda nella pagina prodotto.

I clienti possono inviare segnalazioni di problemi?
Sì. Le segnalazioni pubbliche vengono salvate come voci in attesa e possono essere esaminate nel back office.

Posso collegare un problema a un prodotto o modulo specifico?
Sì. Ogni problema appartiene a un ID prodotto, e le pagine di dettaglio problema possono rimandare al prodotto interessato e alla sua pagina di documentazione.

Posso mostrare un problema noto solo nel back office?
Sì. Disattivi la voce con il suo interruttore Active se non vuole mostrarla pubblicamente.

Le singole pagine problema possono essere indicizzate dai motori di ricerca?
No. L’attuale policy SEO del modulo mantiene le pagine di dettaglio problema non indicizzabili e le esclude da hreflang, sitemap e output schema.

Il modulo aggiunge URL alla sitemap?
Sì, quando l’inclusione nella sitemap è attiva. L’hub può essere incluso; le pagine di dettaglio problema vengono saltate dalla policy SEO attuale.

Posso cambiare l’URL pubblico da /known-issues?
Sì. Modifichi la riscrittura URL per la pagina meta PrestaShop module-mprissuesrevolution-issues in Shop Parameters -> Traffic & SEO.

Screenshot o allegati file sono supportati nelle segnalazioni?
No. Il modulo di segnalazione integrato salva solo prodotto selezionato, titolo, descrizione e indirizzo e-mail.

Compatibilità: da PrestaShop 1.6 a 9.0 (ultima versione), PHP 7.1+. Continuiamo a supportare le prossime versioni di PrestaShop.

Issue Tracker — Mprissuesrevolution integrity checks
Torna su