کسٹم ایڈیٹرز

کچھ کام ایسے ہوتے ہیں جو کسی بھی پینل میں نہیں ہوتے، کیونکہ وہ صرف آپ کے ہیں: سپلائر کے فارمولے کے مطابق قیمتوں کا دوبارہ حساب، کیٹلاگ کا کسی دوسرے اکاؤنٹنگ سسٹم سے موازنہ، «ایک ہی پاس میں بیچ کی خصوصیات بھرنے» کی اسکرین۔ «کسٹم ایڈیٹرز» کا سیکشن آپ کو ایسا منی ایڈیٹر خود لکھنے (یا منگوانے) اور ایڈمن پینل کے اندر چلانے دیتا ہے — ایک سینڈ باکس میں، صرف انہی ڈیٹا تک رسائی کے ساتھ جن کی آپ نے اجازت دی ہو۔

کھولیں: ایڈمن پینل → کسٹم ایڈیٹرز (admin.cenaly.com/custom-editors)۔ یہ سیکشن ایپ اسٹور میں «کسٹم ایڈیٹرز (SDK)» کارڈ سے فعال ہوتا ہے — بطور ڈیفالٹ یہ چھپا ہوتا ہے۔ صفحے ہی پر موجود «📌 سائیڈ بار میں» بٹن اسے سائیڈ مینو میں لے آتا ہے، جب اس کی بار بار ضرورت ہو۔

یہ کیا سیکشن ہے#

پلگ ان ایک بلڈ شدہ اسکرپٹ (index.js) اور اس کی تفصیل (manifest.json) پر مشتمل ہوتا ہے۔ پینل اسکرپٹ کو ایک الگ تھلگ فریم میں لوڈ کرتا ہے: اسے نہ آپ کے سیشن تک رسائی ہوتی ہے، نہ ایڈمن پینل کے کوڈ تک، نہ نیٹ ورک تک۔ یہ ڈیٹا سے بات صرف برج کے ذریعے کر سکتا ہے — اجازت یافتہ درخواستوں کا ایک مجموعہ، جن میں سے ہر ایک دی گئی اجازتوں کے مطابق جانچی جاتی ہے۔

صفحہ ان بلاکس پر مشتمل ہے:

کھلا ایڈیٹر پوری اسکرین لے لیتا ہے، اور صفحے کے پتے میں ?app=<شناخت کنندہ> کا اضافہ ہو جاتا ہے — یہ لنک آپ ان لوگوں کے ساتھ شیئر کر سکتے ہیں جن کے پاس رسائی ہو۔

چلانے کے لیے کیا درکار ہے#

مرحلہ 1۔ فیصلہ کریں کہ ایڈیٹر کون لکھے گا#

تین راستے ہیں، اور ان میں فرق یہ ہے کہ کوڈ کس کے پاس رہتا ہے:

تینوں صورتوں میں تنصیب مالک ہی کے پاس رہتی ہے: گرانٹ والا ڈویلپر بھی اپنا کوڈ صرف اپنے ڈویلپر موڈ میں چلا سکتا ہے، اسے اکاؤنٹ میں نصب نہیں کر سکتا۔

مرحلہ 2۔ AI کے ساتھ ڈویلپمنٹ (وائب کوڈنگ)#

«🤖 AI کے ساتھ ڈویلپمنٹ (وائب کوڈنگ)» بلاک چار چیزیں دیتا ہے، تاکہ کام AI ایجنٹ (Claude Code، Cursor اور ان جیسے) کو سونپا جا سکے اور اسے کنٹریکٹ شروع سے سمجھانا نہ پڑے:

1. «⬇️ پروجیکٹ ٹیمپلیٹ ڈاؤن لوڈ کریں (zip)» — پلگ ان کا تیار ڈھانچہ: مینی فیسٹ، انٹری پوائنٹ، کنٹریکٹ کی تفصیل (GUIDE.en.md) اور ایجنٹ کے لیے ہدایات۔ آرکائیو براؤزر ہی میں بنتا ہے، باہر سے کچھ ڈاؤن لوڈ کرنے کی ضرورت نہیں۔
2. «📋 ایجنٹ کے لیے پرامپٹ کاپی کریں» — انگریزی میں ٹاسک کا متن: ٹیمپلیٹ سے شروع کریں، گائیڈ سے موازنہ کریں، نتیجہ کیسے جانچیں۔
3. ایجنٹ کے لیے ٹول سیٹ کی کنفیگریشن — اس کے ساتھ ایجنٹ پلگ ان بلڈ کرتا ہے، سینڈ باکس کی مقامی اسٹینڈ کاپی اٹھاتا ہے، اسکرین شاٹس اور حالت کے اسنیپ شاٹس بناتا ہے، اور آخر میں ریلیز تیار کرتا ہے: دستی تنصیب کے لیے zip یا GitHub میں ریلیز۔
4. «⬇️ کیٹلاگ کا اسنیپ شاٹ ڈاؤن لوڈ کریں (ٹیسٹ فکسچر)» — آپ کی کیٹیگریز اور آئٹمز ایک فائل میں، تاکہ ایجنٹ فرضی ڈیٹا کے بجائے حقیقی ڈیٹا پر ٹیسٹ کرے۔

⚠️ اسنیپ شاٹ سے دوسرے پلگ انز کے کسٹم فیلڈز مکمل طور پر کاٹ دیے جاتے ہیں: جو ڈیٹا کوئی دوسری ایکسٹینشن آپ کے کارڈز پر محفوظ کرتی ہے، وہ فکسچر کے ساتھ اکاؤنٹ سے باہر نہیں جاتا۔

مرحلہ 3۔ ایڈیٹر نصب کریں#

فائلوں سے۔ «ایڈیٹر نصب کریں» بلاک: «بنڈل (index.js)» اور «مینی فیسٹ (manifest.json)» منتخب کریں → «جانچیں اور نصب کریں»۔ پینل پہلے مینی فیسٹ کی جانچ کرتا ہے — شناخت کنندہ، مقامی نام، ورژن، SDK کا کم از کم ورژن، جگہیں، اجازتیں اور نیٹ ورک ہوسٹس کی فہرست — اور پھر رضامندی دکھاتا ہے: «یہ ایڈیٹر درخواست کرتا ہے:» اور آسان زبان میں اجازتوں کی فہرست۔ جب تک آپ «نصب کریں» نہ دبائیں، کچھ بھی نصب نہیں ہوتا۔

GitHub سے۔ «GitHub سے تنصیب» بلاک: «ریپوزٹری (URL یا owner/repo)» فیلڈ، «ٹیگ (خالی = تازہ ترین ریلیز)» فیلڈ اور «ریپوزٹری کی جانچ کریں» بٹن۔ اصول سادہ ہے: ریپوزٹری کی جڑ میں manifest.json، ٹیگ میں بلڈ شدہ dist/index.js، اور ٹیگ v{ورژن} کی شکل میں۔ مینی فیسٹ اور بنڈل براہ راست آپ کے براؤزر سے کھینچے جاتے ہیں۔ دونوں صورتوں میں تنصیب کے وقت بنڈل کا فنگر پرنٹ (sha256) شمار اور محفوظ کیا جاتا ہے: اگر بعد میں فائل بدل دی جائے، تو چلانا بلاک ہو جائے گا اور پینل ایڈیٹر دوبارہ نصب کرنے کو کہے گا۔

حقوق اور جگہیں#

حقوق (جنہیں اسکوپس بھی کہا جاتا ہے) پلگ اِن مینی فیسٹ میں مانگتا ہے، اور آپ انسٹال کرتے وقت ان کی تصدیق کرتے ہیں۔ مکمل فہرست یہ ہے، اس سے زیادہ برج کچھ نہیں کر سکتا:

جو فہرست میں بالکل نہیں ہے، وہ پلگ اِن کسی بھی ترتیب سے حاصل نہیں کر سکتا: مہمانوں اور کلائنٹس، آرڈرز، رسیدیں، مالیات، عملہ، پیغامات اور کالز برج فراہم نہیں کرتا۔

جگہیں (سلاٹس) تین ہیں:

ڈویلپر موڈ اور کنٹریکٹر تک رسائی#

ڈویلپر موڈ (بلاک «🛠️ ڈویلپر موڈ») پلگ اِن کو آپ کے کمپیوٹر سے براہِ راست ماؤنٹ کرتا ہے: «بنڈل URL» فیلڈ صرف localhost / 127.0.0.1 پتے قبول کرتی ہے، اس کے ساتھ «مینی فیسٹ JSON»، اور بٹن «dev سیشن شروع کریں»۔ اس صورت میں فنگر پرنٹ پن نہیں ہوتا، اور سیشن ٹیب بند ہونے تک قائم رہتا ہے؛ «dev سیشن روکیں» اسے فوراً بند کر دیتا ہے۔

ڈویلپر کو گرانٹس (بلاک «👩‍💻 ڈویلپر رسائی») اس وقت درکار ہوتے ہیں جب لکھنے والا مالک نہ ہو۔ ڈویلپر کے لیے ایک عام عملے کا اکاؤنٹ بنایا جاتا ہے، پھر مالک گرانٹ جاری کرتا ہے: «ڈویلپر کا ای میل (اس کا staff لاگ اِن)»، «اجازت یافتہ حقوق»، «میعاد (دنوں میں)» اور ایک اختیاری نوٹ → «رسائی دیں»۔ کسی بھی وقت «واپس لیں» بٹن سے منسوخ کیا جا سکتا ہے۔

گرانٹ کیا دیتا ہے اور کیا نہیں:

• دیتا ہے — صرف ڈویلپر موڈ ان حقوق کے ساتھ جو آپ نے نشان زد کیے (طے شدہ میعاد 14 دن، زیادہ سے زیادہ 90)؛
• حقوق تقاطع سے کترے جاتے ہیں: جو مینی فیسٹ مانگتا ہے اور جو گرانٹ سے دیا گیا؛ پلگ اِن اضافی کچھ نہیں پائے گا، چاہے مینی فیسٹ میں مانگے؛
• نہیں دیتا — پلگ اِن کی تنصیب، فعال کرنا اور حذف کرنا: یہ مالک کے پاس رہتا ہے۔

اپ ڈیٹ، فعال کرنا اور حذف کرنا#

خودکار اپ ڈیٹ جان بوجھ کر نہیں ہے: کسی اور کے کوڈ کا نیا ورژن ایک نیا فنگر پرنٹ ہے اور ممکنہ طور پر نئے حقوق بھی، اس لیے اپ ڈیٹ ہمیشہ مالک کا سوچا سمجھا عمل ہوتا ہے۔

بلٹ اِن ایکسٹینشنز#

ہمارے اپنے کچھ ماڈیولز اسی فارمیٹ میں پیک ہیں — یہ رویے سے نظر آتا ہے، مگر انہیں نصب کرنے کی ضرورت نہیں: وہ پینل کے ساتھ آتے ہیں اور ایپ اسٹور میں کارڈ سے فعال ہوتے ہیں، اس سیکشن سے نہیں۔

فی الحال ایسا ایک ہی ماڈیول ہے — روس کے لیے «Mercury/VetIS»: یہ «اسٹاک» سیکشن کے ٹیب میں رہتا ہے، اسی سینڈ باکس میں اور فنگر پرنٹ کی انہی جانچوں کے ساتھ چلتا ہے۔ بلٹ اِن ایکسٹینشنز نصب شدہ ایڈیٹرز کی فہرست میں شامل نہیں ہوتیں۔

ایڈیٹر کیا کر سکتا ہے اور کیا نہیں#

فریقِ ثالث کے پلگ اِن کارڈ پر انتباہ کے ساتھ نشان زد ہوتے ہیں: «سینڈ باکس میں فریقِ ثالث کی ایپ — یہ کبھی پاس ورڈ نہیں مانگتی۔» اگر پلگ اِن پینل کا لاگ اِن، ادائیگی کا ڈیٹا یا SMS کا کوڈ مانگے تو یہ دھوکہ ہے، ایکسٹینشن کا کام نہیں۔

حدود#

• یہ سیکشن بطور ڈیفالٹ بند ہے اور اُن کے لیے ہے جو کوڈ لکھتے ہیں (یا لکھواتے ہیں): عام مالک کے لیے یہاں کوئی کام نہیں۔
• دیکھنے کے علاوہ سب کچھ صرف اکاؤنٹ کے مالک کے پاس ہے۔ ملازم کو ہب صرف پڑھنے کے لیے نظر آتا ہے؛ ڈویلپر موڈ صرف فعال گرانٹ کے ساتھ۔
• نجی GitHub ریپوزٹریز معاون نہیں — ریپوزٹری عوامی ہونی چاہیے، تنصیب ٹیگ کے ذریعے ہوتی ہے۔
• خودکار اپ ڈیٹ نہیں ہے: پلگ ان کی اپ ڈیٹ ہمیشہ مالک شروع کرتا ہے۔
• دوسروں کے پلگ انز کا اسٹور نہیں ہے۔ تیار توسیعات پینل کے ذریعے شائع یا فروخت نہیں ہوتیں — ذریعہ صرف آپ کی فائل یا آپ کی ریپوزٹری ہے۔
• سلاٹ تین ہیں (اپنا صفحہ، کیٹلاگ کا بٹن، اسٹاک کا ٹیب) — پلگ ان پینل کی کسی بھی اسکرین میں داخل نہیں ہو سکتا۔
• برج مہمان، آرڈرز، مالیات، ملازمین اور گفتگو نہیں دیتا — حقوق سے اسے نظرانداز نہیں کیا جا سکتا، ایسی درخواستیں وجود ہی نہیں رکھتیں۔
• الگ لاگ «پلگ ان نے یہ کیا» نہیں ہے۔ حقوق کارڈ پر نظر آتے ہیں، اور کیٹلاگ کی تبدیلیاں عام آئٹم ہسٹری میں جاتی ہیں؛ اگر نگرانی چاہیے تو ایسے پلگ ان سے شروع کریں جسے صرف پڑھنے کا حق دیا گیا ہو۔
• تکنیکی حدیں: بنڈل 4 MB تک، مینی فیسٹ میں 8 نیٹ ورک ایڈریسز تک، اسٹوریج کی ایک کلید پر 1 MB تک؛ سرور پر عمل — 30 سیکنڈ تک اور ایک وقت میں 50 انٹرنیٹ کالز تک۔
• پلگ ان کا ڈیٹا آپ کے برانڈ کے کلاؤڈ میں رہتا ہے: cenaly.ru والے اکاؤنٹ میں سرور حصے کی حالت روسی دائرے میں رہتی ہے۔

مسائل کا حل#

اکثر پوچھے جانے والے سوالات#

کیا پروگرامنگ آنا ضروری ہے؟#

تیار ریلیز نصب کرنے کے لیے — نہیں۔ خود ریلیز حاصل کرنے کے لیے — ہاں: اسے ڈویلپر یا AI ایجنٹ «AI کے ساتھ ڈویلپمنٹ» بلاک کے ہمارے ٹیمپلیٹ کے مطابق لکھتا ہے۔ یہ سیکشن کوڈ کا آلہ ہے، «ماؤس» سے بنانے والا کنسٹرکٹر نہیں۔

کیا کوئی دوسرے کا پلگ ان میرے کلائنٹس یا آمدنی دیکھ سکتا ہے؟#

نہیں۔ پلگ ان سینڈ باکس میں چلتا ہے اور ڈیٹا صرف برج کے ذریعے حاصل کرتا ہے، اور برج صرف چھ چیزیں کر سکتا ہے: کیٹلاگ، قیمتیں اور اسٹاپ لسٹس، اسٹاک کی ڈائریکٹری، اپنا اسٹوریج، اپنے سرور حصے کی کال، اور انٹرفیس عناصر۔ مہمان، آرڈرز، رسیدیں، مالیات، ملازمین اور گفتگو وہاں بنیادی طور پر نہیں ہیں۔ کسی مخصوص پلگ ان کو کیا اجازت ہے، یہ ہمیشہ اس کے کارڈ پر «حقوق» کی سطر میں نظر آتا ہے۔

کسی ٹھیکیدار کو ڈویلپمنٹ کیسے دیں اور اسے پورے اکاؤنٹ میں داخل نہ ہونے دیں؟#

اس کے لیے ملازم کا اکاؤنٹ بنائیں، پھر «ڈویلپر رسائی» بلاک میں گرانٹ دیں: صرف مطلوبہ حقوق منتخب کریں اور مدت مقرر کریں (بطور ڈیفالٹ 14 دن، زیادہ سے زیادہ 90)۔ اسے ڈویلپر موڈ ملے گا اور اس کے علاوہ کچھ نہیں؛ پلگ ان کی تنصیب پھر بھی آپ ہی کے پاس رہے گی۔ گرانٹ ایک بٹن سے واپس لی جاتی ہے۔

جب مصنف نیا ورژن جاری کرے تو کیا پلگ ان خود اپ ڈیٹ ہو جائے گا؟#

نہیں۔ اپ ڈیٹ مالک شروع کرتا ہے: «اپ ڈیٹس چیک کریں» → «… تک اپ ڈیٹ کریں»۔ اس طرح نیا ورژن کسی شخص کے علم کے بغیر اکاؤنٹ میں نہیں آئے گا — ورژن کے ساتھ مطلوبہ حقوق بھی بدل سکتے ہیں۔

پلگ ان اپنی ترتیبات اور ڈیٹا کہاں محفوظ کرتا ہے؟#

آپ کے اکاؤنٹ میں، اس کے شناخت کنندہ کے تحت ایک الگ اسٹوریج میں (فی کلید 1 MB تک)، اور اگر وہ انہیں استعمال کرتا ہے تو آپ کے کارڈز کے کسٹم فیلڈز میں — ہر پلگ ان صرف اپنی جگہ دیکھتا ہے۔ cenaly.ru والے اکاؤنٹ میں سرور حصہ اور اس کی حالت روسی دائرے میں رہتی ہے۔

یہ API اور MCP سے کیسے مختلف ہے؟#

ڈویلپرز کے لیے API اور اپنے PBX کا MCP اُس وقت درکار ہوتے ہیں جب پروگرام باہر کام کرتا ہو: اپنی ویب سائٹ، کسی اور کا اکاؤنٹ سسٹم، AI ایجنٹ۔ کسٹم ایڈیٹر اس کے برعکس پینل کے اندر انٹرفیس ہے: ملازم اسے ایڈمن کے عام صفحے کی طرح کھولتا ہے اور اپنی ورکنگ ونڈو سے باہر نہیں نکلتا۔

متعلقہ سیکشنز#

• ایپ اسٹور — جہاں سیکشن اور بلٹ اِن توسیعات فعال ہوتی ہیں
• اسٹاک — وہ ٹیب جس میں «VetIS» جیسی توسیعات رہتی ہیں، اور اشیاء کی ڈائریکٹری
• کیٹلاگ درآمد — آئٹمز اپ لوڈ کرنے کا باقاعدہ راستہ، اگر کام صرف یہی ہو
• اپنے کوڈ پر اسٹور فرنٹ (headless) — بیرونی ویب سائٹ کے لیے کھلا ڈیٹا کنٹریکٹ
• API اور اپنے PBX کا MCP اور AI ایجنٹس کے لیے Guest API — پینل کے اندر نہیں، باہر کام
• ملازمین اور شفٹیں — ڈویلپر کے لیے اکاؤنٹ اور رولز
• سیکیورٹی اور ڈیٹا — ڈیٹا کہاں محفوظ ہے اور کس کی اس تک رسائی ہے
• سپورٹ — اگر پلگ ان مشکوک برتاؤ کرے تو کہاں لکھیں