AdminLTE に基づく Yii2 フレームワークのバックエンド UI
このパッケージには、AdminLTE ユーザーインターフェースの CSS ファイルを登録する Yii 2.0 Framework のアセットバンドルが含まれています。
CSS ファイルは、Yii が推奨するfxp/composer-asset-plugin
v1.1.1 以降の使用法を介してインストールされます。
この拡張機能をインストールするには、composer を使用することをお勧めします。
AdminLTE v2 をインストールするには、次のコマンドを実行します。
composer require dmstr/yii2-adminlte-asset "^2.1"
AdminLTE v1 をインストールするには、次のコマンドを実行します。
composer require dmstr/yii2-adminlte-asset "^1"
AdminLTE は2.4.0
で Web フォントの組み込みを削除したため、目的のフォントを手動で組み込む必要があります。
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,600,700,300italic,400italic,600italic">
CDN 経由での組み込みは運用環境では推奨されません。プロジェクトのアセット バンドル ワークフローに合わせて調整してください。
詳細については #140 を参照してください。
アップグレードする場合、ビューで必要な調整については、AdminLTE アップグレード ガイドを参照してください。
DmitryBaranovskiy/eve.git
に関する問題については、#128 および #113 を参照してください。yii2-adminlte-asset | 管理者LTE | 素晴らしいフォント |
---|---|---|
2.4 | 2.0~2.3 | 必須 |
2.5 | 2.4 | 必須 |
3.0 | 2.4 | - |
その他の問題については、まず GitHub を検索してください。
拡張機能をインストールしたら、ビュー コンポーネントのパス マッピングを再構成してプレビューを表示できます。
Yii 2 アドバンスト アプリケーション テンプレートまたはベーシック アプリケーション テンプレートの場合
' components ' => [
' view ' => [
' theme ' => [
' pathMap ' => [
' @app/views ' => ' @vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app '
],
],
],
],
phd5アプリケーションの場合
' components ' => [
' view ' => [
' theme ' => [
' pathMap ' => [
' @app/views ' => ' @vendor/dmstr/yii2-adminlte-asset/example-views/testing/app '
],
],
],
],
このアセット バンドルは、レイアウトとビュー用のサンプル ファイルを提供します (フォルダーexamples/
を参照)。これらは、 vendor/
フォルダーで直接カスタマイズするためのものではありません。
したがって、ビューをアプリケーションにコピーし、ニーズに合わせて調整することをお勧めします。
vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app
(または他のテーマ) から@app/views
にファイルをコピーします。view
構成を削除します。vendor/almasaeed2010/adminlte/pages
に準拠してビューを編集します。AdminLTE プラグインのアセットはAdminLteAsset
には含まれていませんが、これらのファイルはベンダー ディレクトリのvendor/almasaeed2010/adminlte/plugins
にあります。したがって、それらのいずれかを使用したい場合は、必要なプラグイン ファイルをリストしたカスタム バンドルを作成することをお勧めします。
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 ' ,
];
}
このアセットはAdminLteAsset
に依存しているため、たとえばmain.php
レイアウト ファイルに登録する必要がある唯一のアセットです。
ヘッダーのネイティブ DOM を使用する場合 AdminLTE
< h1 >
About < small > static page </ small >
</ h1 >
次に、コードに従うことができます。
/* @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>
メニューのセクションを分離する必要がある場合は、 items
内の項目にheader
オプションを追加するだけです
' 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
アイテムにバッジを追加するには:
' items ' => [
[
' label ' => ' Mailbox ' ,
' iconType ' => ' far ' ,
' icon ' => ' envelope ' ,
' url ' => [ ' /mailbox ' ],
' badge ' => ' <span class="badge badge-info right">123</span> '
],
]
デフォルトでは、アイコンには Font Awesome の接頭辞が追加されます
Gii にテンプレートについて教えてください。設定は構成ファイルで行われます。
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 ' ,
]
]
],
];
}
テストフォルダーに移動し、テストスタックを開始します
cd tests
docker-compose up -d
テストアプリケーションにyii2-adminlte-asset
をインストールします
docker-compose exec php composer install
ブラウザでテスト URL を開きます
http://docker.local:20580/test
http://docker.local:20580/test/login
AdminLTE のドキュメントについては、https://almsaeedstudio.com/themes/AdminLTE/documentation/index.html をご覧ください。
名前空間ルールは Yii 2.0 フレームワーク構造に従います。アセット バンドルの
dmstradminlteweb
。