laravel.io
1.0.0
Dies ist das Repository für das Community-Portal Laravel.io. Der Code ist vollständig Open Source und unter der MIT-Lizenz lizenziert. Wir freuen uns über Ihre Beiträge, empfehlen Ihnen jedoch, den Beitragsleitfaden zu lesen, bevor Sie ein Problem erstellen oder eine Pull-Anfrage senden. Lesen Sie die Installationsanleitung unten, um mit der Einrichtung der App auf Ihrem Computer zu beginnen.
Wir möchten diesen großartigen Unternehmen dafür danken, dass sie uns gesponsert haben. Wenn Sie daran interessiert sind, Sponsor zu werden, besuchen Sie bitte die GitHub-Sponsorenseite von Laravel.io.
Eventuell
Schmiede
Gesandter
Ergründen
Tinkerwell
BairesDev
N-iX
Um die Installation zu starten, sind die folgenden Tools erforderlich.
PHP 8.3
Komponist
NPM
Kammerdiener
Beachten Sie, dass Sie den Speicherort
~/Sites/laravel.iofrei an jedes gewünschte Verzeichnis auf Ihrem Computer anpassen können. Stellen Sie dabei sicher, dass Sie denvalet link-Befehl im gewünschten Verzeichnis ausführen.
Klonen Sie dieses Repository mit git clone [email protected]:laravelio/laravel.io.git ~/Sites/laravel.io
Führen Sie composer install aus, um die PHP-Abhängigkeiten zu installieren
Richten Sie eine lokale Datenbank namens laravel ein
Führen Sie composer setup aus, um die Anwendung einzurichten
Richten Sie einen funktionierenden E-Mail-Treiber wie Mailtrap ein
Führen Sie valet link aus, um die Site mit einer Test-Webadresse zu verknüpfen
Erstellen Sie eine testing in MySQL, damit Sie die Testsuite ausführen können
Konfigurieren Sie die (optionalen) Funktionen unten
Sie können die App jetzt in Ihrem Browser aufrufen, indem Sie http://laravel.io.test aufrufen. Wenn Sie die Datenbank gesät haben, können Sie sich mit testing und password bei einem Testkonto anmelden.
Damit die GitHub-Authentifizierung lokal funktioniert, müssen Sie eine neue OAuth-Anwendung auf GitHub registrieren. Verwenden Sie http://laravel.io.test für die Homepage-URL und http://laravel.io.test/auth/github für die Rückruf-URL. Wenn Sie die App erstellt haben, geben Sie die ID und das Geheimnis in Ihrer .env Datei in die folgenden env-Variablen ein. Sie sollten nun in der Lage sein, sich mit GitHub zu authentifizieren.
GITHUB_ID= GITHUB_SECRET= GITHUB_URL=http://laravel.io.test/auth/github
Damit die Algolia-Suche lokal ausgeführt werden kann, müssen Sie sich für ein neues Konto registrieren und einen Index namens threads erstellen. Algolia verfügt über eine kostenlose Stufe, die alle für eine Entwicklungsumgebung erforderlichen Anforderungen erfüllt. Aktualisieren Sie nun die folgenden Variablen in Ihrer .env Datei. Die App-ID und die geheimen Schlüssel finden Sie im Abschnitt API Keys der Algoila-Benutzeroberfläche.
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=usersUm Ihre vorhandenen Threads zu indizieren, führen Sie den folgenden Befehl aus:
php artisan scout:import AppModelsThread
Neue Threads werden automatisch zum Index hinzugefügt und aktualisierte Threads werden automatisch synchronisiert. Wenn Sie Ihren Index leeren und erneut starten müssen, können Sie den folgenden Befehl ausführen:
php artisan scout:flush AppModelsThread
Damit veröffentlichte Artikel automatisch auf X geteilt werden können, müssen Sie eine App erstellen. Sobald die App erstellt wurde, aktualisieren Sie die folgenden Variablen in Ihrer .env Datei. Der Verbraucherschlüssel und das Geheimnis sowie das Zugriffstoken und das Geheimnis finden Sie im Abschnitt Keys and tokens der X-Entwickler-Benutzeroberfläche.
TWITTER_CONSUMER_KEY= TWITTER_CONSUMER_SECRET= TWITTER_ACCESS_TOKEN= TWITTER_ACCESS_SECRET=
Um dasselbe für Bluesky zu tun, müssen Sie lediglich die App-Schlüssel mit Ihrem Login und Passwort einrichten:
BLUESKY_USERNAME= BLUESKY_PASSWORD=
Genehmigte Artikel werden in der Reihenfolge freigegeben, in der sie zur Genehmigung eingereicht wurden. Artikel werden zweimal täglich um 14:00 und 18:00 UTC geteilt. Sobald ein Artikel geteilt wurde, wird er nicht erneut geteilt.
Laravel.io kann Betreuer über neu eingereichte Artikel per Telegram benachrichtigen. Damit dies funktioniert, müssen Sie einen Telegram-Bot einrichten und einen Token erhalten. Konfigurieren Sie dann den Kanal, an den Sie neue Artikelnachrichten senden möchten.
TELEGRAM_BOT_TOKEN= TELEGRAM_CHANNEL=
Um die Anzahl der Aufrufe von Artikeln zu aktivieren, müssen Sie ein Fathom Analytics-Konto registrieren und es auf der Website installieren. Anschließend müssen Sie ein API-Token erstellen und Ihre Site-ID ermitteln, bevor Sie die folgenden Umgebungsvariablen in Ihrer .env Datei aktualisieren.
FATHOM_SITE_ID= FATHOM_TOKEN=
Um sicherzustellen, dass Artikel- und Benutzer-Header-Bilder mit der Datenbank synchronisiert werden, müssen wir einen Zugriffsschlüssel von Unsplash einrichten. Bitte beachten Sie, dass Ihre Unsplash-App Produktionszugriff benötigt.
UNSPLASH_ACCESS_KEY=
Danach können Sie jeder Artikelzeile in der Spalte hero_image_id eine Unsplash-Foto-ID hinzufügen und den Synchronisierungsbefehl ausführen, um die Bild-URL und die Autorendaten abzurufen:
php artisan lio:sync-article-images
| Befehl | Beschreibung |
|---|---|
vendor/bin/pest -p | Führen Sie die Tests mit paralleler Ausführung aus |
php artisan migrate:fresh --seed | Setzen Sie die Datenbank zurück |
npm run dev | Erstellen Sie und achten Sie auf Änderungen in CSS- und JS-Dateien |
Das Laravel.io-Portal wird derzeit von Dries Vints und Joe Dixon betreut. Wenn Sie Fragen haben, zögern Sie bitte nicht, ein Problem in diesem Repo zu erstellen.
Bitte lesen Sie den Beitragsleitfaden, bevor Sie ein Problem erstellen oder eine Pull-Anfrage senden.
Bitte lesen Sie unseren Verhaltenskodex, bevor Sie einen Beitrag leisten oder sich an Diskussionen beteiligen.
Bitte lesen Sie unsere Sicherheitsrichtlinie zum Melden von Sicherheitslücken.
Die MIT-Lizenz. Weitere Informationen finden Sie in der Lizenzdatei.
