Panel Admin berkode rendah dan mesin Business Intelligence Rails (tanpa DSL - dapat dikonfigurasi dari UI) .
? Aplikasi Demo | ? Ikhtisar fitur | Pro
Tambahkan baris ini ke Gemfile aplikasi Anda:
gem 'motor-admin'
Dan kemudian jalankan:
$ bundle install
Membuat dan menjalankan migrasi:
$ rails motor:install && rake db:migrate
Segala sesuatu di panel admin dapat dikonfigurasi menggunakan UI pengaturan intuitif, yang dapat dibuka melalui ikon di pojok kanan atas.
Data yang ditampilkan di halaman sumber daya dapat sepenuhnya dikustomisasi melalui kueri SQL dan dasbor yang dilampirkan ke sumber daya sebagai tab. Biasanya, kueri yang digunakan untuk menampilkan data sumber daya harus berisi variabel {{resource_name_id}}
.
Pelajari lebih lanjut tentang penyesuaian sumber daya
Tindakan sumber daya kustom dapat ditambahkan melalui panggilan metode Rekaman Aktif, titik akhir API, atau formulir kustom. Selain itu, dimungkinkan untuk mengganti tindakan buat/perbarui/hapus default.
Metode atau atribut model ActiveRecord apa pun dapat diekspos ke panel admin dengan menambahkan kolom baru dengan nama yang cocok dengan nama metode dari model sumber daya:
class Customer < ApplicationRecord
has_many :orders
def lifetime_value
orders . sum ( & :total_price )
end
end
Nilai dari kolom formulir dapat digunakan di jalur API melalui sintaksis {field_name}
: /api/some-endpoint/{resource_id}/apply
.
Pelajari lebih lanjut tentang pembuat formulir kustom
Kueri dapat menyertakan variabel yang disematkan melalui sintaksis {{variable}}
(kumis). Sintaks {{#variable}} ... {{/variable}}
memungkinkan untuk memutuskan apakah kondisi di dalam cakupan harus disertakan dalam kueri.
Data dari kueri SQL dapat direpresentasikan sebagai: tabel, angka, diagram garis, diagram batang, diagram lingkaran, corong, penurunan harga.
Kueri SQL dapat diatur ke dalam dasbor untuk membuat representasi data yang nyaman.
Data query dapat dikirim melalui email secara berkala menggunakan fitur alert. Interval email peringatan dapat ditentukan menggunakan bahasa alami, misalnya, every day at midnight
, every Monday at 8 PM
, every weekday at 6AM and 6PM
, every minute
.
Alamat pengirim dapat ditentukan menggunakan variabel lingkungan MOTOR_ALERTS_FROM_ADDRESS
.
Pencarian intelijen dapat dibuka melalui tombol pojok kanan atas atau menggunakan pintasan Cmd + K.
Admin Motor memungkinkan untuk mengatur izin tingkat baris dan tingkat kolom melalui permata cancan. Izin Admin UI harus ditentukan dalam file app/models/motor/ability.rb
di kelas Motor::Ability
. Lihat Panduan Admin Motor dan dokumentasi CanCan untuk mempelajari cara menentukan izin pengguna.
Admin Motor dikonfigurasikan secara default untuk melakukan pengunggahan ke penyedia yang Anda konfigurasikan di file storage.yml
untuk Penyimpanan Aktif. Jika Anda menggunakan unggahan besar dalam Motor Admin, Anda harus mengaktifkan unggahan langsung dengan mengatur variabel ENV berikut.
MOTOR_ACTIVE_STORAGE_DIRECT_UPLOADS_ENABLED=true
Catatan: Saat ini, ini akan memungkinkan unggahan langsung secara global
Admin Motor dapat menggunakan kunci Rails ActiveRecord i18n untuk merender terjemahan sumber daya:
es :
activerecord :
models :
customer :
one : Cliente
other : Clientes
attributes :
customer :
name : Nombre
scopes :
customer :
enabled : Activado
Semua konfigurasi panel admin secara otomatis disimpan di file config/motor.yml
. Disarankan untuk menyertakan file ini dalam repositori git aplikasi agar konfigurasi panel admin selalu sinkron di berbagai lingkungan lokal dan jarak jauh.
Konfigurasi panel admin pengembangan lokal dapat disinkronkan dengan aplikasi produksi jarak jauh melalui tugas rake motor:sync
:
MOTOR_SYNC_REMOTE_URL=https://remote-app-url/ MOTOR_SYNC_API_KEY=secure-random-string rake motor:sync
Panel admin dapat diamankan dengan 'Otentikasi dasar' dengan menentukan variabel lingkungan MOTOR_AUTH_USERNAME
dan MOTOR_AUTH_PASSWORD
.
Alternatifnya, dapat diamankan dengan perangkat atau pustaka autentikasi lainnya yang digunakan oleh aplikasi:
authenticate :admin_user do
mount Motor :: Admin => '/admin'
end
Mulai server pengembang webpack:
yarn install && yarn serve
Siapkan basis data pengembangan:
rake app:db:create && rake app:db:setup
Mulai contoh aplikasi dalam mode pengembangan:
MOTOR_DEVELOPMENT=true rails s
Motor Admin dilisensikan di bawah lisensi MIT.