laravel.io

Laravel.io

Ini adalah gudang portal komunitas Laravel.io. Kode ini sepenuhnya open source dan dilisensikan di bawah lisensi MIT. Kami menyambut baik kontribusi Anda, namun kami mendorong Anda untuk membaca panduan berkontribusi sebelum membuat masalah atau mengirimkan permintaan penarikan. Baca panduan instalasi di bawah ini untuk mulai menyiapkan aplikasi di mesin Anda.

Sponsor

Kami ingin mengucapkan terima kasih kepada perusahaan-perusahaan luar biasa ini yang telah mensponsori kami. Jika Anda tertarik menjadi sponsor, silakan kunjungi halaman GitHub Sponsors Laravel.io.

• Acara

• Menempa

• Utusan

• Memahami

• Tinkerwell

• BairesDev

• T-iX

Persyaratan

Alat-alat berikut diperlukan untuk memulai instalasi.

• PHP 8.3

• Komposer

• NPM

• pelayan

Instalasi

Perhatikan bahwa Anda bebas menyesuaikan lokasi ~/Sites/laravel.io ke direktori mana pun yang Anda inginkan di mesin Anda. Saat melakukannya, pastikan untuk menjalankan perintah valet link di dalam direktori yang diinginkan.

1. Kloning repositori ini dengan git clone [email protected]:laravelio/laravel.io.git ~/Sites/laravel.io

2. Jalankan composer install untuk menginstal dependensi PHP

3. Siapkan database lokal bernama laravel

4. Jalankan composer setup untuk mengatur aplikasi

5. Siapkan driver email yang berfungsi seperti Mailtrap

6. Jalankan valet link untuk menautkan situs ke alamat web pengujian

7. Buat database testing di MySQL sehingga Anda dapat menjalankan rangkaian pengujian

8. Konfigurasikan fitur (opsional) dari bawah

Anda sekarang dapat mengunjungi aplikasi di browser Anda dengan mengunjungi http://laravel.io.test. Jika Anda menyemai database, Anda dapat masuk ke akun pengujian dengan testing & password .

Otentikasi GitHub (opsional)

Agar autentikasi GitHub berfungsi secara lokal, Anda harus mendaftarkan aplikasi OAuth baru di GitHub. Gunakan http://laravel.io.test untuk url beranda dan http://laravel.io.test/auth/github untuk url panggilan balik. Setelah Anda membuat aplikasi, isikan ID dan rahasia pada file .env Anda pada variabel env di bawah. Anda sekarang seharusnya dapat mengautentikasi dengan GitHub.

GITHUB_ID=
GITHUB_SECRET=
GITHUB_URL=http://laravel.io.test/auth/github

Pencarian Algolia (opsional)

Agar pencarian Algolia berjalan secara lokal, Anda harus mendaftar akun baru dan membuat indeks bernama threads . Algolia memiliki tingkat gratis yang memenuhi semua persyaratan yang diperlukan untuk lingkungan pengembangan. Sekarang perbarui variabel di bawah ini di file .env Anda. ID Aplikasi dan kunci rahasia dapat ditemukan di bagian API Keys di UI Algoila.

SCOUT_DRIVER=algolia
SCOUT_QUEUE=true

ALGOLIA_APP_ID=
ALGOLIA_SECRET="Use the Write API Key"

VITE_ALGOLIA_APP_ID="${ALGOLIA_APP_ID}"
VITE_ALGOLIA_SECRET="Use the Search API Key"

VITE_ALGOLIA_THREADS_INDEX=threads
VITE_ALGOLIA_ARTICLES_INDEX=articles
VITE_ALGOLIA_USERS_INDEX=users

Untuk mengindeks thread yang ada, jalankan perintah berikut:

 pramuka tukang php: import AppModelsThread

Thread baru akan secara otomatis ditambahkan ke indeks dan thread yang diperbarui akan disinkronkan secara otomatis. Jika Anda perlu menghapus indeks dan memulai lagi, Anda dapat menjalankan perintah berikut:

 pramuka tukang php:flush AppModelsThread

Berbagi Media Sosial (opsional)

Untuk mengaktifkan artikel yang diterbitkan agar dibagikan secara otomatis di X, Anda harus membuat aplikasi. Setelah aplikasi dibuat, perbarui variabel di bawah ini dalam file .env Anda. Kunci dan rahasia konsumen serta token dan rahasia akses dapat ditemukan di bagian Keys and tokens pada UI pengembang X.

TWITTER_CONSUMER_KEY=
TWITTER_CONSUMER_SECRET=
TWITTER_ACCESS_TOKEN=
TWITTER_ACCESS_SECRET=

Untuk melakukan hal yang sama pada Bluesky, Anda hanya perlu mengatur kunci aplikasi dengan login dan kata sandi Anda:

BLUESKY_USERNAME=
BLUESKY_PASSWORD=

Artikel yang disetujui dibagikan sesuai urutan pengirimannya untuk disetujui. Artikel dibagikan dua kali sehari pada pukul 14:00 dan 18:00 UTC. Setelah artikel dibagikan, artikel tersebut tidak akan dibagikan lagi.

Notifikasi Telegram (opsional)

Laravel.io dapat memberi tahu pengelola artikel yang baru dikirimkan melalui Telegram. Agar ini berfungsi, Anda perlu menyiapkan bot Telegram dan mendapatkan token. Kemudian, konfigurasikan saluran yang ingin Anda kirimi pesan artikel baru.

TELEGRAM_BOT_TOKEN=
TELEGRAM_CHANNEL=

Analisis Fathom (opsional)

Untuk mengaktifkan jumlah penayangan artikel, Anda harus mendaftarkan akun Fathom Analytics dan menginstalnya di situs. Anda kemudian perlu membuat token API dan menemukan ID situs Anda sebelum memperbarui variabel lingkungan di bawah ini dalam file .env Anda.

FATHOM_SITE_ID=
FATHOM_TOKEN=

Hapus percikan (opsional)

Untuk memastikan artikel dan gambar header pengguna disinkronkan ke dalam database, kita perlu menyiapkan kunci akses dari Unsplash. Harap dicatat bahwa aplikasi Unsplash Anda memerlukan akses produksi.

UNSPLASH_ACCESS_KEY=

Setelah itu Anda dapat menambahkan ID foto Unsplash ke baris artikel mana pun di kolom hero_image_id dan menjalankan perintah sinkronisasi untuk mengambil url gambar dan data penulis:

 php artisan lio:sinkronisasi-artikel-gambar

Perintah

Memerintah	Keterangan
vendor/bin/pest -p	Jalankan pengujian dengan eksekusi paralel
php artisan migrate:fresh --seed	Setel ulang basis data
npm run dev	Bangun dan perhatikan perubahan pada file CSS dan JS

Pemelihara

Portal Laravel.io saat ini dikelola oleh Dries Vints dan Joe Dixon. Jika Anda mempunyai pertanyaan, jangan ragu untuk membuat masalah pada repo ini.

Berkontribusi

Harap baca panduan berkontribusi sebelum membuat masalah atau mengirimkan permintaan penarikan.

Kode Etik

Harap baca Kode Etik kami sebelum berkontribusi atau terlibat dalam diskusi.

Kerentanan Keamanan

Harap tinjau kebijakan keamanan kami tentang cara melaporkan kerentanan keamanan.

Lisensi

Lisensi MIT. Silakan lihat file lisensi untuk informasi lebih lanjut.