Este es el repositorio del portal comunitario Laravel.io. El código es completamente de código abierto y tiene la licencia MIT. Agradecemos sus contribuciones, pero lo alentamos a leer la guía de contribución antes de crear un problema o enviar una solicitud de extracción. Lea la guía de instalación a continuación para comenzar a configurar la aplicación en su máquina.
Nos gustaría agradecer a estas increíbles empresas por patrocinarnos. Si está interesado en convertirse en patrocinador, visite la página de Patrocinadores de Laravel.io GitHub.
Evento
Fragua
enviador
Braza
Tinkerwell
BairesDev
Nada
Se requieren las siguientes herramientas para comenzar la instalación.
PHP 8.3
Compositor
MNP
Ayudante de cámara
Tenga en cuenta que puede ajustar la ubicación
~/Sites/laravel.io
a cualquier directorio que desee en su máquina. Al hacerlo, asegúrese de ejecutar el comandovalet link
dentro del directorio deseado.
Clona este repositorio con git clone [email protected]:laravelio/laravel.io.git ~/Sites/laravel.io
Ejecute composer install
para instalar las dependencias de PHP.
Configurar una base de datos local llamada laravel
Ejecute composer setup
para configurar la aplicación.
Configure un controlador de correo electrónico que funcione como Mailtrap
Ejecute valet link
para vincular el sitio a una dirección web de prueba
Cree una base de datos testing
en MySQL para poder ejecutar el conjunto de pruebas
Configure las funciones (opcionales) desde abajo
Ahora puede visitar la aplicación en su navegador visitando http://laravel.io.test. Si sembró la base de datos, puede iniciar sesión en una cuenta de prueba con testing
y password
.
Para que la autenticación de GitHub funcione localmente, deberá registrar una nueva aplicación OAuth en GitHub. Utilice http://laravel.io.test
para la URL de la página de inicio y http://laravel.io.test/auth/github
para la URL de devolución de llamada. Cuando haya creado la aplicación, complete el ID y el secreto en su archivo .env
en las variables env a continuación. Ahora debería poder autenticarse con GitHub.
GITHUB_ID= GITHUB_SECRET= GITHUB_URL=http://laravel.io.test/auth/github
Para que la búsqueda de Algolia se ejecute localmente, deberá registrarse para obtener una nueva cuenta y crear un índice llamado threads
. Algolia tiene un nivel gratuito que satisface todos los requisitos necesarios para un entorno de desarrollo. Ahora actualice las siguientes variables en su archivo .env
. El ID de la aplicación y las claves secretas se pueden encontrar en la sección API Keys
de la interfaz de usuario de 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
Para indexar sus hilos existentes, ejecute el siguiente comando:
php craft scout:importar aplicaciónmodeloshilo
Los nuevos hilos se agregarán automáticamente al índice y los hilos que se actualicen se sincronizarán automáticamente. Si necesita vaciar su índice y comenzar de nuevo, puede ejecutar el siguiente comando:
Explorador artesanal php: vaciar AppModelsThread
Para permitir que los artículos publicados se compartan automáticamente en X, deberá crear una aplicación. Una vez que se haya creado la aplicación, actualice las siguientes variables en su archivo .env
. La clave y el secreto del consumidor y el token de acceso y el secreto se pueden encontrar en la sección Keys and tokens
de la interfaz de usuario de desarrolladores de X.
TWITTER_CONSUMER_KEY= TWITTER_CONSUMER_SECRET= TWITTER_ACCESS_TOKEN= TWITTER_ACCESS_SECRET=
Para hacer lo mismo con Bluesky, simplemente necesita configurar las claves de la aplicación con su nombre de usuario y contraseña:
BLUESKY_USERNAME= BLUESKY_PASSWORD=
Los artículos aprobados se comparten en el orden en que fueron enviados para su aprobación. Los artículos se comparten dos veces al día a las 14:00 y 18:00 UTC. Una vez que se ha compartido un artículo, no se volverá a compartir.
Laravel.io puede notificar a los mantenedores sobre artículos recién enviados a través de Telegram. Para que esto funcione, necesitarás configurar un bot de Telegram y obtener un token. Luego, configura el canal al que deseas enviar mensajes de artículos nuevos.
TELEGRAM_BOT_TOKEN= TELEGRAM_CHANNEL=
Para habilitar el recuento de vistas de artículos, deberá registrar una cuenta de Fathom Analytics e instalarla en el sitio. Luego deberá crear un token API y encontrar el ID de su sitio antes de actualizar las siguientes variables de entorno en su archivo .env
.
FATHOM_SITE_ID= FATHOM_TOKEN=
Para asegurarnos de que las imágenes del artículo y del encabezado del usuario se sincronicen con la base de datos, necesitaremos configurar una clave de acceso desde Unsplash. Tenga en cuenta que su aplicación Unsplash requiere acceso de producción.
UNSPLASH_ACCESS_KEY=
Después de eso, puede agregar una identificación con foto de Unsplash a cualquier fila de artículo en la columna hero_image_id
y ejecutar el comando de sincronización para recuperar la URL de la imagen y los datos del autor:
php artesano lio: sincronización-artículo-imágenes
Dominio | Descripción |
---|---|
vendor/bin/pest -p | Ejecute las pruebas con ejecución paralela. |
php artisan migrate:fresh --seed | Restablecer la base de datos |
npm run dev | Cree y observe cambios en archivos CSS y JS |
El portal Laravel.io está actualmente mantenido por Dries Vints y Joe Dixon. Si tiene alguna pregunta, no dude en crear un problema en este repositorio.
Lea la guía de contribución antes de crear un problema o enviar una solicitud de extracción.
Lea nuestro Código de conducta antes de contribuir o participar en discusiones.
Revise nuestra política de seguridad sobre cómo informar vulnerabilidades de seguridad.
La licencia MIT. Consulte el archivo de licencia para obtener más información.