Beranda>Kode sumber PHP>Kategori lainnya
Unduh

Paket Laravel template AdminLTE

Paket Laravel yang mengalihkan scaffolding / boilerplate Laravel default ke template AdminLTE dengan Bootstrap 3.0 dan Pratt Landing Page

Lihat demonya di sini:

http://demo.adminlte.acacha.org/

Jika Anda mencari versi Laravel 4, gunakan versi/tag 0.1.5 dan lihat OLD-README.md

Instalasi 

composer require " acacha/admin-lte-template-laravel "

Akhirnya publikasikan file dengan: 

php artisan vendor:publish --tag=adminlte --force

Persyaratan

Paket ini menggunakan (tidak perlu menginstal):

  • Komposer
  • Laravel
  • AdminLTE. Anda dapat melihat dan pratinjau tema AdminLTE di: http://almsaeedstudio.com/preview/
  • Pratt. Halaman Arahan Pratt
  • acacha/helpers : Helper tambahan untuk Laravel yang disediakan oleh acacha.
  • creativeorange/gravatar: Dukungan Gravatar untuk gambar profil pengguna. Ini bisa bersifat opsional melalui konfigurasi.
  • liga/flysystem : Dukungan sistem file.
  • laravel/ui : Perancah otentikasi Laravel.
  • liga/kerangka. Paket ini digunakan/telah diadaptasi untuk menggunakan kerangka phpleague.
  • Acacha llum membutuhkan sed GNU. pada MAC OS instal GNU sed dengan: 
brew install gnu-sed --with-default-names

Paket ini mengasumsikan bahwa Anda memiliki jalur folder bin komposer Anda: 

 /YOUR_PATH_TO_HOME/.composer/vendor/bin

Misalnya menambahkan baris ini: 

 export PATH= ${PATH} : ~ /.composer/vendor/bin

ke file ~/.bashrc Anda

Catatan: di beberapa sistem jalurnya bisa berbeda misalnya: 

 export PATH= ${PATH} : ~ /.config/composer/vendor/bin

Pastikan untuk memeriksa lingkungan Anda.

Persyaratan opsional

  • Menu Laravel: hanya digunakan dengan perintah adminlte:menu yang menggantikan menu adminlte default dengan menu dengan dukungan spatie/laravel-menu.

Laravel 7 dan yang lebih lama

  • Paket ini bekerja dengan lancar dengan Laravel 7.x dengan versi 7.x
  • Paket ini bekerja dengan lancar dengan Laravel 6.x|5.x dengan versi 6.x

Rute Laravel

Paket ini menginstal rute Laravel yang tidak akan Anda temukan di file rute.php. Rute yang diinstal oleh paket dapat ditemukan di file:

https://github.com/acacha/adminlte-laravel/blob/master/src/Http/routes.php

File yang disertakan oleh AdminLTETtemplateServiceProvider:

https://github.com/acacha/adminlte-laravel/blob/master/src/Providers/AdminLTETtemplateServiceProvider.php

Anda dapat mengganti rute ini dengan mengubah urutan ServiceProviders di file config/app.php jadi jika Anda memasukkan: 

 App  Providers RouteServiceProvider::class

Setelah 

 Acacha  AdminLTETemplateLaravel  Providers AdminLTETemplateServiceProvider::class

Rute Anda di file rute.php akan menggantikan rute adminlte-laravel default.

Anda juga dapat menginstal rute secara manual di file rute.php. Adminlte-laravel menggunakan rute yang sama dengan penggunaan perintah Laravel make:auth, lihat:

https://github.com/laravel/framework/blob/5.2/src/Illuminate/Auth/Console/stubs/make/routes.stub

sehingga Anda dapat menambahkan baris ini ke file rute.php: 

Route:: auth ();

Route:: get ( ' /home ' , ' HomeController@index ' );

Dan nonaktifkan AdminLTETtemplateServiceProvider di file config/app.php (perhatikan bahwa Adminte-laravel Facades dan perintah khusus tidak akan tersedia).

Lihat edisi #69 untuk info lebih lanjut

Langkah pertama, pembuatan database, migrasi dan login

Setelah paket terinstal, Anda harus mengikuti langkah-langkah yang biasa dilakukan pada proyek laravel mana pun untuk Masuk ke antarmuka admin:

  • Buat basis data. Saya merekomendasikan penggunaan laravel Homestead()
  • Buat/periksa file .env dan konfigurasikan akses database (nama database, kata sandi, dll)
  • Jalankan migrasi dengan perintah $php artisanmigrate
  • Daftarkan pengguna pertama dan Login dengannya

AdminLTE

AdminLTE adalah Tema Panel Kontrol Admin Premium Gratis Berdasarkan Bootstrap 3.x yang dibuat oleh Abdullah Almsaeed. Melihat:

https://github.com/almasaeed2010/AdminLTE

Avatar/Gravatar

Adminlte-laravel mendukung avatar yang diakui secara global (http://gravatar.com) menggunakan paket creativeorange/gravatar (https://github.com/creativeorange/gravatar).

Perintah Pengrajin

membuat: melihat

Perintah ini menambahkan tampilan ke folder sumber daya/tampilan menggunakan tata letak adminlte default: 

php artisan make:view about

membuat:menu

Perintah ini menambahkan entri menu ke file config/menu.php : 

php artisan make:menu link menuname

Contoh: 

php artisan make:menu /contact

membuat: rute

Perintah ini menambahkan rute ke file rute menggunakan: 

php artisan make:route linkname

Misalnya Anda dapat menambahkan file rute rute/web.php dengan URI /about menggunakan: 

php artisan make:route about

Perintah ini menambahkan entri ini ke rute/web.php

Anda dapat membuat 3 jenis rute dengan tipe opsi :

  • regular : merutekan menggunakan penutupan dengan perintah tampilan kembali yang sederhana. Ini adalah yang default
  • controller : merutekan menggunakan pengontrol.
  • resource : merutekan menggunakan pengontrol sumber daya.

Contoh: 

php artisan make:route about --type=controller

ini menambahkan yang berikut: 

Route:: get ( ' about ' , ' AboutController@index ' );

untuk mengajukan rute/web.php . Anda dapat memilih nama dan metode pengontrol dengan: 

php artisan make:route about MyController@method --type=controller

Jika Anda ingin membuat pengontrol sumber daya: 

php artisan make:route about --type=resource

ini menambahkan yang berikut: 

Route:: resource ( ' about ' , ' About@index ' );

untuk mengajukan rute/web.php .

Anda juga dapat membuat rute dengan metode HTTP lain menggunakan metode opsi : 

php artisan make:route save --method=post

Anda juga dapat menambahkan rute ke api menggunakan opsi api : 

php artisan make:route save --api

Kemudian rute akan ditambahkan ke rute/api.php .

Terakhir gunakan opsi -a untuk menambahkan tindakan setelah pembuatan rute: 

php artisan make:route about -a

Perintah terakhir juga membuat tampilan dengan nama about.blade.php . Menggunakan: 

php artisan make:route about -a --type=controller

Akan membuat file Controller dengan nama AboutController dan indeks metode.

Anda dapat berkonsultasi semua opsi dengan: 

php artisan make:route --help

adminlte:terbitkan | adminlte-laravel:terbitkan

Perintah ini sudah dijalankan selama instalasi, Anda dapat mengeksekusi (kembali) secara manual dengan: 

php artisan adminlte:publish

Publikasikan semua file yang diperlukan dari paket ke proyek Laravel.

admin:bilah samping | adminlte-laravel:sidebar

Hanya terbitkan sidebar paket ke proyek Laravel yang memungkinkan untuk menyesuaikan sidebar: 

php artisan adminlte:sidebar

Catatan: sidebar sudah dipublikasikan saat Anda menggunakan perintah adminlte-laravel install .

admin:menu | adminlte-laravel:menu

Mengganti tampilan sidebar dengan sidebar menggunakan spatie/laravel-menu: 

php artisan adminlte:menu

Perintah ini juga menginstal paket spatie/laravel-menu dan membuat menu default yang terletak config/menu.php .

PENTING : Menu Spatie Laravel memerlukan PHP7.0 atau lebih tinggi agar dapat berfungsi

adminlte-laravel:admin | admin:admin

Jalankan perintah artisan make:adminUserSeeder (lihat bagian selanjutnya) dan jalankan seed. Perintah ini menambahkan pengguna admin default ke database. 

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 !

Perintah ini menggunakan (jika ada) variabel lingkungan (file .env) ADMIN_USER, ADMIN_EMAIL dan ADMIN_PWD. Jika variabel env ini tidak ada maka gunakan git config (~/.gitconfig) untuk mendapatkan data dan jika info ini tidak ada gunakan Admin ([email protected]) dan kata sandi 123456 sebagai default.

buat: adminUserSeeder

Buat seed baru untuk menambahkan pengguna admin ke database. Menggunakan: 

php artisan make:adminUserSeeder
File /home/sergi/Code/AdminLTE/acacha/adminlte-laravel_test/database/seeds/AdminUserSeeder.php created

Login Sosial/Daftar dengan acacha/laravel-social

Sangat mudah untuk menambahkan (opsional) dukungan Login/Daftar Sosial ke Laravel Adminlte menggunakan paket acacha/laravel-social. Jalankan di folder root proyek Anda: 

adminlte-laravel social

Ikuti wizard untuk mengonfigurasi data Oauth penyedia sosial Anda dan nikmatilah!

Info lebih lanjut di https://github.com/acacha/laravel-social.

Bagaimana cara menghapus Login sosial?

Hapus garis 

@ include ( ' auth.partials.social_login ' )

dalam file resources/views/auth/login.blade.php dan register.blade.php

Peta jalan

  • Tambahkan templat html email
  • Tambahkan remah roti dengan: https://github.com/davejamesmiller/laravel-breadcrumbs

Dokumentasi TODO

  • File Gulp disediakan untuk mengkompilasi lebih sedikit file Boostrap dan AdminLTE
  • Tampilan sebagian (header html, header konten, footer, dll.) untuk menggunakan kembali kode dengan mudah

ahli pengemasan

https://packagist.org/packages/acacha/admin-lte-template-laravel

Informasi lebih lanjut

http://acacha.org/mediawiki/AdminLTE#adminlte-laravel

Tes

Menguji paket ini

Gunakan phpunit saat menjalankan tes skrip komposer: 

$ composer test

Menguji proyek laravel setelah paket ini diinstal

Setelah paket ini diinstal dalam proyek Laravel, beberapa pengujian diinstal untuk menguji fitur paket. Ada dua jenis tes Tes Fitur/Unit dan tes Browser. Untuk menjalankan pengujian Fitur/Unit, jalankan: 

 ./vendor/bin/phpunit

Dalam proyek laravel yang baru dibuat dengan acacha-admintle.laravel diinstal untuk menguji apakah paket diinstal dengan benar. Anda juga dapat menjalankan tes Browser dengan Laravel Dusk (silakan instal terlebih dahulu paket Dusk secara manual berikut https://laravel.com/docs/master/dusk): 

 php artisan dusk:install
touch database/testing.database.sqlite
php artisan serve --env=dusk.local &
php artisan dusk

Anda juga dapat menguji paket ini di sandbox tanpa perlu menginstal. Jalankan skrip: 

./test.sh

Lokalisasi

Semua string dilokalkan menggunakan dukungan lokalisasi Laravel: https://laravel.com/docs/master/localization

Di file config/app.php Anda, Anda dapat mengubah lokal untuk mengubah bahasa. Anda hanya dapat menginstal file yang dilokalkan menggunakan tag adminlte_lang: 

php artisan vendor:publish --tag=adminlte_lang --force

Bahasa berikut ini didukung secara default pada paket ini: Inggris, Katalan, Spanyol, Belanda, dan Portugis Brasil. Silakan kirimkan permintaan penarikan baru dalam bahasa lain jika Anda mau.

Pemecahan masalah

GNU diinstal pada MAC OS

CATATAN: tidak diperlukan di Laravel 5.5+

Acacha llum memerlukan sed GNU agar berfungsi, jadi ganti sed BSD dengan sed GNU menggunakan: 

brew install gnu-sed --with-default-names

Periksa versi sed Anda dengan: 

man sed

sed jalur versi GNU adalah: 

$ which sed
/usr/local/bin/sed

Alih-alih jalur default sed BSD (diinstal secara default di MAC OS): 

/usr/bin/sed

Info lebih lanjut di #58

Cara menggunakan nama pengguna saat login, bukan email

Jalankan perintah: 

 php artisan adminlte:username

Dan kemudian Anda dapat menggunakan nama pengguna alih-alih email untuk login.

CATATAN: ketika kita menggunakan login dengan nama pengguna jika login dengan nama pengguna gagal maka sistem mencoba menggunakan nama pengguna yang dimasukkan sebagai email untuk login. Jadi pengguna juga bisa login menggunakan email.

Untuk kembali ke login email, hapus opsi bidang dari file config/auth.php : 

 ' providers ' = > [
    ' users ' => [
        ' driver ' => ' eloquent ' ,
        ' model ' => App U ser::class,
        ' field ' => ' username ' // Adminlte laravel. Valid values: ' email ' or ' username '
    ],

CATATAN: Migrasi diperlukan untuk menambahkan bidang nama pengguna ke tabel pengguna memerlukan: 

composer require doctrine/dbal

Domain default untuk pendaftaran nama pengguna

Secara opsional, Anda dapat menentukan nama domain default untuk login nama pengguna. Tambahkan opsi domain: 

 ' defaults ' => [
    ' guard ' => ' web ' ,
    ' passwords ' => ' users ' ,
    ' domain ' => ' defaultdomain.com ' ,
],

ke file config/auth.php . Kemudian jika pengguna mencoba masuk tanpa domain, domain default akan ditambahkan saat masuk.

Jadi dengan contoh sebelumnya Anda bisa mengetik saat login: 

 sergiturbadenas

dan sistem/javascript akan menggantinya dengan: 

 [email protected]

Lihat

Paket admin Laravel secara default mempublikasikan terjemahan Laravel ke dalam Javascript/Vue.js dengan menambahkan skrip berikut ke header HTML: 

 < 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 >

Skrip ini terletak di sebagian file blade (vendor/acacha/admin-lte-template-laravel/resources/views/layouts/partials/htmlheader.blade.php)

Jadi variabel global window.trans berisi semua terjemahan Laravel yang dapat digunakan dalam file Javascript apa pun.

Juga di bagian kode file resources/assets/js/bootstrap.js : 

 Vue.prototype.trans = (key) => {
    return _.get(window.trans, key, key);
};

Mengizinkan penggunaan langsung fungsi trans di templat vue: 

 {{ trans('auth.failed') }}

Anda juga dapat menggunakan kode di dalam komponen Vue: 

 this.trans('auth.failed')

Pesan Laravel Adminlte tersedia menggunakan awalan adminlte_lang_message : 

 {{ trans('adminlte_lang_message.username') }}

Jangan ragu untuk menghapus/menyesuaikan file ini dengan kebutuhan Anda.

Ubah catatan

Silakan lihat CHANGELOG untuk informasi lebih lanjut tentang apa yang berubah baru-baru ini.

Berkontribusi

Silakan lihat KONTRIBUSI dan PERILAKU untuk rinciannya.

Keamanan

Jika Anda menemukan masalah apa pun terkait keamanan, silakan kirim email ke [email protected] alih-alih menggunakan pelacak masalah.

Kredit

  • Sergi Tur Badenas
  • Semua Kontributor

Lisensi

Lisensi MIT (MIT). Silakan lihat File Lisensi untuk informasi lebih lanjut.

Lihat juga

https://github.com/acacha/adminlte-laravel-installer

Memperluas
Informasi Tambahan
Aplikasi Terkait
Direkomendasikan untuk Anda
Informasi Terkait Semua