VUBB

README

Installation | Manual Install | Modules | Templates | Extras

Installation Steps

Please first read the license and if you agree then you can upload the
contents of the upload folder into your desired location.

 

To install the forum please use install.php in the uploads directory,
you will need to chmod config.php to 777 or on some configurations 755.

 

1) Please make sure you read the licence and agree to it before installing.

 

2) Upload all the contents of the upload folder in the desired location

 

3) When all files are uploaded, chmod the config.php file to 777

 

4) Run the install.php file from the main directory. 

eg, if you installed to www.mysite.com/forum, the installer would be located at www.mysite.com/forum/install.php

 

5) Fill in the required information the installer asks for and click to proceed.

 

6) Installation Complete!

 

NOTE:  To provide security, it is advised at this point to remove the install.php file, keeping the install file could enable someone to do damage to your board.


Manual Install

If you have no problems with install.php, ignore this section.

 

If you have problems installing you can manually configure the forum installation.


Please use the the SQL file provided with this package located in the docs folder, use this file in phpmyadmin and then edit the config table to match your site path and site url to the script.

 

You will need to put this in the config file(replace with correct values):
database_connect('localhost', 'user', 'pass', 'database');


Modules
VUBB has a fully modular system meaning that all files forum.php, viewforum.php, viewtopic.php are all modules. This makes it easy to mod as the pages are not hard-coded into the system.

Links: Adding new module | Changing defualt module


To add a new module open index.php and find;
// Modules
$modules = array(
'forum' => 'forum',
'viewforum' => 'viewforum',
'viewtopic' => 'viewtopic',
'register' => 'register',
'login' => 'login',
'usercp' => 'usercp',
'newtopic' => 'newtopic',
'newreply' => 'newreply',
'newpoll' => 'newpoll',
'editpost' => 'editpost',
'viewprofile' => 'viewprofile',
'members' => 'members'
);

Simply add another module in like so;
// Modules
$modules = array(

'newmdoule' => 'newmodule',
'forum' => 'forum',
'viewforum' => 'viewforum',
'viewtopic' => 'viewtopic',
'register' => 'register',
'login' => 'login',
'usercp' => 'usercp',
'newtopic' => 'newtopic',
'newreply' => 'newreply',
'newpoll' => 'newpoll',
'editpost' => 'editpost',
'viewprofile' => 'viewprofile',
'members' => 'members'
);



Changing the defualt module, to do this find;
// Set defualt module if none set
if (!isset($_GET['act']))
{
$act = 'forum';
}


Change 'forum'; to the name of the module you want to show when the forum is first loaded up. For example;
// Set defualt module if none set
if (!isset($_GET['act']))
{
$act = 'members';
}


Templates
The templates for VUBB are in php for a very good reason, instead of messing around with a new templating syntax i can actually work php and html together which also makes for faster loading and enables me to include advanced options easily.
With a tiny bit of php knowledge you will be able to easily edit the templates.

For example if you wanted to add another space after each category you would edit the forum.php template and find this;
// end cat table
function end_cat_table()
{
echo '
<tr><td width="100%" colspan="5" class="cat_block">&nbsp;</td></tr>
</table>
<br />';
}


You would add another <br /> to the end of it so it would look like this;

// end cat table
function end_cat_table()
{
echo '
<tr><td width="100%" colspan="5" class="cat_block">&nbsp;</td></tr>
</table>
<br />

<br />';
}


It is that simple! PHP templates does not make it hard to template! Each template name is relative to the module name and in each template are the different sections that module uses (usually inside functions).

The PSD files for the images of the core template will be supplied for download in a later version.