admin panel

Panel Admin

Kerangka Panel Admin Agnostik.

Sasaran

Mencoba membuatnya minimal mungkin. Ini memungkinkan Anda untuk membuat beberapa halaman dengan berbagai jenis (tabel, bentuk). tanpa banyak campur tangan dengan basis kode Anda.

PS: Anda masih perlu mengatur rute Anda, otentikasi dll ...

Tanggapan

Kami mengizinkan beberapa jenis respons, sebagai default kami menggunakan tampilan PHP, tetapi kami menganggap untuk pengguna Laravel sebagai contoh, akan menggunakan blade sebagai gantinya, jadi salah satu solusi yang mungkin adalah membuat Renderer yang berbeda.

Untuk saat ini kami memiliki dua Renderers default:

• DefaultRenderer ini hanya mengembalikan array sebagai output
• JsonRenderer ini mengembalikan output json

Untuk membuat renderer membuatnya memperluas AecodesAdminPanelResponsesRenderer . Kemudian tambahkan ke konfigurasi.

Tata letak yang didukung saat ini

• Tabel (mengambil serangkaian TD, setiap TD dapat diserahkan khusus)
• Formulir (mengambil array bidang)
• Div (satu -satunya kasus penggunaan adalah memiliki pembungkus khusus)
• Dimungkinkan untuk membuat widget Anda sendiri.

PS: Widget mengimplementasikan antarmuka Widget .

Bidang formulir yang didukung saat ini

• Input (teks, kata sandi, email, nomor, ...)
• Radio
• Memilih
• TexTarea
• Kotak centang
• Gambar (unggah gambar tunggal)

Cara mengatur

1. instal dengan komposer
2. Buat file konfigurasi menggunakan config/panel.php sebagai titik awal.
3. Buat contoh (singleton) dari kelas Dashboard , pastikan untuk meneruskan konfigurasi sebagai array.

 $ config = require ' ./config/panel.php ' ;
Aecodes  AdminPanel Dashboard:: setup ( $ config );

Cara membuat halaman admin

1. Buat kelas baru yang memperluas kelas Panel
2. Untuk kenyamanan, atur properti untuk $name & $description dari panel (terlihat di halaman).
3. Buat metode query yang mengembalikan array data.

 function query (): array {
    // get data from database.
    return Page:: all ()-> toArray ();
}

4. Buat metode render yang mengembalikan array widget.

• Untuk membuat tabel

 function render (): array {
    return [
        Table:: make ([
            // (label, name) both are optional
            TD :: make ( ' # ' , ' id ' ),
            // it's also possible to use Table::column
            Table:: column ( ' Title ' , ' title ' ),
        ])
        // ...
    ];
}

• Untuk membuat formulir

 function render (): array {
    return [
        Form:: make ([
            Input:: make ( ' title ' )-> title ( ' Title ' ),

            // form submit
            Action:: button ( ' Save ' ),
        ])
        -> action ( ' # ' )
        -> method ( ' post ' ),
        // ...
    ];
}

5. Untuk menyelesaikan, dalam panggilan balik rute Anda, cukup kembalikan contoh baru dari kelas yang Anda buat.

 // callback for some route
public function index () {
    // PagesTable extends Panel
    return ( new Response ( new PagesTable ))-> render ();
}

Kemampuan memperpanjang

Tata letak

Saat memperpanjang kelas Panel , Anda dapat menentukan properti $layout .

Tampilan

Ini tidak dikirimkan dengan lapisan pemandangan. Anda dapat menggunakan paket tampilan default (segera).

Konfigurasi

Konfigurasi default adalah:

 return [
    // current renderer.
	' renderer ' => ' default ' ,

    // add new renderer here.
	' renderers ' => [
		' json '    => Aecodes  AdminPanel  Responses JsonRenderer::class,
		' default ' => Aecodes  AdminPanel  Responses DefaultRenderer::class,
	],

    // default classes for button and a tag.
	' classes ' => [
		' link '   => '' ,
		' button ' => '' ,
	],

    // global menus, can be and array or callback
	' menu ' => function () {
		return [];
	},

    // input old value.
	' old_value ' => function ( $ name , $ default ) {
		return $ default ;
	},

    // global errors (i.e: validation errors)
	' errors ' => function () {
		return [];
	}

];