Install Vanilla forums

Vanilla forums software is a popular forum software that includes many advanced features not found in other forum software, including automatic draft saving, active notifications of messages and discussion responses, and an overall clean look. This article covers installing Vanilla Forums to a UNPM server.

vanilla.conf
Paste into the file, with  being the site's root subdirectory Vanilla will be installed to:

vanilla_https.conf
Paste into the file, with  being the site's root subdirectory Vanilla will be installed to:

Edit sites-available file
Open the sites-available file for the domain:

In the HTTP server block, add:

In the HTTPS server block, add:

Test and Restart nginx
Test and restart nginx.

Create Vanilla database and database user
Create a Vanilla database and database user:

Note that the,   and   will be required for the Vanilla installation process.

Vanilla Forums package installation
This install is for Vanilla Forums 2.1b2 beta release. This beta includes many upgrades that make it worthwhile to run. Many forum admins have been running the beta in production environments since its initial release in April, 2013. It can be considered reasonably stable for most configurations:

2.1b2 security fix
There is an important security fix that must be installed to 2.1b2. The instructions can be followed, which require manually editing two text files as per this GitHub revision, or, more conveniently, a tar file containing the fixed files can be downloaded from unpm.org:

Navigate to the secure  https://www.example.com/forums/  and complete the Vanilla Forums online installation.

Configure Vanilla Forums
In addition to the configurations available from the default plugins located in the Vanilla forums dashboard, plugins may be added to the  directory then enabled in the dashboard and configurations may be set in the   file.

Themes
It is strongly recommended that admins using the default theme create a clone of the default and use that instead. Otherwise all customizations made to the default theme may be lost during an update.

In the line  change   to the desired name.

In the line  change   to the desired name. This will be displayed in the dashboard as the name of the theme.

The  line is displayed in the dashboard to describe the theme. The  can be replaced with   around text that will be displayed as the version - be sure to leave the   at the end of the line. ,  and   may also be changed as desired.

The new theme should now be an option in the dashboard's themes menu.

Configuration settings in config.php
To use the following configurations, open  for editing:

Load local fonts and jQuery scripts
The default configuration for Vanilla makes use of Google APIs for loading jQuery scripts as well as some fonts, which will use fewer resources and may load faster than when locally stored. The tradeoff being that Google can track users who use the site by recording the header information sent when requesting the scripts and fonts. To force locally stored scripts and fonts to load, add the following line:

Combine CSS files
CSS files may be combined for faster page loading. Note this is an experimental feature which may cause issues for some setups. Add the following line:

Change input method
The input method can be specified by adding a line then specifying the desired method. If not present, add the following line:

The above configuration sets markdown as the input type. Input type options are case sensitive:,  ,  or.

Enable debug
This will display messages at the bottom of each page that may be useful for troubleshooting. It is different from the Debugger plugin.

Note that when disabling the plugin it easier to change  to   so that when Vanilla overwrites the config file for a settings change made via the dashboard the line will not be deleted, allowing for convenient enabling in the future.

Plugins
The default set of plugins are fairly straightforward. Note that when enabling the WYSIWYG editor, the editor defaults to this mode and some features may not be available without selecting the text button.

Enable Debugger
If the forum is not responding as expected, the debug mode may be enabled for troubleshooting by enabling the Debugger plugin. This mode will display information and error statements at the bottom of every page.

Add quote option for comments
The Quotes plugin adds a quote option to more easily quote posts:

The Quotes plugin should now be an option in the dashboard.

Piwik plugin
For servers with Piwik installed, the Piwik Analytics plugin can be used to enable Piwik across the forum. To install, download and extract the plugin to the  directory. It is also advisable to make a few changes to some of the files to prevent popular tracker blockers from preventing the code from being loaded.

Change the following lines:

For an explanation of, see the Piwik article.

In the Vanilla Forums dashboard, navigate to Addons -> Plugins and enable Piwik Analytics. In the plugin's settings, set PiwikInstall to ://www.example.com/randomsymlinkname/ (again, see the Piwik article for an explanation of randomsymlinkname) and set PiwikSiteID to the Id of the website.

Making nice code blocks with PrettyPrint
If the forum being made is expected to make regular use of code blocks, users may not like the default code blocks created by Vanilla. The PrettyPrint plugin can be installed and configured to greatly enhance the forum's code blocks.

Paste into the new file:

To make in-line code a lighter shaded background:

Remove the following code: