craftable

أخبار كبيرة

لقد أصدرنا للتو Craftable PRO - الإصدار المتميز من أداة إنشاء لوحة الإدارة الشهيرة مفتوحة المصدر Laravel. يأتي الإصدار الاحترافي مزودًا بواجهة مستخدم جديدة مبنية على Tailwind، ويستخدم أحدث Laravel وInertiaJS ويأتي مع الكثير من الميزات الجديدة.

---

قابلة للصياغة - أنشئ لوحات إدارية باستخدام Laravel

• عن
  • تجريبي
  • الحزم المستخدمة
• متطلبات
• تثبيت
  • مشروع جديد
  • إضافة إلى المشروع الحالي
• الأساسيات
• التوثيق
• إلى أين تذهب بعد ذلك؟

عن

مرحبًا Crafter، مرحبًا بك في الوثائق الرسمية لـ Craftable 6 - مجموعة أدوات مفتوحة المصدر قائمة على Laravel لبناء واجهات الإدارة. إنه قالب بسيط لمنطقة الإدارة. نقطة انطلاق لتطوير أنظمة المكاتب الخلفية أو الشبكات الداخلية أو أنظمة إدارة المحتوى (CMS).

يمكنك تسميتها CMS، ولكنها صغيرة جدًا، وتحتوي على أقل قدر ممكن من المحتوى الذي يمكن إدارته. لديها:

• واجهة المستخدم - قالب إداري جميل يعتمد على CoreUI (http://coreui.io/)
• مولد الخام
• التفويض وملفي الشخصي والمستخدمين CRUD
• مدير الترجمات
• مساعدين آخرين لتشغيل منطقة الإدارة الجديدة بسرعة (مكتبة الوسائط، قائمة المسؤول، وما إلى ذلك)

تجريبي

لقد أنشأنا عرضًا تجريبيًا لتتمكن من اللعب به على https://demo.getcraftable.com.

استخدم بيانات الاعتماد هذه لتسجيل الدخول:

• البريد الإلكتروني: [email protected]
• كلمة المرور: demo123

يمكنك رؤية إدارة:

• المنشورات - هذا هو CRUD القياسي الذي تم إنشاؤه باستخدام حزمة admin-generator
• المقالات القابلة للترجمة - هذا هو عرض النماذج البليغة translatable
• إدارة الوصول - عبارة عن CRUD ممتد لإدارة المستخدم (نموذجك البليغ الحالي).
• الترجمات - حيث يمكنك إدارة الترجمات المخزنة في قاعدة البيانات

مصنوعة من مكونات

كان هدفنا هو تقسيم كل العناصر إلى عدة حزم بأقل قدر ممكن من التبعيات. وهذا ما نحن قادمون عليه في هذه اللحظة:

• واجهة المستخدم الإدارية - قالب الإدارة (أصول CoreUI، والشفرات، وVue)
• Admin Generator - مولد CRUD لنماذج Eloquent
• مصادقة المسؤول - القدرة على المصادقة في منطقة المسؤول
• قابل للترجمة - القدرة على الحصول على محتوى قابل للترجمة (توسيع الترجمة الافتراضية لـ Laravel)
• قائمة الإدارة - القدرة على إنشاء استعلام سريعًا لقائمة الإدارة لنماذج Eloquent الخاصة بك
• مكتبة الوسائط - القدرة على إرفاق الوسائط بنماذج بليغة
• ترجمات المسؤول - مدير الترجمة (مع واجهة المستخدم)

يستخدم Craftable جميع الحزم المذكورة أعلاه. كما أنه يستخدم أيضًا بعض حزم الجهات الخارجية الأخرى (مثل Spatie spatie/laravel-permission ) ويوفر بعض التكوينات الافتراضية الأساسية لتسريع عملية تطوير واجهة الإدارة النموذجية.

متطلبات

يتطلب الصنع:

• PHP 7.4+
• قواعد البيانات المدعومة:
  • ماي إس كيو إل 5.7+
  • بوستجري إس كيو إل 9.5+
• نبم 5.3+
• العقدة 8.4+

يستخدم Craftable Laravel لذا يجب عليك التحقق من متطلباته أيضًا. وهو متوافق مع لارافيل 8:

• https://laravel.com/docs/8.x/installation#server-requirements

تثبيت

مشروع جديد قابل للصياغة

إذا كنت تريد البدء باستخدام Laravel الجديد، فيمكنك استخدام brackets/craftable-installer والتي تقوم بكل الحيل نيابةً عنك. لنقم بتثبيته عالميًا:

composer global require " brackets/craftable-installer "

قم بإنشاء قاعدة بيانات فارغة من اختيارك (PostgreSQL أو MySQL).

يمكنك الآن إنشاء مشروع جديد قابل للصياغة:

craftable new my_project

سيؤدي هذا إلى تثبيت Craftable باستخدام أحدث إصدار من Laravel (حاليًا 6). إذا كنت تفضل استخدام أحدث إصدار LTS Laravel (حاليًا أيضًا 6)، فاستخدم علامة --lts :

craftable new --lts my_project

ستطلب الأوامر إعدادات قاعدة البيانات وبعد ذلك ستقوم بإعداد كل شيء (تثبيت جميع التبعيات، ونشر جميع تكوينات البائع المهمة، والترحيل، وإعداد بعض التكوينات، وتكوين حزمة الويب، وتشغيل عمليات الترحيل).

سيقوم الأمر بإنشاء وطباعة كلمة المرور لحساب المسؤول الافتراضي . احفظ كلمة المرور هذه في الحافظة الخاصة بك، فسنحتاجها قريبًا.

أضف Craftable إلى المشروع الحالي

أو بدلاً من ذلك، يمكنك استخدام تطبيق Laravel الموجود لديك. ابدأ بطلب هاتين الحزمتين الرئيسيتين:

composer require brackets/craftable
composer require --dev brackets/admin-generator

لتثبيت هذه الحزمة استخدم:

php artisan craftable:install

سيؤدي هذا إلى تثبيت جميع التبعيات، ونشر جميع تكوينات الموردين المهمة، والترحيل، وإعداد بعض التكوينات، وتكوين حزمة الويب، وتشغيل عمليات الترحيل.

سيقوم الأمر بإنشاء وطباعة كلمة المرور لحساب المسؤول الافتراضي . احفظ كلمة المرور هذه في الحافظة الخاصة بك، فسنحتاجها قريبًا.

الأساسيات

بمجرد التثبيت، انتقل بالمتصفح إلى /admin/login . يجب أن تكون قادرا على رؤية شاشة تسجيل الدخول.

استخدم بيانات الاعتماد هذه لتسجيل الدخول:

• البريد الإلكتروني: [email protected]
• كلمة المرور: استخدم كلمة المرور من الحافظة الخاصة بك (تمت طباعتها في نهاية الأمر craftable:install )

بعد الحصول على الترخيص، من المفترض أن تكون قادرًا على رؤية الصفحة الرئيسية الافتراضية وعنصري القائمة:

• إدارة الوصول
• ترجمات

التوثيق

يمكنك العثور على الوثائق الكاملة لهذه الحزمة والحزم الأخرى التي تستخدمها Craftable على https://docs.getcraftable.com/#/craftable.

إلى أين تذهب بعد ذلك؟

في هذه المرحلة، أنت جاهز للبدء في بناء منطقة الإدارة الخاصة بك. ربما تريد البدء في إنشاء واجهة CRUD نموذجية لنماذجك البليغة. يجب عليك بالتأكيد التحقق من وثائق Admin Generator الخاصة بنا.

في حالة رغبتك في إنشاء إدارة مخصصة غير نمطية، فربما تريد التوجه إلى حزمة Admin UI.

استمتع واصنع شيئًا رائعًا!

كيفية المساهمة:

• قم بإسقاط علامة على مستودع Github (اختياري)
  

• قبل المساهمة، يرجى قراءة CONTRIBUTING.md وCODE_OF_CONDUCT.md.

• أنشئ إصدارًا للمشروع أو ميزة ترغب في إضافتها في المشروع واحصل على المهمة المخصصة لك. (يمكن أن تكون المشكلة أي إصلاحات للأخطاء أو أي ميزة تريد إضافتها في هذا المشروع).

• شوكة الريبو إلى جيثب الخاص بك.
  

• انسخ Repo بالانتقال إلى Git Client المحلي في مجلد محلي معين في جهازك المحلي باستخدام هذا الأمر مع رابط المستودع المتشعب الخاص بك بدلاً من الرابط المحدد أدناه:
  git clone https://github.com/BRACKETS-by-TRIAD/craftable

• قم بإنشاء فرع باستخدام الأمر أدناه. git branch <your branch name>

• الخروج إلى فرعك. git checkout <your branch name>

• أضف الكود الخاص بك في مجلد جهازك المحلي. git add .

• ارتكب التغييرات الخاصة بك. git commit -m"<add your message here>"

• ادفع تغييراتك. git push --set-upstream origin <your branch name>

• تقديم طلب سحب! (قارن فرعك بالفرع الرئيسي للمالك)

المساهمين

مجد لهؤلاء الناس مذهلة

رخصة

رخصة معهد ماساتشوستس للتكنولوجيا. ارجع إلى ملف الترخيص للحصول على مزيد من المعلومات.