Incorpora Alter Product nel tuo sito: WordPress + WooCommerce o API

Il plugin offre supporto pronto all'uso per WordPress e WooCommerce. L'API permette di creare un collegamento personalizzato con un'altra piattaforma, un'applicazione headless o un sistema ordini esistente.

Scegli lo strumento in base a ciò che il cliente deve fare nella pagina. Prepara in anticipo il progetto e le regole di personalizzazione in Designer.

Per incorporare Alter Product nel tuo sito serve un abbonamento Business attivo o un piano superiore che includa questa funzione. Vale sia per il plugin WordPress + WooCommerce sia per un'integrazione personalizzata tramite API. I piani Personal FREE e Personal non includono l'incorporamento nel tuo negozio.

Per usare il plugin, prepara WordPress con WooCommerce installato e attivo e un account Alter Product. Archiviare i file sul tuo hosting non sostituisce l'abbonamento richiesto: Alter Product continua a fornire l'applicazione e ad autorizzarne l'avvio.

Alter Product funziona nella pagina del negozio dentro un iframe. I browser limitano alcune funzioni utilizzate dall'applicazione se la pagina non offre un contesto sicuro. HTTPS cifra la connessione e un certificato valido permette al browser di verificare il dominio.

Il browser verifica anche la pagina che contiene l'iframe. L'indirizzo HTTPS dell'applicazione Alter Product non basta quindi se il negozio usa HTTP. HTTPS deve coprire anche il tuo sito, dove incorpori lo strumento. È una conseguenza delle regole di sicurezza dei browser per le applicazioni incorporate.

La connessione automatica ti guida nell'autorizzazione dell'account Alter Product e nella configurazione del negozio. Con questo metodo non occorre trasferire manualmente le chiavi API.

Nella modifica del prodotto WooCommerce apri la scheda Alter Product. Crea un progetto o selezionane uno esistente, poi apri Designer. Imposta la stampa, le opzioni disponibili e le aree di stampa del prodotto.

Il plugin salva file di modelli, librerie, progetti, mockup e ordini nello spazio WordPress. Anche i dati dei progetti del generatore e delle loro revisioni vengono salvati nel database di questa installazione.

Puoi aggiungere i tuoi materiali e importare risorse selezionate da Alter Product. Dopo il download utilizzi una copia locale. Importazione, ricerca di aggiornamenti e download di nuove versioni sono azioni distinte.

Gestisci libreria e progetti nel pannello WordPress con le autorizzazioni appropriate. I clienti usano gli strumenti e i materiali disponibili nel tuo negozio, senza accesso alla modifica amministrativa della libreria.

Decidi quale progetto assegnare al prodotto, dove mostrare lo strumento incorporato e quali opzioni di personalizzazione offrire. Controlla anche le risorse nella libreria del Customizer incorporato. Dopo l'assegnazione di un progetto, l'incorporamento può essere attivato per impostazione predefinita nella pagina prodotto; ne controlli la visualizzazione nelle impostazioni del prodotto.

Le risorse restano sul tuo hosting, mentre l'interfaccia degli strumenti viene caricata da Alter Product in un iframe. Il servizio Alter Product verifica l'accesso dell'account, il piano e le sessioni e fornisce il catalogo per l'importazione. L'integrazione richiede una connessione a questo servizio.

Nei backup conserva il database, la directory dei file e le chiavi e i salt WordPress necessari per leggere i dati cifrati del plugin. Potrai così ripristinare sia le grafiche visibili sia i dati necessari per continuare a lavorare.

Scegli la visualizzazione in base al layout del negozio: strumento nella pagina prodotto, pulsante verso una pagina dedicata o incorporamento tramite blocchi e shortcode disponibili. Viewer, Configurator e Customizer hanno ruoli diversi, quindi non occorre offrirli tutti insieme.

Adatta la presentazione del prodotto al tuo marchio. Nel plugin gestisci sfondi e loghi locali e le impostazioni visive degli strumenti incorporati. La disponibilità delle opzioni dipende dal piano.

Il cliente sceglie una variante e prepara la personalizzazione. Il plugin associa la configurazione e il progetto salvato alla voce del carrello e poi all'ordine WooCommerce. I mockup disponibili aiutano a riconoscere la stampa ordinata.

Configura il collegamento al fornitore scelto nelle impostazioni del plugin. Poi associa prodotto, varianti e posizioni di stampa al suo catalogo, prepara i file e richiedi la produzione dell'ordine da WooCommerce.

Puoi configurare una connessione personale a un fornitore di IA e usare le funzioni disponibili per generare o migliorare grafiche mentre lavori al progetto. Le richieste del plugin partono da WordPress verso il fornitore scelto e vengono addebitate sul tuo account presso quel fornitore.

All'avvio di uno strumento incorporato, l'integrazione ottiene un token temporaneo, cioè una chiave di sessione. Le credenziali permanenti dell'account restano sul server. Il cliente non deve copiare chiavi né accedere all'account Alter Product del proprietario.

Nell'implementazione attuale la validità predefinita del token è di 15 minuti. Il server può stabilire un'altra durata, quindi l'integrazione usa la scadenza della sessione ricevuta. Riutilizzare il token non prolunga quella scadenza. Per una nuova autorizzazione dopo la scadenza serve una nuova sessione.

Dipende dallo strumento e dalla disponibilità di una sessione adatta ancora valida. Il plugin non usa una sola sessione condivisa tra tutti i visitatori e prodotti. Le regole seguenti descrivono il comportamento attuale.

Il contatore cresce quando l'API emette con successo un nuovo token. Usare un token valido già emesso non è una nuova emissione. Per scegliere il piano, considera quindi avvii degli strumenti, ricaricamenti e riaperture, non solo ordini o visitatori.

Gli strumenti incorporati nello stesso negozio condividono un limite mensile di sessioni. Il contatore è separato per ogni negozio e segue i mesi di calendario in UTC. Anche le nuove sessioni di Designer e del Generatore di modelli incorporati nel pannello WordPress aumentano questo contatore. Scaricare un modello disponibile tramite l'API di importazione non apre, di per sé, una sessione dell'editor.

Raggiunto il limite, il sistema rifiuta di emettere nuove sessioni. È un limite d'utilizzo dell'abbonamento; verifica la quantità attualmente inclusa nel tuo piano.

La Public API usa richieste HTTP e dati JSON. Puoi quindi scrivere l'integrazione nel linguaggio e nell'ambiente del tuo backend. Non devi ricostruire il negozio in WordPress per incorporare gli strumenti Alter Product.

Ecco alcune tecnologie per realizzare il collegamento sul server. In tutte segui gli stessi passaggi: autorizzazione API, creazione della sessione dello strumento e collegamento di prodotti, carrello e ordini al tuo sistema.

Nel browser puoi usare React, Vue, Angular o semplicemente HTML e JavaScript. Anche TypeScript è adatto a implementare la comunicazione. La pagina incorpora l'iframe, gestisce eventi postMessage e si collega al tuo backend.

Il frontend gestisce l'aspetto della pagina e le reazioni del carrello, il backend le chiamate autenticate alla Public API. Nei framework che combinano entrambi i livelli, come Next.js, mantieni le chiavi permanenti e la creazione delle sessioni esclusivamente nella parte server.

Puoi mantenere il tuo checkout, sistema di pagamento, CMS e processo di evasione ordini. Nell'implementazione li colleghi ai dati del progetto e agli eventi dello strumento Alter Product scelto.

Alter Product fornisce strumenti 3D, dati dei progetti e meccanismi di sessione. Il tuo backend li collega a prodotti, account dei clienti, carrello e ordini. Puoi creare endpoint intermedi per il frontend senza esporre le credenziali Alter Product nel browser.

Per prima cosa attiva la connessione e una sessione di incorporamento per un prodotto. Aggiungi poi la gestione della configurazione, del salvataggio del progetto e degli ordini secondo lo strumento scelto.

Nelle istruzioni di incorporamento trovi parametri ed esempi. I capitoli postMessage spiegano la comunicazione con la pagina e la documentazione API descrive le operazioni del backend.

Dopo aver preparato un prodotto, percorri l'intero processo. Solo allora ripeti la configurazione verificata per gli altri articoli del catalogo.