Virtual Products Management Pro - File Scaricabili per Combinazione con Versioni e Sincronizzazione GitHub

Il problema di PrestaShop 9 che questo modulo risolve

In PrestaShop 9, "Prodotto virtuale" e "Prodotto con combinazioni" sono tipi di prodotto che si escludono a vicenda. Non è un problema finché non vendi software, e-book, campioni o licenze in più di una variante — Standard e Pro, singola postazione e team, Windows e macOS — perché nel momento in cui ti servono le combinazioni, il campo file del prodotto virtuale integrato scompare.

Questo modulo gestisce i file scaricabili al di fuori del sistema dei prodotti virtuali di PrestaShop. Crea il prodotto come Prodotto con combinazioni, definisci le varianti e carica un file su ciascuna. Ogni combinazione ottiene il proprio file, il proprio numero di versione e il proprio registro delle modifiche.

Una sola pagina invece di un prodotto per volta

I file dell'intero catalogo vivono su una sola schermata. Espandi un prodotto, vedi le sue combinazioni, carica o sostituisci un file, imposta la versione, scrivi il registro delle modifiche. Sette contatori in cima ti dicono a che punto sei con un colpo d'occhio — File virtuali, Prodotti, File combinazioni, File semplici, File mancanti, Download totali e Clienti — così un prodotto il cui file non è mai stato caricato compare qui in rosso, invece di essere scoperto da un cliente.

Ogni file porta con sé anche il proprio limite di download, la validità in giorni e la data di scadenza: una licenza può quindi avere una durata definita anziché essere consegnata per sempre. Funziona qualunque formato scaricabile: ZIP, PDF, MP3, FLAC, EPUB o qualsiasi altra cosa tu venda.

Collega una combinazione a GitHub e smetti di caricare file

Ogni combinazione funziona in una delle due modalità: Carica file oppure Repository GitHub. Passa a GitHub, indica un owner/repo e, se vuoi, un branch o un tag: un unico pulsante Recupera / Sincronizza da GitHub recupera insieme il file, la versione e il registro delle modifiche — creando il pacchetto della release, estraendo la versione e leggendo gli oggetti dei commit recenti lato server, invece di limitarsi a riempire un campo nel tuo browser.

I repository privati sono supportati tramite Personal Access Token. Imposta una volta un token predefinito per tutto il negozio e sovrascrivilo per singolo prodotto quando un repository diverso richiede credenziali diverse.

Una tabella Recent Sync Log (registro delle sincronizzazioni recenti) riporta cosa è realmente accaduto a ogni esecuzione — prodotto, combinazione, stato, messaggio e data — mostrando il passaggio dalla versione precedente a quella nuova, oppure esplicitamente "no version change" quando un'esecuzione non ha trovato nulla. Sopra la tabella c'è la data e l'ora di Last automatic run (ultima esecuzione automatica), così capisci a colpo d'occhio se la sincronizzazione pianificata è davvero partita o non è mai stata eseguita.

Una precisazione onesta: la sincronizzazione oraria si appoggia al sistema di attività cron di PrestaShop, che per essere avviato ha bisogno di un vero cron esterno sul tuo server. Finché non lo hai configurato, il pulsante manuale Recupera / Sincronizza fa lo stesso lavoro su richiesta — e la riga Last automatic run continuerà a dire never, che è esattamente il motivo per cui viene mostrata.

Di' ai tuoi clienti che c'è un aggiornamento

Ogni combinazione ha il proprio pulsante Notifica clienti, che invia un'e-mail ai clienti che hanno acquistato quel prodotto per avvisarli che è disponibile una nuova versione. Per qualsiasi cosa venduta come licenza o come strumento di lavoro, quel singolo pulsante è la differenza tra un cliente che fa l'upgrade e uno che si dimentica di averlo comprato.

I clienti hanno una vera area download

Chi acquista vede i propri file nel proprio account e nella pagina di dettaglio dell'ordine, con la versione a cui ha diritto. È la normale esperienza dell'account PrestaShop, estesa per coprire i file per combinazione che il core non è in grado di rappresentare.

Cosa ha corretto la versione 1.5.x

La versione 1.5.2 ha corretto una serie di difetti reali che vale la pena conoscere, perché sono di quelli che restano nascosti per mesi.

Il campo del registro delle modifiche non poteva mai essere aggiornato dalla sincronizzazione. Entrambi i percorsi di sincronizzazione omettevano changelog dalla propria istruzione UPDATE, quindi una volta creata la riga di una combinazione il campo restava congelato all'ultimo testo inserito a mano — e nessuno dei due percorsi recuperava affatto il contenuto del changelog da GitHub lato server. Ora la sincronizzazione legge da sé gli oggetti dei commit recenti del ref risolto e li salva nella stessa operazione, sia sul percorso manuale sia su quello automatico.

Il percorso di sincronizzazione manuale e quello automatico erano divergenti. L'endpoint manuale reimplementava in modo indipendente le chiamate a GitHub, la gestione dello zip e l'estrazione della versione, così una correzione applicata a uno non si applicava silenziosamente all'altro. Ora il percorso manuale delega alla classe di sincronizzazione condivisa — continuando però a prendere repository e ref dal form che hai davanti, in modo che provare prima di salvare funzioni ancora.

La sincronizzazione oraria registrava sempre "success" senza alcun dettaglio, anche quando non era cambiato nulla, il che rendeva il registro inutile per distinguere un'esecuzione tranquilla da un fallimento silenzioso. Inoltre le installazioni nuove non registravano mai l'hook cron — lo faceva solo il blocco di autoriparazione della pagina di configurazione, quindi la sincronizzazione oraria non poteva partire fino a quando un amministratore non apriva per caso quella pagina. Ora l'installazione lo registra direttamente.

Un aspetto da pianificare

Poiché il prodotto non è contrassegnato come Virtuale in PrestaShop, il calcolo standard delle spese di spedizione continua ad applicarsi. Per tenere questi prodotti liberi da spese di spedizione, assegnali a un trasportatore con una regola a costo zero / spedizione gratuita. È un passaggio di configurazione da fare una sola volta, e la pagina di configurazione del modulo lo dice chiaramente invece di lasciartelo scoprire su un ordine reale.

Compatibilità

PrestaShop 1.7, 8 e 9, in otto lingue: italiano, francese, inglese, olandese, polacco, spagnolo, tedesco e turco. Compatibile con il multinegozio. La disinstallazione rimuove i dati del modulo e i file virtuali che gestisce, come dichiara esplicitamente la conferma di disinstallazione — quindi fai prima una copia se intendi reinstallarlo.

Domande frequenti

Perché mi serve su PrestaShop 9?

Perché PS 9 rende Prodotto virtuale e Prodotto con combinazioni mutuamente esclusivi. Se vendi un prodotto scaricabile in più edizioni o livelli, il core non può dare a ogni variante il proprio file. Questo modulo sì.

Ogni combinazione può avere un file e una versione diversi?

Sì — il proprio file, il proprio numero di versione e il proprio registro delle modifiche. È esattamente lo scopo del modulo.

Come funziona la sincronizzazione con GitHub?

Porta una combinazione in modalità Repository GitHub, indica un owner/repo più un branch o un tag opzionale e premi Recupera / Sincronizza da GitHub: recupera file, versione e changelog in un colpo solo. I repository privati funzionano tramite un Personal Access Token, impostato una volta come predefinito del negozio e sovrascrivibile per singolo prodotto. La sincronizzazione automatica oraria richiede inoltre l'esecutore di attività cron di PrestaShop, avviato da un vero cron sul tuo server.

I miei clienti sapranno quando pubblico un aggiornamento?

Sì, se premi Notifica clienti sulla combinazione: invia un'e-mail ai clienti che hanno acquistato quel prodotto.

Su questi prodotti verranno addebitate le spese di spedizione?

Può succedere, perché PrestaShop non li considera virtuali. Assegnali a un trasportatore con una regola di spedizione gratuita e l'addebito scompare.

Quali tipi di file sono supportati?

ZIP, PDF, MP3, FLAC, EPUB e qualsiasi altro formato scaricabile.

Come individuo un prodotto a cui manca il file?

Tra i contatori in cima alla pagina c'è la voce File mancanti, così una lacuna emerge lì e non nel reclamo di un cliente.

Cosa succede se disinstallo?

I dati del modulo e i file virtuali che gestisce vengono eliminati — la conferma lo dichiara. Conserva una copia di tutto ciò che ti servirà di nuovo.