Erabiltzailearen eskuliburua — Xabia Woo (WooCommerce gehigarria)
Gehigarria: Xabia Woo v1.0.4 · Beharrezko nukleoa: ≥ 1.0.166 (gomendatua)
Instalazio Gida Azkarra
- Instalatu eta aktibatu Xabia Agent Core (
v1.0.166edo berriagoa gomendatzen da). - Instalatu eta aktibatu Xabia Woo (
xabia-woo-1.0.4.zip) Pluginak → Gehitu berria → Plugin-a igo ataletik. - Xabia Agent → Gehigarriak atalean , aktibatu edo sinkronizatu xabia-woo harpidetza Hub Polar: aktiboa ikusi arte.
- Denda WordPress gune berean badago, baieztatu WooCommerce aktibo dagoela eta produktuak zerrendatuta dituela.
- Denda beste webgune batean badago, bete agentean Woo dendaren (urruneko) SQL kredentzialak eta URL publikoa .
- Agentean, hautatu Informazio iturria → Gehigarri natiboa → WooCommerce eta egin klik Konektatu eta mapatu aukeran .
- Gorde, sakatu Sinkronizatu datuak eta, bektoreen bilaketa erabiltzen ari bazara, sakatu Entrenatu AI .
- Argitaratu aurretik, probatu produktuen kontsultak, stocka, eskaintzak eta saskiko botoiak Playground- en.
CPT Assistant (≥ Core 1.0.162): Woo gehigarriaren iturburuarekin, product bakarrik zerrendatzen ditu. Hybrid Remote (≥ 1.0.163): SQL host edo urruneko dendaren URLa → urruneko katalogoa, WC instalatuta badago ere. Eskema/kuratze sakona CPT-k Woo metadatuak bistaratzen ditu ( _price , _sku , stocka, etab.).
1. zatia — Zer den eta zertarako balio duen
1.1 Definizio laburra
Xabia Woo Xabia Agent Core eta WooCommerce- rekin batera instalatzen den plugin independente bat da. Zure laguntzailea zure dendaren produktuen katalogora konektatzen du honetarako:
- Sinkronizatu argitaratutako produktuak agentearen ezagutza-basearekin (testua eta, konfiguratuta badago, bilaketa semantikorako bektoreak).
- Erantzun WooCommerce-tik hartutako izenburuekin, prezioekin, eskaintzekin, stockarekin, SKUarekin, kategoriekin eta zerrenden estekekin.
- Kudeatu produktu aldakorrak (atributuak eta aldaerak prezio/stockarekin Laburpen Aberastuaren eremuan).
- “Saskira gehitu” botoiak erakutsi
[ACTION:CART:ID]etiketatik hasita, non ID produktuaren errenkadaren identifikatzaile numerikoa den (konektorearen ID zutabea). - IA-k egokitzat jotzen duenean, argitaratutako eta baliozko kupoiak iradoki (dendatik lortutako benetako kodeak soilik; IA-k ez ditu asmatu behar).
- Erregistratu txatarekin lotutako bihurketak (bisitariak saio berean gomendio baten ondoren erosten duenean) Oinarrizko bihurketa taulan.
Ez ditu WooCommerce-ren zerga, bidalketa, ordainketa-pasabidea edo legezko politika ezarpenak ordezkatzen; WordPress-en dituzun datuen gainean eraikitako elkarrizketa eta salmenta bidezko geruza bat da.
1.2 Zein arazo konpontzen du?
Gehigarri hau gabe, laguntzaile batek prezioak edo produktuak asmatu ditzake.
Xabia Woo- rekin, erantzunak argitaratutako product SQL kontsultetan eta metadatu estandarretan ( _price , _stock_status , etab.), testuinguru-arauetan (“Eskaintza Berezia”, ADDON DISCOVERY- ren erabilera) eta gaiaren AJAX saskian eta WooCommerce-n oinarritzen dira.
1.3 Produktuaren identifikazioa (erreferentzia erabilgarria)
- Polar denda (harpidetza): https://polar.sh/xabia
- Hub-eko gehigarri-slug-a normalean
xabia-wooda (woo/woocommercebezalako aliasak ere ezagutzen dira hornitzailearen konfigurazioaren arabera).
1.4 Ezinbesteko eskakizunak
| Eskakizuna | Zer esan nahi du zuretzat? |
|---|---|
| WordPress lanean | Core eta Xabia Woo WordPress pluginak dira. |
| Xabia Agent Core instalatuta eta aktibo | Core gabe, Xabia Wook abisu bat erakusten du eta ez du integrazioa kargatzen . |
| WooCommerce instalatuta eta aktibo | Beharrezkoa da denda WordPress gune berean ostatatuta dagoenean. Urruneko katalogo batean, WooCommerce iturburu webgunean bakarrik ostata daiteke, eta Xabia Wook urruneko SQL bidez irakurtzen du. |
| Xabia Woo plugina instalatuta eta aktibo | SQL konektorea, errenkada aldagaien aberastea eta saskiaren AJAX xabia-woo/xabia-woo.php helbidean daude. |
| Polar / Hub harpidetza xabia-woo barraskiloarentzat | Premium sinkronizazio eta katalogo arauak Xabia Agent → Addons- etik Hub-aren aurka baliozkotzen dira. Harpidetza aktiborik gabe, “Polar Hub: inaktibo” eta “Sinkronizatu datuak” botoia desgaituta ikus ditzakezu agenteak WooCommerce Addon iturria erabiltzen duenean. |
2. zatia — Urratsez urratseko instalazioa
2.1 Hasi aurretik
- Eduki itzazu ZIP fitxategi edo pakete hauek: Xabia Agent Core , WooCommerce (WordPress.org-etik edo zure saltzailetik) eta Xabia Woo .
- Mesedez, baieztatu zure hosting-ak REST/admin-ajax onartzen duela erosketa-gurditxoarentzat eta lizentziarentzat.
2.2 Gomendatutako aktibazio-ordena
- Xabia Agent Core → Aktibatu.
- WooCommerce → Aktibatu eta osatu gutxieneko dendaren morroia, oraindik egin ez baduzu.
- Xabia Woo → Aktibatu ondoren Core.
Xabia Woo Core gabe aktibatzen baduzu, abisu bat ikusiko duzu mahaigainean: lehenik Xabia Agent Core aktibatu behar duzu.
2.3 Instalatu Xabia Woo ZIPetik
- Hasi saioa administratzaile gisa.
- Pluginak → Gehitu berria → Plugin bat igo .
- Aukeratu Xabia Woo ZIP fitxategia.
- Instalatu orain → Aktibatu plugina .
2.4 Egiaztatu WordPress-ek plugina ezagutzen duela
Xabia Woo Pluginetan agertu beharko litzateke. Xabia Agent → Addons atalean, “Xabia — WooCommerce” txartelak WordPress egoera (aktibo / instalatuta / instalatu gabe) erakutsi beharko luke xabia-woo/xabia-woo.php fitxategiaren ondoan.
3. zatia — “Gehigarriak” pantaila: Polar harpidetza eta lizentzia
Ireki Xabia Agent → Gehigarriak .
Bertan Woo gehigarriaren aukera komertzial guztiak kudea ditzakezu.
3.1 Pantaila-testu orokorrak
- “Polar Hub: aktiboa / inaktiboa” txapak adierazten du lizentziak xabia-woo gehigarria barne hartzen duen ala ez, Hub-aren arabera (ez nahasi ZIP fitxategia aktibo edukitzearekin soilik).
- “Lizentziak hub-arekin sinkronizatu” botoiak txartel guztien egiaztapen berri bat behartzen du.
- “Harpidetu” (Hub-a inaktibo dagoenean) Woo produktuaren Polar denda irekitzen du (ez nahasi MEC gehigarrien ordainketarekin).
- “Gehigarria ez dago planean sartuta” ikusten baduzu Core lizentzia baliodun batekin: hub-ak ez du
xabia-wooaddon_activations-en zure gakoarentzat (Woo produktua falta da Polar-en edo produktuaren UUIDa falta da hub zerbitzarian).
3.2 Erosi edo berritu ondoren
- Itsatsi lizentzia-giltza zure lan-fluxuak gehigarri-txartelean erabiltzen badu.
- Egin klik Aktibatu / Eguneratu harpidetza edo Sinkronizatu lizentzia aukeran .
- Kargatu berriro gehigarriak eta baieztatu Polar Hub: aktibo Woo-rako.
4. zatia — Agentearen konfigurazioa (iturria «WooCommerce Addon»)
Editatu katalogoaren berri eman edo salmenta lagundu behar duen agentea.
4.1 Letra-tipo mota
«Informazio iturria» atalean:
- Aukeratu “Native Addons (External Connector)” Core-ak Xabia Woo detektatzen duenean eta Hub lizentzia baliozkoa denean.
4.2 Gehigarrien hautatzailea
Gehigarrien goitibeherako zerrendan, aukeratu “WooCommerce — katalogoa eta salmentak” (barneko slug woo ).
4.3 “Konektatu eta mapatu” botoia
- Egin klik “Konektatu eta mapatu” aukeran proba-kontsulta bat (errenkada bat) eta zerrenda-zutabeak egiteko.
- Hub Polar Woo-rako inaktibo badago, lizentzia-errore bat ikusiko duzu; konpondu gehigarriak jarraitu aurretik.
- Aplikatu produktuetarako iradokitako zutabe aurrezarpena (ikus beheko taula).
4.4 Mapaketan aurrezarpenaren eremu tipikoak
| SQL zutabea | Iradokitako rola | ENTITATEA | Notak |
|---|---|---|---|
| NAN | — | Bai (identitatea) | product IDa argitaratu; ezinbestekoa [ACTION:CART:ID] -rako. |
| Titulazioa | Titulazioa | Ez | Merkataritza izena. |
| Laburpena | — | Ez | Erauzi; aldagaietan aldagai bakoitzeko aukerekin eta stockarekin zabaltzen da. |
| produktu_mota | — | Ez | Adibidez, simple , variable . |
| SKU | — | Ez | Erreferentzia. |
| Prezioa | — | Ez | Uneko prezioa ( _price ). |
| Ohiko prezioa / Salmenta prezioa | — | Ez | deskontu_ehunekoa kalkulatzeko eta Eskaintza Berezia nabarmentzeko. |
| deskontu_ehunekoa | — | Ez | SQL-n kalkulatua; IA-k promozio esplizitu gisa aurkeztu behar du. |
| Stock_egoera / Stock_kantitatea | — | Ez | instock , outofstock , etab. |
| Esteka | URLa | Ez | Sinkronizazioan, benetako permalink batek ordezkatzen du. |
| Irudiaren_URLa | Irudia | Ez | Ahal den guztietan tamaina egokiarekin aberasten da. |
| Kategoriak | — | Ez | Produktuen kategoriak eta etiketak. |
4.5 Gorde
Sakatu “Gorde agentea” source_type , addon_slug , mapping eta SQL kredentzialak gordetzeko, urruneko eszenatoki batean erabiliko badituzu.
4.6 Urruneko denda WooCommerce lokalik gabe
Xabia Woo-k urruneko katalogo gisa funtziona dezake: txat guneak Xabia Woo aktibo eta Hub lizentzia du, baina benetako denda beste WordPress gune batean dago WooCommerce-rekin.
Orduan:
- Mantendu informazio iturria → Jatorrizko gehigarria → WooCommerce .
- Bete urruneko SQL kredentzialak ( Host , DB , User , Password eta Prefix
wp_ez bada). - Bete zure Woo dendaren (urruneko) URL publikoa , adibidez
https://tu-tienda.com. - Sakatu Konektatu eta Mapatu , gorde eta sinkronizatu.
Txateak urruneko datu-baseko produktuak erabiliko ditu. [ACTION:CART:ID] botoia sortzen duzunean, frontend-ak urruneko dendara zuzenean erosteko esteka bat erakutsiko du ( ?add-to-cart=ID ), produktua tokiko WordPress saskira gehitzen saiatu beharrean. Produktu aldakorrek normalean produktu-orrialde batera eramango dute, non bisitariak aldaera bat aukeratu dezakeen.
5. zatia — Memoria, sinkronizazioa eta jolastokia
| Kontrola | Funtzioa |
|---|---|
| “1. Datuak sinkronizatu” | SQL Woo-tik datuak hartzen ditu (eta aldagaiak/estekak aberasten ditu). Blokeatuta dago Hub-a gehigarri honetarako inaktibo badago . |
| “2. IA entrenatzea” | Txertatzeak Core konfigurazioaren arabera. |
| Jolastokia | Kode laburra argitaratu aurretik, probatu katalogoko galderak, eskaintzak eta “saskira gehitu” atala. |
Prezioak edo stocka kopuru handi batean aldatu ondoren, berriro sinkronizatu (eta entrenatu bektoreak erabiltzen badira).
6. zatia — WooCommerce-ko jardunbide egokiak
- Mantendu argitaratutako produktuak koherenteak (prezioak, zergak ikusgai zure txantiloiaren arabera).
- Aldagaietan , definitu atributu argiak Laburpen Aberastuak konbinazio erabilgarriak zerrenda ditzan.
- IA-k aipatu ditzakeen kupoiak argitaratu direnak baino ez dira, erabilera muga eta iraungitze data batekin; ez ditu WooCommerce-ko produktuaren edo posta elektronikoaren araberako egokitasun arauak ordezkatzen.
7. zatia — Bisitarien esperientzia txatean
- Proiektuak Woo erabiltzen duenean, IAk salmenta-arauak eta azken produktuen laburpena jasotzen ditu.
- Saskiaren ekintza duen produktu bat gomendatzen baduzu, frontend-ak saskira gehitzeko botoia bistaratuko du (txat orrian WooCommerce aktibo egon behar du).
- Produktu aldakorrak: batzuetan beharrezkoa da fitxa teknikoan aldaera bat aukeratzea; laburpenak bisitaria gidatzen duten lerroak izan ditzake.
- Saskira gehitu ondoren, bisitariak eskaera WooCommerce-n osatu dezake; erosketa saioan gomendio bati jarraitzen badio, barne-bihurketa bat erregistratu daiteke (ikus hurrengo zatia).
- Katalogoa urruneko denda batean badago, fitxak, erosketa-saskia eta kupoiak Woo dendaren URL publiko (urruneko) gisa konfiguratutako domeinura ebazten dira.
- Nukleoak automatikoki itzul dezake produktuaren informazioa eta testuingurua bisitari batek beste hizkuntza batean galdetzen duenean;
Kode laburren hizkuntza interfazearen babeskopia gisa erabiltzen da, ez erantzunen blokeatzaile gisa.
8. zatia — Bihurketak eta ROI (erreferentzia)
Xabia gehigarria aktibatzen denean, WooCommerce-ko erosketa batek txat-gomendio berri bati jarraitzen dionean, bihurketa- erregistro sinple bat sortzen du (agentea, eskaera, zenbatekoa, produktuak eta data). Hau barne-ROI analisirako da eta ez ditu WooCommerce-ko txosten natiboak ordezkatzen.
9. zatia — Arazo ohikoenak
| Sintoma | Zer berrikusi |
|---|---|
| Polar Hub: inaktibo eta sinkronizazioa blokeatuta | Erosi Woo produktua Polar-etik; konfiguratu Woo produktua hub-ean. Gehigarriak → Sinkronizatu lizentzia . |
| “Gehigarria ez dago planean sartuta” (lizentzia baliozkoa) | Core giltzak ez du Woo gehigarria gaituta hub-ean; egiaztatu laguntzarekin edo bezeroentzako atarian. |
| Ez dago produkturik aurrebistan | Ba al dago argitaratutako produkturik? Zuzena al da SQL aurrizkia urruneko datu-base bat erabiltzen bada? |
| Erosketa-saskiaren botoiak ez du ezer egiten. | Nabigatzailearen kontsola; WooCommerce aktibo al dago txat orrian? |
| Aldagaia ez da gehitu | Egiaztatu atributurik falta zaizun; erabili txartelerako edo aldaerarako esteka Laburpenaren arabera. |
Kontrol-zerrenda azkarra: Active Core → Active WooCommerce → Active Xabia Woo → Active Hub → Addon Source + Woo → Connect and Map → Save → Sync → Train (baldin badagokio) → Playground .
10. zatia — Laguntza
- Xabia/Digixop (lizentzia, Hub, Xabia Woo): help@xabia.ai .
- WooCommerce (ordainketak, bidalketa, gaiak, hirugarrenen gatazkak): zure hornitzailearen edo WooCommerce.com- en laguntza, dagokionean.
Lizentzia nagusia, tokenak eta zorroa ikusteko, ikusi Oinarrizko Eskuliburua .
Xabia AI — Web Bizidunaren
Adimen artifizialarekin batera jakinduria naturala
Xabia AI bereziki egokia da turismo sektoreko enpresa eta elkarteentzat, erakundeentzat, negozioentzat eta beren bihurketa-tasa handitu nahi duten online dendentzat.
Xabia AI Digixopek garatu du.
Xabia AI · Garaizar, 2 · 48004 Bilbao (ESPAÑA)