Vodnik za integracijo z WooCommerce

Ta vodnik poveže trgovino WooCommerce s Tajom. Integracija ima dve polovici, ki delujeta skupaj:

• Vtičnik Tajo for WooCommerce: znotraj WordPressa zajema dogodke sodelovanja v realnem času (naročila, košarice, vračila, recenzije, oddane obrazce) in jih prek zanesljivega, podpisanega odhodnega predala dostavi v Tajo.
• Povezava WooCommerce REST: Tajo bere stranke, naročila, izdelke, kupone, vračila in recenzije vaše trgovine za zgodovinski uvoz in sprotno sinhronizacijo. Nastavitev samo prek REST je opisana v referenci konektorja WooCommerce.

Sama avtomatizacija trženja (e-pošta, SMS, WhatsApp prek platforme Brevo in drugih ponudnikov) se nastavi v Tajo, ne v vtičniku. Naloga vtičnika je, da iz WordPressa spravi zanesljive dogodke.

Predpogoji

• WordPress 6.3+ s skrbniškim dostopom
• PHP 7.4+
• WooCommerce 7.0+ (vtičnik deluje tudi na spletnih mestih WordPress brez WooCommerce, trgovinski adapterji preprosto ostanejo neaktivni)
• Račun Tajo z ustvarjeno povezavo WordPress
• HTTPS na končni točki Tajo (pri gostovanem Tajo velja vedno)

Korak 1: Namestite vtičnik Tajo for WooCommerce

Ročna namestitev

# Download the plugin
cd wp-content/plugins
wget https://tajo.io/downloads/woocommerce/tajo-woocommerce-latest.zip

# Verify and unzip
unzip tajo-woocommerce-latest.zip

Nato ga aktivirajte v skrbniškem vmesniku WordPressa:

1. Odprite Plugins → Installed Plugins
2. Poiščite „Tajo for WooCommerce“
3. Kliknite Activate

Datoteko zip lahko naložite tudi neposredno prek Plugins → Add New → Upload Plugin. Ob vsaki izdaji je objavljena kontrolna vsota SHA-256 na naslovu tajo.io/downloads/woocommerce/. Vtičnik še ni uvrščen v imenik WordPress.org; podprta pot je danes ročna namestitev.

Korak 2: Nastavite povezavo

Odprite WooCommerce → Tajo (na spletnih mestih brez WooCommerce: Settings → Tajo) in vnesite tri vrednosti iz svoje povezave WordPress v Tajo:

V wp-config.php ni treba dodajati nobenih konstant s ključem API. Dogodki varno čakajo v lokalnem odhodnem predalu, dokler ne shranite vseh treh vrednosti.

Nato preverite celotno pot od začetka do konca:

1. Kliknite Queue test event in nato Process now.
2. Tabela odhodnega predala mora dogodek prikazati kot dostavljen.
3. V Tajo potrdite, da je dogodek connection.test prispel na povezavo WordPress.

Kaj vtičnik pošilja

Vsak dogodek je kompaktna ovojnica, omejena na nujno potrebne podatke in podpisana s HMAC-SHA256. WordPress zapustijo le identifikacijska polja za sodelovanje (e-pošta, telefon, lokalni ID-ji) in omejeni metapodatki dogodka, nikoli imena, poštni naslovi, naslovi IP, uporabniški agenti, vsebine komentarjev, poljubna polja obrazcev, opombe k naročilom ali podatki o plačilu.

Dogodki WooCommerce

Dogodki naročil nosijo številko naročila, status, valuto, vsote, postavke ter pripravljene naslove URL za recenzijo in ponovno naročilo, kar zadostuje za avtomatizacije po nakupu in za vračanje strank brez dodatnega klica API.

Dogodki WordPress

• contact.created / contact.updated / contact.deleted za uporabniške račune
• content.published / content.updated / content.unpublished za javno vsebino
• comment.created / comment.status_changed za komentarje obiskovalcev in recenzije izdelkov (interne opombe k naročilom v WooCommerce, pingbacki in trackbacki se nikoli ne oddajo)
• form.submitted ob uspešni oddaji obrazcev Contact Form 7, WPForms, Gravity Forms in Fluent Forms: izluščijo se samo tipizirana identifikacijska polja e-pošte in telefona ter metapodatki obrazca; poljubna oddana polja se zavržejo

Zanesljivost: odhodni predal za dostavo

Vtičnik dogodkov nikoli ne pošlje v Tajo neposredno med nalaganjem strani. Vsak dogodek se najprej zapiše v lokalno tabelo odhodnega predala, nato ga dostavi WP-Cron s temi lastnostmi:

• Omejen eksponentni odlog (do 8 poskusov, upošteva Retry-After)
• Neuspele pošiljke z enim klikom na Replay dead letters v skrbniškem vmesniku
• Omejitve hrambe, da nedosegljiva končna točka nikoli ne kopiči osebnih podatkov (dostavljeno: 7 dni; v čakalni vrsti: 30 dni; neuspele pošiljke: 30 dni po zadnji posodobitvi)
• Idempotentni ID-ji dogodkov, tako da ponovni poskusi in ponovitve nikoli ne podvojijo zapisov na drugi strani

Če vaš gostitelj onemogoča WP-Cron (DISABLE_WP_CRON), pokličite wp-cron.php iz pravega razporejevalnika vsaj enkrat na minuto.

Privolitev se nikoli ne sklepa

Ustvarjanje računa, blagajna, nakup in splošne oddaje obrazcev ne veljajo za trženjsko privolitev. Vgrajeni dogodki nosijo prazen seznam privolitev. Če želite zabeležiti izrecno privolitev (na primer iz označenega polja za e-novice), jo oddajte prek razširitvenega kavlja:

do_action(
    'tajo_engagement_emit',
    'consent.updated',
    array( 'email' => $email ),
    array( 'policyVersion' => '2026-07' ),
    array(
        array(
            'channel'  => 'email',
            'status'   => 'opt_in',        // or 'opt_out'
            'purpose'  => 'marketing',
            'source'   => 'newsletter_checkbox',
            'evidence' => array( 'formId' => 'newsletter-footer', 'field' => 'marketing_email' ),
        ),
    ),
    gmdate( 'c' )
);

Isti kavelj omogoča kateremu koli vtičniku ali temi, da odda lastne dogodke; vse gre skozi isto čiščenje vhodov, odhodni predal in podpis.

Korak 3: Zgodovinski uvoz

Dogodki v realnem času pokrivajo vse od namestitve naprej. Za zgodovino pred vtičnikom povezava WooCommerce REST v Tajo uvozi obstoječe stranke, naročila, izdelke, kupone, vračila in recenzije. Nastavi se v celoti na strani Tajo s ključem WooCommerce REST API (WooCommerce → Settings → Advanced → REST API, dovoljenje za branje). Podrobnosti so v referenci konektorja WooCommerce.

Zasebnost in GDPR

• Vtičnik se registrira v orodji WordPress Tools → Export Personal Data in Tools → Erase Personal Data; ohranjeni dogodki v odhodnem predalu za ujemajoči se e-poštni naslov se lokalno izvozijo ali izbrišejo.
• Brisanje in dostava si delita zaklep, ki se ob napaki zapre, zato brisanje nikoli ne more sporočiti zaključka, medtem ko se koristni tovor še pošilja.
• Lokalno brisanje pokriva samo odhodni predal v WordPressu. Za nadaljnje podatke oddajte ustrezno zahtevo v Tajo.
• Deaktivacija zaustavi dostavo, a ohrani nastavitve in dogodke v čakalni vrsti; izbris vtičnika trajno odstrani odhodni predal, nastavitve, skrivni ključ in urnike.

Združljivost

• HPOS: vtičnik izjavlja združljivost z WooCommerce High-Performance Order Storage in uporablja izključno objekte CRUD in javne kavlje.
• WooCommerce Subscriptions: spremembe stanja naročnine se zajamejo, kadar je razširitev aktivna.
• Multisite: odstranitev počisti vsako spletno mesto v omrežju.

Referenca za obratovanje

Odkrivanje med strežniki in upravljanje odhodnega predala sta skrbnikom na voljo prek overjanja Application Password:

Odpravljanje težav

Naslednji koraki

• Referenca konektorja WooCommerce: sinhronizacija prek REST, podrobnosti podpisa webhooka, konfiguracijski ključi
• Sinhronizacija strank: preslikava strank WooCommerce v vaš sistem zapisov
• V Tajo nastavite avtomatizacije za zapuščene košarice, obdobje po nakupu in vračanje strank z dogodki cart.updated, order.placed in order.fulfilled