vBadvanced Gallery Readme File

F.A.Q.

vBadvanced Gallery

Introduction

vBadvanced Gallery is an advanced Gallery which is built around, and completely integrated with vBulletin. It includes more features and flexibility than most other image galleries available on the market today and is very easy to set up and maintain. It allows unlimited categories, subcategories, and uploads. Also includes many other options such as user favorites, subscriptions, comments, ratings, multimedia file support, and much more!

Features:

Fully integrated with vBulletin.
Unlimited* categories & sub-categories.
Unlimited* file uploads.
Automatically resizes images and creates thumbnails using the GD library or ImageMagick.
Support for multimedia and any other types of files. Also allows you to add new filetypes.
Ability to allow as many uploads at a time as you would like**, along with bulk uploading from your server.
Ability to limit how much disk space a user's uploads may consume on a per-usergroup basis.
Image manipulation options to allow you to rotate and flip images.
Set filesize, width, and height limits on uploads on a per-extension and per-category basis.
Watermarking of images.
Slide show.
Allow your users to send e-Cards to their friends.
Printer friendly version of images.
Allow users to send images to their friends.
What's New & What's Popular sections.
Allow users to comment on uploads.
Allow users to rate uploads.
User Favorites.
User Subscriptions.
User Albums where your users can create and manage their own categories.
Advanced searching features along with cached searching for faster results.
Choose what information to show with thumbnails of images (User, date, filesize, dimensions, views, replies, description, and last post).
On/off indicators to show your users which categories contain new images since their last visit.
Password protected categories.
New and/or random images on your gallery index page.
Ability to add custom fields to collect and display more information about the files being uploaded.
Ability to allow your users to select the number of images to display per page, plus other advanced sorting options.
Sticky files.
Shows the number of replies and uploads per category.
Shows the number of hits, posts, last person to reply to uploads, and etc for each upload.
Advanced sorting options in each category.
Allow users to report broken/problematic images.
Category permissions where you can set different permissions for each usergroup on a per-category basis.
Completely template based so it is very easy to change the look and feel.
Moderate images and/or posts before they will appear on a per usergroup basis.
Ability to choose moderators to moderate each category.
Options to mass edit/delete uploads.
Optimized to handle thousands and thousands of images without a performance hit.
Installer that will install all of the templates, phrases, and all database modifications.
And MUCH more!

* The term "unlimited" denotes that the only limitions are those of PHP, MySQL, or your web server and not of the vBadvanced product.

** There is an option to allow as many upload input boxes as you wish. The actual number of files that may be uploaded at once will depend on your server configuration and the size of the file(s) being uploaded.

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 - 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 - File Modifications

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

Find:

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

Above that Add:

	construct_nav_option($vbphrase['modify_settings'], 'vba_gallery_admin.php?do=modifysettings');
	construct_nav_option($vbphrase['edit_categories'], 'vba_gallery_admin.php?do=dirmanager');
	construct_nav_option($vbphrase['add_category'], 'vba_gallery_admin.php?do=addcat');
	construct_nav_option($vbphrase['category_permissions'], 'vba_gallery_admin.php?do=categorypermissions');
	construct_nav_option($vbphrase['custom_fields'], 'vba_gallery_admin.php?do=customfields');
	construct_nav_option($vbphrase['usergroup_permissions'], 'vba_gallery_admin.php?do=permissions');
	construct_nav_option($vbphrase['view_ecards'], 'vba_gallery_admin.php?do=viewecards');
	construct_nav_option($vbphrase['validate_new_images'], '../' . $modcpdir . '/vba_gallery.php?do=validateimages');
	construct_nav_option($vbphrase['validate_new_posts'], '../' . $modcpdir . '/vba_gallery.php?do=validateposts');
	construct_nav_option($vbphrase['edit_filetypes'], 'vba_gallery_admin.php?do=filetypes');
	construct_nav_option($vbphrase['maintenance'], 'vba_gallery_admin.php?do=maintenance');
	construct_nav_group($vbphrase['vba_gallery']);

	construct_nav_spacer();

	// *************************************************

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

Find:

	print_input_row($vbphrase['title'], 'usergroup[title]', $usergroup['title']);

Above that Add:

	$gperms = convert_bits_to_array($usergroup['gallerypermissions'], $_BITFIELD['usergroup']['gallerypermissions']); 

	foreach($gperms AS $key => $galleryperms) 
	{ 
		construct_hidden_code("usergroup[$key]", $galleryperms); 
	}

In your /forum/clientscript/vbulletin_editor.js file:

Find:

misc.php

Replace that with:

/forum/misc.php

Note: That's assuming that your forum directory is called 'forum'. If it's named something different then you will need to change that accordingly.

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

Find:

	'aaa' => 'AAA Old Backup'

Above that Add:

	'adv_gallery' => $vbphrase['group_adv_gallery'],

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

Find:

// ### INSERT PLUGIN USERGROUP PERMISSIONS BITFIELDS HERE ###
// ----------------------------------------------------------

Below that Add:

$_BITFIELD['usergroup']['gallerypermissions'] = array(
	'canviewgallery'	 			=> 1,
	'canviewimages' 				=> 2,
	'moderateimages' 				=> 4,
	'moderateposts' 				=> 8,
	'cansearchimages' 			=> 16,
	'cansendimagetofriend' 	=> 32,
	'caneditimages' 				=> 64,
	'caneditothersimages' 	=> 128,
	'candelete' 						=> 256,
	'candeleteothers' 			=> 512,
	'canviewreplies' 				=> 1024,
	'canreplytoimages' 			=> 4096,
	'caneditposts' 					=> 2048,
	'caneditothersposts' 		=> 8192,
	'candeleteposts' 				=> 16384,
	'candeleteothersposts' 	=> 32768,
	'canrateimages' 				=> 65536,
	'canuploadimages'				=> 131072,
	'canuploadfromserver'		=> 262144,
	'cancreatecategories'		=> 524288,
	'canuploadasuser'				=> 1048576
);

Find:

	'profilepicmaxsize'     => 1

Replace With:

	'profilepicmaxsize'     => 1,
	'gallery_maxdiskspace'	=> 1,
	'gallery_maxcats'				=> 1

In your /forum/modcp/index.php:

Find:

	if ($canmass)
	{
		construct_nav_group($vbphrase['thread']);
		construct_nav_spacer();
	}

Below that Add:

	construct_nav_option($vbphrase['validate_new_images'], 'vba_gallery.php?do=validateimages');
	construct_nav_option($vbphrase['validate_new_posts'], 'vba_gallery.php?do=validateposts');
	construct_nav_group($vbphrase['vba_gallery']);
	construct_nav_spacer();

In your /gallery/gallery_config.php.new file that came with this script:

Open this file and find:
$forumpath = '';

Add the full path to your forum on your server between the '' marks here.
Save the file as gallery_config.php (removing the '.new' part from the end).

Not sure how to find the path to your forums?

Step 3 - Upload Files

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

root/forum/admincp - vbagallery_install.php, vba_gallery_admin.php, index.php, usergroup.php

root/forum/clientscript - vbulletin_editor.js

root/forum/includes - adminfunctions_template.php, init.php, adminfunctions_gallery.php, functions_gallery.php, functions_gallery_imageedit.php

root/forum/includes/cron - gallery_ecard.php, gallery_search.php, gallery_subscriptions.php

root/forum/modcp - index.php, vba_gallery.php

root/gallery/ - Upload this folder and all of it's contents into your root directory.

Note: Be sure to upload the /gallery/images folder and it's contents in Binary mode and the other files in ASCII mode.

Now you will need to chmod the /gallery/files folder to 777:

Step 4 - Run the Install Script

Now you're almost done! It's time to add the vBadvanced settings and templates. Run the install script from your browser by going to http://yoursite.com/forum/admincp/vbagallery_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 "vBa Gallery" in the left frame. That is where you will modify the settings and set up your new Gallery.

Step 5 - Setting Your Options - Important Settings

The first thing you will want to do after you finish running the install script is to log into your Admin CP and set some options. You'll find the options by clicking on the 'Modify Settings' link under 'vBa Gallery' in the left frame.
The most important setting here is your 'Files Path' option, listed under 'Uploading Options'. You must set this to the full path (Not the URL) to your '/gallery/files' folder before you will be able to upload files.
All of the other options may be changed at a later time if you wish, but the 'Files Path' setting must be changed before the gallery will be fully functional.

FTP & Bulk Uploads:
If you plan to allow some of your users to upload files via FTP, you will first need to make sure that your 'FTP User Folder Path' setting (listed under the 'Modify Settings' link under your 'vBa Gallery' options in your Admin CP) is set to the full path to your '/gallery/users' folder.
You will then need to create a new folder under your '/gallery/users' directory and name it according to that user's userid (so if the user's userid was 5, you would simple create a new folder called 5 under your '/gallery/users' directory.
Lastly, you will need to create a new FTP account on your server for that user and make sure they have access to the newly created folder to upload their files to.

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/gallery/gallery_global.php on line 15

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 gallery_config.php file. Re-upload your gallery_config.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 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.