Trin 1: Hent din Photta widget-nøgle
Log ind på Photta Business Dashboard på business.photta.app. Gå til Settings → API Keys og kopier din publishable key, som starter med pk_live_. Dette er den eneste legitimation, du har brug for. Før nøglen virker, skal du tilføje dit WooCommerce butiksdomæne (f.eks. mystore.com) til Settings → Allowed Domains. Domænetjekket kører ved hver prøvningsanmodning, så listen over tilladte domæner skal være opsat, før du går live.
Hvis du tester lokalt på et subdomæne som localhost eller en staging-URL, skal du tilføje dette domæne separat. Du kan tilføje op til 10 domæner på enhver betalt plan. Trial-kontoen tillader ét domæne. Når dit domæne er på listen, vil anmodninger fra den oprindelse blive accepteret med det samme — der er ingen forsinkelse i udbredelsen.
Trin 2: Vælg shortcode vs. script-tag
WooCommerce giver dig to enkle integrationsmuligheder. Shortcode-metoden ([photta_widget pk="pk_live_..."]) lader dig indsætte widgetten på en specifik placering i din produktskabelon eller et brugerdefineret WooCommerce hook — ideelt hvis du ønsker, at knappen skal vises præcis mellem produktgalleriet og Køb-knappen. For at bruge shortcoden skal du indsætte den direkte i WooCommerce produktskabelon-filen single-product/add-to-cart/simple.php eller bruge en page builder-blok.
Script-tag-metoden indsætter SDK'et globalt via dit temas functions.php-fil ved hjælp af wp_enqueue_script. Tilføj følgende til dit child-temas functions.php: add_action('wp_footer', function() { echo '<script src="https://widget.photta.app/sdk.js" data-pk="pk_live_..." defer></script>'; }); Dette renderer automatisk widget-knappen på hver produktside uden ændringer i skabelonerne. De fleste forhandlere foretrækker script-tag-metoden på grund af dens enkelhed.
Trin 3: Indsæt og gem din valgte kode
For shortcode-vejen: Åbn dit child-temas WooCommerce skabelon-override for den enkelte produktside. Indsæt [photta_widget pk="pk_live_..."] på den præcise vertikale position, hvor du ønsker, at knappen skal vises. Gem filen. Shortcode-rendereren registreres af Photta's letvægts-helper — ingen plugin-fil er nødvendig, da selve SDK'et registrerer shortcode-handleren, når det indlæses.
For script-tag-vejen: Åbn Udseende → Temafil-editor i din WordPress-admin, find dit child-temas functions.php, og tilføj wp_footer action-koden vist i trin 2. Klik på Opdater fil for at gemme. Bekræft at koden blev gemt ved at opdatere editoren og se om koden er der. Hvis du bruger et caching-plugin (WP Rocket, W3 Total Cache), skal du rydde cachen nu, så det nye footer-script bliver leveret.
Trin 4: Bekræft at widgetten vises i din butik
Naviger til en produktside i din WooCommerce-butik i et privat browservindue. Du bør se en 'Prøv den'-knap i nærheden af Køb-sektionen. Klik på knappen, upload et testbillede, og bekræft at prøvningsresultatet vises. Hvis knappen ikke vises, skal du åbne browserkonsollen (F12) og se efter photta-fejl. En 403-domænefejl betyder, at dit domæne endnu ikke er på listen over tilladte domæner (Allowed Domains).
Tjek også at SDK-script-tagget vises i sidens HTML-kildekode ved at trykke på Ctrl+U (Vis kilde) og søge efter photta. Hvis tagget mangler, men du har tilføjet wp_footer-hooket, skal du dobbelttjekke, at dit tema rent faktisk kalder wp_footer() i sin footer-skabelon — visse ældre eller meget tilpassede temaer udelader dette kald. Tilføjelse af <?php wp_footer(); ?> før det lukkende </body> i din footer.php løser dette.
Trin 5: Konfigurer synlighed pr. kategori
Som standard vises widget-knappen på alle produktsider. For at begrænse den til specifikke kategorier, skal du tilføje data-categories attributten til dit script-tag med en kommasepareret liste over WooCommerce kategori-slugs: <script src="https://widget.photta.app/sdk.js" data-pk="pk_live_..." data-categories="womens-apparel,mens-apparel,swimwear" defer></script>. SDK'et læser den aktuelle sides WooCommerce kategoridata og skjuler automatisk knappen på sider, der ikke matcher.
For shortcode-brugere: Placer kun shortcoden i de skabeloner, der er knyttet til målkategorierne, eller pak shortcoden ind i en WooCommerce betingelse: brug PHP-funktionen has_term() til at tjekke, om det aktuelle produkt tilhører målkategorien, før shortcoden udskrives. Dette mønster giver dig kirurgisk kontrol over, hvilke produkttyper der viser prøvningsmuligheden uden at duplikere skabeloner.