Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/laravelio/portal
The Laravel.io Community Portal.
https://github.com/laravelio/portal
community forums laravel php
Last synced: 2 days ago
JSON representation
The Laravel.io Community Portal.
- Host: GitHub
- URL: https://github.com/laravelio/portal
- Owner: laravelio
- License: mit
- Created: 2013-09-17T12:57:48.000Z (over 11 years ago)
- Default Branch: main
- Last Pushed: 2024-10-23T07:31:11.000Z (3 months ago)
- Last Synced: 2024-10-29T11:57:26.554Z (3 months ago)
- Topics: community, forums, laravel, php
- Language: PHP
- Homepage: https://laravel.io
- Size: 27.2 MB
- Stars: 2,441
- Watchers: 114
- Forks: 651
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
- awesome-laravel - Laravel.io - Fuente del portal de la comunidad Laravel.io (Bases de código para referencia)
README
# Laravel.io
This is the repository for the [Laravel.io](http://laravel.io) community portal. The code is entirely open source and licensed under [the MIT license](LICENSE.md). We welcome your contributions but we encourage you to read [the contributing guide](CONTRIBUTING.md) before creating an issue or sending in a pull request. Read the installation guide below to get started with setting up the app on your machine.
## Sponsors
We'd like to thank these **amazing companies** for sponsoring us. If you are interested in becoming a sponsor, please visit the Laravel.io GitHub Sponsors page.
- **[Eventy](https://https://eventy.io/?utm_source=Laravel.io&utm_campaign=eventy&utm_medium=advertisement)**
- [Forge](https://forge.laravel.com)
- [Envoyer](https://envoyer.io)
- [Fathom](https://usefathom.com)
- [Tinkerwell](https://tinkerwell.app)
- [BairesDev](https://www.bairesdev.com/sponsoring-open-source-projects/)
- [N-iX](https://www.n-ix.com/)
- [Litslink](https://litslink.com/)
## Requirements
The following tools are required in order to start the installation.
- PHP 8.3
- [Composer](https://getcomposer.org/download/)
- [NPM](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
- [Valet](https://laravel.com/docs/valet#installation)
## Installation
> Note that you're free to adjust the `~/Sites/laravel.io` location to any directory you want on your machine. In doing so, be sure to run the `valet link` command inside the desired directory.
1. Clone this repository with `git clone [email protected]:laravelio/laravel.io.git ~/Sites/laravel.io`
2. Run `composer install` to install the PHP dependencies
3. Set up a local database called `laravel`
4. Run `composer setup` to setup the application
5. Set up a working e-mail driver like [Mailtrap](https://mailtrap.io/)
6. Run `valet link` to link the site to a testing web address
7. Create a `testing` database in MySQL so you can run the test suite
8. Configure the (optional) features from below
You can now visit the app in your browser by visiting [http://laravel.io.test](http://laravel.io.test). If you seeded the database you can login into a test account with **`testing`** & **`password`**.
### GitHub Authentication (optional)
To get GitHub authentication to work locally, you'll need to [register a new OAuth application on GitHub](https://github.com/settings/applications/new). Use `http://laravel.io.test` for the homepage url and `http://laravel.io.test/auth/github` for the callback url. When you've created the app, fill in the ID and secret in your `.env` file in the env variables below. You should now be able to authentication with GitHub.
```
GITHUB_ID=
GITHUB_SECRET=
GITHUB_URL=http://laravel.io.test/auth/github
```
### Algolia Search (optional)
To get Algolia search running locally, you'll need to [register for a new account](https://www.algolia.com/users/sign_up) and create an index called `threads`. Algolia has a free tier that satisfies all of the requirements needed for a development environment. Now update the below variables in your `.env` file. The App ID and secret keys can be found in the `API Keys` section of the 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
```
In order to index your existing threads, run the following command:
```bash
php artisan scout:import App\\Models\\Thread
```
New threads will be automatically added to the index and threads which get updated will be automatically synced. If you need to flush your index and start again, you can run the following command:
```bash
php artisan scout:flush App\\Models\\Thread
```
### Social Media Sharing (optional)
To enable published articles to be automatically shared on X, you'll need to [create an app](https://developer.x.com/apps/). Once the app has been created, update the below variables in your `.env` file. The consumer key and secret and access token and secret can be found in the `Keys and tokens` section of the X developers UI.
```
TWITTER_CONSUMER_KEY=
TWITTER_CONSUMER_SECRET=
TWITTER_ACCESS_TOKEN=
TWITTER_ACCESS_SECRET=
```
To do the same for Bluesky you simply need to set up the app keys with your login and password:
```
BLUESKY_USERNAME=
BLUESKY_PASSWORD=
```
Approved articles are shared in the order they were submitted for approval. Articles are shared twice per day at 14:00 and 18:00 UTC. Once an article has been shared, it will not be shared again.
### Telegram Notifications (optional)
Laravel.io can notify maintainers of newly submitted articles through Telegram. For this to work, you'll need to [set up a Telegram bot](https://core.telegram.org/bots) and obtain a token. Then, configure the channel you want to send new article messages to.
```
TELEGRAM_BOT_TOKEN=
TELEGRAM_CHANNEL=
```
### Fathom Analytics (optional)
To enable view counts on articles, you'll need to register a [Fathom Analytics](https://app.usefathom.com/register) account and [install](https://usefathom.com/docs/start/install) it on the site. You will then need to create an API token and find your site ID before updating the below environment variables in your `.env` file.
```
FATHOM_SITE_ID=
FATHOM_TOKEN=
```
### Unsplash (optional)
To make sure article and user header images get synced into the database we'll need to setup an access key from [Unsplash](https://unsplash.com/developers). Please note that your Unsplash app requires production access.
```
UNSPLASH_ACCESS_KEY=
```
After that you can add an Unsplash photo ID to any article row in the `hero_image_id` column and run the sync command to fetch the image url and author data:
```bash
php artisan lio:sync-article-images
```
## Commands
Command | Description
--- | ---
**`vendor/bin/pest -p`** | Run the tests with parallel execution
`php artisan migrate:fresh --seed` | Reset the database
`npm run dev` | Build and watch for changes in CSS and JS files
## Maintainers
The Laravel.io portal is currently maintained by [Dries Vints](https://github.com/driesvints) and [Joe Dixon](https://github.com/joedixon). If you have any questions please don't hesitate to create an issue on this repo.
## Contributing
Please read [the contributing guide](CONTRIBUTING.md) before creating an issue or sending in a pull request.
## Code of Conduct
Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before contributing or engaging in discussions.
## Security Vulnerabilities
Please review [our security policy](.github/SECURITY.md) on how to report security vulnerabilities.
## License
The MIT License. Please see [the license file](LICENSE.md) for more information.