PHPackages                             dimassrio/vanilla - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. dimassrio/vanilla

ActiveLaravel-library[Utility &amp; Helpers](/categories/utility)

dimassrio/vanilla
=================

Vanilla is a powerfully simple discussion forum you can easily customize to make as unique as your community.

06PHP

Since Sep 16Pushed 10y agoCompare

[ Source](https://github.com/dimassrio/vanilla)[ Packagist](https://packagist.org/packages/dimassrio/vanilla)[ RSS](/packages/dimassrio-vanilla/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (28)Used By (0)

*Cloning to your production site? Checkout the 2.1 branch! It's our vetted stable release.*

[![Vanilla](https://camo.githubusercontent.com/ff8ed0df3da909df1df8aa2576810703550a9abe49355ed0a2203ce57e3dc71e/687474703a2f2f63646e2e76616e696c6c61666f72756d732e636f6d2f76616e696c6c612d626c61636b2d6c6f676f2d3430302e737667)](https://camo.githubusercontent.com/ff8ed0df3da909df1df8aa2576810703550a9abe49355ed0a2203ce57e3dc71e/687474703a2f2f63646e2e76616e696c6c61666f72756d732e636f6d2f76616e696c6c612d626c61636b2d6c6f676f2d3430302e737667)

Howdy, Stranger!
----------------

[](#howdy-stranger)

Vanilla was born out of the desire to create flexible, customizable, and downright entertaining community solutions. Vanilla has been used to power tens of thousands of community forums around the world and we couldn't be happier if you've decided to use Vanilla to grow yours.

Every community is unique. Vanilla is a finely-crafted platform on which designers and developers can build a custom-tailored environment that meets your community's particular needs.

5 reasons Vanilla is the sweetest forum
---------------------------------------

[](#5-reasons-vanilla-is-the-sweetest-forum)

1. We've reimagined traditional forums for mass-appeal.
2. Our theming flexibility is second-to-none.
3. Impossibly good integration options with single sign-ons and embedding.
4. The best tools available for community management.
5. Curated features with great plugin options, not the kitchen sink.

Open Source
-----------

[](#open-source)

Vanilla is free, open source software distributed under the GNU GPL2. We accept and encourage contributions from our community and sometimes give hugs in return. You can join us on the [Vanilla Community Forums](http://vanillaforums.org/discussions) to be part of that discussion.

The latest stable release is always [listed here](http://vanillaforums.org/addon/vanilla-core). Currently, it is the 2.1 branch.

New plugins and themes can be listed in the [Official Addon Directory](http://vanillaforums.org/addon/). We encourage addon developers to release their code under the GPL as well, but do not require it.

Cloud Solution
--------------

[](#cloud-solution)

Vanilla Forums provides an official cloud hosting solution at [vanillaforums.com](http://vanillaforums.com)with a 1-click install, automatic upgrades, amazing professional support, incredible scalability, integration assistance, theming and migration services, and exclusive features. For the very best Vanilla forum experience, you can skip the rest of this technical stuff and [go there directly](http://vanillaforums.com/plans).

If you professionally run a large community or enterprise forum, our cloud solution will make the best technical and economic sense by far.

Self-Hosting Requirements
-------------------------

[](#self-hosting-requirements)

- PHP version 5.3 or newer with `--enable-mbstring`.
- pdo\_mysql module must be enabled.
- MySQL 5 or newer.

Vanilla 2.2 requires PHP 5.3. Running `master` branch requires PHP 5.4, as will future official releases.

Vanilla is compatible up to PHP 5.6 (the current release) and we always recommend using the lastest stable PHP release whenever possible.

Vanilla ships with a `.htaccess` file required for Apache support. Nginx and IIS require additional configuration.

On the client side, Vanilla should run &amp; look good in just about any modern browser. Using IE? How exotic. You'll want IE8 or greater. IE7 *might* work if you squint hard and click gently, but we make no promises.

We've been natively mobile since before it was cool. Vanilla ships with a mobile-optimized theme enabled by default for all smartphones &amp; tablets. Heck, it even works on the PlayStation Vita.

Installation
------------

[](#installation)

Vanilla is built to be simple, and its installation is no exception.

- Upload this entire file structure up to your web server.
- Confirm the cache, conf, and uploads folders are writable by PHP.
- Navigate to that folder in your web browser.
- Follow the instructions on screen.

Upgrading
---------

[](#upgrading)

Follow these steps to upgrade Vanilla when a new stable release is announced.

- Backup your database, `.htaccess` and `conf/config.php` file somewhere safe.
- Upload the new release's files so they overwrite the old ones.
- Go to `yourforum.com/utility/update` to force any updates needed.
- If it fails, try it a second times by refreshing the page.

To upgrade from **2.0.18 or earlier**, add these steps:

- Delete the file [`/themes/mobile/views/discussions/helper_functions.php`](https://github.com/vanillaforums/Garden/blob/2.0/themes/mobile/views/discussions/helper_functions.php)
- Delete the file [`/applications/dashboard/views/default.master.php`](https://github.com/vanilla/vanilla/blob/2.0/applications/dashboard/views/default.master.php)

To upgrade from Vanilla **1.0**, you must export your data using the Vanilla Porter as if it were a migration. Your theme and any customizations will need to be recreated. Backup your Vanilla 1 data and files completely, then delete them from your server before attempting to install Vanilla 2.

Migrating to Vanilla
--------------------

[](#migrating-to-vanilla)

- Get [Vanilla Porter](http://vanillaforums.org/addon/porter-core) and verify it supports your platform.
- Read the Advanced Uses notes on that page.
- Upload it to your current server.
- Navigate to the file in your web browser &amp; run it.
- Take the file it produces and import it to Vanilla.

Getting Help
------------

[](#getting-help)

- [Troubleshooting upgrades &amp; installs](http://docs.vanillaforums.com/developers/troubleshooting/)
- [Official documentation](http://docs.vanillaforums.com)
- [Vanilla community forums](http://vanillaforums.org/discussions)
- [Official cloud hosting with professional support &amp; migration services](http://vanillaforums.com/plans)

Contributing
------------

[](#contributing)

- Troubleshoot issues you run into on the community forum so everyone can help &amp; reference it later.
- Got an idea or suggestion? Use the [forum](http://vanillaforums.org/discussions) to discuss it.
- File detailed [issues](https://github.com/vanilla/vanilla/issues) on GitHub (version number, what you did, and actual vs expected outcomes).
- Sign the [Contributors' Agreement](http://vanillaforums.org/contributors) to send us code.
- Use pull requests against the correct release (currently `stage` for most changes).
- Keep our to-do list fresh by reviewing our open issues for resolved or duplicated items.

Version Control Strategy
------------------------

[](#version-control-strategy)

We've adopted the [git flow branching model](http://nvie.com/posts/a-successful-git-branching-model) in our projects. The creators of git flow released a [short intro video](http://vimeo.com/16018419) to explain the model.

The `master` branch is production-ready for our cloud product but is not yet vetted for open source release (alternate platforms &amp; configurations). Reviewed, stable changes land against `master` via pull-request.

Our open source release branches are named by version number, e.g. `release/2.2`. We begin release branches with a beta (b1) designation and progress them thru release candidate to stable. All open source releases (included pre-releases) are tagged.

Reporting Security Issues
-------------------------

[](#reporting-security-issues)

Please disclose security issues responsibly by emailing  with a full description. We'll work on releasing an updated version as quickly as possible. Please do not email non-security issues; use the [issue tracker](https://github.com/vanilla/vanilla/issues) instead.

Legal Stuff
-----------

[](#legal-stuff)

Copyright © 2008-2015 Vanilla Forums Inc.

Vanilla Forums is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. Vanilla Forums is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Vanilla Forums. If not, see . Contact Vanilla Forums Inc. at support \[at\] vanillaforums \[dot\] com

Bonk!
-----

[](#bonk)

Just kidding, everything's awesome. [![dance](https://camo.githubusercontent.com/18c2fe53312b4bd21d279b717aa76e3f1d7d8a88f66bb1a580b4bf954d549d0c/687474703a2f2f63646e2e76616e696c6c61666f72756d732e636f6d2f64616e63652e676966)](https://camo.githubusercontent.com/18c2fe53312b4bd21d279b717aa76e3f1d7d8a88f66bb1a580b4bf954d549d0c/687474703a2f2f63646e2e76616e696c6c61666f72756d732e636f6d2f64616e63652e676966)

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/c258a303a68f46e6fcd794c47e6526cf49655b70a6dcbb76a076a4fb6298f2a5?d=identicon)[dimassrio](/maintainers/dimassrio)

---

Top Contributors

[![tburry](https://avatars.githubusercontent.com/u/97432?v=4)](https://github.com/tburry "tburry (5467 commits)")[![kaecyra](https://avatars.githubusercontent.com/u/248212?v=4)](https://github.com/kaecyra "kaecyra (1932 commits)")[![linc](https://avatars.githubusercontent.com/u/117672?v=4)](https://github.com/linc "linc (1670 commits)")[![markosullivan](https://avatars.githubusercontent.com/u/739922?v=4)](https://github.com/markosullivan "markosullivan (1494 commits)")[![danemacmillan](https://avatars.githubusercontent.com/u/4390491?v=4)](https://github.com/danemacmillan "danemacmillan (146 commits)")[![beckyvb](https://avatars.githubusercontent.com/u/3805381?v=4)](https://github.com/beckyvb "beckyvb (106 commits)")[![kasperisager](https://avatars.githubusercontent.com/u/1174718?v=4)](https://github.com/kasperisager "kasperisager (82 commits)")[![JohnIncog](https://avatars.githubusercontent.com/u/6825291?v=4)](https://github.com/JohnIncog "JohnIncog (61 commits)")[![R-J](https://avatars.githubusercontent.com/u/3996187?v=4)](https://github.com/R-J "R-J (54 commits)")[![bleistivt](https://avatars.githubusercontent.com/u/5205806?v=4)](https://github.com/bleistivt "bleistivt (43 commits)")[![adrianspeyer](https://avatars.githubusercontent.com/u/425366?v=4)](https://github.com/adrianspeyer "adrianspeyer (28 commits)")[![TiGR](https://avatars.githubusercontent.com/u/281226?v=4)](https://github.com/TiGR "TiGR (25 commits)")[![JasonBarnabe](https://avatars.githubusercontent.com/u/583995?v=4)](https://github.com/JasonBarnabe "JasonBarnabe (19 commits)")[![sirlancelot](https://avatars.githubusercontent.com/u/71916?v=4)](https://github.com/sirlancelot "sirlancelot (16 commits)")[![imnotjames](https://avatars.githubusercontent.com/u/1551593?v=4)](https://github.com/imnotjames "imnotjames (15 commits)")[![initvector](https://avatars.githubusercontent.com/u/1390241?v=4)](https://github.com/initvector "initvector (15 commits)")[![hgtonight](https://avatars.githubusercontent.com/u/1475940?v=4)](https://github.com/hgtonight "hgtonight (14 commits)")[![ddumont](https://avatars.githubusercontent.com/u/482734?v=4)](https://github.com/ddumont "ddumont (10 commits)")[![fredwu](https://avatars.githubusercontent.com/u/31945?v=4)](https://github.com/fredwu "fredwu (9 commits)")[![jverkoey](https://avatars.githubusercontent.com/u/45670?v=4)](https://github.com/jverkoey "jverkoey (7 commits)")

### Embed Badge

![Health badge](/badges/dimassrio-vanilla/health.svg)

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

PHPackages © 2026

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