laravel.io

Laravel.io

Este é o repositório do portal da comunidade Laravel.io. O código é totalmente de código aberto e licenciado sob a licença MIT. Agradecemos suas contribuições, mas encorajamos você a ler o guia de contribuição antes de criar um problema ou enviar uma solicitação pull. Leia o guia de instalação abaixo para começar a configurar o aplicativo em sua máquina.

Patrocinadores

Gostaríamos de agradecer a essas empresas incríveis por nos patrocinar. Se você estiver interessado em se tornar um patrocinador, visite a página Laravel.io GitHub Sponsors.

• Evento

• Forja

• Enviado

• Compreender

• Tinkerwell

• BairesDev

• N-iX

Requisitos

As seguintes ferramentas são necessárias para iniciar a instalação.

• PHP 8.3

• Compositor

• NPM

• Manobrista

Instalação

Observe que você pode ajustar o local ~/Sites/laravel.io para qualquer diretório que desejar em sua máquina. Ao fazer isso, certifique-se de executar o comando valet link dentro do diretório desejado.

1. Clone este repositório com git clone [email protected]:laravelio/laravel.io.git ~/Sites/laravel.io

2. Execute composer install para instalar as dependências do PHP

3. Configure um banco de dados local chamado laravel

4. Execute composer setup para configurar o aplicativo

5. Configure um driver de e-mail funcional como o Mailtrap

6. Execute valet link para vincular o site a um endereço da web de teste

7. Crie um banco de dados testing no MySQL para poder executar o conjunto de testes

8. Configure os recursos (opcionais) abaixo

Agora você pode visitar o aplicativo em seu navegador visitando http://laravel.io.test. Se você semeou o banco de dados, poderá fazer login em uma conta de teste com testing & password .

Autenticação GitHub (opcional)

Para que a autenticação do GitHub funcione localmente, você precisará registrar um novo aplicativo OAuth no GitHub. Use http://laravel.io.test para o URL da página inicial e http://laravel.io.test/auth/github para o URL de retorno de chamada. Depois de criar o aplicativo, preencha o ID e o segredo em seu arquivo .env nas variáveis ​​env abaixo. Agora você deve conseguir fazer a autenticação com GitHub.

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

Pesquisa Algolia (opcional)

Para que a pesquisa do Algolia seja executada localmente, você precisará se registrar em uma nova conta e criar um índice chamado threads . Algolia possui um nível gratuito que satisfaz todos os requisitos necessários para um ambiente de desenvolvimento. Agora atualize as variáveis ​​abaixo em seu arquivo .env . O App ID e as chaves secretas podem ser encontrados na seção API Keys da Algoila UI.

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 seus threads existentes, execute o seguinte comando:

 php artesão scout:importar AppModelsThread

Novos threads serão adicionados automaticamente ao índice e os threads atualizados serão sincronizados automaticamente. Se precisar liberar seu índice e começar novamente, você pode executar o seguinte comando:

 php artesão scout:flush AppModelsThread

Compartilhamento de mídia social (opcional)

Para permitir que artigos publicados sejam compartilhados automaticamente no X, você precisará criar um aplicativo. Depois que o aplicativo for criado, atualize as variáveis ​​abaixo em seu arquivo .env . A chave e o segredo do consumidor e o token e o segredo de acesso podem ser encontrados na seção Keys and tokens da IU dos desenvolvedores X.

TWITTER_CONSUMER_KEY=
TWITTER_CONSUMER_SECRET=
TWITTER_ACCESS_TOKEN=
TWITTER_ACCESS_SECRET=

Para fazer o mesmo com o Bluesky basta configurar as chaves do aplicativo com seu login e senha:

BLUESKY_USERNAME=
BLUESKY_PASSWORD=

Os artigos aprovados são compartilhados na ordem em que foram submetidos para aprovação. Os artigos são compartilhados duas vezes por dia às 14h e às 18h UTC. Depois que um artigo for compartilhado, ele não será compartilhado novamente.

Notificações de telegrama (opcional)

Laravel.io pode notificar os mantenedores sobre artigos recém-enviados através do Telegram. Para que isso funcione, você precisará configurar um bot do Telegram e obter um token. Em seguida, configure o canal para o qual deseja enviar novas mensagens de artigos.

TELEGRAM_BOT_TOKEN=
TELEGRAM_CHANNEL=

Fathom Analytics (opcional)

Para ativar a contagem de visualizações de artigos, você precisará registrar uma conta do Fathom Analytics e instalá-la no site. Em seguida, você precisará criar um token de API e encontrar o ID do seu site antes de atualizar as variáveis ​​de ambiente abaixo em seu arquivo .env .

FATHOM_SITE_ID=
FATHOM_TOKEN=

Unsplash (opcional)

Para garantir que as imagens do artigo e do cabeçalho do usuário sejam sincronizadas no banco de dados, precisaremos configurar uma chave de acesso do Unsplash. Observe que seu aplicativo Unsplash requer acesso de produção.

UNSPLASH_ACCESS_KEY=

Depois disso, você pode adicionar um ID de foto do Unsplash a qualquer linha do artigo na coluna hero_image_id e executar o comando de sincronização para buscar o URL da imagem e os dados do autor:

 php artesão lio:sync-article-images

Comandos

Comando	Descrição
vendor/bin/pest -p	Execute os testes com execução paralela
php artisan migrate:fresh --seed	Redefinir o banco de dados
npm run dev	Crie e observe alterações em arquivos CSS e JS

Mantenedores

O portal Laravel.io é atualmente mantido por Dries Vints e Joe Dixon. Se você tiver alguma dúvida, não hesite em criar um problema neste repositório.

Contribuindo

Leia o guia de contribuição antes de criar um problema ou enviar uma solicitação pull.

Código de Conduta

Leia nosso Código de Conduta antes de contribuir ou participar de discussões.

Vulnerabilidades de segurança

Revise nossa política de segurança sobre como relatar vulnerabilidades de segurança.

Licença

A licença do MIT. Consulte o arquivo de licença para obter mais informações.