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.
Uninstalls 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.

Currnt 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, or on vbulletin.org in the vBadvanced CMPS thread. I will be more than happy to help in any way I can if the request for help is made there. Anyone trying to contact me via email, private message, or any other means will be ignored.

This script is © 2003 - 2004 vBadvanced.com and PlurPlanet, LLC.
This script is NOT to be re-distributed in any way or placed on a website for download without permission.
All copyright notes in the script itself must remain unchanged.

Installation Instructions

Step 1 - Admin CP Modifications

Go to your Style Manager under "Styles & Templates" in your Admin CP. Choose to modify All Style Options. On this page, you will see a section for "Image Paths". Here you must change the path for each image directory (Title Image, Button Images Folder, Miscellaneous Images Folder, etc) to the full path (ex - /forum/images or http://yoursite.com/forum/images).

You must do this for each of your styles, otherwise your images will not show up!

Step 2 - Template Modifications

You should still be in your Admin CP at this point. Go to your Style Manager again 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". Open the templates.txt file which was included in the zip file. Make the changes to each template that is listed there. Simply copy the content listed under each template name and replace the current content with that for each template.

Step 3 - File Modifications

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

Find:

require_once('./includes/init.php');

Above 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:

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:

'forumhome' => $vbphrase['group_forum_home'],

Below 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 = '')
{
	global $birthdaycache, $eventcache, $bbuserinfo, $vbphrase, $stylevar, $show, $offset, $colspan, $days, $months, $show;

Replace it with:

function construct_calendar_output($today, $usertoday, $calendarinfo, $fullcalendar = 0, $weekrange = '')
{
	global $birthdaycache, $eventcache, $bbuserinfo, $vbphrase, $stylevar, $show, $offset, $colspan, $days, $months, $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 4 - 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 5 - 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 wrong. Create a file called info.php with the following content:

<? phpinfo(); ?>

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

_SERVER["PATH_TRANSLATED"]

Copy that path, paste it over what you currently have for your path in the cmps_index.php file, and add the name of your forums directory after it. Reupload your cmps_index.php file.

Q.	Now that I've installed this script I can't log out!
A.	Try clearing your cookies. If you're still having problems afterwards, edit your Cookie Domain (Under Cookies and HTTP Header Options in your vBulletin options section) and change that to ".yoursite.com" (note the two dots!).

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 or vbulletin.org in the vBadvanced CMPS thread. I will be more than happy to help in any way I can if the request for help is made there. Anyone trying to contact me via email, private message, or any other means will be ignored.

Upgrading

To upgrade from vBadvanced CMPS 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.

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.