تجعل لوحة المسؤول من السهل إعداد وصيانة ميزات المسؤول لمشروع البخار الخاص بك. فيما يلي قائمة ببعض من أفضل الأوتار التي تخرج من المربع مع هذه الحزمة:
قم بتحديث ملف Package.swift
الخاص بك:
. package ( url : " https://github.com/nodes-vapor/admin-panel-provider.git " , . upToNextMinor ( from : " 0.7.0 " ) ) ,
targets: [
. target (
name : " App " ,
dependencies : [
...
" AdminPanelProvider "
]
) ,
...
]
في المرة القادمة التي تقوم فيها بتشغيل لوحة مسؤول vapor update
على سبيل المثال ، سيتم تثبيت.
انسخ Resources
والمجلدات Public
من هذا الريبو إلى مشروعك. يمكنك تنزيل REPO كضغط ثم نقل المجلدات إلى جذر مشروعك. تذكر أن تتأكد من أنك لست فوق أي ملفات في مشروعك.
إذا كنت تستخدم meta ، فلا تنس إضافة المسارات التالية إلى صفيف exceptPaths
داخل meta.json
:
"/bower_components/*"
"/dist/*"
"/plugins/*"
في Config+Setup.swift
(أو أينما قمت بإعداد مقدمي الخدمات) ، تأكد من إضافة مزود لوحة المسؤول:
import AdminPanelProvider
// ...
private func setupProviders ( ) throws {
// ...
try addProvider ( AdminPanelProvider . Provider . self )
}
تأكد أيضًا من إضافة الموفر بطلاقة إذا لم يكن بالفعل:
try addProvider ( FluentProvider . Provider . self )
تعتمد هذه الحزمة اعتمادًا كبيرًا على عارض عرض الورقة. لكي تعمل لوحة المسؤول ، يرجى التأكد من إضافة LeafProvider
:
import LeafProvider
// ...
private func setupProviders ( ) throws {
// ...
try addProvider ( LeafProvider . Provider . self )
}
تأكد من أن مشروعك يستخدم Leaf كعارض العرض. يمكنك ضبط الورقة كقائدك عن طريق تعيين طريقة view
المفتاح على leaf
القيمة في droplet.json
. في حال لم يتم تقديمه بعد ، فقط أضفه:
"//" : " Choose which view renderer to use " ,
"//" : " leaf: Vapor's Leaf renderer " ,
"view" : " leaf " ,
إذا لم تكن قد أضفت مزودًا SSO ، فإن الشيء التالي الذي عليك القيام به هو أن ترفع مستخدمًا حتى تتمكن من تسجيل الدخول إلى لوحة المسؤول الجديدة. للقيام بذلك ، أضف أمر البذور إلى صفيف commands
الخاصة بك في droplet.json
:
"//" : " Choose which commands this application can run " ,
"//" : " prepare: Supplied by the Fluent provider. Prepares the database (configure in fluent.json) " ,
"commands" : [
" prepare " ,
" admin-panel:seeder "
],
الآن لديك طريقتان لتشغيل البذور. إما تقوم بتشغيل البذور في المحطة الخاصة بك بواسطة:
vapor build; vapor run admin-panel:seeder
أو قمت بتحرير مخطط Run
مؤقتًا في Xcode وإضافة admin-panel:seeder
تحت "الحجج التي تم تمريرها عند الإطلاق". سيقوم هذا بتشغيل البذور عند تشغيل المشروع. قم بتشغيل المشروع وإزالة الوسيطة بعد أن تم زرع المستخدم.
سيكون للمستخدم الذي سيتم إنشاؤه باستخدام البذور بيانات الاعتماد التالية:
يحتوي Vapor على مجموعة Node.fuzzy
المستخدمة في عملية التشغيل ديناميكيًا في وقت التشغيل. إذا كنت تعاني من التناقضات مع تقديم قوالب ، فمن المحتمل أن يكون صفيفك الغامض مفقودًا في ViewData.self
تأكد من إضافته إلى المصفوفة أو أن جميع طرزك تتوافق مع JSON
/ Node
. مثال Node.fuzzy
:
extension Config {
public func setup ( ) throws {
// allow fuzzy conversions for these types
// (add your own types here)
Node . fuzzy = [ JSON . self , Node . self , ViewData . self ]
تأتي لوحة المسؤول مع مجموعة من علامات الأوراق المخصصة التي تساعد على تخفيف عبء تطوير الواجهة الأمامية. تحقق من القائمة الكاملة هنا.
يوصى بشدة بإضافة البرامج الوسيطة للكورس إلى مشروعك.
يمكن تكوين لوحة المسؤول عن طريق (إضافة أو) تعديل ملف التكوين adminpanel.json
. فيما يلي انهيار المفاتيح المتاحة.
مفتاح | قيمة مثال | مطلوب | وصف |
---|---|---|---|
name | My Tech Blog | لا | سيكون هذا هو العنوان داخل لوحة المسؤول. |
baseUrl | http://mytechblog.com | لا | سيتم استخدام هذا لإنشاء عناوين URL للوحة المسؤول (على سبيل المثال عند إعادة تعيين كلمة مرور). |
skin | green-light | لا | الجلد لاستخدامه في لوحة المسؤول. سوف تتوافق الخيارات مع الجلود المتاحة التي تدعمها AdminLte. يرجى حذف البادئة skin- عند تحديد الجلد. |
email | {"fromName": "Admin Panel", "fromAddress": "[email protected]"} ` | لا | سيتم استخدام هذا لتكوين البريد الإلكتروني لـ AdminPanel. |
يمكن أن يكون تسجيل الدخول الفردي وسيلة مريحة لتزويد مستخدمي مشروعك بتسجيل الدخول إلى لوحة المسؤول.
تم تطوير هذه الحزمة وصيانتها من قبل فريق البخار في العقد. صاحب الحزمة لهذا المشروع هو ستيفن.
هذه الحزمة عبارة عن برامج مفتوحة المصدر مرخصة بموجب ترخيص معهد ماساتشوستس للتكنولوجيا