PhotoPost vBGallery Readme File

F.A.Q.

PhotoPost vBGallery

Introduction

PhotoPost vBGallery is an advanced photo 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 make any category a "Members' Category" in which any uploads to the category or sub-categories created will automatically be placed in a sub-category named after the user who uploaded the file.
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. May be done permanently or on-the-fly.
Slide show.
Film strip to show X number of previous/next thumbnails when viewing large images.
Allow your users to send e-Cards to their friends.
Printer friendly version of images.
Allow users to send images to their friends.
Display 'Direct Link Code', 'BB Image Code', and '<img> Tag Code' on the showimage page to allow your users to quickly link to / post images.
Option to use .htaccess protection to help keep your private categories private and to prevent image leeching).
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. Optional settings to allow your users to edit, delete, empty, password protect, and allow/deny other users from viewing, uploading, replying, and rating uploads.
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.
Mass move uploads from one category to other.
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 PhotoPost vBGallery 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.

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.

Changes in PhotoPost vBGallery

PhotoPost vBGallery, v2.4.3

NEW:

Clean Description in showimage page <title> - $image[description_clean]
Added securitytoken to submit forums to operate in 3.7 vBulletin.
Profile Enhancements
- User CP control over the image block in the member profile. (active, 9 locations, image size, extra image info, count)
- In the "Statistics Tab" - added gallery field (media count, comment count, last upload with link, last comment with link)
- Gallery Tab added : media count, comment count, last upload with link, last comment with link, total views, total sticky,
total votes, disk space, last 30 added favorites w/ link , last 30 added subscriptions w/ link.
- Gallery usergroup permissions: Can view profile tab (yes/no), Can view profile block (yes/no), Can change profile block settings (yes/no)
- Added media count to Mini Statistics block
Added ppgal_user table to hold personal user information and setting.
Gallery usergroup permission: Can view FORUMHOME block (yes/no)
Added phrase group adv_gallery_int for phrases that are needed outside of the gallery (profile page, forumhome, ect)
vs. main phrase group adv_gallery.
Userinfo Merge - this merges the fields of user table and ppgal_user table
Added meta keywords and meta description to showimage from media keywords and description

Fixes / Changes

Failed Validation
Phrasegroup adv_gallery called on all pages Replaced
Fields ppicount, pppcount in user table was moved to ppgal_user table
Validation Error go button
Fixed member removal. (when a user is removed from the system: images, posts, member categories, votes, ect will be removed)
Notifications Links in forums navbar fixed while on gallery pages.
Moved user profile setting in AdminCP => Modify Add-Ons => vBGallery Profile to UserCP
Posts Awaiting Moderation - Validating does not work

Template Changes

ADV_GALLERY

ADV_GALLERY_BROWSEIMAGES

adv_gallery_conformation

ADV_GALLERY_ECARD_SEND

ADV_GALLERY_EDITIMAGE

adv_gallery_member_block (new)

adv_gallery_member_imagebit (new)

adv_gallery_member_ministats (new)

adv_gallery_member_newestbits (new)

adv_gallery_member_stats (new)

adv_gallery_newestbits

adv_gallery_profile

ADV_GALLERY_REPLY

ADV_GALLERY_SHOWIMAGE

ADV_GALLERY_UPLOAD

adv_gallery_usercp_navbit (new)

File Changes
Upload the new PhotoPost vBGallery files to the directories listed below. root/forum/admincp

vbgallery_install.php
vba_gallery_admin.php
product-ppvbgallery.xml

root/forum/includes

class_profileblock_vbgallery.php (new)
functions_gallery.php
functions_gallery_imageedit.php

root/forum/includes/vbgallery

block_fetch_unwrapped.php (new)
cache_templates.php
forumhome_complete.php
fetch_userinfo_query.php (new)
member_complete.php
member_build_blocks_start.php (new)
member_profile.php (new)
notifications_list.php (new)
postbit_display_complete.php
profile_start.php (new)
register_addmember_complete.php (new)
showthread_query (new)
useradmin_prune.php (new)
useradmin_update_data.php (new)
userdata_delete.php (new)

root/gallery

browseimages.php
displayimage.php
managecats.php
newreply.php
showimage.php
stats.php

PhotoPost vBGallery, v2.4 Released!
PhotoPost vBGallery, v2.3 Released!
PhotoPost vBGallery, v2.2 Released!

Installation Instructions

Step 1 - File Modifications

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

Open this file and find:
$forumpath = '/path/to/your/forums';

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 2 - Upload Files

Upload the new PhotoPost vBGallery files to the directories listed below.

- forums\admincp
product-ppvbgallery.xml
vba_gallery_admin.php
vbgallery_install.php

- forums\cpstyles
ppgal_cp_logo.gif

- forums\images\misc
gallery.gif

- forums\includes
adminfunctions_gallery.php
class_profileblock_vbgallery.php
functions_gallery.php
functions_gallery_imageedit.php

- forums\includes\cron
gallery_ecard.php
gallery_search.php
gallery_stats.php
gallery_subscriptions.php
gallery_totals.php

- forums\includes\vbgallery
admindata_start.php
admin_permissions_form.php
admin_permissions_process.php
cache_templates.php
can_administer.php
error_generic.php
fetch_userinfo_query.php
forumhome_complete.php
global_complete.php
global_setup_complete.php
member_build_blocks_start.php
member_complete.php
member_profileblock_fetch_unwrapped.php
mod_index_navigation.php
notifications_list.php
online_location_preprocess.php
online_location_process.php
online_location_unknown.php
postbit_display_complete.php
profile_start.php
register_addmember_complete.php
showthread_query.php
style_fetch.php
template_groups.php
useradmin_prune.php
useradmin_update_data.php
usercp_nav_start.php
userdata_delete.php
userdata_update_username.php

- forums\includes\xml
bitfield_vbgallery.xml
cpnav_vbagallery.xml
hooks_vbgallery.xml

- forums\modcp
vba_gallery.php

- gallery
ajax.php
browseimages.php
displayimage.php
ecard.php
editimage.php
gallery_config.php.new
gallery_global.php
index.php
managecats.php
misc.php
moderate.php
newreply.php
search.php
sendmessage.php
showimage.php
stats.php
upload.php

- gallery\images
announcement.gif
ecard-layout1.gif
ecard-layout2.gif
ecard-layout3.gif
file_audio.gif
file_avi.gif
file_bmp.gif
file_gif.gif
file_iff.gif
file_jb2.gif
file_jp2.gif
file_jpc.gif
file_jpeg.gif
file_jpg.gif
file_jpx.gif
file_midi.gif
file_mov.gif
file_mp3.gif
file_mpeg.gif
file_mpg.gif
file_png.gif
file_psd.gif
file_ram.gif
file_swc.gif
file_swf.gif
file_tif.gif
file_tiff.gif
file_wav.gif
file_wbmp.gif
file_wma.gif
file_wmv.gif
file_xbm.gif
slideshow.gif
slideshow_back.gif
slideshow_next.gif
slideshow_play.gif
slideshow_stop.gif

Note: Be sure to upload the /gallery/images and /forum/cpstyles folders and their contents in Binary mode and the other files in ASCII mode.

Now you will need to chmod the /gallery/files folder to 777. Some servers may have problems if so use 755.

Step 3 - Run the Install Script

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

Once you have finished please remove vbgallery_install.php, product-ppvbgallery.xml in the forums/admincp folder.

Step 4 - Setting Your Options - Important Settings

During the installation, the script will attempt to determine your path and URL settings. If these option are blank when you get to this step then you will need to set these yourself. If you are unsure of these settings, you may find the options later by clicking on the 'Modify Settings' link under 'vBGallery' in the left frame. You will find these settings listed under the "Title, URL's, & Paths" group on this page. You must set these options (with the exception of the two FTP upload options) before you will be able to upload files.

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 'vBGallery' 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.

Upgrade

I can not stress enough. Please backup your database and files from your server before you start to upgrade the gallery.
Please replace all files on your server with the current download.

NOTE: There was a large change in the code. This is a script wide variable change. All hacks will need to be updated. (file and template usage)

$vba_options => $ppg_options please disable add-ons that pull gallery information before upgrade.

Run the install script from your browser by going to:
Code:

http://www.yourwebsite.com/forums/admincp/vbgallery_install.php

[ x ] Upgrade.

This script will make all necessary changes to your database, templates, phrases, and settings.

Once you have finished please remove vbgallery_install.php, product-ppvbgallery.xml in the forums/admincp folder.

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

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:

<?php 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 PhotoPost vBGallery 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.