|
1 | 1 | # Forumium |
2 | | -<img src="./public/favicon.svg" width="50" /> |
3 | 2 |
|
4 | | -**Fast**, **Clean**, **Easy to use** and **Open Source** Forum to boost collaboration |
| 3 | +<p align="center"> |
| 4 | + <a href="https://laravel.com"><img alt="Laravel v9.x" src="https://img.shields.io/badge/Laravel-v9.x-FF2D20?style=for-the-badge&logo=laravel"></a> |
| 5 | + <a href="https://laravel-livewire.com"><img alt="Livewire v2.x" src="https://img.shields.io/badge/Livewire-v2.x-FB70A9?style=for-the-badge"></a> |
| 6 | + <a href="https://filamentphp.com/"><img alt="Filament v2.x" src="https://img.shields.io/badge/Filament-v2.x-e9b228?style=for-the-badge"></a> |
| 7 | + <a href="https://php.net"><img alt="PHP 8.0" src="https://img.shields.io/badge/PHP-8.0-777BB4?style=for-the-badge&logo=php"></a> |
| 8 | + <br/> |
| 9 | + <a href="https://github.com/devaslanphp/forumium/releases/"> |
| 10 | + <img src="https://img.shields.io/github/tag/devaslanphp/forumium?include_prereleases=&sort=semver&color=blue&style=for-the-badge" alt="GitHub tag"> |
| 11 | + </a> |
| 12 | + <a href="#license"> |
| 13 | + <img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License"> |
| 14 | + </a> |
| 15 | + <a href="https://github.com/devaslanphp/forumium/issues"> |
| 16 | + <img src="https://img.shields.io/github/issues/devaslanphp/forumium?style=for-the-badge" alt="issues - forumium"> |
| 17 | + </a> |
| 18 | + <br/> |
| 19 | + <a href="https://devaslanphp.github.io/forumium-docs-docs" title="Go to project documentation"> |
| 20 | + <img src="https://img.shields.io/badge/view-Documentation-blue?style=for-the-badge" alt="view - Documentation"> |
| 21 | + </a> |
| 22 | +</p> |
5 | 23 |
|
| 24 | +# Introduction |
6 | 25 |
|
7 | | -## Installation |
| 26 | +Forumium is a simple Forum platform made with the [**Laravel Framework**](https://laravel.com) and the elegant TALLkit [**Filament**](https://filamentphp.com/). |
8 | 27 |
|
9 | | -- Clone the repository |
10 | | -- Install backend dependencies: `composer install` |
11 | | -- Install frontend dependencies: `npm install` (or `yarn`) |
12 | | -- Generate assets: `npm run build` (or `yarn build`) |
13 | | -- Create a new file `.env` based on `.env.example`: `cp .env.example .env` (or any other compatible command) |
14 | | -- Update `.env` file by adding your database information and your SMTP server information |
| 28 | +## Prerequisites |
15 | 29 |
|
16 | | -> **IMPORTANT:** The queue is activated by default in this configuration (based on .env.example file), and it's recommanded to have it enabled at least for the configuration step |
17 | | -- Generate an application key: `php artisan key:generate` |
| 30 | +- Good knowledge of [Laravel](https://laravel.com/) Framework |
| 31 | +- Good knowledge of [Filament](https://filamentphp.com/) TALLkit |
18 | 32 |
|
19 | | -## Database configuration |
| 33 | +## Screenshots |
20 | 34 |
|
21 | | -There is 2 ways to configure your database : |
| 35 | +<div> |
| 36 | + <img src="github-contents/1.jpg" width="45%"></img> |
| 37 | + <img src="github-contents/2.jpg" width="45%"></img> |
| 38 | + <img src="github-contents/3.jpg" width="45%"></img> |
| 39 | + <img src="github-contents/4.png" width="45%"></img> |
| 40 | +</div> |
22 | 41 |
|
23 | | -### Manually |
| 42 | +## Documentation |
24 | 43 |
|
25 | | -By executing the commands: |
| 44 | +Full documentation can be viewed online: [Docs](https://devaslanphp.github.io/forumium-docs) |
26 | 45 |
|
27 | | -`php artisan migrate` |
| 46 | +## Work in progress |
28 | 47 |
|
29 | | -`php artisan db:seed` |
30 | | - |
31 | | -> Here the database configuration is done, you got the database structure and the minimal data inserted by the seeder to make the application work, if you want demo data to be inserted, you need to run the following commands: |
32 | | -> Before you execute demo data seeder, you need to run queue listener: `php artisan queue:work`, because there is some data that will be inserted via jobs |
33 | | -> - `php artisan db:seed --class=ContentSeeder` |
34 | | -> - `php artisan db:seed --class=NotificationSeeder` |
| 48 | +We are always working to make Forumium platform a better application, all contributions are welcome. |
35 | 49 |
|
36 | | -### Automatically |
| 50 | +## Credits |
37 | 51 |
|
38 | | -By executing the command: `composer run app-install` |
| 52 | +- [All Contributors](https://github.com/devaslanphp/forumium/graphs/contributors) |
39 | 53 |
|
40 | | -> Before you execute the composer command, you need to run queue listener: `php artisan queue:work`, because there is some data that will be inserted via jobs |
| 54 | +## License |
41 | 55 |
|
42 | | -> Please note that this command will insert also demo data into your database (if you don't need demo data, please use the manual configuration above) |
| 56 | +The MIT License (MIT). Please see [License File](LICENSE.md) for more information. |
43 | 57 |
|
44 | | -## Serve the application |
| 58 | +## Releases |
45 | 59 |
|
46 | | -- After you have configured the database you can serve the application: `php artisan serve` |
47 | | -- The database seeder already executed will create at least two users: |
48 | | - - **Administrator** |
49 | | - - Email address: *admin@forumium.app* |
50 | | - - Password : *password* |
51 | | - - **Moderator** |
52 | | - - Email address: *mod@forumium.app* |
53 | | - - Password: *password* |
| 60 | +- **Release 1.0.0** (January 5th, 2023) |
| 61 | + - The first stable release of Forumium |
54 | 62 |
|
55 | | -> **IMPORTANT:** if you have executed the demo data seeders, you will have 30 other users (with the **Member** role) inserted also, you can check the database (table: `users`) to get their email addresses, and all their passwords will be *password* (the same as Administrator and Moderator) |
| 63 | +## Support us |
| 64 | + |
| 65 | +<a href="https://www.buymeacoffee.com/heloufir" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a> |
0 commit comments