{"id":14974699,"url":"https://github.com/chatter-laravel/core","last_synced_at":"2025-04-05T20:08:34.934Z","repository":{"id":41190313,"uuid":"222789383","full_name":"Chatter-Laravel/core","owner":"Chatter-Laravel","description":"The Laravel single page forum package (Vue + Tailwind CSS + Laravel)","archived":false,"fork":false,"pushed_at":"2022-03-29T08:43:23.000Z","size":6267,"stargazers_count":160,"open_issues_count":17,"forks_count":36,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-04-05T20:08:25.431Z","etag":null,"topics":["forum","forum-software","larave-forum","laravel","laravel-framework","tailwindcss","vue","vuejs"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Chatter-Laravel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-11-19T21:04:05.000Z","updated_at":"2024-12-29T16:55:18.000Z","dependencies_parsed_at":"2022-09-03T02:22:01.731Z","dependency_job_id":null,"html_url":"https://github.com/Chatter-Laravel/core","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chatter-Laravel%2Fcore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chatter-Laravel%2Fcore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chatter-Laravel%2Fcore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chatter-Laravel%2Fcore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Chatter-Laravel","download_url":"https://codeload.github.com/Chatter-Laravel/core/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247393570,"owners_count":20931813,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["forum","forum-software","larave-forum","laravel","laravel-framework","tailwindcss","vue","vuejs"],"created_at":"2024-09-24T13:50:57.050Z","updated_at":"2025-04-05T20:08:34.911Z","avatar_url":"https://github.com/Chatter-Laravel.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg width=\"300\" src=\"https://raw.githubusercontent.com/chatter-laravel/core/master/public/assets/images/logo.png\"\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.styleci.io/repos/7548986/shield?style=flat\" alt=\"Build status\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Maintained%3F-yes-green.svg\" alt=\"Maintained repository\"\u003e\n\u003ca href=\"https://github.com/Chatter-Laravel/core/blob/master/license\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-blue.svg\" alt=\"MIT License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# Chatter - Laravel Forum Package\n\nThis is a Vue + Tailwind CSS + Laravel forum package. Chatter is a single page application to create forums on Laravel applications with ease.\n\n**[See the youtube demo](https://youtu.be/HIaEsMWBV28)**\n\n*This package is inspired on the [thedevdojo/chatter](https://github.com/thedevdojo/chatter) package*\n\n## Installation\n\nIf you are planning to install Chatter on an already existing project, please check the ChatterPreset class and check which of the instalations steps you need to run, really dependes on what you got.\n\nChatter Branch | Chatter Version | Laravel version\n--------------- | --------------- | ---------------\n5.x|^5.8|^5.8\n6.x|^6|^6\n7.x|^7|^7\nmaster|dev-master|^8\n\n1. Install [Laravel 8](https://laravel.com/docs/8.x/installation#installing-laravel),\n    If you are installing Chatter in an existing project skip this step.\n\n2. Include the package in your project and publish the package views, configs, etc:\n\n    ```bash\n    $ composer require \"chatter-laravel/core:dev-master\"\n    $ php artisan vendor:publish --provider \"Chatter\\\\Core\\\\ChatterServiceProvider\"\n    $ composer dump-autoload\n    ```\n\n3. Run the `chatter:install` command and follow the instructions:\n\n    ```bash\n    $ php artisan chatter:install\n    ```\n\n    If you are installing Chatter in an existing project, include the *--plugin* option when you call the install command:\n    ```bash\n    $ php artisan chatter:install --plugin\n    ```\n\n    The installation command will take care of all that you need to install the forum: migrations, js components, tailwind, composer packages, node packages, etc.\n\n   \u003e The app must be connected to a running mysql instance to run the migrations, on a development environment [Laravel Sail](https://laravel.com/docs/8.x/sail#installing-sail-into-existing-applications) can be run\n\n4. Add the CanDiscuss and HasApiTokens trait to your [**User model**](https://github.com/laravel/laravel/blob/8.x/app/Models/User.php). If you have Laravel Passport already installed on your project you probably already have the HasApiTokens trait in your *User model*:\n\n    ```php\n    \u003c?php\n\n    namespace App\\Models;\n\n    use Chatter\\Core\\Traits\\CanDiscuss;\n    use Laravel\\Passport\\HasApiTokens;\n    use Illuminate\\Notifications\\Notifiable;\n    use Illuminate\\Foundation\\Auth\\User as Authenticatable;\n\n    class User extends Authenticatable\n    {\n        use HasApiTokens, Notifiable, CanDiscuss;\n    ```\n\n5. Chatter installation command already installs [Laravel Passport](https://laravel.com/docs/8.x/passport#installation) but you need to add the CreateFreshApiToken middleware to your `web` middleware group in your *app/Http/Kernel.php* file:\n\n    ```php\n    'web' =\u003e [\n        // Other middleware...\n        \\Laravel\\Passport\\Http\\Middleware\\CreateFreshApiToken::class,\n    ],\n    ```\n\n**If you are installing Chatter on a fresh Laravel instalation, go straight to step 9**\n\n6. Make sure you have [Tailwind CSS configured with Laravel Mix](https://laravel.com/docs/8.x/mix#tailwindcss)\n7. Include the Chatter JS app into your *resources/js/app.js*:\n\n    ```javascript\n    require('./chatter/app')\n    ```\n\n8. Populate the categories of your forum. You can create a new seed for your project.\n\n9. Run the Laravel server:\n\n    ```bash\n    $ php artisan serve\n    ```\n\n10. **Now, visit http://localhost:8000/forums and you should see your new forum in front of you!**\n\n## Testing\n\nThere are some factories that generates some testing information on the database. Just run the seed to execute those factories:\n\n```bash\n$ php artisan db:seed --class ChatterTableSeeder\n```\n\n## Roadmap\n\n- [x] Check compatiblity with Laravel 8\n- [x] React to posts\n- [x] Star this repository\n- [ ] Pin a discussion\n- [ ] Administration/moderation panel (block users, delete posts)\n- [ ] Report discussion\n- [ ] Edit posts and discussions (with versioning)\n- [ ] Users profiles\n- [ ] Users rewards\n- [ ] Tag other users on discussions and posts\n- [ ] Create tests\n- [ ] Use Localization (translations)\n\n\n## Known issues\n\nIf you're experiencing issues with your chatter installation, refer to [Known issues](https://github.com/Chatter-Laravel/core/labels/known-issues). If you couldn't solve the issue, please submit a new ticket.\n\n## Customization\n\n### Configuration\n\nWhen you published the vendor assets you added a new file inside of your `config` folder which is called `config/chatter.php`. This file contains a bunch of configuration you can use to configure your forums\n\n### Vue components\n\nAll the view components used by Chatter are published to your project by the preset instalation. You can make all the changes you need for your project on those.\n\n## Screenshots\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/chatter-laravel/core/master/public/assets/images/laravel-chatter-demo.gif\" alt=\"Laravel chatter forum demo\" style=\"max-width:600px;\"\u003e\u003cbr\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/chatter-laravel/core/master/public/assets/images/laravel-chatter-forum.png\" alt=\"Laravel chatter forum\" style=\"max-width:600px;\"\u003e\u003c/br\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/chatter-laravel/core/master/public/assets/images/laravel-chatter-forum-2.png\" alt=\"Laravel chatter forum\" style=\"max-width:600px;\"\u003e\u003cbr\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/chatter-laravel/core/master/public/assets/images/laravel-chatter-forum-3.png\" alt=\"Laravel chatter forum\" style=\"max-width:600px;\"\u003e\u003cbr\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/chatter-laravel/core/master/public/assets/images/laravel-chatter-forum-mobile.png\" alt=\"Laravel chatter forum\" style=\"max-width:600px;\"\u003e\n\u003c/p\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchatter-laravel%2Fcore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchatter-laravel%2Fcore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchatter-laravel%2Fcore/lists"}