Erabiltzailearen eskuliburua — Xabia Modern Events Calendar (MEC gehigarria)

Gehigarria: Xabia MEC v1.0.3 · Beharrezko nukleoa: ≥ 1.0.166 (gomendatua)

Instalazio Gida Azkarra

1. Instalatu eta aktibatu Xabia Agent Core ( v1.0.166 edo berriagoa gomendatzen da).
2. Instalatu eta aktibatu Xabia MEC ZIP ( xabia-mec-1.0.3.zip ) Pluginak → Gehitu berria → Plugin-a igo ataletik.
3. Xabia Agent → Gehigarriak atalean , aktibatu edo sinkronizatu xabia-mec harpidetza Hub Polar: aktiboa ikusi arte.
4. Ekitaldiak WordPress gune berean badaude, aktibatu Modern Events Calendar eta argitaratu mec-events ere.
5. Gertaerak beste webgune batean badaude, ez da beharrezkoa tokiko MEC bat: bete urruneko SQL kredentzialak agentean eta erabili Informazio Iturria → Gehigarri Natiboa → MEC .
6. Egin klik Konektatu eta mapatu aukeran , berrikusi zutabearen aurrezarpena eta gorde agentea.
7. Egin klik Sinkronizatu datuak aukeran eta, bektoreen bilaketa erabiltzen baduzu, Entrenatu AI aukeran .
8. Saiatu Playground- en kode laburra argitaratu aurretik “zer ekitaldi izango dira asteburu honetan?” bezalako galderak egiten.

CPT Assistant (≥ Core 1.0.162): MEC gehigarriaren iturburuarekin, mec-events bakarrik zerrendatzen ditu (urruneko SQL-n baliozkotzen du ostalari bat existitzen bada). Hybrid Remote (≥ 1.0.163): SQL ostalari bat konfiguratzen baduzu, katalogoa urrunekotzat hartzen da MEC lokalki instalatuta egon arren (IDak nahastea saihesten du). Eskema sakonak mec_available_slots eta mec_* etiketak ditu.

1. zatia — Zer den eta zertarako balio duen

1.1 Definizio laburra

Xabia MEC Xabia Agent Core- rekin batera instalatzen den plugin independente bat da. Zure laguntzailea (adibidez, Izar edo beste agente konfiguratu bat) Modern Events Calendar-ekin (MEC) konektatzen du honetarako:

• Sinkronizatu gunearen gertaeren egutegia agentearen ezagutza-basearekin (testua eta, konfiguratuta badago, bilaketa semantikorako bektoreak).
• Erantzun argitaratutako ekitaldietatik hartutako datak, kokapenak, prezioak, kategoriak eta testuak adieraziz.
• Erakutsi eskuragarri dauden zirrikitu-tarteak MEC-ek edukiera definitua eta erreserbak erregistratuak dituenean (kalkulatutako mec_available_slots eremua).
• Ekitaldiak MEC-en erreserbak/txartelak konfiguratuta dituenean, bisitaria erreserba-aingura duen gertaeraren orrialdera eramaten duten erreserba-botoiak ( [ACTION:BOOK] #book eskaintzen dituzte.
• Aukeran, federaziorako (Xabia Central edo beste nodo batzuk) REST jario bat erakutsi dezakezu argitaratutako gertaerak eta ezagutzarekin lerrokatutako metadatuak dituena.

Ez ditu MEC panela edo prezioen, ezeztapenen edo ordainketa-pasabideen legezko ezarpenak ordezkatzen; WordPress-en dagoeneko dituzun datuei buruzko elkarrizketa eta informazio geruza bat da.

1.2 Zein arazo konpontzen du?

Gehigarri hau gabe, laguntzaileak datak asmatu edo testu estatikoa kopiatu besterik ezin du egin.

Xabia MEC- ekin, erantzunak MEC-en ohiko mec-events argitalpen eta metadatuekin koordinatutako SQL kontsultetan eta “zer gertatzen da asteburu honetan?” edo “ba al dago lekurik libre?” bezalako galderak interpretatzen laguntzen dioten testuinguru-arauetan oinarritu daitezke.

1.3 Produktuaren identifikazioa (erreferentzia erabilgarria)

• Ordaindu Polar (harpidetza): https://buy.polar.sh/polar_cl_wEzwnqMvZIrPelny1I5HNIsdcVjGs1UO12Roj3zzxIm
• Polar Produktuaren IDa (UUID): 8078756b-c566-4557-a55d-3712d8e47c44 — laguntza-zerbitzuari eska diezaiokezu fakturazioa edo webhooka Hub-ean kudeatzen baduzu.

1.4 Ezinbesteko eskakizunak

2. zatia — Urratsez urratseko instalazioa

2.1 Hasi aurretik

1. ZIP fitxategiak eduki: Xabia Agent Core eta Xabia MEC (eta MEC Webnus biltegi ofizialetik, oraindik ez baduzu).
2. Federazioa edo hodeiko integrazioak erabiliko badituzu, baieztatu zure hosting-ak REST APIa ( /wp-json/ ) onartzen duela.

2.2 Gomendatutako aktibazio-ordena

1. Xabia Agent Core → Aktibatu.
2. Gertaeren egutegi modernoa → Aktibatu.
3. Xabia MEC → Aktibatu Core-ren ondoren .

Xabia MEC Core gabe aktibatzen baduzu, abisu bat ikusiko duzu mahaigainean: lehenik Xabia Agent Core aktibatu behar duzu.

2.3 Xabia MEC ZIPetik instalatu

1. Hasi saioa administratzaile gisa.
2. Pluginak → Gehitu berria → Plugin bat igo .
3. Aukeratu Xabia MEC ZIP fitxategia.
4. Instalatu orain → Aktibatu plugina .

2.4 Egiaztatu WordPress-ek plugina ezagutzen duela

Xabia MEC Pluginetan agertu beharko litzateke. Xabia Agent → Addons atalean, “Xabia — Modern Events Calendar” txartelak WordPress egoera (aktibo / instalatuta / instalatu gabe) erakutsi beharko luke xabia-mec/xabia-mec.php fitxategiaren ondoan.

3. zatia — “Gehigarriak” pantaila: Polar harpidetza eta lizentzia

Ireki Xabia Agent → Gehigarriak .

Bertan MEC gehigarriaren aukera komertzial guztiak kudea ditzakezu.

3.1 Pantaila-testu orokorrak

• “Gehigarriak” izenburua eta azpititulua: azaldu Hub Polar txapak Xabia zerbitzarian harpidetza balioduna direla, plugina WordPress-en aktibo dagoen ala ez kontuan hartu gabe .
• “Lizentziak hub-arekin sinkronizatu” botoia (Polar eremuaren goiko barra): Hub-a harpidetza-txartel guztiak berriro egiaztatzera behartzen du. Erabili hau Polar-en ordaindu edo gako berri bat itsatsi ondoren.
• “Ireki WordPress pluginak” : Xabia MEC aktibatu behar baduzu, pluginetarako sarbide azkarra.

3.2 “Xabia — Ekitaldi Modernoen Egutegia” txartela — elementu bakoitza

3.3 Polar-etik erosi ondoren

1. Kopiatu Polarrek ematen dizun lizentzia-giltza .
2. Gehigarrietan , itsatsi MEC txartelean eta sakatu Aktibatu / Eguneratu harpidetza .
3. Egin klik Lizentzia sinkronizatu edo Lizentziak hub globalarekin sinkronizatu aukeran .
4. Itxaron minutu batzuk Hub-ak aktibazio atzeratua aplikatzen badu eta kargatu berriro gehigarrien orria.

4. zatia — Agentearen konfigurazioa (iturria «Addon MEC»)

Sartu Xabia Agente , sortu edo editatu gertaeren berri izan behar duen agentea.

4.1 Aukeratu letra-tipo mota

«Informazio iturria» atalean ( source_type ):

• Aukeratu “Native Addons (Kanpoko konektorea)” zure Core instalazioak konektore natibo aktiboak detektatzen baditu bakarrik ( Xabia MEC barne hartzen du WordPress-eko Hub eta MEC lizentzia zuzenak direnean).
• Aukera gaituta ikusten ez baduzu, egiaztatu Xabia MEC aktibo dagoela eta Addons-ek Hub Polar: MEC-erako aktiboa erakusten duela.

4.2 Gehigarrien hautatzailea ( addon_slug )

Gehigarria aukeratzean agertzen den atalean, zabaldu zerrenda eta hautatu MEC — Modern Events Calendar (internal slug mec ) izeneko sarrera. Xabia MEC pluginak erregistratutako konektorea da hau.

4.3 Hautatzailearen azpian dagoen ohar informatiboa

MEC hautatzen denean, ikonoa duen testua ikusiko duzu:

MEC gehigarria aktibo: Erreserba eta erabilgarritasun eremuak automatikoki sinkronizatzen dira.

Ohiko aurrezarpena erabiltzen baduzu, ez duzula “lekuen” zutabeak eskuz asmatu beharrik gogorarazteko balio du.

4.4 “Konektatu eta mapatu” botoia

1. Sakatu “Konektatu eta mapatu” botoia .
2. Sistemak proba-kontsulta bat exekutatzen du konektorearen SQLarekin (errenkada bat gehienez) benetako zutabeak zerrendatzeko.
3. Hub lizentzia MECerako aktibo ez badago, harpidetza beharrezkoa dela adierazten duen errore bat ikusiko duzu; ezingo duzu mapaketa aurrizkirik jarri aktibatu arte.
4. Dena ondo badoa, zutabeak jasotzen ditu eta, MEC-rentzat, atributu-taulari aplika diezazkiokeen mapatze-errenkada ( fields ) aurrez konfiguratu bat.

4.5 Aurrezarritako eremuen mapaketa (katalogo ofiziala)

Mapaketako errenkada bakoitzak honako hauek ditu: CSV/SQL zutabe bat , etiketa irakurgarri bat , rol bisual bat , ENTITY bat (kontrol-laukia) eta adierazpen bat . Konektorearen ordena logikoa hau da:

CPT morroiarekin edo beste Core tresna batzuekin zutabe gehigarriak gehi ditzakezu, baina aurrezarpenak fluxu estandarra hartzen du barne.

4.6 Urruneko datu-base konexioa (host, SQL)

Xabia MEC-ek Xabia Woo-ren eredu bera jarraitzen du: agenteak Addon → MEC natiboa erabil dezake gertaerak beste webgune batean egon arren.

Erabili modu hau honako kasu hauetan:

• Txata dagoen guneak Xabia Agent Core eta Xabia MEC aktibo ditu.
• Benetako gertaerak urruneko WordPress datu-base batean daude, adibidez https://tu-sitio-con-eventos.com helbidean.
• MEC gehigarriaren arau semantikoak (datak, lekuak, kategoriak, erabilgarritasun kualitatiboa) mantendu nahi ditu, baina datuak urruneko SQL bidez irakurri.

Urratsak:

1. Informazio iturrian , hautatu Native Addon (konektore automatikoa) .
2. Goitibeherako menuan, aukeratu Ekitaldi Modernoen Egutegia (MEC) .
3. Bete Host , DB , User , Password eta, hala badagokio, Prefix ( wp_ , wpdb_ , etab.).
4. Sakatu Konektatu eta Mapa .
5. Gorde agentea, sinkronizatu datuak eta entrenatu bektoreak erabiltzen badituzu.

Aurrizkia eremua hutsik uzten bada, Core-k urruneko datu-basearen aurrizki aktiboa detektatzen saiatuko da eta wp_ erabiliko du ordezko gisa.

4.6.1 Alternatiba: urruneko MEC aurrezarpena SQL hutsetik

Xabia MEC txat gunean instalatuko ez baduzu, zuzenean Core erabil dezakezu:

1. Aukeratu Kanpoko datu-basea (urruneko SQL) .
2. Sakatu Erabili urruneko MEC aurrezarpena .
3. Bete urruneko SQL kredentzialak eta probatu kontsulta.
4. Gorde, sinkronizatu eta entrenatu.

Alternatiba honek gertaeren katalogo bat sortzen du SQL bidez ( sql_preset = mec_remote ) eta mapaketa automatikoa erabiliz, baina ez ditu MEC gehigarriaren gaitasun guztiak kargatzen. Lizentzia aktibo bat duten instalazio komertzialetarako, gomendatutako lan-fluxua Native Add-on → MEC da.

4.7 Gorde agentea

Sakatu “Gorde agentea” (edo pantailan duzun baliokide botoia) source_type , addon_slug , mapping eta SQL kredentzialak gordetzeko.

5. zatia — Agentearen alboko barra: Memoria, sinkronizazioa eta jolas-eremua

Dagoeneko dagoen agente bat editatzen duzunean (ez agente “berri” huts bat), memoriaren alboko barra ikusiko duzu. Kontrol bakoitzak honako hau egiten du:

6. zatia — Nola konfiguratu behar den ekitaldien egutegi modernoa WordPress-en

Gehigarriak MECek dagoeneko gordetzen duena irakurtzen du , erreserbak eta eskuragarri dauden espazioak zentzua izan dezaten.

1. ME Egutegia → Ezarpenak → Erreserbak atalean, aktibatu erreserba modulua MEC erreserba funtzioa erabiltzen baduzu (Webnus dokumentazioaren / zure Lite edo Pro edizioaren arabera).
2. Ekitaldi bakoitzerako, konfiguratu sarrera/txartelen mugak kalkula daitekeen edukiera egon nahi baduzu.
3. Argitaratu edo programatu gertaerak ( publish / future ); konektorearen SQL sistemak gaurko datak eta erroko gertaerak ( post_parent = 0 ) iragazten ditu indizean seme-alaben agerpenak bikoiztu ez daitezen.

Ekitaldi batek ez badu online erreserbarik, sistemak [ACTION:BOOK] botoia ezaba dezake, nahiz eta IAk testu informatiboak iradoki.

7. zatia — Bisitarien esperientzia txatean

7.1 MEC testuinguruak interpretatzen laguntzen dituen galderak

Routerrean txertatutako bilaketa-arauei esker, ereduak ondo erabiltzen ditu:

• “Asteburu honetan” bezalako datak eta esamoldeak (sistemak Data zutabearen arabera iragaztea iradokitzen du).
• Zirrikituak mec_available_slots zenbaki bat dagoenean.
• Lekua ( Lugar / mec_location ).
• Kategoriak eta etiketak Kategoriak_Etiketak atalean elkartuta.

7.2 Erreserba botoia

Proiektuak MEC erreserba -motorra erabiltzen duenean eta ekitaldiak erreserba gaituta duenean, erantzunak gertaeraren orria irekitzen duen esteka edo botoia izan dezake (erreserba-aingura lehenetsi batekin).

WordPress txatean tokiko MECik gabeko urruneko MEC katalogoetan, Xabiak ez ditu tokiko erreserba botoirik sortzen ( [ACTION:BOOK:ID] ) Core ≥ 1.0.202tik aurrera: laguntzaileak beti bidaltzen du esteka bat urruneko gertaeraren Esteka eremura ( [ACTION:URL:Link] ). Gertaerak erreserba bat badu jatorrizko webgunean, urruneko erregistro horrek kudeatuko du prozesua.

7.3 Pribatutasuna

Bisitariak txat pluginak erakusten duena bakarrik ikusten du. Mezuak Core konfigurazioaren arabera prozesatzen dira (IA hornitzailea, Hub-a, etab.).

Mesedez, kontsultatu zure gunearen pribatutasun-politika eta Oinarrizko Eskuliburua .

8. zatia — MEC Federazio Zubia («MEC Zubia» menua)

Xabia MEC aktibo dagoenean, “MEC Bridge” agertzen da Xabia menuan (agentearen ezarpenen azpimenua).

8.1 Pantailak erakusten duena

8.2 GET parametroak (API)

• per_page (1–200, lehenetsia 100).
• page (orrialde-multzoa).

Argitaratze edo programazio egoera duten mec-events soilik, root ( post_parent = 0 ), mec_start_date ren arabera ordenatuta.

9. zatia — Errepikapena eta serie bakoitzeko errenkada bat

Konektorea MEC metadatuetan hurrengo data duen serie bakoitzeko erro-gertaera bat indexatzeko diseinatuta dago (ez ditu dozenaka errenkada zabaltzen errepikapen bakoitzeko, MECek seme-alaba gisa adierazten baditu). Zure kasuak seme-alaba gertaerak bakarrik erabiltzen baditu, jarri harremanetan laguntzarekin edo integratzaile batekin mantentze pertsonalizatuaren bidez SQL doitzeko.

10. zatia — Arazo ohikoenak eta kontrol-zerrenda

Kontrol-zerrenda azkarra: Core ≥ 1.0.24 → MEC aktiboa → Xabia MEC aktiboa → Hub aktiboa → Iturburu gehigarria + mec → Konektatu eta mapatu → Gorde → Sinkronizatu datuak → Entrenatu (hala badagokio) → Probatu Playground-en .

11. zatia — Praktika onak

• Mantendu MEC eguneratuta eta berrikusi bertan behera utzitako gertaerak hurrengo sinkronizaziora arte data zaharkituak ez eskaintzeko.
• Erabili kategoria argiak agenteak Kategoriak_Etiketak ataletik behar bezala iragazi ahal izan dezan.
• Beti probatu benetako erreserba leiho pribatu batean gertaeraren txantiloia aldatu ondoren.
• Barne-dokumentuan nork duen Polar giltza eta nork sakatu dezakeen Sinkronizazio Lizentzia .

12. zatia — Laguntza

• Xabia / Digixop (instalazioa, Core eta MEC gehigarrien lizentziak, Hub): ohiko kontaktua help@xabia.ai helbidean .
• Polar Billing : Erabili gehigarrietatik lotutako bezeroentzako ataria harpidetza aktibo dagoenean.
• MEC egutegiaren arazoak (Webnus pluginen akatsak, estiloak, kode laburrak): Webnus/MEC laguntza .

Lizentzia nagusia, tokenak eta zorroa lortzeko, ireki Oinarrizko Eskuliburua .