yii2 adminlte asset

Paket Aset AdminLTE

UI Backend untuk Kerangka Yii2, berdasarkan AdminLTE

Paket ini berisi Bundel Aset untuk Kerangka Yii 2.0 yang mendaftarkan file CSS untuk antarmuka pengguna AdminLTE.

File CSS diinstal melalui penggunaan fxp/composer-asset-plugin v1.1.1 yang direkomendasikan Yii atau lebih baru.

Instalasi

Cara yang lebih disukai untuk memasang ekstensi ini adalah melalui komposer.

Untuk menginstal AdminLTE v2, jalankan:

 composer require dmstr/yii2-adminlte-asset "^2.1"

Untuk menginstal AdminLTE v1, jalankan:

 composer require dmstr/yii2-adminlte-asset "^1"

Pertanyaan Umum

Penggunaan font web

AdminLTE menghapus penyertaan font web di 2.4.0 , jadi Anda perlu memasukkan font yang Anda inginkan secara manual, yaitu.

 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,600,700,300italic,400italic,600italic">

Penyertaan melalui CDN tidak disarankan untuk produksi, harap sesuaikan dengan alur kerja bundling aset proyek Anda.

Untuk detailnya lihat #140.

Perbaikan

Saat memutakhirkan, silakan lihat panduan pemutakhiran AdminLTE untuk penyesuaian yang perlu Anda lakukan pada pandangan Anda.

Instalasi komposer

• Untuk masalah dengan DmitryBaranovskiy/eve.git , silakan lihat #128 dan #113.

Matriks kompatibilitas

yii2-adminlte-asset	AdminLTE	Font Luar Biasa
2.4	2.0 - 2.3	diperlukan
2.5	2.4	diperlukan
3.0	2.4	-

Untuk masalah lainnya, silakan cari di GitHub terlebih dahulu.

Mulai Cepat

Setelah ekstensi dipasang, Anda dapat melihat pratinjau dengan mengonfigurasi ulang pemetaan jalur komponen tampilan:

Untuk Template Aplikasi Lanjutan Yii 2 atau Template Aplikasi Dasar

 ' components ' => [
    ' view ' => [
         ' theme ' => [
             ' pathMap ' => [
                ' @app/views ' => ' @vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app '
             ],
         ],
    ],
],

Untuk aplikasi PhD5

 ' components ' => [
    ' view ' => [
        ' theme ' => [
            ' pathMap ' => [
                ' @app/views ' => ' @vendor/dmstr/yii2-adminlte-asset/example-views/testing/app '
            ],
        ],
    ],
],

Paket aset ini menyediakan file contoh untuk tata letak dan tampilan (lihat examples/ ), mereka tidak dimaksudkan untuk dikustomisasi langsung di folder vendor/ .

Oleh karena itu disarankan untuk menyalin tampilan ke dalam aplikasi Anda dan menyesuaikannya dengan kebutuhan Anda.

Kustomisasi

• Salin file dari vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app (atau tema lain) ke @app/views .
• Hapus konfigurasi view kustom dari aplikasi Anda dengan menghapus pemetaan jalur, jika Anda pernah membuatnya sebelumnya.
• Edit tampilan Anda dengan mengikuti markup html vendor/almasaeed2010/adminlte/pages

Plugin AdminLTE

Aset untuk plugin AdminLTE tidak termasuk dalam AdminLteAsset kami tetapi Anda dapat menemukan file ini di direktori vendor Anda di bawah vendor/almasaeed2010/adminlte/plugins . Jadi jika Anda ingin menggunakan salah satu dari mereka, kami sarankan untuk membuat bundel khusus tempat Anda mencantumkan file plugin yang Anda perlukan:

 use yii  web  AssetBundle ;
class AdminLtePluginAsset extends AssetBundle
{
    public $ sourcePath = ' @vendor/almasaeed2010/adminlte/plugins ' ;
    public $ css = [
        ' chart.js/Chart.min.css ' ,
        // more plugin CSS here
    ];
    public $ js = [
        ' chart.js/Chart.bundle.min.js '
        // more plugin Js here
    ];
    public $ depends = [
        ' dmstradminltewebAdminLteAsset ' ,
    ];
}

Karena aset ini bergantung pada AdminLteAsset kami, ini adalah satu-satunya aset yang harus Anda daftarkan, misalnya di file tata letak main.php Anda.

Tajuk konten khusus

Jika Anda ingin menggunakan DOM asli dari header AdminLTE

 < h1 >
    About < small > static page </ small >
</ h1 >

maka Anda dapat mengikuti kode:

 /* @var yiiwebView $this */

$ this -> params [ ' breadcrumbs ' ][] = ' About ' ;

$ this -> beginBlock ( ' content-header ' ); ?>
About <small>static page</small>
<?php $ this -> endBlock (); ?>

<div class="site-about">
    <p> This is the About page. You may modify the following file to customize its content: </p>
    <code> <?= __FILE__ ?> </code>
</div>

Menu bilah sisi kiri - Menu Widget

Jika Anda perlu memisahkan bagian menu, tambahkan saja opsi header ke item dalam items

    ' items ' => [
        [ ' label ' => ' Gii ' , ' iconType ' => ' far ' 'icon' => 'file-code', ' url ' => [ ' /gii ' ]],
        [ ' label ' => ' Debug ' , ' icon ' => ' dashboard-alt ' , ' url ' => [ ' /debug ' ]],
        [ ' label ' => ' MAIN NAVIGATION ' , ' header ' => true ], // here
        // ... a group items
        [ ' label ' => '' , ' header ' => true ],
        // ... a group items
        [ ' label ' => '' , ' header ' => true ],
        // ... a group items

Untuk menambahkan lencana pada item:

 ' items ' => [
    [
        ' label ' => ' Mailbox ' ,
        ' iconType ' => ' far ' ,
        ' icon ' => ' envelope ' ,
        ' url ' => [ ' /mailbox ' ],
        ' badge ' => ' <span class="badge badge-info right">123</span> '
    ],
]

Secara default, ikon akan ditambahkan awalan Font Awesome

Templat untuk generator Gii CRUD

Beritahu Gii tentang templat kami. Pengaturan dibuat di file konfigurasi:

 if ( YII_ENV_DEV ) {
    $ config [ ' modules ' ][ ' gii ' ] = [
        ' class ' => ' yiigiiModule ' ,
        ' generators ' => [ // HERE
            ' crud ' => [
                ' class ' => ' yiigiigeneratorscrudGenerator ' ,
                ' templates ' => [
                    ' adminlte ' => ' @vendor/dmstr/yii2-adminlte-asset/gii/templates/crud/simple ' ,
                ]
            ]
        ],
    ];
}

Pengujian

Buka folder tes dan mulai tumpukan pengujian

 cd tests
docker-compose up -d

Instal yii2-adminlte-asset di aplikasi pengujian

 docker-compose exec php composer install

Buka URL pengujian di browser Anda

 http://docker.local:20580/test
http://docker.local:20580/test/login    

Informasi Lebih Lanjut

Untuk dokumentasi AdminLTE, silakan baca https://almsaeedstudio.com/themes/AdminLTE/documentation/index.html

Aturan penspasian nama mengikuti struktur kerangka kerja Yii 2.0, misalnya. dmstradminlteweb untuk Paket Aset.