Redaktorë të personalizuar

Ka punë që nuk gjendet në asnjë panel, sepse është vetëm e juaja: rillogaritja e çmimeve sipas formulës së furnizorit, përputhja e katalogut me një sistem tjetër kontabël, ekrani "plotëso karakteristikat e grupit me një kalim". Seksioni "Redaktorë të personalizuar" ju lejon ta shkruani vetë një mini-redaktor të tillë (ose ta porosisni) dhe ta ekzekutoni brenda panelit të administrimit — në një mjedis të izoluar, me akses pikërisht në ato të dhëna që keni lejuar.

Për ta hapur: Paneli i administrimit → Redaktorë të personalizuar (admin.cenaly.com/custom-editors). Seksioni aktivizohet me kartën "Redaktorë të personalizuar (SDK)" në dyqanin e aplikacioneve — si parazgjedhje është i fshehur. Butoni "📌 Në menynë anësore" në vetë faqen e kalon atë në menynë anësore, kur nevojitet shpesh.

Çfarë është ky seksion#

Shtojca është një skript i përpiluar (index.js) dhe përshkrimi i tij (manifest.json). Paneli e ngarkon skriptin në një kornizë të izoluar: ai nuk ka akses as në sesionin tuaj, as në kodin e panelit, as në rrjet. Mund të komunikojë me të dhënat vetëm përmes urës — një grup kërkesash të lejuara, secila prej të cilave kontrollohet sipas lejeve të dhëna.

Faqja përbëhet nga blloqet:

Redaktori i hapur zë të gjithë ekranin, dhe adresa e faqes merr shënimin ?app=<identifikuesi> — një lidhje e tillë mund të ndahet me ata që kanë akses.

Çfarë nevojitet për ta nisur#

Hapi 1. Vendosni kush do ta shkruajë redaktorin#

Ka tre rrugë, dhe ato ndryshojnë sipas kujt e mban kodin:

Në të tre rastet instalimi mbetet në duart e pronarit: edhe një zhvillues me grant mund vetëm ta ekzekutojë kodin e tij në modalitetin e zhvilluesit, por nuk mund ta instalojë atë në llogari.

Hapi 2. Zhvillim me IA (vibe-coding)#

Blloku "🤖 Zhvillim me IA (vibe-coding)" ofron katër gjëra për t'ia dhënë detyrën një agjenti të IA-së (Claude Code, Cursor dhe të ngjashëm) pa i shpjeguar kontratën nga e para:

1. "⬇️ Shkarko shabllonin e projektit (zip)" — një strukturë e gatshme e shtojcës: manifesti, pika e hyrjes, përshkrimi i kontratës (GUIDE.en.md) dhe udhëzimet për agjentin. Arkivi përpilohet direkt në shfletues, nuk ka nevojë të shkarkohet asgjë e jashtme.
2. "📋 Kopjo prompt-in për agjentin" — teksti i detyrës në anglisht: nis nga shablloni, konsultohu me guidën, si ta verifikosh rezultatin.
3. Konfigurimi i grupit të mjeteve për agjentin — me të agjenti e përpilon shtojcën, ngre një kopje lokale të mjedisit të izoluar, bën pamje ekrani dhe fotografi të gjendjes, dhe në fund përpilon versionin: zip për instalim manual ose version në GitHub.
4. "⬇️ Shkarko pamjen e katalogut (fixture testuese)" — kategoritë dhe artikujt tuaj si skedar, që agjenti të testojë me të dhëna reale, jo të sajuara.

⚠️ Nga pamja hiqen plotësisht fushat e personalizuara të shtojcave të tjera: të dhënat që një shtojcë e huaj ruan në kartat tuaja nuk largohen nga llogaria bashkë me fixturen.

Hapi 3. Instaloni redaktorin#

Nga skedarët. Blloku "Instalo redaktor": zgjidhni "Paketa (index.js)" dhe "Manifesti (manifest.json)" → "Kontrollo dhe instalo". Paneli fillimisht kontrollon manifestin — identifikuesin, emrin e lokalizuar, versionin, versionin minimal të SDK-së, vendosjet, lejet dhe listën e hosteve të rrjetit — dhe më pas shfaq pëlqimin: "Ky redaktor kërkon:" dhe listën e lejeve në gjuhë të thjeshtë. Derisa të shtypni "Instalo", nuk instalohet asgjë.

Nga GitHub. Blloku "Instalim nga GitHub": fusha "Repozitori (URL ose owner/repo)", fusha "Etiketa (bosh = versioni i fundit)" dhe butoni "Kontrollo repozitorin". Konventa është e thjeshtë: manifest.json në rrënjën e repozitorit, dist/index.js e përpiluar në etiketë, etiketa në formën v{versioni}. Manifesti dhe paketa tërhiqen direkt nga shfletuesi juaj. Në të dyja rastet, gjatë instalimit llogaritet dhe mbahet mend gjurmë e paketës (sha256): nëse skedari zëvendësohet më vonë, ekzekutimi bllokohet dhe paneli kërkon të riinstaloni redaktorin.

Të drejtat dhe vendet e vendosjes#

Të drejtat (të quajtura edhe skop) plugini i kërkon në manifest, ndërsa ju i konfirmoni gjatë instalimit. Lista e plotë është kjo, Ura nuk bën asgjë më shumë:

Atë që nuk është fare në listë, plugin-i nuk e merr me asnjë cilësim: mysafirët dhe klientët, porositë, faturat, financat, punonjësit, bisedat dhe telefonatat Ura nuk i jep.

Vendet e vendosjes (slotet) janë tre:

Regjimi i zhvilluesit dhe aksesi për kontraktorin#

Regjimi i zhvilluesit (blloku "🛠️ Regjimi i zhvilluesit") e monton plugin-in drejtpërdrejt nga kompjuteri juaj: fusha "URL e paketës" pranon vetëm adresat localhost / 127.0.0.1, pranë saj është "JSON i manifestit", butoni "Nis sesionin dev". Gjurmëza në këtë rast nuk fiksohet, ndërsa sesioni zgjat deri në mbylljen e skedës; "Ndalo sesionin dev" e fik atë menjëherë.

Grantet për zhvilluesin (blloku "👩‍💻 Aksesi i zhvilluesit") nevojiten kur nuk shkruan vetë pronari. Zhvilluesit i krijohet një llogari e zakonshme punonjësi, dhe më pas pronari lëshon grantin: "Email i zhvilluesit (login-i i tij staff)", "Të drejtat e lejuara", "Afati i vlefshmërisë (ditë)" dhe një shënim opsional → "Jep akses". Mund të tërhiqet në çdo moment me butonin "Tërhiq".

Çfarë jep granti dhe çfarë jo:

• jep — vetëm regjimin e zhvilluesit me të drejtat që keni shënuar (si parazgjedhje afati është 14 ditë, maksimumi 90);
• të drejtat priten me prerje: atë që kërkon manifesti dhe atë që është dhënë me grant; tepricën plugin-i nuk e merr, edhe nëse e kërkon në manifest;
• nuk jep — instalimin, aktivizimin dhe fshirjen e plugin-eve: këto i mbeten pronarit.

Përditësimi, aktivizimi dhe fshirja#

Përditësimi automatik nuk ekziston me qëllim: një version i ri i kodit të huaj është një gjurmë e re dhe, ndoshta, të drejta të reja, prandaj përditësimi është gjithmonë veprim i vetëdijshëm i pronarit.

Zgjerimet e integruara#

Një pjesë e moduleve tona është paketuar në të njëjtin format — kjo shihet nga sjellja, por nuk ka nevojë t'i instaloni: ato vijnë bashkë me panelin dhe aktivizohen me kartë në dyqanin e aplikacioneve, jo në këtë seksion.

Tani një modul i tillë është vetëm "Mercury/VetIS" për Rusinë: ai jeton si skedë e seksionit "Magazina", ekzekutohet në të njëjtën sandbox dhe me të njëjtat kontrolle të gjurmëzës. Në listën e redaktorëve të instaluar zgjerimet e integruara nuk përfshihen.

Çfarë mund dhe çfarë nuk mund redaktori#

Plugin-et e palëve të treta shënohen në kartë me një paralajmërim: "Aplikacion i palës së tretë në sandbox — ai nuk kërkon kurrë fjalëkalim." Nëse plugin-i kërkon login-in e panelit, të dhëna pagese ose kodin nga SMS — kjo është mashtrim, jo punë e zgjerimit.

Kufizimet#

• Seksioni është i fikur si parazgjedhje dhe është menduar për ata që shkruajnë kod (ose e porosisin atë): një pronar i zakonshëm nuk ka çfarë të bëjë këtu.
• Gjithçka përveç shikimit është vetëm për pronarin e llogarisë. Punonjësi e sheh hub-in vetëm për lexim; modaliteti i zhvilluesit hapet vetëm me një grant aktiv.
• Repozitorët privatë të GitHub nuk mbështeten — repozitori duhet të jetë publik, instalimi bëhet sipas etiketës.
• Nuk ka përditësim automatik: përditësimin e plugin-it e nis gjithmonë pronari.
• Nuk ka dyqan për plugin-et e të tjerëve. Zgjerimet e gatshme nuk publikohen dhe nuk shiten përmes panelit — burimi është vetëm skedari juaj ose repozitori juaj.
• Ka tre vende (faqja juaj, butoni i katalogut, skeda e magazinës) — plugin-i nuk mund të futet në një ekran arbitrar të panelit.
• Ura nuk jep të dhëna për mysafirët, porositë, financat, punonjësit dhe bisedat — kjo nuk anashkalohet me të drejta, kërkesa të tilla thjesht nuk ekzistojnë.
• Nuk ka një regjistër të veçantë "plugin-i bëri këtë e atë". Të drejtat shihen në kartën e tij, ndërsa ndryshimet e katalogut hyjnë në historikun e zakonshëm të artikujve; nëse ju nevojitet kontroll, filloni me një plugin që ka vetëm të drejtë leximi.
• Kufij teknikë: paketa deri në 4 MB, deri në 8 adresa rrjeti në manifest, deri në 1 MB për një çelës ruajtjeje; ekzekutimi në server — deri në 30 sekonda dhe deri në 50 kërkesa në internet njëherësh.
• Të dhënat e plugin-it mbeten në renë e markës suaj: për një llogari në cenaly.ru gjendja e pjesës serverore ndodhet në konturin rus.

Zgjidhja e problemeve#

Pyetje të shpeshta#

A duhet të dini të programoni?#

Për të instaluar një publikim të gatshëm — jo. Për të marrë vetë publikimin — po: atë e shkruan një zhvillues ose një agjent IA sipas shabllonit tonë nga blloku "Zhvillimi me IA". Seksioni është një mjet për kod, jo një konstruktor "me miun".

A mundet një plugin i huaj të shohë klientët ose të ardhurat e mia?#

Jo. Plugin-i punon në një sandbox dhe i merr të dhënat vetëm përmes urës, ndërsa ura di saktësisht gjashtë gjëra: katalogun, çmimet dhe listat e ndalimit, regjistrin e magazinës, ruajtjen e vet, thirrjen e pjesës së vet serverore dhe elementet e ndërfaqes. Mysafirë, porosi, fatura, financa, punonjës dhe biseda aty nuk ka në parim. Çfarë lejohet konkretisht për një plugin të caktuar shihet gjithmonë në kartën e tij në rreshtin "Të drejtat".

Si t'ia jap zhvillimin një kontraktori pa e lënë atë të hyjë në të gjithë llogarinë?#

Krijoni për të një llogari punonjësi dhe më pas jepni një grant në bllokun "Qasja e zhvilluesit": shënoni vetëm të drejtat e nevojshme dhe vendosni një afat (si parazgjedhje 14 ditë, maksimumi 90). Ai do të marrë modalitetin e zhvilluesit dhe asgjë më shumë; instalimi i plugin-it gjithsesi mbetet në duart tuaja. Granti tërhiqet me një buton.

A përditësohet plugin-i vetë kur autori nxjerr një version të ri?#

Jo. Përditësimin e nis pronari: "Kontrollo përditësimet" → "Përditëso në …". Kështu versioni i ri nuk shfaqet në llogari pa dijeninë e njeriut — bashkë me versionin mund të kenë ndryshuar edhe të drejtat e kërkuara.

Ku i ruan plugin-i cilësimet dhe të dhënat e tij?#

Në llogarinë tuaj, në një ruajtje të veçantë nën identifikuesin e tij (deri në 1 MB për çelës), plus, nëse i përdor ato, në fushat e personalizuara të kartelave tuaja — çdo plugin sheh vetëm hapësirën e vet. Për një llogari në cenaly.ru pjesa serverore dhe gjendja e saj mbeten në konturin rus.

Si ndryshon kjo nga API dhe MCP?#

API për zhvilluesit dhe MCP i centralit tuaj telefonik nevojiten kur programi punon nga jashtë: faqja juaj, një sistem i huaj kontabël, një agjent IA. Redaktori i personalizuar, përkundrazi, është një ndërfaqe brenda panelit: punonjësi e hap si një faqe të zakonshme të panelit dhe nuk del nga dritarja e punës.

Seksione të lidhura#

• Dyqani i aplikacioneve — ku aktivizohet seksioni dhe zgjerimet e integruara
• Magazina — skeda ku jetojnë zgjerime si "VetIS", dhe regjistri i artikujve
• Importi i katalogut — rruga standarde e ngarkimit të artikujve, nëse detyra është vetëm kjo
• Vitrina me kodin tuaj (headless) — kontrata e hapur e të dhënave për një faqe të jashtme
• API dhe MCP i centralit tuaj telefonik dhe Guest API për agjentë IA — punë nga jashtë, jo brenda panelit
• Punonjësit dhe turnet — llogaria për zhvilluesin dhe rolet
• Siguria dhe të dhënat — ku ruhen të dhënat dhe kush ka qasje në to
• Mbështetja — ku të shkruani nëse plugin-i sillet në mënyrë të dyshimtë