- •Table of Contents
- •Preface
- •What This Book Covers
- •Conventions
- •Reader Feedback
- •Customer Support
- •Downloading the Example Code for the Book
- •Errata
- •Questions
- •What is vBulletin?
- •Why Have a Discussion Board?
- •Benefits of a Discussion Board
- •Why vBulletin?
- •History
- •Development
- •The vBulletin Advantage
- •Versatile
- •Performance
- •Customizable
- •Easy to Maintain
- •Other Features
- •vBulletin Licensing Options
- •Leased License
- •Owned License
- •Choosing a License
- •Example vBulletin Sites
- •Summary
- •Requirements
- •Disk Space
- •Bandwidth
- •System Resources
- •Shared Hosting
- •Semi-Dedicated Hosting
- •Dedicated Hosting
- •Other Options
- •Installing vBulletin
- •Tools
- •Downloading the Installation Files
- •File Extraction
- •Upload Preparation
- •Creating the Database
- •Command-Line Database Creation
- •cPanel Database Creation
- •File Editing
- •Uploading the vBulletin Files
- •Running the vBulletin Installation Script
- •Troubleshooting
- •Database Access Issues
- •Images/Styling Not Showing
- •PHP Errors
- •The vBulletin Control Panel
- •Importing Data into vBulletin
- •Downloading the ImpEx Script
- •Compatibility
- •Preparing for Upload
- •Editing the Configuration File
- •Upload the ImpEx Script
- •Running the ImpEx Script
- •Default Usergroups
- •Securing vBulletin
- •Help & Support
- •Summary
- •The vBulletin User Experience
- •How to Get to the Board?
- •What the End Users See
- •Site Logo
- •Forum Title, Login Box, and Navbar
- •Welcome Banner
- •Main Body of the Forum
- •What's Going On
- •Footer
- •Touring the Main Forum—Unregistered Users
- •No "New Threads" for Unregistered Users
- •Registering on a vBulletin Board
- •Touring the Forum—Members
- •New Threads
- •Replying
- •Editing a Message
- •Private Messages
- •BB Code
- •User Tools
- •Display Modes
- •Navbar Changes for Members
- •The vBulletin Administrator Experience
- •Forum and Thread Tools
- •The AdminCP
- •Control Panel Home
- •Latest Version Information
- •vBulletin Options
- •Forum Management
- •Editing and Adding Forums
- •Editing Existing Forums
- •Moderation Options
- •Forum Styling
- •Access Control Options
- •Forum Posting Options
- •Enable/Disable Features
- •Branding
- •Changing the Logo
- •Undoing the Change
- •Summary
- •Types of Customization
- •CSS Modifications
- •Changing the Table Title Text
- •Viewing Changes
- •Undoing the Changes
- •Phrase Modifications
- •Searching for Phrases
- •Making Changes
- •Viewing the Changes
- •Undoing Changes
- •Template Modifications
- •Accessing Templates
- •Exploring a Template
- •Template Structure
- •Adding a FORUMHOME Sidebar
- •Two Changes
- •PHP Code Modifications
- •PayPal Modification
- •File Modification
- •Hacks
- •Pros and Cons of Hacking a vBulletin Board
- •Finding a Hack
- •Installing a Hack
- •Backing Up a Hack
- •Commercial Hacks
- •Summary
- •Setting Up a Forum
- •Creating the Forum
- •Forum Permissions
- •Viewing Permissions
- •Opening the Forum
- •Super Administrators
- •Creating a Super Administrator
- •Other Changes to the config.php File
- •Admin Log Viewing Permission
- •Admin Log Pruning Permission
- •Query Running Permission
- •Undeletable and Unalterable Users
- •Maintaining the Database
- •Backing Up the Database
- •Repairing and Optimizing the Database
- •Some Maintenance Issues
- •Smilies
- •Editing a Smilie
- •Adding a New Smilie
- •Uploading a Smilie
- •Creating Your Own Smilies
- •Avatars
- •Adding Avatars
- •Storing Avatars
- •Summary
- •When to Upgrade
- •Preparing for Upgrade
- •Migrating Changes
- •File Compare Utilities
- •Uploading the Files
- •Running the Upgrade Script
- •Testing the Upgrade
- •Unveiling the Upgrade
- •Summary
- •Styling vBulletin
- •Template Lifecycles
- •Lifecycle 1—Constant Change
- •Lifecycle 2—Working Behind the Scenes
- •Editing the Default Style
- •Changing Image Paths
- •Other Editable Elements
- •Some Tips about Editing Styles
- •Adding a New Style
- •Editing the Style
- •Saving the Style
- •Downloading the Style
- •Making the New Style into the Default
- •Distributing a Style
- •Installing a New Style
- •Summary
- •Hacking vBulletin
- •Making the Changes
- •Locating the Template
- •Hacking the pm_newpm Template
- •Testing the Hack
- •Hack Distribution
- •Tips for Hack Distribution
- •Plugins and Products
- •Getting Plugins and Products
- •Adding a Product
- •Adding a Plugin
- •What If Things Go Wrong?
- •Summary
- •Default Usergroup Settings
- •(COPPA) Users Awaiting Moderation
- •Administrators
- •Moderators
- •Registered Users
- •Super Moderators
- •Unregistered / Not Logged In
- •Users Awaiting Email Confirmation
- •Banned Users
- •Default vBulletin Database Tables
- •Moving Servers in Six Easy Steps
- •Cookie Check
- •Back up Database
- •Download the vBulletin Files
- •Transfer to New Server
- •Database Restoration
- •Back Online
- •Graphics
- •Global Post Text Find and Replace
- •Programming Standards
- •Braces
- •Indenting
- •Give Operators Space
- •String Quoting
- •Return Values
- •SQL Queries
- •Naming Conventions for Functions
- •Summary
- •vBulletin Directory Structure
- •Notes
- •Official vBulletin Sites
- •Main vBulletin Hack Site
- •vBulletin Styles and Templates
- •vBulletin Add-Ons
- •Index
9
Programmer's Reference
This chapter has information that you may need if you are going to delve deeper into your vBulletin installation, and make changes, tweaks, and other hacks.
In this chapter we will look at:
•The settings for the default usergroups
•The default database tables created by a vBulletin installation
•How to migrate to a new server
•How graphics work in vBulletin
•How to find and replace text in posts
•Some tips on how to program for vBulletin
Default Usergroup Settings
vBulletin comes pre-configured with seven default usergroups and one custom usergroup.
Default Usergroups
(COPPA) Users Awaiting Moderation
Administrators
Moderators
Registered Users
Super Moderators
Unregistered / Not Logged In
Users Awaiting Email Confirmation
Custom Usergroup
Banned Users
Here are the default usergroup settings for these usergroups.
Programmer's Reference
(COPPA) Users Awaiting Moderation
Viewable on Show Groups |
No |
Birthdays Viewable |
No |
Viewable on the Memberlist |
No |
Allow Users to have Member Groups |
Yes |
This Usergroup is a 'Banned' Group |
No |
Can 'See' Users Who Have Chosen to be Invisible While Online |
No |
Can View Member Info |
Yes |
Can Edit Own Profile |
Yes |
Can Set Self to Invisible Mode |
No |
Show edited by note on edited messages? |
No |
Can Use Custom Title |
No |
Can Use Signatures |
No |
Can View Others' Profile Pictures |
No |
Can View Private Custom Fields |
No |
Can View Forum |
Yes |
Can View Others' Threads |
Yes |
Can See Deletion Notices |
No |
Can Search Forums |
Yes |
Can Use Email to Friend |
Yes |
Can Download Attachments |
No |
Can Post Threads |
No |
Can Reply to Own Threads |
No |
Can Reply to Others' Threads |
No |
Can Edit Own Posts |
No |
Can Delete Own Posts |
No |
Can Move Own Threads |
No |
Can Open / Close Own Threads |
No |
Can Delete Own Threads |
No |
Always Moderate This Group's Posts |
No |
Can Rate Threads |
No |
Can Upload Attachments |
No |
Space (in bytes) that a user's total attachment usage may consume |
0 |
Can Post Polls |
No |
|
|
180 |
|
|
|
Chapter 9 |
|
|
|
|
Can Vote on Polls |
No |
|
Can Upload Custom Avatars |
No |
|
Custom Avatar Maximum Width (pixels) |
80 |
|
Custom Avatar Maximum Height (pixels) |
80 |
|
Custom Avatar Maximum File Size (bytes) |
20000 |
|
Can Upload Profile Pictures |
No |
|
Profile Picture Maximum Width (pixels) |
100 |
|
Profile Picture Maximum Height (pixels) |
100 |
|
Profile Picture Maximum File Size (bytes) |
65535 |
|
Maximum Stored Messages |
50 |
|
Can Use Message Tracking |
No |
|
Can Deny Private Message Read Receipt Request |
No |
|
Maximum Recipients to Send PMs at a time |
0 |
|
Can View Calendar |
No |
|
Can Post Events |
No |
|
Can Edit Own Events |
No |
|
Can Delete Own Events |
No |
|
Can View Others' Events |
No |
|
Can View Who's Online |
No |
|
Can View Detailed Location Info for Users |
No |
|
Can View IP Addresses |
No |
|
Can View Detailed Location Info of Users Who Visit Bad / No Permission Locations |
No |
|
Can view actual location of user (filepath/url) |
No |
|
Can Use Reputation |
No |
|
Can Leave Negative Reputation |
No |
|
Can See Who Left User Ratings |
No |
|
Can Hide Reputation from Others |
No |
|
Can View User Notes About Self |
No |
|
Can Manage User Notes About Self |
No |
|
Can Post User Notes About Self |
No |
|
Can View User Notes About Others |
No |
|
Can Manage User Notes About Others |
No |
|
Can Post User Notes About Others |
No |
|
Can Manage Own User Notes |
No |
|
|
|
|
|
181 |
Programmer's Reference
Notes that this User Has Posted, for Self or Others (This will override the above manage permissions, |
No |
if enabled) |
|
User Notes Can Be Posted About This Group |
No |
Can Moderate All Forums (is Super Moderator) |
No |
Can Access Control Panel (is Administrator) |
No |
|
|
Administrators
Viewable on Show Groups |
Yes |
Birthdays Viewable |
Yes |
Viewable on the Memberlist |
Yes |
Allow Users to have Member Groups |
Yes |
This Usergroup is a 'Banned' Group |
No |
Can 'See' Users Who Have Chosen to be Invisible While Online |
Yes |
Can View Member Info |
Yes |
Can Edit Own Profile |
Yes |
Can Set Self to Invisible Mode |
Yes |
Show edited by note on edited messages? |
Yes |
Can Use Custom Title |
Yes |
Can Use Signatures |
Yes |
Can View Others' Profile Pictures |
Yes |
Can View Private Custom Fields |
Yes |
Can View Forum |
Yes |
Can View Others' Threads |
Yes |
Can See Deletion Notices |
Yes |
Can Search Forums |
Yes |
Can Use Email to Friend |
Yes |
Can Download Attachments |
Yes |
Can Post Threads |
Yes |
Can Reply to Own Threads |
Yes |
Can Reply to Others' Threads |
Yes |
Can Edit Own Posts |
Yes |
Can Delete Own Posts |
Yes |
Can Move Own Threads |
Yes |
Can Open / Close Own Threads |
Yes |
|
|
182 |
|
|
|
Chapter 9 |
|
|
|
|
Can Delete Own Threads |
Yes |
|
Always Moderate This Group's Posts |
No |
|
Can Rate Threads |
Yes |
|
Can Upload Attachments |
Yes |
|
Space (in bytes) that a user's total attachment usage may consume |
0 |
|
Can Post Polls |
Yes |
|
Can Vote on Polls |
Yes |
|
Can Upload Custom Avatars |
Yes |
|
Custom Avatar Maximum Width (pixels) |
80 |
|
Custom Avatar Maximum Height (pixels) |
80 |
|
Custom Avatar Maximum File Size (bytes) |
20000 |
|
Can Upload Profile Pictures |
Yes |
|
Profile Picture Maximum Width (pixels) |
100 |
|
Profile Picture Maximum Height (pixels) |
100 |
|
Profile Picture Maximum File Size (bytes) |
65535 |
|
Maximum Stored Messages |
50 |
|
Can Use Message Tracking |
Yes |
|
Can Deny Private Message Read Receipt Request |
Yes |
|
Maximum Recipients to Send PMs at a time |
5 |
|
Can View Calendar |
Yes |
|
Can Post Events |
Yes |
|
Can Edit Own Events |
Yes |
|
Can Delete Own Events |
Yes |
|
Can View Others' Events |
Yes |
|
Can View Who's Online |
Yes |
|
Can View Detailed Location Info for Users |
Yes |
|
Can View IP Addresses |
Yes |
|
Can View Detailed Location Info of Users Who Visit Bad / No Permission Locations |
Yes |
|
Can view actual location of user (filepath/url) |
Yes |
|
Can Use Reputation |
Yes |
|
Can Leave Negative Reputation |
Yes |
|
Can See Who Left User Ratings |
Yes |
|
Can Hide Reputation from Others |
Yes |
|
Can View User Notes About Self |
Yes |
|
|
|
|
|
183 |