PHPackages                             liddledev/liddleforum - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. liddledev/liddleforum

AbandonedArchivedLibrary[Framework](/categories/framework)

liddledev/liddleforum
=====================

A forum package built for Laravel

0.2.2(9y ago)61561PHP

Since Mar 25Pushed 9y ago2 watchersCompare

[ Source](https://github.com/LiddleDev/LiddleForum)[ Packagist](https://packagist.org/packages/liddledev/liddleforum)[ RSS](/packages/liddledev-liddleforum/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependencies (1)Versions (9)Used By (0)

Liddle Forum
============

[](#liddle-forum)

A simple forum for your Laravel application
-------------------------------------------

[](#a-simple-forum-for-your-laravel-application)

### Requirements

[](#requirements)

- Laravel 5.1.11+
- PHP 5.6+
- A Laravel project with a User model and database
- Optionally Laravel 5.3 if you wish to use notifications

### Installation

[](#installation)

1. Use composer to add LiddleForum to your project

    ```
    composer require "liddledev/liddleforum"

    ```
2. Add the LiddleForum service provider to `config/app.php` providers:

    ```
    LiddleDev\LiddleForum\LiddleForumServiceProvider::class,

    ```
3. Run the following command to publish the LiddleForum assets:

    ```
    php artisan vendor:publish

    ```
4. Open up the LiddleForum config file located at

    ```
    app/config/liddleforum.php

    ```

    and edit the User model class to be your User model. By default it is `\App\User::class` which is what comes with Laravel.
5. Since new files have been copied to your project you will need to run:

    ```
    composer dump-autoload

    ```
6. LiddleForum needs to create some tables in your database in order to function. By default all tables will use the prefix `liddleforum_` but you can change this in the config if you wish. Once you have set your prefix, run:

    ```
    php artisan migrate

    ```
7. Inside the config you will see a `blade` array. You will need to fill in which layout file the pages should extend, what content section to use, and the names of two stacks which you must place in the head of your layout and just before the body closes. For example, your layout file could look like this:

    ```

        @stack('head')

            @yield('content')

        @stack('footer')

    ```

    and your config would look like

    ```
    'blade' => [
        'layout' => 'layouts.app',
        'section' => 'content',
        'stacks' => [
            'head' => 'head',
            'footer' => 'footer',
        ]
    ],

    ```
8. In your database, add your personal user as an admin by adding yourself to the `liddleforum_admins` table.
9. Navigate to the admin panel at `domain.com/forums/admin` and add your categories. First add base categories - these cannot have threads and can only contain subcategories. Then add subcategories to these base categories to show on your home page. Alternatively, you can run the command `php artisan db:seed --class=LiddleForumExampleSeeder` to add some example categories for you.

The forum should now be viewable by going to *domain.com/forums* - however you can change the routes in the config if you wish

This is all of the necessary configuration required to get up and running. Follow the next section for further customisation and features

### Additional Features / Customisation

[](#additional-features--customisation)

#### User Avatars

[](#user-avatars)

By default, user avatars are displayed using Gravatar. You can change the avatar driver in the config under `user.avatar.driver`

LiddleForum comes with `gravatar` and `user_column` but you are welcome to create your own by extending `\LiddleDev\LiddleForum\Drivers\Avatar\AvatarInterface` and adding it to the config

##### Gravatar

[](#gravatar)

If you wish to use Gravatar, set the driver to `gravatar` and enter the email column of your user table in the gravatar options

##### User Column

[](#user-column)

Set the driver to `user_column` and set `url_column` to the column of your user table that contains the avatar URL

#### Text Editors

[](#text-editors)

TinyMCE is used by default to create and reply to threads. You can change this in the config under the `text_editor` section.

You can choose between `tinymce`, `trumbowyg` or you can add your own by extending `\LiddleDev\LiddleForum\Drivers\TextEditor\TextEditorInterface`

If you choose to use Trumbowyg, note that it requires jQuery

#### Notifications

[](#notifications)

LiddleForum comes with the option to use the Laravel notification system that was introduced in version 5.3. Notifications are disabled by default. If you are using at least 5.3 you can turn on notifications in the config by setting a notification type to enabled and extending the abstract class provided.

Note: Your user model needs to use the Notifiable trait

#### Moderators

[](#moderators)

Moderators can be added in the admin panel. Navigate to the moderators tab add moderators by entering the user ID of who you'd like to be a moderator.

You can either make them a global moderator or limit their moderation powers to a specific category and its children.

### Roadmap

[](#roadmap)

Here are a list of features currently planned for future versions:

- Themes - provide a way to easily customise the CSS on the forum

### Final Notes

[](#final-notes)

Please take a good look in `app/config/liddleforum.php` to make sure you customise the forum the way you want it. You'll find notes in there explaining more about each section.

If you have any issues using the forum please create an issue or pull request and I will look into it :)

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 94.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~10 days

Recently: every ~17 days

Total

8

Last Release

3315d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4fe18391da155bbee17f32712ddbadd1944cb7590ac3894979400785d3eb235f?d=identicon)[LiddleDev](/maintainers/LiddleDev)

---

Top Contributors

[![LiddleDev](https://avatars.githubusercontent.com/u/5737931?v=4)](https://github.com/LiddleDev "LiddleDev (68 commits)")[![inetsquared-tome](https://avatars.githubusercontent.com/u/4477799?v=4)](https://github.com/inetsquared-tome "inetsquared-tome (2 commits)")[![jgill88](https://avatars.githubusercontent.com/u/10379307?v=4)](https://github.com/jgill88 "jgill88 (1 commits)")[![tomgrohl](https://avatars.githubusercontent.com/u/418838?v=4)](https://github.com/tomgrohl "tomgrohl (1 commits)")

### Embed Badge

![Health badge](/badges/liddledev-liddleforum/health.svg)

```
[![Health](https://phpackages.com/badges/liddledev-liddleforum/health.svg)](https://phpackages.com/packages/liddledev-liddleforum)
```

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[magento/community-edition

Magento 2 (Open Source)

12.2k53.6k13](/packages/magento-community-edition)[yiisoft/yii2-dev

Yii PHP Framework Version 2 - Development Package

14.3k104.0k34](/packages/yiisoft-yii2-dev)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.1k16.8k](/packages/prestashop-prestashop)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M560](/packages/shopware-core)[yiisoft/yii2

Yii PHP Framework Version 2

36830.8M9.6k](/packages/yiisoft-yii2)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
