Krok 1: Získejte klíč k widgetu Photta
Přihlaste se do Photta Business Dashboardu na adrese business.photta.app. Přejděte do Settings → API Keys a zkopírujte svůj „publishable key“, který začíná na pk_live_. Toto je jediný údaj, který potřebujete. Aby klíč fungoval, přidejte doménu svého WooCommerce obchodu (např. mujobchod.cz) v Settings → Allowed Domains. Kontrola domény probíhá při každém požadavku na vyzkoušení, takže povolené domény musí být nastaveny dříve, než službu spustíte.
Pokud testujete lokálně na subdoméně jako localhost nebo na staging URL, přidejte tuto doménu do seznamu povolených samostatně. V libovolném placeném tarifu můžete přidat až 10 domén. Zkušební účet umožňuje jednu doménu. Jakmile je vaše doména v seznamu, požadavky z tohoto zdroje budou okamžitě přijímány — nedochází k žádnému prodlení při propagaci.
Krok 2: Vyberte si mezi shortcode a script tagem
WooCommerce vám nabízí dvě čisté cesty integrace. Přístup pomocí shortcode ([photta_widget pk="pk_live_..."]) vám umožní vložit widget na konkrétní místo v šabloně produktové stránky nebo do vlastního WooCommerce hooku — ideální, pokud chcete, aby se tlačítko zobrazilo přesně mezi galerii produktů a tlačítko Přidat do košíku. Chcete-li použít shortcode, vložte jej přímo do souboru WooCommerce produktové šablony single-product/add-to-cart/simple.php, nebo použijte blok v page builderu.
Přístup přes script tag vloží SDK globálně prostřednictvím souboru functions.php vašeho tématu pomocí wp_enqueue_script. Do souboru functions.php vašeho child tématu přidejte následující: add_action('wp_footer', function() { echo '<script src="https://widget.photta.app/v1/embed.js" data-api-key="pk_live_..." defer></script>'; }); Tím se tlačítko widgetu automaticky vykreslí na každé produktové stránce bez nutnosti změn v šablonách. Většina obchodníků dává přednost script tagu pro jeho jednoduchost.
Krok 3: Vložte a uložte vybraný fragment kódu
Pro cestu se shortcode: otevřete v child tématu přepsanou WooCommerce šablonu pro stránku jednoho produktu. Vložte [photta_widget pk="pk_live_..."] přesně na vertikální pozici, kde se má tlačítko objevit. Soubor uložte. Renderer pro shortcode je registrován lehkým pomocníkem Photta — není potřeba žádný soubor pluginu, protože samotné SDK zaregistruje handler pro shortcode při načtení.
Pro cestu se script tagem: v administraci WordPressu otevřete Vzhled → Editor souboru šablony, přejděte do functions.php vašeho child tématu a přidejte fragment s akcí wp_footer uvedený v kroku 2. Klikněte na Aktualizovat soubor. Ověřte uložení obnovením editoru a potvrzením přítomnosti kódu. Pokud používáte verzování nebo cache pluginy (WP Rocket, W3 Total Cache), vymažte nyní mezipaměť, aby se začal odesílat nový skript v patičce.
Krok 4: Ověřte, zda se widget v obchodě zobrazuje
Přejděte na stránku produktu ve svém WooCommerce obchodě v anonymním okně prohlížeče. Poblíž sekce Přidat do košíku byste měli vidět tlačítko „Vyzkoušet na sobě“. Klikněte na tlačítko, nahrajte testovací fotografii a ověřte, zda se výsledek vykreslí. Pokud se tlačítko nezobrazí, otevřete konzoli prohlížeče (F12) a hledejte chyby photta. Chyba domény 403 znamená, že vaše doména ještě není v seznamu Allowed Domains.
Zkontrolujte také, zda se script tag SDK zobrazuje ve zdrojovém kódu HTML stránky stisknutím Ctrl+U (Zobrazit zdrojový kód) a vyhledáním výrazu photta. Pokud tag chybí, přestože jste přidali hook wp_footer, zkontrolujte, zda vaše téma volá funkci wp_footer() ve své šabloně footer.php — některá starší nebo silně upravená témata toto volání vynechávají. Přidání <?php wp_footer(); ?> před uzavírací značku </body> ve vašem footer.php to vyřeší.
Krok 5: Konfigurace viditelnosti podle kategorií
Ve výchozím nastavení se tlačítko widgetu zobrazuje na všech produktových stránkách. Chcete-li jej omezit na konkrétní kategorie, přidejte do script tagu atribut data-categories se seznamem slugů WooCommerce kategorií oddělených čárkou: <script src="https://widget.photta.app/v1/embed.js" data-api-key="pk_live_..." data-categories="damske-odevy,panske-odevy,plavky" defer></script>. SDK automaticky načte data o kategorii WooCommerce aktuální stránky a na neodpovídajících stránkách tlačítko skryje.
Uživatelé shortcode mohou shortcode umístit pouze do šablon spojených s cílovými kategoriemi, nebo shortcode obalit do WooCommerce podmínky: použijte PHP funkci has_term() ke kontrole, zda aktuální produkt patří do cílové kategorie, než shortcode vypíšete. Tento vzorec vám dává chirurgickou kontrolu nad tím, které typy produktů zobrazují možnost vyzkoušení, aniž byste museli duplikovat šablony.
