---
title: "Vodnik za integracijo z WooCommerce | Tajo"
description: "Povežite svojo trgovino WooCommerce s Tajom prek vtičnika Tajo for WooCommerce: dogodki sodelovanja, zanesljiva dostava in podatki o strankah, omejeni na nujno potrebno. V razvoju, še ni preverjeno od začetka do konca."
url: https://tajo.io/sl/docs/ecommerce-platforms/woocommerce/
markdown: https://tajo.io/sl/docs/ecommerce-platforms/woocommerce.md
lang: sl-SI
author: "Set Noa"
author_url: https://tajo.io/sl/set-noa/
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# Vodnik za integracijo z WooCommerce

[Set Noa](https://tajo.io/sl/set-noa/)

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 (naročila, košarice, vračila, recenzije, oddane obrazce), ko se zgodijo, in jih prek zanesljivega, podpisanega odhodnega predala dostavi v Tajo. 14. oktobra 2026 je bil vtičnik preizkušen na lokalnem spletnem mestu; dostava v Tajo še ni bila preverjena.
- **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](https://tajo.io/sl/docs/connectors/ecommerce/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

```bash
# 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/](https://tajo.io/downloads/woocommerce/tajo-woocommerce-1.0.0.zip.sha256). 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:

| Polje | Vrednost |
| --- | --- |
| **Končna točka Tajo** | Naslov URL webhooka HTTPS, prikazan v Tajo, na primer `https://alto.tajo.io/api/connectors/wordpress/webhooks/engagement` |
| **Binding ID** | Binding ID povezave iz Tajo |
| **Podpisni skrivni ključ** | Deljeni skrivni ključ (32–256 znakov). Vtičnik ob aktivaciji ustvari močan lokalni ključ; prilepite ga v Tajo ali sem prilepite ključ iz 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

| Kavelj | Dogodek |
| --- | --- |
| `woocommerce_created_customer` / `woocommerce_update_customer` | `customer.created` / `customer.updated` |
| `woocommerce_new_product` / `woocommerce_update_product` | `product.created` / `product.updated` |
| `woocommerce_add_to_cart`, odstranitev postavke, dodajanje/odstranjevanje kupona | `cart.updated` (s povzetkom košarice za tokove ob zapuščeni košarici) |
| `woocommerce_cart_emptied` | `cart.emptied` |
| `woocommerce_new_order` / `woocommerce_update_order` | `order.placed` / `order.updated` |
| `woocommerce_order_status_changed` | `order.status_changed` (+ `order.fulfilled` ob zaključku) |
| `woocommerce_payment_complete` | `order.paid` |
| `woocommerce_order_refunded` | `refund.created` |
| Spremembe stanja v WooCommerce Subscriptions | `subscription.status_changed` |

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:

```php
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 vtičnika 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](https://tajo.io/sl/docs/connectors/ecommerce/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:

| Metoda | Pot | Namen |
| --- | --- | --- |
| `GET` | `/wp-json/tajo/v1/capabilities` | Različica vtičnika, zaznani adapterji, popis dogodkov, zdravje odhodnega predala |
| `GET` | `/wp-json/tajo/v1/outbox` | Števci odhodnega predala (koristni tovori niso nikoli izpostavljeni) |
| `POST` | `/wp-json/tajo/v1/outbox/process` | Takoj obdelaj paket |
| `POST` | `/wp-json/tajo/v1/outbox/replay` | Ponovi neuspele pošiljke |

## Odpravljanje težav

| Znak | Vzrok in rešitev |
| --- | --- |
| Dogodki ostajajo v stanju „Queued“ | Končna točka, binding ID ali skrivni ključ še niso shranjeni; dostava je zaustavljena, dokler niso nastavljeni vsi trije |
| Dogodki ostajajo v stanju „Retrying“ | Končna točka Tajo je z vašega gostitelja nedosegljiva ali pa WP-Cron ne teče; preverite stolpec z napako v tabeli odhodnega predala in svojo nastavitev crona |
| Kopičijo se neuspele pošiljke | Napaka, ki je ni smiselno ponavljati (običajno napačen binding ID ali skrivni ključ); popravite nastavitve in nato uporabite **Replay dead letters** |
| „Enter a valid HTTPS Tajo webhook endpoint“ | Končna točka mora biti HTTPS brez vdelanih poverilnic |
| Testni dogodek je dostavljen, v Tajo pa ni ničesar | Preverite, ali ste prilepili binding ID iz istega delovnega prostora in povezave Tajo, ki jima končna točka pripada |

## Naslednji koraki

- [Referenca konektorja WooCommerce](https://tajo.io/sl/docs/connectors/ecommerce/woocommerce/): sinhronizacija prek REST, podrobnosti podpisa webhooka, konfiguracijski ključi
- [Sinhronizacija strank](https://tajo.io/sl/docs/skills/data-sync/customer-sync/): 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`