Socialstream hanya dirancang untuk diinstal pada aplikasi BARU. Menginstal Socialstream pada aplikasi yang sudah ada dapat memiliki konsekuensi yang tidak diinginkan.
Socialstream secara utama dimaksudkan untuk digunakan dalam aplikasi Laravel BARU dengan Laravel Jetstream, Laravel Breeze, atau Panel Admin Filament. Jika Anda tidak memerlukan salah satu dari kit pemula ini, Anda dapat menginstal Socialstream sebagai paket mandiri.
"Socialstream" membawa kekuatan OAuth Laravel Socialite ke aplikasi Laravel Breeze, Jetstream, atau Filament Anda secara efisien dan mudah. Memulainya sangatlah mudah; tambahkan socialstream ke aplikasi Anda, jalankan perintah artisan install, pilih tumpukan dan fitur opsional Anda, duduklah dan santailah sementara kami menyiapkan aplikasi Anda untuk Anda!
Anda dapat menginstal Socialstream ke dalam proyek Anda melalui composer:
composer create-project laravel/laravel example-app
cd example-app
composer require joelbutcher/socialstream
Setelah menginstal Socialstream, Anda dapat menjalankan perintah Artisan socialstream:install. Perintah ini akan memandu Anda melalui berbagai tumpukan dan opsi untuk mengonfigurasi instalasi sesuai dengan kebutuhan aplikasi Anda.
Konfigurasi pertama dari ini adalah memutuskan kit pemula mana yang akan digunakan. Secara default, Socialstream terintegrasi langsung ke dalam Laravel Jetstream, Laravel Breeze, atau Filament. Manfaat dari masing-masing kit pemula ini, dan tumpukan mereka yang berbeda, tercantum di bawah ini: Laravel Jetstream
Jetstream adalah kit pemula komprehensif untuk para pengrajin Laravel, dibangun di atas Laravel Sactum dan Laravel Fortify, Jetstream menambahkan otentikasi dua faktor, manajemen sesi, manajemen token API, dan fungsionalitas Tim ke aplikasi Anda. Jetstream tersedia dalam tumpukan berikut:
inertia (Vue dengan Inertia) livewire (Livewire)
Instal Socialstream untuk Laravel Jetstream:
php artisan socialstream:install jetstream inertia
php artisan socialstream:install jetstream livewire
Untuk informasi lebih lanjut, silakan lihat dokumentasi resmi untuk Laravel Breeze.
Laravel Breeze menawarkan implementasi minimal dan sederhana dari mekanisme otentikasi Laravel, termasuk login, registrasi, reset kata sandi, dan verifikasi email. Ini juga memberikan Anda halaman profil sederhana di mana pengguna Anda dapat memperbarui informasi nama, email, dan kata sandi mereka, serta menghapus akun mereka. Laravel Breeze tersedia dalam "tumpukan" berikut:
blade (Blade dengan Alpine) livewire (Livewire (Volt) dengan Alpine) livewire-functional (Livewire (fungsional) dengan Alpine) react (React dengan Inertia) vue (Vue dengan Inertia)
php artisan socialstream:install breeze blade
php artisan socialstream:install breeze livewire
php artisan socialstream:install breeze livewire-functional
php artisan socialstream:install breeze react
php artisan socialstream:install breeze vue
Untuk informasi lebih lanjut, silakan lihat dokumentasi resmi untuk Laravel Breeze.
Jika Anda ingin menyertakan dukungan "mode gelap" saat membangun frontend aplikasi Anda, berikan direktif --dark saat menjalankan perintah socialstream:install:
php artisan socialstream:install breeze livewire --dark
Laravel Breeze dilengkapi dengan dukungan untuk typescript dengan React atau Vue. Untuk menyertakan dukungan typescript ke dalam kerangka kerja frontend aplikasi Anda, tambahkan direktif --typescript saat menjalankan perintah socialstream:install:
php artisan socialstream:install breeze react --typescript
php artisan socialstream:install breeze vue --typescript
Laravel Breeze dan Laravel Jetstream keduanya dilengkapi dengan dukungan untuk Server Side Rendering melalui Laravel Vite & Inertia. Untuk menginstal dukungan SSR, Anda dapat melakukannya dengan menambahkan direktif --ssr saat menjalankan perintah socialstream:install:
php artisan socialstream:install breeze react --ssr
php artisan socialstream:install breeze vue --ssr
php artisan socialstream:install jetstream inertia --ssr
Dukungan Filament saat ini berada dalam versi beta. Tidak disarankan untuk menjalankannya dalam lingkungan produksi karena Anda mungkin mengalami masalah.
Filament adalah paket tumpukan TALL yang memungkinkan pengembang Laravel untuk dengan cepat membangun UI menggunakan komponen yang mudah dikonfigurasi tanpa harus khawatir tentang membangun komponen. Socialstream akan terintegrasi dengan mudah ke dalam panel admin Filament dengan memublikasikan file Livewire yang diperlukan dan merendernya setelah panel login
php artisan socialstream:install filament
Untuk menyelesaikan instalasi Anda, Socialstream akan menjalankan perintah npm install yang diperlukan untuk menginstal dependensi tumpukan frontend dan membangun aplikasi Anda. Setelah ini, Anda perlu menjalankan migrasi secara manual untuk memastikan aplikasi Anda memiliki tabel yang diperlukan agar Socialstream berfungsi:
php artisan migrate
Beberapa konfigurasi lainnya bisa langsung dilihat di website resmi socialstream.
Penulis dari artikel ini.