Complete documentation is available on teamteatime.net.
| Laravel version | Package version | PHP version |
|---|---|---|
| 11 | ^6.0 | ^8.2 |
| 10 | ^5.5 | ^8.1 |
Please note that older package versions not listed above are no longer maintained or supported.
See the support policy in the Laravel docs for more information about Laravel release versions, their supported PHP versions, and how long they receive bug & security fixes.
Install the package via composer:
composer require riari/laravel-forum:^6.0
Package Discovery should take care of registering the service provider automatically, but if you need to do so manually, add the service provider to your bootstrap/providers.php:
TeamTeaTime\Forum\ForumServiceProvider::class,Run the vendor:publish command to publish the package config, translations and migrations to your app's directories:
php artisan vendor:publish
Run your migrations:
php artisan migrate
A forum:preset-install {name} command is available for installing UI presets. Run forum:preset-list to see a list of available presets. You must install one of these to publish the corresponding views to your application. For example:
php artisan forum:preset-install livewire-tailwind
Note
By default, the livewire-tailwind preset is set as the active one in the forum.frontend.preset config value. This preset requires Livewire and a few other dependencies. Refer to UI Presets for details.
Several configuration files are published to config/forum. Refer to these for a variety of options for changing the behaviour of the forum and how it integrates with key parts of your application code.
Note
You may need to modify the forum.integration.user_name config option according to your user model. This specifies which attribute on the user model should be used as a display name in the forum views.
Laravel Forum currently supports 15 languages: German, English, Spanish, French, Italian, Dutch, Romanian, Russian, Thai, Turkish, Serbian, Portuguese (Brazil), Swedish, Chinese, and Indonesian. The translation files are published to resources/lang/vendor/forum/{locale}.
Note
Some new language strings have been introduced in version 6 but not yet translated; PRs to translate these would be greatly appreciated.
If you wish to contribute, an easy way to set up the package for local development is Team-Tea-Time/laravel-studio, which is set up to load a local working copy of this repository (see the readme for usage details).
Bring up the MySQL service:
docker-compose up -d mysqlInstall Composer dependencies:
docker-compose run --rm composer installRun the phpunit container to execute tests:
docker-compose run --rm phpunitThe package tables can be seeded with sample categories, threads, posts, and a user via forum:seed:
docker-compose exec php-fpm php artisan forum:seed