Bygg inn Alter Product på nettstedet ditt: WordPress + WooCommerce eller API

Utvidelsen gir ferdig støtte for WordPress og WooCommerce. Med API-et kan du bygge en egen forbindelse til en annen plattform, en headless-applikasjon eller et eksisterende bestillingssystem.

Velg verktøy ut fra hva kunden skal gjøre på nettstedet. Designet og reglene for tilpasning klargjør du på forhånd i Designer.

For å bygge inn Alter Product på ditt eget nettsted trenger du et aktivt Business-abonnement eller et høyere abonnement som inkluderer denne funksjonen. Dette gjelder både WordPress + WooCommerce-utvidelsen og en egen integrasjon gjennom API-et. Personal FREE og Personal inkluderer ikke innbygging i din butikk.

Hvis du velger utvidelsen, trenger du WordPress med WooCommerce installert og aktivert samt en Alter Product-konto. Lagring av filer på eget webhotell erstatter ikke abonnementet som kreves: Alter Product leverer fortsatt applikasjonen og autoriserer oppstarten av den.

Alter Product kjører på butikkens nettsted i en innebygd iframe. Nettlesere begrenser tilgangen til noen av funksjonene applikasjonen bruker hvis siden ikke har en sikker kontekst. HTTPS krypterer forbindelsen, og et gyldig sertifikat lar nettleseren verifisere domenet.

Nettleseren kontrollerer også siden som omgir iframe-en. Derfor er ikke HTTPS-adressen til Alter Product-applikasjonen alene nok når butikken kjører over HTTP. HTTPS må også omfatte siden der du bygger inn verktøyet. Dette følger av nettlesernes sikkerhetsregler for innebygde applikasjoner.

Automatisk tilkobling veileder deg gjennom autorisering av Alter Product-kontoen og oppsett av butikken. Du trenger ikke å overføre API-nøkler manuelt med denne metoden.

Åpne fanen Alter Product i redigeringen av WooCommerce-produktet. Opprett et nytt design eller velg et eksisterende, og åpne deretter Designer. Angi trykk, tilgjengelige alternativer og trykkområder for produktet.

Utvidelsen lagrer filer for modeller, biblioteker, design, mockuper og bestillinger i WordPress-lagringsområdet. Data om generatorprosjekter og revisjonene deres lagres også i databasen for denne installasjonen.

Du kan legge til egne materialer og importere utvalgte ressurser fra Alter Product. Etter nedlasting bruker du en lokal kopi. Import, søk etter oppdateringer og nedlasting av nye versjoner er separate handlinger.

Du administrerer biblioteket og designene i WordPress-kontrollpanelet med de nødvendige tilgangsrettighetene. Kundene bruker verktøyene og materialene som er gjort tilgjengelige i butikken din, uten tilgang til administrativ redigering av biblioteket.

Du bestemmer hvilket design du kobler til produktet, hvor du viser det innebygde verktøyet, og hvilke tilpasningsmuligheter du tilbyr. Kontroller også ressursene som er tilgjengelige i biblioteket til den innebygde Customizer. Etter at et design er tilordnet, kan innbygging være aktivert som standard på produktsiden; visningen styrer du i produktinnstillingene.

Du lagrer ressursene hos deg, mens verktøyenes grensesnitt lastes fra Alter Product i en innebygd iframe. Alter Product-tjenesten kontrollerer kontotilgang, abonnement og økter og leverer katalogen for import. Integrasjonen krever tilkobling til denne tjenesten.

Ta vare på databasen, filmappen samt WordPress-nøklene og saltene som kreves for å lese utvidelsens krypterte data når du sikkerhetskopierer. Da kan du gjenopprette både den synlige grafikken og dataene som trengs for å fortsette arbeidet.

Velg visningsmåten ut fra butikkens oppsett: et verktøy på produktsiden, en knapp til en egen side eller innbygging med tilgjengelige blokker og kortkoder. Viewer, Configurator og Customizer har ulike roller, så du trenger ikke å tilby kunden alle samtidig.

Tilpass produktvisningen til merkevaren din. I utvidelsen administrerer du lokale bakgrunner og logoer samt utseendeinnstillinger for de innebygde verktøyene. Tilgjengeligheten av de enkelte alternativene avhenger av abonnementet.

Kunden velger en variant og lager sin tilpasning. Utvidelsen kobler konfigurasjonen og det lagrede designet til en varelinje i handlekurven og senere i WooCommerce-bestillingen. Tilgjengelige mockuper gjør det enklere å identifisere det bestilte trykket.

Sett opp forbindelsen til valgt leverandør i utvidelsens innstillinger. Koble deretter produktet, variantene og trykkplasseringene til leverandørens sortiment, klargjør filene og send bestillingen til produksjon fra WooCommerce.

Du kan sette opp din egen forbindelse til en AI-leverandør og bruke de tilgjengelige funksjonene for å generere eller forbedre grafikk mens du arbeider med et design. Forespørsler fra utvidelsen sendes fra WordPress til valgt leverandør og faktureres på kontoen din hos leverandøren.

Når et innebygd verktøy starter, henter integrasjonen et kortvarig token, altså en øktnøkkel. Kontoens faste tilgangsopplysninger forblir på serveren. Kunden trenger ikke å kopiere nøkler eller logge inn på eierens Alter Product-konto.

I den nåværende implementasjonen er tokenets standardgyldighet 15 minutter. Serveren kan angi en annen varighet, så integrasjonen bruker utløpstidspunktet for økten den mottar. Gjenbruk av tokenet forlenger ikke dette tidspunktet. For ny autorisering etter at det har utløpt, kreves en ny økt.

Det avhenger av verktøyet og om det fortsatt har en passende, gyldig økt. Utvidelsen bruker ikke én felles økt for alle besøkende og alle produkter. Reglene nedenfor beskriver hvordan den fungerer nå.

Telleren øker når API-et utsteder et nytt token. Bruk av et allerede utstedt, gyldig token er ikke en ny utstedelse. Ta derfor hensyn til oppstart av verktøy, sideoppdateringer og gjenåpninger når du velger abonnement, og ikke bare antall bestillinger eller besøkende.

Verktøy som bygges inn i samme butikk, deler en felles månedlig øktkvote. Telleren føres separat for hver butikk, per kalendermåned i UTC. Nye økter i innebygd Designer og Modellgenerator i WordPress-kontrollpanelet øker også denne telleren. Det å laste ned en tilgjengelig modell via import-API-et er i seg selv ikke å åpne en økt i redigeringsverktøyet.

Når grensen nås, nekter systemet å utstede flere økter. Dette er en bruksgrense i abonnementet; se abonnementet ditt for gjeldende kvotestørrelse.

Public API bruker HTTP-forespørsler og JSON-data. Du kan derfor skrive din egen integrasjon i språket og miljøet som backend-en din bruker. Du trenger ikke å bygge om butikken til WordPress for å bygge inn Alter Product-verktøyene.

Nedenfor finner du eksempler på teknologier for å opprette forbindelsen på serversiden. I alle gjennomfører du de samme trinnene: API-autorisering, opprettelse av en verktøyøkt og kobling av produkter, handlekurv og bestillinger til ditt eget system.

I nettleseren kan du bruke React, Vue, Angular eller vanlig HTML og JavaScript. TypeScript egner seg også til å implementere kommunikasjonen. Siden bygger inn en iframe, håndterer postMessage-hendelser og kobler til backend-en din.

Frontend-en styrer sidens utseende og handlekurvens reaksjoner, mens backend-en håndterer autentiserte kall til Public API. I rammeverk som kombinerer begge lagene, for eksempel Next.js, må håndtering av faste nøkler og opprettelse av økter bare ligge i serverdelen.

Du kan beholde din egen kasse, betalingsløsning, CMS og prosess for ordrebehandling. Som del av implementeringen kobler du disse elementene til designdataene og hendelsene fra det valgte Alter Product-verktøyet.

Alter Product leverer 3D-verktøy, designdata og øktmekanismer. Backend-en din kobler dem til produkter, kundekontoer, handlekurv og ordrebehandling. Du kan lage egne mellomliggende endepunkter for frontend-en uten å eksponere Alter Product-tilgangsopplysninger i nettleseren.

Start med å sette opp tilkoblingen og en innbyggingsøkt for ett produkt. Legg deretter til håndtering av konfigurasjon, designlagring og bestillinger i henhold til valgt verktøy.

Innbyggingsveiledningene inneholder parametere og eksempler. Kapitlene om postMessage forklarer kommunikasjonen med siden, og API-dokumentasjonen beskriver operasjonene som backend-en utfører.

Etter at du har klargjort ett produkt, går du gjennom hele prosessen. Først deretter bruker du det utprøvde oppsettet på flere produkter i katalogen.