# vBulletin 5 Setup for openSUSE Forums

Brief setup instructions:

 1. Prepare the binaries as instructed in [init.sls](init.sls).

 1. ``salt-call state.apply grains``

 1. ``salt-call state.apply pillar='{"vbulletin":{"tools":"yes"}}'``

 1. ``cd /srv/www/vhosts/forums/``

 1. ``(cd htdocs/core/install; sudo -u nginx php -f upgrade.php)``

 1. `` mysql webforums 

 1. ``(cd htdocs/core/install; sudo -u nginx php -f upgrade.php)``

 1. ``salt-call state.apply``

## vBulletin setup tools

If the pillar ``vbulletin.tools`` is truthy, the extra files described below

are available to aid with setup of vBulletin.

**It is important to disable the ``vbulletin.tools`` pillar and running

``highstate`` again to remove the files before production use.**

### ``/srv/www/vhosts/forums/db-tweak.sql``

Running this SQL script on the vBulletin database will:

  * Set up the correct grants for the database user.

  * Define the site URL correctly for template setup

  * Adjust various other vBulletin settings

After running the script, run ``core/install/upgrade.php`` again to make sure

the templates are set up correctly.

### ``/srv/www/vhosts/forums/htdocs/vb_test.php``

A tool for checking that vBulletin is installed correctly, including all

dependencies, as well as verifying that it is possible to connect to the

database.

### ``/srv/www/vhosts/forums/htdocs/info.php``

Shows ``phpinfo()`` for the forum server.

## Styling

These steps achieve a minimal styling suitable for openSUSE Forums.

Enable the _Default vB5 Style_, then customize these style variables:

 * ``global_palette_accent_02`` = #73ba25

 * ``global_palette_text_04`` = #5a911d

Finally, change the [site logo](files/logo-color-90.png).