vBadvanced Readme File

vBadvanced CMPS (Content Management & Portal System)

Introduction

vBadvanced CMPS (Content Management & Portal System) is an advanced portal / content management system that will allow you to easily include different options from your vBulletin message board on your site's homepage. It also allows you to easily create and manage new pages in which you can set different settings other than the default. It's module system also makes it very easy to add custom modules without hacking any of the files, plus it is very easy to integrate with other vBulletin pages and hacks. Everything is also template based and completely integrated with vBulletin, so it is very easy to customize and change everything through your Admin CP.

Features:

Easily create and manage your site's content and new pages through your vBulletin Admin CP.
Easily add new modules without hacking any vBulletin or vBadvanced files.
Ability to set a different value for each module's settings on a per-page basis.
Easily enable/disable modules on a per-page basis.
Set and change all options via the Admin CP.
Everything is completely template based so it is very easy to customize.
Install file that will make all database queries and templates for you in seconds.
Un-installs in seconds.
Tested and stable with vBulletin 3.01, 3.00, RC1, RC2, RC3.
100% validated XHTML 1.0 compliance
And Much more!

Included Modules:

Welcome Block - Creates a login box for members to log into your site on the homepage, or shows logged in users their avatar, last visit, and new PMs (all of which may be enabled/disabled).

News - Post News in a forum you specify and have it appear on your page. Additional options to show attachments, icons, images, HTML, and more in your news posts.

News Archive - A condensed version of older news posts. Includes options to control the number of archived posts to show.

Latest Topics - Show the latest threads started in your forum. Additional options to set the number of threads to display, show a preview of the first post, icons, and last post info.

Current Poll - Show a poll and allow users to vote and see the results on your homepage.

Buddy List - Show the user's buddy list for members who are logged in.

Online Users - Shows a list of active users, including the stats for your 'most users ever online'.

Stats - Shows statistics such as total members, threads, posts, top poster, newest member, and today's birthday's.

Mini Calendar - Shows a mini calendar with links to days with scheduled events.

Search - Search box to allow users to quickly search your forums.

Quick Moderation - Shows the number of posts, threads, users, attachments, and calendar events awaiting moderation for users that have permission to moderate these items.

Custom Page Content - Allows you to easily specify a template to include the content from on a page.

More modules available in the Addon Modules, Hacks, & Modifications forum at vbadvanced.com.

Help & Support

Before asking for support Please read the F.A.Q below!
If you have any problems or questions that are not covered in the F.A.Q. please post them at vbadvanced.com in the appropriate forum. We will be more than happy to help in any way we can if the request for help is made there. Anyone trying to contact a staff member via e-mail, private message, or any other means will be ignored.

This script is NOT to be re-distributed in any way or placed on a web site for download.

All copyright notes in the script itself must remain unchanged unless you have purchased a Branding Free license.

Installation Instructions

Step 1 - Template Modifications

Go to your Style Manager under the "Styles & Templates" section of your Admin CP. Click on the '« »' button to expand the templates for that style. Once the templates are expanded, you will see a group called "Calendar Templates". Simply copy the content listed under each template name (marked in blue) below and replace the current content with that for each template.

calendar_smallmonth_day

<!-- a single day on the small calendars -->
<td class="<if condition="$show['highlightweek']">alt2<else />alt1</if>"<if condition="$show['highlighttoday']"> style="border:solid 1px red; font-weight:bold" title="$vbphrase[today]"</if>>
	<if condition="$show['daylink']">
		<if condition="$show['dontshowweek']"><span class="smallfont"></if><a href="$vboptions[bburl]/calendar.php?$session[sessionurl]do=getinfo&amp;day=$year-$month-$day&amp;c=$calendarid" title="$eventdesc">$day</a><if condition="$show['dontshowweek']"></span></if>
	<else />
		<if condition="$show['dontshowweek']"><span class="smallfont">$day</span><else />$day</if>
	</if>
</td>

calendar_smallmonth_day_other

<!-- a single day from another month on the small calendars -->
<td class="smallfont"><em><if condition="$show['dontshowweek']"><span class="smallfont">$day</span><else />$day</if></em></td>

calendar_smallmonth_header

<tr>
<if condition="$show['dontshowweek']">
<td class="tcat" colspan="$colspan" align="$stylevar[left]"><span class="smallfont"><b>$vba_options[portal_blockbullet] 
<else />
<td class="tcat" colspan="$colspan" align="center"><b>
</if><a href="$vboptions[bburl]/calendar.php?$session[sessionurl]month=$month&amp;year=$year&amp;c=$calendarid&amp;do=displaymonth">$monthname $year</a></td>
</tr>
<tr align="center">
	<if condition="!$show['dontshowweek']"><td class="thead">&nbsp;</td></if>
	<if condition="$show['day1']"><td class="thead">$day1</td></if>
	<if condition="$show['day2']"><td class="thead">$day2</td></if>
	<if condition="$show['day3']"><td class="thead">$day3</td></if>
	<if condition="$show['day4']"><td class="thead">$day4</td></if>
	<if condition="$show['day5']"><td class="thead">$day5</td></if>
	<if condition="$show['day6']"><td class="thead">$day6</td></if>
	<if condition="$show['day7']"><td class="thead">$day7</td></if>
</tr>
$calendarrowbits

calendar_smallmonth_week

<tr align="center">
<if condition="$show['dontshowweek'] != 1">	<td class="thead"><a href="calendar.php?$session[sessionurl]c=$calendarid&amp;week=$firstweek&amp;do=displayweek&amp;month=$month" title="$vbphrase[view_this_week_in_detail]" style="font-family:arial,sans-serif; text-decoration:none">&gt;</a></td></if>
	$calendardaybits
</tr>

Step 2 - File Modifications

In your /forum/global.php file: (3 Changes)

Find:

define('VB_AREA', 'Forum');

Below that Add:

if (defined('VBA_PORTAL'))
{
	$phrasegroups = array_merge($phrasegroups, 
		array(
			'calendar', 
			'adv_portal',
			'postbit'
		)
	);

	$specialtemplates = array_merge($specialtemplates, 
		array(
			'adv_modules',
			'adv_portal_opts',
			'attachmentcache',
			'bbcodecache',
			'birthdaycache',
			'eventcache',
			'iconcache',
			'maxloggedin',
			'smiliecache',
			'userstats'
		)
	);
	
	$globaltemplates = array_merge($globaltemplates,
		array(
			'adv_portal',
			'adv_portal_footer'
		)
	);
}

Find:

// #############################################################################
// ######################## START TEMPLATES & STYLES ###########################
// #############################################################################

Above that Add:

if (defined('VBA_PORTAL'))
{
	require_once('./includes/vba_cmps_include_top.php');
}

Find:

// #############################################################################
// ######################### END TEMPLATES & STYLES ############################
// #############################################################################

Above that Add:

if (defined('VBA_PORTAL'))
{
	require_once('./includes/vba_cmps_include_bottom.php');
}

In your /forum/admincp/index.php file:

Find:

	$printhr = false;
	if (can_administer('canadmincalendars'))

Above that Add:

	construct_nav_option($vbphrase['default_settings'], 'vba_cmps_admin.php?do=modifysettings');
	construct_nav_option($vbphrase['edit_modules'], 'vba_cmps_admin.php?do=listmodules');
	construct_nav_option($vbphrase['add_module'], 'vba_cmps_admin.php?do=addmodule');
	construct_nav_option($vbphrase['edit_pages'], 'vba_cmps_admin.php?do=listpages');
	construct_nav_option($vbphrase['add_page'], 'vba_cmps_admin.php?do=addpage');
	construct_nav_group($vbphrase['vba_cmps']);

	construct_nav_spacer();

In your /forum/includes/adminfunctions_template.php file:

Find:

	'aaa' => 'AAA Old Backup'

Above that Add:

	'adv_portal' => 'vBadvanced CMPS',

In your /forum/includes/functions_calendar.php file:

Find:

function construct_calendar_output($today, $usertoday, $calendarinfo, $fullcalendar = 0, $weekrange = '')
{

Below that Add:

global $vba_options, $vboptions;

In your /forum/includes/functions.php:

Find:

	if (THIS_SCRIPT == 'online' OR THIS_SCRIPT == 'calendar' OR (THIS_SCRIPT == 'index' AND $vboptions['showevents']))

Replace it with:

	if (THIS_SCRIPT == 'online' OR THIS_SCRIPT == 'calendar' OR (THIS_SCRIPT == 'adv_index') OR (THIS_SCRIPT == 'index' AND $vboptions['showevents']))

In your cmps_index.php file:

Now open your cmps_index.php file in this folder and find:
chdir('./forum');

Replace this with the full path to your forum on your server.
Not sure what this means?

Note: If you are installing this script in the same directory as your forums then you may simply comment out this line.

Step 3 - Upload Files

Upload the new vBadvanced CMPS files and your modified vBulletin files to the directories listed below.

root folder - cmps_index.php (you will probably rename this file to index.php once everything is set up)

root/forums - global.php

root/forums/admincp - index.php, vbacmps_install.php, vba_cmps_admin.php

root/forums/includes - functions_calendar.php, functions.php, adminfunctions_template.php, vba_cmps_include_top.php, vba_cmps_include_bottom.php

root/forums/images/misc - noavatar.gif

root/forums/modules - Upload this folder and all of it's contents

Step 4 - Run the Install Script

Now you're almost done! It's time to add the vBadvanced CMPS settings and templates. Run the install script from your browser by going to http://yoursite.com/forum/admincp/vbacmps_install.php.
This script will make all necessary changes to your database and install the templates, phrases, settings, and etc for you. Once the script is done go to your Admin CP and you will see a new group of options called "vBadvanced CMPS". That is where you will modify the settings, add/edit modules, and add/edit new pages.

For more information on how to use your new script, please see the User's Manual available at vbadvanced.com.

Frequently Asked Questions

I'm not sure how to find the path to my forums.

I get an error like this when I first try to install the script:

Warning: chdir() [function.chdir]: No such file or directory (errno 2) in /home/yoursite/html/cmps_index.php on line 8

The path to your forums directory is set incorrectly. Create a file called info.php with the following content:

<? phpinfo(); ?>

Then upload that file into your forums directory on your server and go to the file in your browser. You will see a list of options that were set by your host. One of them is called:

_SERVER["PATH_TRANSLATED"]

Find that, copy that path, and paste it over what you currently have for your path in the cmps_index.php file. Re-upload your cmps_index.php file.

Q.	Now that I've installed this script I'm having problems logging in or out of my forum.
A.	Try clearing your cookies. If you're still having problems afterwards, edit your 'Cookie Domain' setting (Under Cookies and HTTP Header Options in your vBulletin options section) and change that to ".yoursite.com" (note the two dots!). Also make sure that the 'Path to Save Cookies' setting right above is set to '/'.

Some of my images are broken on my vBadvanced pages.

If it is your smilies and/or icons that are broken, upload the install file to your /forum/admincp directory and go to the file in your browser. Once there, you will see a link that says 'Click here to update your image paths'. Click that link and it will attempt to update your image paths. If it cannot, you will need to change the URL to each of your smilies and icons through the Admin CP.

If your buttons and other images are broken, follow the instructions here.

Q.	I've just upgraded my vBulletin and now my page appears to be broken!
A.	Upload the vbacmps_install.php file to your admincp directory and go to it in your browser. Once there, select the option to install only the templates.

Help & Support

Before asking for support Please read the F.A.Q above!
If you have any problems or questions that are not covered in the F.A.Q. please post them at vbadvanced.com in the appropriate forum. We will be more than happy to help in any way we can if the request for help is made there. Anyone trying to contact a staff member via e-mail, private message, or any other means will be ignored.

Upgrading

To upgrade from vBadvanced CMPS v1.0.0, vRC1, or vRC2 simply upload the new files over your existing ones (with the exception of your cmps_index.php file). Then go to http://yoursite.com/forum/admincp/vbacmps_install.php in your browser and select the option to upgrade.

Then look in your forum/global.php file for this code:

if (defined('VBA_PORTAL'))
{
	require_once('./includes/vba_cmps_include_bottom.php');
}

Remove it, and add it just above this code:

// #############################################################################
// ######################### END TEMPLATES & STYLES ############################
// #############################################################################

If you are upgrading to the CMPS from vBadvanced Homepage, simply follow the install instructions. During the install you will be given the option to import your vBadvanced Homepage settings. Once the CMPS is installed and you are ready to switch to the CMPS you may uninstall the homepage by using the install file that came with that script.