Digital Revolution: configurazione e aiuto

Carica e installa lo ZIP Digital Revolution in Moduli > "Module Manager". Apri "Sell" > Prodotti digitali > "Settings" > Configurazione.

Seleziona il negozio desiderato. Controlla Integrità e risolvi gli avvisi di aggiornamento database prima delle operazioni di licenza. Il modulo aggiunge le aree "Catalog", "Licensing", Assistenza, "Analytics" e "Settings" sotto Prodotti digitali.

Controlla il pannello Chiavi di firma prima di pubblicare un download. L'installazione tenta di predisporre le chiavi di firma, ma gli errori restano visibili. Finché le chiavi non sono utilizzabili, non è possibile attivare licenze, scaricare moduli protetti o produrre le risposte firmate richieste dall'API licenze.

Usa un prodotto e un ordine di prova prima di aggiungere il resto del catalogo. I processi PHP/CLI devono accedere a sorgenti caricati, versioni preparate e spazio temporaneo di compilazione. Il packaging ZIP richiede ZipArchive; la crittografia richiede le funzioni usate dai servizi di firma e cifratura.

Apri "Settings" > Configurazione > Generale.

Esempi di pattern e indirizzi interni:

@yourcompany.com,*.dev.example.com,staging.example.com

127.0.0.1
192.168.1.0/24
10.0.

Un'email o un dominio inserito serve solo alla classificazione dei report. Non autorizza a evitare quote download, limiti o blocchi. Il controllo delle richieste interne attendibili usa un IP interno configurato.

Gli interruttori delle notifiche email demo per amministratori e clienti non sono disponibili nella configurazione.

In Chiavi di firma, controlla stato, ID chiave, impronta e indirizzo dell'emittente. I nuovi pacchetti si fidano dell'emittente e dell'identità pubblica di firma di questo negozio.

Per un nuovo negozio senza chiavi, usa "Set up signing keys". Esporta un backup cifrato con una password di backup e conservalo fuori dal negozio. "Download public key" fornisce la chiave pubblica per verificare le firme delle risposte quando disponibile. "Import backup" ripristina un'identità esistente; le importazioni browser sono limitate a 4 MB.

Se _MPR_DIGITAL_SIGNING_KEY_DIR_ è configurato, l'operatore del server gestisce le chiavi in quella cartella. Il pannello mostra "Use the keys in the operator folder" quando applicabile. Ripristina cartella e file configurati se quel backend non è più disponibile.

Se il negozio ha già emesso pacchetti, ripristina il backup delle chiavi prima di considerarne la sostituzione. Sostituirle crea una nuova identità; i moduli già consegnati possono smettere di fidarsi finché i clienti non scaricano di nuovo. Revoca una chiave precedente solo se vuoi rifiutare ciò che ha firmato. Il modulo richiede conferma esplicita per sostituzione e revoca.

Lo stesso servizio è disponibile dalla radice del negozio, usando l'identità del server web:

php modules/mprdigitalrevolution/scripts/signing_keys.php status

L'utilità supporta anche configurazione, esportazione/importazione cifrata, sostituzione e revoca. Legge la password del backup da MPR_SIGNING_BACKUP_PASSWORD. Usa gli argomenti documentati anziché stampare chiavi private o modificare manualmente le righe delle chiavi.

Apri "Catalog" > Prodotti e aggiungi un prodotto. Collegalo a un normale prodotto PrestaShop tramite Prodotto negozio. Il prodotto nativo collegato fornisce il contesto commerciale del negozio.

Usa "Localized Roadmap Content" per i campi tradotti Nome visualizzato, Slug SEO, Note del ramo, Descrizione Showcase, Immagine Showcase, Funzionalità Showcase, Tag Showcase e Nota non ordinabile. Contenuti tradotti vuoti non creano da soli una pagina pubblica localizzata completa.

Per un rilascio pianificato, compila Rilascio previsto e scegli Notifica al rilascio secondo necessità. L'area Iscritti mostra i visitatori interessati. Questi campi non sostituiscono il caricamento di una versione attiva.

I campi "Minimum Protection Generation", "Blocked Build IDs" e "Legacy Protection Compatibility Until" sono controlli operatore per l'accettazione di client/pacchetti. Esamina le generazioni client distribuite prima di modificarli; non servono alla prima configurazione ordinaria di un prodotto.

L'editor contiene anche Versioni, Prezzi licenza, Prezzi supporto, Servizi e Varianti. Configura scelte e prezzi effettivi da offrire, poi verifica selezione nel negozio e metadati al checkout. Non presumere che un nome prodotto o un vecchio esempio JSON configuri automaticamente tali scelte.

I download gratuiti richiedono l'idoneità al download gratuito e un prodotto collegato a prezzo zero. Il modulo prodotto non ha un interruttore separato per questa idoneità. Dopo aver impostato il prezzo, verifica l'intero flusso di acquisizione gratuita.

Apri "Catalog" > Versioni, oppure l'area Versioni del prodotto.

Usa pacchetti sorgente puliti. Se il modulo carica vendor/autoload.php, includi dipendenze di produzione e autoloader. Il packager convalida percorsi dell'archivio, radice del modulo e file principale, poi prepara la versione. Non usare come sorgente uno ZIP protetto già personalizzato di un cliente.

Una riga di versione non dimostra la prontezza alla consegna. Esegui i controlli disponibili di Prontezza del modulo e un vero download controllato. Il pacchetto protetto viene certificato lato server prima della consegna; una certificazione fallita impedisce la consegna e segnala un errore.

I pacchetti attuali possono contenere dati licenza cifrati, .mpr_license.json, un .mpr_wm locale al modulo, codice d'integrità emittente/runtime e un commento archivio MPR:<watermark ID>. I dettagli dipendono dalla modalità di consegna. Un vecchio JSON helper minimale non è un modello da copiare nelle nuove versioni.

Effettua un ordine di prova per il prodotto collegato. Gli hook di validazione e stato ordine assegnano e riconciliano i diritti. Una licenza in attesa non equivale a un accesso pagato attivo. Conferma che l'ordine raggiunga uno stato pagato/logable idoneo e controlla "Licensing" > Licenze.

Accedi come cliente di prova e apri /licenses tramite il link localizzato generato dal negozio. Controlla la scheda licenza e scarica la versione autorizzata.

Il primo download a pagamento dalla scheda licenza può essere un pacchetto firmato non ancora associato al dominio di un negozio. L'attivazione durante l'installazione lo associa al negozio. Gli aggiornamenti di un'attivazione esistente usano il negozio già associato alla licenza.

Per una demo già installata, usa Attiva nel client, accedi al portale dell'emittente e conferma la licenza. Il solo possesso della chiave non basta a creare una nuova associazione tramite le azioni ritirate di registrazione negozio/assegnazione automatica.

Controlla stato di attivazione, negozio associato, proprietà della licenza e verifica aggiornamenti del modulo installato. Esamina "Licensing" > Domini e "Installs". Usa le azioni supportate di trasferimento/cambio dominio nel portale; non modificare direttamente le righe di associazione.

La route di download pagato con token è:

/release-download/{token}

Evita la directory fisica download/ di PrestaShop. Il token della richiesta pagata dura di default 30 minuti e viene consumato al riscatto. Un servizio separato di token per artefatti preparati usa un TTL di 300 secondi. Sono fasi di token diverse. Ottieni un nuovo link dal portale quando scade o è già stato usato.

I log download collegano prodotto, versione, cliente, IP, dati di associazione, hash e identità della filigrana quando disponibili.

Validità della licenza e copertura dell'assistenza sono separate. Con assistenza attiva, il servizio può scegliere l'ultima versione attiva. Con assistenza scaduta, sceglie una versione pubblicata nella finestra di assistenza autorizzata. Una licenza perpetua valida non concede automaticamente ogni nuova versione. Servizi e pacchetti possono imporre un proprio limite temporale alle versioni.

Usa Prezzi supporto e l'integrazione checkout supportata per estensioni o assistenza ricorrente. Controlla contratto e scelte di assistenza effettivamente offerti.

In Configurazione > Servizi, "Demo Orchestrator Admin Token" parte vuoto. Ottienilo dall'amministrazione dell'orchestratore demo configurato. Non viene generato da questo formulario. Una demo ospitata richiede l'orchestratore esterno oltre al flag del prodotto.

I valori predefiniti delle note di servizio sono:

Le note possono usare {module_name}, {service_name} e {service_type}. Controlla il flag di visibilità cliente quando aggiorni un ordine servizio. Il modulo offre ordini servizio, contratti e integrazione ticket; esamina Assistenza e le relative pagine licenze/amministrazione per il cliente selezionato.

Per un pacchetto di catalogo, attiva Pacchetto, scegli Composizione del pacchetto, Aggiunte successive ed eventuali Mesi per le aggiunte. Un nuovo pacchetto usa di default la composizione da elenco e aggiunte per sempre. Salvalo come non ordinabile, poi modifica e salva ID dei prodotti inclusi nel pacchetto prima di attivare le vendite. Verifica i diritti dei prodotti figli con un ordine di prova.

L'attuale scheda "Stripe" espone Segreto webhook, vuoto per impostazione predefinita. Non espone i vecchi campi "Stripe Mode", "Test Secret Key" o "Live Secret Key". I flussi ricorrenti di pagamento/assistenza richiedono comunque l'integrazione compatibile di pagamento/abbonamento e credenziali valide.

Il modulo registra /webhook/stripe. Configura il segreto di firma corretto per quell'endpoint. In Coda di reinvio dei webhook, correggi la causa di un evento fallito, usa Rimetti l'evento in coda, poi "Resend" in Stripe. Gli eventi completati non possono essere rieseguiti con questa azione.

In Sicurezza, "Require Signed Support API Requests" è disattivo per impostazione predefinita. Attivalo dopo che i client firmati compatibili sono arrivati ai moduli dei clienti. Chiave segreta API viene generata all'installazione ed è di sola scrittura nel modulo. Rigenerarla cambia il materiale di autenticazione lato server; esamina client e token dipendenti prima di farlo.

Il pannello "Shared sign-in credentials" appare solo quando un altro modulo installato offre credenziali OAuth supportate. Esamina proprietario/impronta e concedi o revoca il riuso per questo negozio. Non è un campo per incollare chiavi Stripe arbitrarie.

Le route API usano /mpr-api/license/{action}. Il vecchio endpoint di validazione accetta chiave licenza e dominio, ad esempio:

curl -X POST 'https://yourshop.example/mpr-api/license/validate' \
  -H 'Content-Type: application/json' \
  -H 'X-License-Key: YOUR_TEST_LICENSE_KEY' \
  -d '{"domain":"example.com","module":"yourmodule","module_version":"1.2.5","ps_version":"8.2.1","php_version":"8.2"}'

Usa una vera associazione licenza/dominio di prova. Questa chiamata di validazione non crea un'associazione di attivazione. Altre operazioni richiedono autenticazione, firma o token con ambito propri. Usa il client licenze incluso per il protocollo completo di aggiornamento e attivazione.

I prodotti collegati possono aggiungere scelte di licenza, assistenza, servizi e demo tramite hook prodotto. Il changelog può apparire con le integrazioni supportate delle schede prodotto. Controlla gli hook displayProductAdditionalInfo, delle schede e dei contenuti extra del tema.

Le route pubbliche includono /roadmap, /roadmap/{slug}, /demos, /demo/{slug} e i flussi /live-demo dove attivati. /demos/{slug} resta come route legacy della pagina demo e reindirizza tramite il flusso catalogo attuale; non considerare ogni vecchio URL una pagina autonoma separata.

Prova separatamente acquisizione demo, download con un clic, accettazione termini/privacy, quote e attivazione alla prima installazione. Una concessione demo/gratuita non diventa una licenza pagata solo perché il cliente accede in seguito. Controlla concessione e proprietà corrette in Download demo e nello spazio cliente.

L'hook sitemap controlla la chiave condivisa di basso livello INCLUDE_IN_SITEMAP, inizializzata a 1. Impostarla a 0 sopprime l'output sitemap del modulo. Non è un'impostazione visibile di Generale e visibilità/indicizzabilità pubblica dipendono comunque dal singolo contenuto e dalla route.

Il CSS del tema può usare selettori esistenti come .mpr-digital-variants, .mpr-demo-link, .mpr-btn-demo, .mpr-btn-demo-download, .mpr-license-selection e .mprdigital-changelog-tab. Esamina il markup attuale prima di aggiungere override.

L'installazione registra attività pianificate condivise per analisi, licenze pagate in attesa, aggiunte ai pacchetti, revoche di diritti, attivazione/assegnazione assistenza, build abbandonate e pulizia audit demo. Configura il runner con il comando/token effettivamente generato dal modulo installato. Controlla attivazione delle attività e risultati riusciti; creare un prodotto non esegue ogni riconciliazione in background.

In Configurazione, "Retention" > "Apply retention now" elabora batch limitati, fino a 50 righe modificate per insieme di dati per passaggio. Ripeti finché il risultato indica "Repeat". Esamina i record irrisolti di pagamento, messaggi di accesso e completamento prima di considerare conclusa la pulizia storica. Log errori PHP e backend ticket esterni non rientrano in questo servizio.

I moduli di classificazione storica chiedono gli ID esaminati e il riferimento di chiusura di ogni record. Usa il record di chiusura reale, non una data di ultima modifica ipotizzata.

Se attivazione o download protetti falliscono, controlla prima Chiavi di firma, URL emittente visualizzato e Integrità. Poi verifica disponibilità della versione, certificazione del pacchetto, proprietà e stato pagato dell'ordine. Una finestra di assistenza scaduta può legittimamente escludere una versione più recente.

Se un URL download restituisce 403, verifica di usare il link generato release-download e non /download/. Se scaduto o consumato, genera un nuovo link dalla scheda licenza. Se una build è occupata, usa il flusso di nuovo tentativo supportato per quella richiesta anziché creare ripetutamente nuovi download.

Se le scelte prodotto non appaiono, controlla Prodotto negozio, Attivo, Ordinabile, stato della versione, prezzi/varianti e hook del tema. Se mancano contenuti pubblici, controlla campi localizzati e "Indexable (SEO)". Se le demo falliscono, controlla integrazione orchestratore, token, quote e protocollo pacchetto disponibile.

Usa "Analytics" > Download, "API Logs", Demo live, Popolarità prodotto e Prontezza del modulo per esaminare ogni area. Per assistenza ricorrente, controlla anche integrazione pagamenti e abbonamenti, webhook falliti e riconciliatore pianificato.

Prima di disinstallare, salva database, archivi sorgente/versioni, chiavi di firma e record necessari. Le chiavi di firma vengono conservate durante la disinstallazione. Conserva il backup cifrato e i file gestiti dall'operatore. La disinstallazione rimuove menu, attività e schema ordinario del modulo; la pulizia dei pacchetti condivisi dipende dagli altri moduli installati che li usano. Può interrompere il servizio licenze/aggiornamenti dei pacchetti già consegnati. Pianifica la continuità del loro emittente prima di rimuovere questo servizio dal negozio.

Richiede PrestaShop 1.7.0 o successivo e PHP 7.1 o successivo.