yosimitso/workingforumbundle

A complete forum bundle

v5.0 2024-07-15 10:09 UTC

Requires

• php: >=8.2.0
• ext-mbstring: *
• doctrine/annotations: ^1.12
• doctrine/common: ^3.0
• doctrine/doctrine-bundle: >=2.6
• doctrine/orm: ^2.8
• egulias/email-validator: ^3.1
• knplabs/knp-markdown-bundle: ^1.9.0
• knplabs/knp-paginator-bundle: ^5.0
• knplabs/knp-time-bundle: ^1.20
• sensio/framework-extra-bundle: ^6.2
• symfony/asset: >=5.0|>=6.2
• symfony/dependency-injection: >=5.0|>=6.2
• symfony/expression-language: ^6.3
• symfony/form: >=5.0|>=6.2
• symfony/framework-bundle: >=5.0|>=6.2
• symfony/mailer: >=5.4|>=6.2
• symfony/messenger: >=5.2
• symfony/mime: >=5.0|>=6.2
• symfony/security-bundle: >=5.0|>=6.2
• symfony/security-core: >=5.4|>=6.2
• symfony/templating: >=5.0|>=6.2
• symfony/translation: >=5.0|>=6.2
• symfony/twig-bridge: >= 5.4|>=6.2
• symfony/validator: >=5.0|>=6.2
• twig/extra-bundle: >= 3.3
• twig/twig: ^2.0|^3.0

Requires (Dev)

• hautelook/alice-bundle: ^2.13
• phpstan/phpstan-doctrine: ^1.3.2
• phpstan/phpstan-symfony: ^1.3.2
• phpunit/phpunit: ^9.6
• symfony/browser-kit: >=5.0|>=6.2
• symfony/css-selector: >=5.0|>=6.2
• symfony/panther: ^2.1
• yosimitso/mockdoctrinemanager: dev-master

MIT

• Yosimitso

README

ENGLISH

A forum bundle for Symfony 5/6, easy to use with a lot of features
This bundle work with your user bundle with no extra configuration (which can extend FOSUserBundle)
The bundle was made to be customizable and overridable to fit your application

Demo

Try it here - https://demoworkingforum.charlymartins.fr

Features

• Support multi language (currently provided : english, french)
• Responsive design (mobile, tablet, desktop)
• Post editor using markdown with smiley, quote and instant preview
• Threads status : resolved, closed, pinned, moved from a moderator
• Enclosed files with post (files upload system)
• Vote system for posts
• Moderator role as ROLE_MODERATOR (and default admin roles)
• Reporting system for thread
• Auto-lock system for old thread
• Automatic breadcrumb, messages counters, pagination
• Allow or not the anonymous to read forums
• Database safety : no HTML stored, only markdown
• Search system
• Backend administration
• Antiflood system
• Email notification on new posts
• Post saved as draft

Setup

See SETUP.md

Configuration

Refer to CONFIGURATION.md

Contribute

About a fix : Make a PR !

About a feature : please open an issue, to talk about it and share the work

Tests

Before opening a pull request, run tests :

Go to the bundle's directory and execute

composer install

Unit tests

vendor/phpunit/phpunit/phpunit --testsuite=unit

Functionnal tests

• create an empty database (all data will be erased when you run tests)
• set its credentials into phpunit.xml
• import the database structure (Tests/Scenario/empty_db.sql)
• run

vendor/phpunit/phpunit/phpunit --testsuite=scenario