E-poodidele

Tulus.ee WooCommerce plugin

Ühenda oma WooCommerce'i pood Tulus.ee-ga: loo sooduskampaaniaid otse WordPressis, need ilmuvad Tulus.ee-s, ostud loetakse automaatselt ja statistika on ühes kohas.

Laadi alla (v8.0.1)
Versioon
8.0.1
Fail
tulus-campaigns-8.0.1.zip · 85 KB
Nõuab
WordPress 6.0+, WooCommerce 7.0+, PHP 8.0+
SHA-256
28d56397ae61d782ef47736555a93f78b4181870222937fc72e844f79e590d8f

Mida plugin teeb

  • Kampaania loomine WordPressis — plugin loob WooCommerce'i sooduskoodi ja avaldab selle samal ajal Tulus.ee-s.
  • Muudatused jõuavad automaatselt — kui muudad kupongi WooCommerce'is (soodustus, kehtivus), uueneb see ka Tulus.ee-s. Prügikasti viidud kupong arhiveeritakse Tulus.ee-s.
  • Ostud loetakse — kui tellimus kupongiga saab olekuks „Lõpetatud”, teatatakse ost Tulus.ee-le. Sama tellimust ei loeta kaks korda. Tagastatud või tühistatud tellimus võetakse arvestusest maha.
  • Statistika — vaatamised, klikid poodi, koodi kopeerimised ja ostud ühel graafikul. Vaatamised ja klikid on mõõdetud Tulus.ee-s; ostud on sinu poe kinnitatud.

Kupongid töötavad sinu poes igal juhul — ka siis, kui Tulus.ee hetkel ei vasta.

Nõuded

  • WordPress 6.0 või uuem, WooCommerce 7.0 või uuem, PHP 8.0 või uuem.
  • Tulus.ee kaupmehe konto, millel on ligipääs sinu poele. Kontot pole? Liitu partnerina või kirjuta [email protected] — saame võtme ka sinu eest luua.

1. Paigaldamine

  1. Laadi alla plugina fail tulus-campaigns-8.0.1.zip (ära seda lahti paki).
  2. Ava WordPressi haldus: Pluginad → Lisa uus → Laadi plugin üles.
  3. Vali allalaaditud .zip fail ja vajuta Paigalda kohe, seejärel Aktiveeri.
  4. Haldusmenüüsse ilmub Tulus Kampaaniad.

2. API võtme loomine

  1. Logi sisse tulus.ee/merchant.
  2. Ava API ja integratsioonid → API võtmed → Loo uus API võti.
  3. Nimi näiteks „WooCommerce”. Vali oma pood.
  4. Märgi need õigused:
    shops.readcoupons.readcoupons.createcoupons.updatecoupons.activatecoupons.synccoupons.archivecoupon_redemptions.createanalytics.read
  5. Vajuta Loo võti ja kopeeri võti kohe — seda näidatakse ainult üks kord. Võti algab tls_live_.

Hoia võtit nagu parooli: ära saada seda avalikus vestluses ega e-kirjas. Kui võti läheb kaotsi või lekib, tühista see samas vaates ja loo uus.

3. Poe ühendamine

  1. WordPressis ava Tulus Kampaaniad.
  2. Kleebi API võti väljale API võti.
  3. Poe ID jäta tühjaks, kui võti kehtib ühele poele. Kui võti kehtib mitmele poele, näitab plugin valikuid koos ID-dega.
  4. API aadress jäta muutmata (https://tulus.ee/api/v1).
  5. Vajuta Ühenda pood. Plugin kontrollib võtit ja õigusi ning seob kohe kõik olemasolevad Tulus kampaaniad.

4. Kampaaniad ja ostud

  • Uus kampaania: Tulus Kampaaniad → Loo uus kampaania → nimi, Tulus.ee kategooria, soodustus (% või €), kehtivus, kellele kehtib (kõik tooted / valitud tooted / kategooriad) → Avalda kampaania. Plugin loob koodi kujul TULUS-XXXXXX.
  • Kehtivus: valitud kuupäev kehtib päeva lõpuni Eesti aja järgi.
  • Muutmine: muuda kupongi tavapäraselt WooCommerce'is (Turundus → Kupongid) — muudatus jõuab Tulus.ee-sse salvestamisel.
  • Ost: loetakse, kui tellimus saab olekuks Lõpetatud. Tagasimakse või tühistamine eemaldab ostu statistikast.
  • Sünkrooni kõik: nupp plugina ülaosas saadab kõik kampaaniad uuesti — kasulik pärast ühenduse taastamist.

Uuendamine versioonilt 7

Versioon 8 kasutab uut Tulus.ee Partner API-t. Vana võti (algab tl_) ei tööta — selle asemel näed WordPressis teadet „pluginaversioon 7 ei ole enam toetatud”.

  1. Paigalda uus versioon samamoodi nagu ülal (WordPress pakub vana asendamist — vali Asenda praegune versioon üleslaaditud versiooniga). Kupongid ja kampaaniad jäävad alles.
  2. Loo uus API võti (samm 2) ja ühenda pood uuesti (samm 3).
  3. Ühendamisel seotakse olemasolevad kampaaniad. Kui sama koodiga kupong on Tulus.ee-s juba olemas, võetakse see üle — duplikaate ei teki.

Probleemid ja lahendused

TeadeMida teha
„See ei ole Tulus.ee Partner API võti”Kasuta uut võtit, mis algab tls_live_. Vanad tl_ võtmed ei tööta.
„Võtmel puuduvad õigused: …”Loo uus võti ja märgi kõik ülal loetletud õigused.
„Võti kehtib mitmele poele — sisesta poe ID”Kopeeri teatest oma poe ID väljale Poe ID.
Tellimuse märge „Tulus.ee: ostu teatamine ebaõnnestus”Kupong ise töötas. Kontrolli ühendust (Tulus Kampaaniad) ja vajuta Sünkrooni kõik. Kui viga kordub, saada märkuse tekst aadressile [email protected].
„pluginaversioon 7 ei ole enam toetatud”Uuenda plugin versioonile 8 (vt eespool).
Kampaania ei ilmu Tulus.ee-sUued kampaaniad võivad vajada Tulus.ee ülevaatust. Olekut näed kaupmehe paneelis Kupongid.

Arendajale: plugin kasutab avalikku Partner API v1-te (/coupons/sync, /coupons/{id}/redemptions, /analytics/*). Abi: [email protected].

Sooduskood

Mine poodi → Kupongi detailid