شرح الإضافة
الإضافة بتعمل إيه
Smart List Buttons بتضيف زراير مخصصة في هيدر صفحات القوائم والسجلات المفتوحة، ومعاها أدوات تنقل سريعة لفريقك واختصارات للأدمن.
أهم المميزات
- زراير ذكية في صفحات القوائم وجوه السجل المفتوح (يمين أو شمال الهيدر أو الاتنين)، ولكل زرار اسم وأيقونة ولينك.
- متغيرات ذكية في اللينك: {entityType} و {scope} و {userId} و {currentUrl} و {baseUrl}.
- تقدر تظهر الزرار في كل الكيانات أو كيانات معينة، يفتح في تبويب جديد، أو يبقى للأدمن بس.
- Entity Navigator (الاختصار الافتراضي Ctrl+Shift+E): ابحث واتنقل لأي كيان مسموح لليوزر يشوفه.
- أدوات المطور للأدمن: لينكات مباشرة لـ Entity Manager و Layouts و Fields و Relationships و Search Layout للكيان الحالي.
- Command Palette للأدمن (الاختصار الافتراضي Ctrl+D): بحث في صفحات الإدارة والكيانات والـ Layouts والحقول، مع آخر عمليات البحث.
طريقة الاستخدام
- ادخل على Administration ← FirstMarkets Tools ← Smart List Buttons.
- اضغط Add Button، اكتب اسم الزرار، اختار الأيقونة، واكتب اللينك (مثلاً #{entityType}/create).
- اختار إظهار في كل الكيانات أو حدد كيانات معينة، وعلّم إظهار داخل السجل المفتوح عشان يظهر في صفحة السجل وحدد مكانه.
- فعّل Entity Navigator و أدوات المطور و Command Palette من نفس الصفحة وغيّر الاختصارات لو حابب.
- اضغط Save وبعدين اعمل Refresh للمتصفح.
الإعدادات والصلاحيات
- الزراير والـ Entity Navigator شغالين لكل اليوزرز، أما أدوات المطور والـ Command Palette فللأدمن بس.
- الـ Navigator بيعرض بس الكيانات اللي اليوزر عنده صلاحية قراءة عليها.
- خيار للأدمن فقط بيخفي الزرار من الواجهة لليوزر العادي، فما تحطش بيانات سرية في اللينك.
ملاحظات
- بعد التسطيب أو التحديث: Administration ← Clear Cache وبعدين Ctrl+F5.
- لو الترخيص مش مفعّل، كل الزراير والأدوات بتتقفل لحد ما تدخل مفتاح صالح.
التثبيت والتفعيل
- نزّل ملف الإضافة من اللينك اللي هيوصلك مع مفتاح الترخيص.
- من EspoCRM: Administration ← Extensions ← Upload ← Install.
- من Administration ← Integrations افتح ترخيص الإضافة، فعّله، والصق المفتاح، واحفظ.
- هتلاقي شرح الإضافة وحالة الترخيص في صفحة الإضافة جوه الـ Administration.
سجل التغييرات
v2.4.8 Minor 2026-10-11
- جديد License gate: all buttons and tools are disabled when the license is not active
- إصلاح Buttons and Entity Navigator now work for regular (non-admin) users
- إصلاح Keyboard shortcuts work on every page from first load (dashboard, admin)
- إصلاح Quick-view modal buttons no longer leak into the main page header
- إصلاح {userId} variable returns the real user ID; fixed Search Layout, Layout Manager, Formula Sandbox and Users/Teams/Roles links
- تحسين Entity Navigator shows only entities with a list page that the user can read
- إصلاح Settings: selected entities are never lost on save; Arabic labels now load (ar_AR)