laravel.io
1.0.0
Il s'agit du référentiel du portail communautaire Laravel.io. Le code est entièrement open source et sous licence MIT. Nous apprécions vos contributions mais nous vous encourageons à lire le guide de contribution avant de créer un problème ou d'envoyer une pull request. Lisez le guide d'installation ci-dessous pour commencer à configurer l'application sur votre ordinateur.
Nous aimerions remercier ces incroyables entreprises de nous parrainer. Si vous souhaitez devenir sponsor, veuillez visiter la page Sponsors de Laravel.io GitHub.
Événementiel
Forge
Envoyer
Brasse
Tinkerwell
BairesDev
Rien
Les outils suivants sont requis pour démarrer l'installation.
PHP8.3
Compositeur
MNP
Valet
Notez que vous êtes libre d'ajuster l'emplacement
~/Sites/laravel.iosur n'importe quel répertoire de votre choix sur votre ordinateur. Ce faisant, assurez-vous d’exécuter la commandevalet linkdans le répertoire souhaité.
Clonez ce référentiel avec git clone [email protected]:laravelio/laravel.io.git ~/Sites/laravel.io
Exécutez composer install pour installer les dépendances PHP
Configurer une base de données locale appelée laravel
Exécutez composer setup pour configurer l'application
Configurez un pilote de messagerie fonctionnel comme Mailtrap
Exécutez valet link pour lier le site à une adresse Web de test
Créez une base de données testing dans MySQL afin de pouvoir exécuter la suite de tests
Configurez les fonctionnalités (facultatives) ci-dessous
Vous pouvez maintenant visiter l'application dans votre navigateur en visitant http://laravel.io.test. Si vous avez créé la base de données, vous pouvez vous connecter à un compte de test avec testing et password .
Pour que l'authentification GitHub fonctionne localement, vous devrez enregistrer une nouvelle application OAuth sur GitHub. Utilisez http://laravel.io.test pour l'URL de la page d'accueil et http://laravel.io.test/auth/github pour l'URL de rappel. Lorsque vous avez créé l'application, remplissez l'ID et le secret dans votre fichier .env dans les variables env ci-dessous. Vous devriez maintenant pouvoir vous authentifier avec GitHub.
GITHUB_ID= GITHUB_SECRET= GITHUB_URL=http://laravel.io.test/auth/github
Pour que la recherche Algolia s'exécute localement, vous devrez créer un nouveau compte et créer un index appelé threads . Algolia propose un niveau gratuit qui satisfait à toutes les exigences nécessaires à un environnement de développement. Mettez maintenant à jour les variables ci-dessous dans votre fichier .env . L'ID de l'application et les clés secrètes se trouvent dans la section API Keys de l'interface utilisateur d'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=usersAfin d'indexer vos threads existants, exécutez la commande suivante :
php artisan scout : importer AppModelsThread
Les nouveaux fils de discussion seront automatiquement ajoutés à l'index et les fils de discussion mis à jour seront automatiquement synchronisés. Si vous devez vider votre index et recommencer, vous pouvez exécuter la commande suivante :
php artisan scout:flush AppModèlesThread
Pour permettre le partage automatique des articles publiés sur X, vous devrez créer une application. Une fois l'application créée, mettez à jour les variables ci-dessous dans votre fichier .env . La clé et le secret du consommateur, ainsi que le jeton d'accès et le secret, se trouvent dans la section Keys and tokens de l'interface utilisateur des développeurs X.
TWITTER_CONSUMER_KEY= TWITTER_CONSUMER_SECRET= TWITTER_ACCESS_TOKEN= TWITTER_ACCESS_SECRET=
Pour faire de même pour Bluesky, il vous suffit de configurer les clés de l'application avec votre identifiant et votre mot de passe :
BLUESKY_USERNAME= BLUESKY_PASSWORD=
Les articles approuvés sont partagés dans l’ordre dans lequel ils ont été soumis pour approbation. Les articles sont partagés deux fois par jour à 14h00 et 18h00 UTC. Une fois qu’un article a été partagé, il ne sera plus partagé.
Laravel.io peut informer les responsables des articles nouvellement soumis via Telegram. Pour que cela fonctionne, vous devrez configurer un bot Telegram et obtenir un jeton. Ensuite, configurez le canal auquel vous souhaitez envoyer des messages de nouveaux articles.
TELEGRAM_BOT_TOKEN= TELEGRAM_CHANNEL=
Pour activer le nombre de vues sur les articles, vous devrez créer un compte Fathom Analytics et l'installer sur le site. Vous devrez ensuite créer un jeton API et trouver l'ID de votre site avant de mettre à jour les variables d'environnement ci-dessous dans votre fichier .env .
FATHOM_SITE_ID= FATHOM_TOKEN=
Pour nous assurer que les images d'article et d'en-tête d'utilisateur sont synchronisées dans la base de données, nous devrons configurer une clé d'accès à partir d'Unsplash. Veuillez noter que votre application Unsplash nécessite un accès en production.
UNSPLASH_ACCESS_KEY=
Après cela, vous pouvez ajouter un identifiant de photo Unsplash à n'importe quelle ligne d'article dans la colonne hero_image_id et exécuter la commande sync pour récupérer l'URL de l'image et les données de l'auteur :
php artisan lio:sync-article-images
| Commande | Description |
|---|---|
vendor/bin/pest -p | Exécutez les tests avec une exécution parallèle |
php artisan migrate:fresh --seed | Réinitialiser la base de données |
npm run dev | Créez et surveillez les modifications dans les fichiers CSS et JS |
Le portail Laravel.io est actuellement géré par Dries Vints et Joe Dixon. Si vous avez des questions, n'hésitez pas à créer un problème sur ce dépôt.
Veuillez lire le guide de contribution avant de créer un problème ou d'envoyer une pull request.
Veuillez lire notre Code de conduite avant de contribuer ou de participer à des discussions.
Veuillez consulter notre politique de sécurité pour savoir comment signaler les vulnérabilités de sécurité.
La licence MIT. Veuillez consulter le fichier de licence pour plus d'informations.
