Bootstrap 3.0 と Pratt Landing Page を使用して、デフォルトの Laravel スキャフォールディング/ボイラープレートを AdminLTE テンプレートに切り替える Laravel パッケージ
ここでデモをご覧ください:
http://demo.adminlte.acach.org/
Laravel 4 バージョンをお探しの場合は、0.1.5 バージョン/タグを使用し、OLD-README.md を参照してください。
composer require " acacha/admin-lte-template-laravel "
最後に次のコマンドを使用してファイルを公開します。
php artisan vendor:publish --tag=adminlte --force
このパッケージは以下を使用します (インストールする必要はありません)。
brew install gnu-sed --with-default-names
このパッケージは、パスにコンポーザーの bin フォルダーがあることを前提としています。
/YOUR_PATH_TO_HOME/.composer/vendor/bin
たとえば、次の行を追加します。
export PATH= ${PATH} : ~ /.composer/vendor/bin
~/.bashrc ファイルに
注: システムによっては、パスが異なる場合があります。例:
export PATH= ${PATH} : ~ /.config/composer/vendor/bin
必ず環境をご確認ください。
このパッケージは、routes.php ファイルには見つからない Laravel ルートをインストールします。パッケージによってインストールされたルートは、次のファイルにあります。
https://github.com/acacha/adminlte-laravel/blob/master/src/Http/routes.php
AdminLTETemplateServiceProvider に含まれるファイル:
https://github.com/acacha/adminlte-laravel/blob/master/src/Providers/AdminLTETemplateServiceProvider.php
config/app.php ファイル内の ServiceProviders の順序を変更することで、このルートをオーバーライドできます。次のように指定します。
App Providers RouteServiceProvider::class
後
Acacha AdminLTETemplateLaravel Providers AdminLTETemplateServiceProvider::class
Routes.php ファイル内のルートは、デフォルトの adminlte-laravel ルートをオーバーライドします。
また、routes.php ファイルにルートを手動でインストールすることもできます。 Adminlte-laravel は、Laravel make:auth コマンドと同じルートを使用します。以下を参照してください。
https://github.com/laravel/framework/blob/5.2/src/Illuminate/Auth/Console/stubs/make/routes.stub
したがって、次の行をroutes.phpファイルに追加できます。
Route:: auth ();
Route:: get ( ' /home ' , ' HomeController@index ' );
そして、config/app.php ファイルで AdminLTETemplateServiceProvider を無効にします (Adminte-laravel ファサードとカスタム コマンドが使用できないことを考慮してください)。
詳細については、問題 #69 を参照してください。
パッケージをインストールしたら、laravel プロジェクトの通常の手順に従って管理インターフェイスにログインする必要があります。
AdminLTE は、Abdullah Almsaeed によって作成された Bootstrap 3.x に基づく無料のプレミアム管理コントロール パネル テーマです。見る:
https://github.com/almasaeed2010/AdminLTE
Adminlte-laravel は、パッケージ Creativeorange/gravatar (https://github.com/creativeorange/gravatar) を使用して、グローバルに認識されるアバター (http://gravatar.com) をサポートします。
このコマンドは、デフォルトの管理レイアウトを使用して、リソース/ビューフォルダーにビューを追加します。
php artisan make:view about
このコマンドは、ファイルconfig/menu.phpにメニュー エントリを追加します。
php artisan make:menu link menuname
例:
php artisan make:menu /contact
このコマンドは、以下を使用してルート ファイルにルートを追加します。
php artisan make:route linkname
たとえば、次のコマンドを使用して、URI /aboutを持つルートRouter/web.phpファイルを追加できます。
php artisan make:route about
このコマンドは、このエントリをroutes/web.phpに追加します。
オプションtype を使用して 3 種類のルートを作成できます。
例:
php artisan make:route about --type=controller
これにより以下が追加されます。
Route:: get ( ' about ' , ' AboutController@index ' );
ファイルRoutes/web.phpに追加します。次の方法でコントローラー名とメソッドを選択できます。
php artisan make:route about MyController@method --type=controller
リソース コントローラーを作成する場合は、次のようにします。
php artisan make:route about --type=resource
これにより以下が追加されます。
Route:: resource ( ' about ' , ' About@index ' );
ファイルRoutes/web.phpに追加します。
オプションmethod を使用して、他の HTTP メソッドでルートを作成することもできます。
php artisan make:route save --method=post
オプションapi を使用して API にルートを追加することもできます。
php artisan make:route save --api
次に、ルートがroutes/api.phpに追加されます。
最後にオプション-a を使用して、ルート作成後にアクションを追加します。
php artisan make:route about -a
最後のコマンドでも、 about.blade.phpという名前のビューを作成します。使用方法:
php artisan make:route about -a --type=controller
AboutControllerという名前とメソッド インデックスを持つコントローラー ファイルを作成します。
すべてのオプションを次のように参照できます。
php artisan make:route --help
このコマンドはインストール中にすでに実行されており、次のように手動で (再) 実行できます。
php artisan adminlte:publish
必要なすべてのファイルをパッケージから Laravel プロジェクトにパブリッシュします。
サイドバーのカスタマイズを許可するパッケージのサイドバーのみを Laravel プロジェクトに公開します。
php artisan adminlte:sidebar
注: adminlte-laravel installコマンドを使用すると、サイドバーはすでに公開されています。
spatie/laravel-menu を使用してサイドバービューをサイドバーに置き換えます。
php artisan adminlte:menu
このコマンドは spatie/laravel-menu パッケージもインストールし、 config/menu.phpにデフォルトのメニューを作成します。
重要: Spatie Laravel メニューが動作するには PHP7.0 以降が必要です
make:adminUserSeeder 職人コマンド (次のセクションを参照) を実行し、シードを実行します。このコマンドは、デフォルトの管理者ユーザーをデータベースに追加します。
php artisan adminlte:admin
File /home/sergi/Code/AdminLTE/acacha/adminlte-laravel_test/database/seeds/AdminUserSeeder.php created
User Sergi Tur Badenas([email protected]) with the environemnt password (env var ADMIN_PWD) created succesfully !
このコマンドは、環境変数 (.env ファイル) ADMIN_USER、ADMIN_EMAIL、および ADMIN_PWD を (存在する場合) 使用します。この環境変数が存在しない場合は、 git config (~/.gitconfig) を使用してデータを取得します。この情報が存在しない場合は、デフォルトとして Admin ([email protected]) とパスワード 123456 を使用します。
新しいシードを作成して、データベースに管理者ユーザーを追加します。使用:
php artisan make:adminUserSeeder
File /home/sergi/Code/AdminLTE/acacha/adminlte-laravel_test/database/seeds/AdminUserSeeder.php created
acacha/laravel-social パッケージを使用して、Laravel Adminlte に (オプションの) ソーシャル ログイン/登録サポートを追加するのは簡単です。プロジェクトのルート フォルダーで実行します。
adminlte-laravel social
ウィザードに従ってソーシャル プロバイダーの Oauth データを構成し、お楽しみください。
詳細については、https://github.com/acacha/laravel-social をご覧ください。
行を削除
@ include ( ' auth.partials.social_login ' )
ファイルresources/views/auth/login.blade.php
およびregister.blade.php
内
https://packagist.org/packages/acacha/admin-lte-template-laravel
http://acacha.org/mediawiki/AdminLTE#adminlte-laravel
Composer スクリプトのテストを実行するときに phpunit を使用します。
$ composer test
このパッケージが Laravel プロジェクトにインストールされると、パッケージの機能をテストするためにいくつかのテストがインストールされます。テストには、機能/単体テストとブラウザ テストの 2 種類があります。機能/単体テストを実行するには、次のコマンドを実行します。
./vendor/bin/phpunit
acacha-admintle.laravel がインストールされた新しく作成された laravel プロジェクトで、パッケージが正しくインストールされていることをテストします。 Laravel Dusk を使用してブラウザ テストを実行することもできます (https://laravel.com/docs/master/dusk に従って、まず手動で Dusk パッケージをインストールしてください)。
php artisan dusk:install
touch database/testing.database.sqlite
php artisan serve --env=dusk.local &
php artisan dusk
このパッケージをインストールせずにサンドボックスでテストすることもできます。スクリプトを実行します:
./test.sh
すべての文字列は、Laravel ローカリゼーション サポートを使用してローカライズされます: https://laravel.com/docs/master/localization
config/app.php ファイルでロケールを変更して言語を変更できます。 adminlte_lang タグを使用して、ローカライズされたファイルのみをインストールできます。
php artisan vendor:publish --tag=adminlte_lang --force
このパッケージでは、英語、カタロニア語、スペイン語、オランダ語、ブラジル系ポルトガル語の言語がデフォルトでサポートされています。ご希望の場合は、別の言語で新しいプル リクエストを送信してください。
注: Laravel 5.5 以降では必要ありません
Acachallum が動作するには GNU sed が必要なので、以下を使用して BSD sed を GNU sed に置き換えます。
brew install gnu-sed --with-default-names
sed のバージョンを次のように確認します。
man sed
sed GNU バージョンのパスは次のとおりです。
$ which sed
/usr/local/bin/sed
BSD sed のデフォルト パス (MAC OS にデフォルトでインストールされる) の代わりに:
/usr/bin/sed
詳細については #58 をご覧ください
コマンドを実行します:
php artisan adminlte:username
そして、ログインに電子メールの代わりにユーザー名を使用できます。
注: ユーザー名によるログインを使用している場合、ユーザー名によるログインが失敗すると、システムは導入されたユーザー名をログイン用の電子メールとして使用しようとします。したがって、ユーザーは電子メールを使用してログインすることもできます。
電子メール ログインに戻るには、 config/auth.phpファイルからフィールドオプションを削除します。
' providers ' = > [
' users ' => [
' driver ' => ' eloquent ' ,
' model ' => App U ser::class,
' field ' => ' username ' // Adminlte laravel. Valid values: ' email ' or ' username '
],
注: ユーザー名フィールドを users テーブルに追加するには移行が必要です:
composer require doctrine/dbal
オプションで、ユーザー名ログインのデフォルトのドメイン名を定義できます。ドメインオプションを追加:
' defaults ' => [
' guard ' => ' web ' ,
' passwords ' => ' users ' ,
' domain ' => ' defaultdomain.com ' ,
],
ファイルconfig/auth.phpにコピーします。ユーザーがドメインを使用せずにログインしようとすると、ログ記録時にデフォルトのドメインが追加されます。
したがって、前の例では、ログイン時に次のように入力できます。
sergiturbadenas
system/javascript はそれを次のように置き換えます。
Laravel adminlte パッケージはデフォルトで、次のスクリプトを HTML ヘッダーに追加して Laravel 翻訳を Javascript/Vue.js に公開します。
< script >
//See https://laracasts.com/discuss/channels/vue/use-trans-in-vuejs
window.trans = @php
// copy all translations from /resources/lang/CURRENT_LOCALE/* to global JS variable
$lang_files = File::files(resource_path() . '/lang/' . App::getLocale());
$trans = [];
foreach ($lang_files as $f) {
$filename = pathinfo ( $f ) [ 'filename' ] ;
$trans [ $filename ] = trans ( $filename ) ;
}
$trans['adminlte_lang_message'] = trans('adminlte_lang::message');
echo json_encode($trans);
@endphp
</ script >
このスクリプトは部分的なブレード ファイル (vendor/acacha/admin-lte-template-laravel/resources/views/layouts/partials/htmlheader.blade.php) にあります。
したがって、グローバル変数 window.trans には、任意の Javascript ファイルで使用できるすべての Laravel 翻訳が含まれています。
また、ファイルresource/assets/js/bootstrap.jsコード セクションにも次のように記述されています。
Vue.prototype.trans = (key) => {
return _.get(window.trans, key, key);
};
vue テンプレートで trans 関数を直接使用できるようにします。
{{ trans('auth.failed') }}
また、Vue コンポーネントのコード内で使用することもできます。
this.trans('auth.failed')
Laravel Adminlte メッセージは、プレフィックスadminlte_lang_messageを使用して利用できます。
{{ trans('adminlte_lang_message.username') }}
必要に応じてこのファイルを自由に削除/調整してください。
最近の変更点の詳細については、CHANGELOG を参照してください。
詳細については、「貢献と実施」を参照してください。
セキュリティ関連の問題を発見した場合は、問題トラッカーを使用する代わりに、[email protected] に電子メールを送信してください。
MIT ライセンス (MIT)。詳細については、ライセンス ファイルを参照してください。
https://github.com/acacha/adminlte-laravel-installer