Skip to content

Commit 6573efa

Browse files
authored
Update README.md
1 parent 045b2e7 commit 6573efa

1 file changed

Lines changed: 46 additions & 36 deletions

File tree

README.md

Lines changed: 46 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,55 +1,65 @@
11
# Forumium
2-
<img src="./public/favicon.svg" width="50" />
32

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>
523

24+
# Introduction
625

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/).
827

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
1529

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
1832

19-
## Database configuration
33+
## Screenshots
2034

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>
2241

23-
### Manually
42+
## Documentation
2443

25-
By executing the commands:
44+
Full documentation can be viewed online: [Docs](https://devaslanphp.github.io/forumium-docs)
2645

27-
`php artisan migrate`
46+
## Work in progress
2847

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.
3549

36-
### Automatically
50+
## Credits
3751

38-
By executing the command: `composer run app-install`
52+
- [All Contributors](https://github.com/devaslanphp/forumium/graphs/contributors)
3953

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
4155

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.
4357

44-
## Serve the application
58+
## Releases
4559

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
5462

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

Comments
 (0)