Panel admin memudahkan untuk mengatur dan memelihara fitur admin untuk proyek uap Anda. Berikut adalah daftar beberapa fitur teratas yang keluar dari kotak dengan paket ini:
Perbarui file Package.swift
Anda:
. package ( url : " https://github.com/nodes-vapor/admin-panel-provider.git " , . upToNextMinor ( from : " 0.7.0 " ) ) ,
targets: [
. target (
name : " App " ,
dependencies : [
...
" AdminPanelProvider "
]
) ,
...
]
Lain kali Anda menjalankan EG vapor update
Admin Panel akan diinstal.
Salin Resources
dan folder Public
dari repo ini ke proyek Anda. Anda dapat mengunduh repo sebagai zip dan kemudian memindahkan folder ke akar proyek Anda. Ingatlah untuk memeriksa bahwa Anda tidak menimpa file apa pun dalam proyek Anda.
Jika Anda menggunakan meta jangan lupa untuk menambahkan jalur berikut ke array exceptPaths
di dalam meta.json
:
"/bower_components/*"
"/dist/*"
"/plugins/*"
Di Config+Setup.swift
Anda (atau di mana pun Anda mengatur penyedia Anda), pastikan untuk menambahkan penyedia panel admin:
import AdminPanelProvider
// ...
private func setupProviders ( ) throws {
// ...
try addProvider ( AdminPanelProvider . Provider . self )
}
Pastikan juga Anda menambahkan penyedia fasih jika belum:
try addProvider ( FluentProvider . Provider . self )
Paket ini sangat bergantung pada renderer pemandangan daun. Agar panel admin dapat bekerja, pastikan Anda telah menambahkan LeafProvider
:
import LeafProvider
// ...
private func setupProviders ( ) throws {
// ...
try addProvider ( LeafProvider . Provider . self )
}
Pastikan proyek Anda menggunakan daun sebagai penyaji pemandangan. Anda dapat mengatur daun sebagai penyaji Anda dengan mengatur view
kunci ke value leaf
di droplet.json
Anda. Jika belum diberikan, tambahkan saja:
"//" : " Choose which view renderer to use " ,
"//" : " leaf: Vapor's Leaf renderer " ,
"view" : " leaf " ,
Jika Anda belum menambahkan penyedia SSO, hal berikutnya yang perlu Anda lakukan adalah menyemai pengguna agar dapat masuk ke panel admin baru Anda. Untuk melakukan ini, tambahkan perintah seeder ke array commands
Anda di droplet.json
Anda.
"//" : " 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 "
],
Sekarang Anda memiliki dua cara untuk menjalankan seeder. Anda menjalankan seeder di terminal Anda dengan:
vapor build; vapor run admin-panel:seeder
Atau Anda untuk sementara mengedit skema Run
di Xcode dan menambahkan admin-panel:seeder
di bawah "argumen yang disahkan pada peluncuran". Ini akan menjalankan seeder saat Anda menjalankan proyek. Jalankan proyek dan hapus argumen setelah pengguna diunggulkan.
Pengguna yang akan dibuat menggunakan seeder akan memiliki kredensial berikut:
Vapor memiliki array Node.fuzzy
yang digunakan untuk casting secara dinamis saat runtime. Jika Anda mengalami ketidakkonsistenan dengan templat rendering, kemungkinan besar karena array fuzzy Anda kehilangan ViewData.self
Sendiri memastikan bahwa Anda telah menambahkannya ke array atau bahwa semua model Anda sesuai dengan JSON
/ Node
. Contoh 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 ]
Panel admin dilengkapi dengan banyak tag daun khusus yang membantu meringankan beban pengembangan frontend. Lihat daftar lengkapnya di sini.
Sangat disarankan agar Anda menambahkan middleware CORS ke proyek Anda.
Panel admin dapat dikonfigurasi dengan (menambahkan atau) memodifikasi file konfigurasi adminpanel.json
. Di bawah ini adalah rincian tombol yang tersedia.
Kunci | Nilai contoh | Diperlukan | Keterangan |
---|---|---|---|
name | My Tech Blog | TIDAK | Ini akan menjadi judul di dalam panel admin. |
baseUrl | http://mytechblog.com | TIDAK | Ini akan digunakan untuk menghasilkan URL untuk panel admin (misalnya saat mengatur ulang kata sandi). |
skin | green-light | TIDAK | Kulit untuk digunakan untuk panel admin. Opsi akan sesuai dengan kulit yang tersedia yang didukung oleh adminlte. Harap hilangkan awalan skin- saat menentukan kulit. |
email | {"fromName": "Admin Panel", "fromAddress": "[email protected]"} ` | TIDAK | Ini akan digunakan untuk mengkonfigurasi pengirim adminPanel. |
Masuk tunggal dapat menjadi cara yang nyaman untuk menawarkan pengguna proyek Anda untuk masuk ke panel admin Anda.
Paket ini dikembangkan dan dikelola oleh tim uap di node. Pemilik paket untuk proyek ini adalah Steffen.
Paket ini adalah perangkat lunak bersumber terbuka yang dilisensikan di bawah lisensi MIT