- •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
2
Installing and Configuring vBulletin
In this chapter we begin at the point where most people begin with vBulletin—with a copy of the software and somewhere to upload it to. If you have both of those, then you are probably eager to get going with the installation!
We will look at:
•The requirements of vBulletin
•How to install the files
•How to create the database
•How to troubleshoot installation problems
•How to configure vBulletin
•How to administer the default usergroups
•How to secure vBulletin
•How to get help and support
Requirements
The requirements to run vBulletin are pretty straightforward, and even the basic shared hosting available nowadays for a few dollars a month should allow you to upload, install, configure, and run vBulletin.
Basic requirements are:
•MySQL database support
•PHP support
If your host claims to support these, then you have a good chance of being able to run vBulletin. Now you need to look in a little more detail at what your host offers.
Installing and Configuring vBulletin
Detailed requirements for vBulletin are:
•PHP 4.0.6 (latest version recommended to reduce security loopholes, improve performance, and maintain best compatibility with future upgrades)
•MySQL 3.23.33 minimum (4.0.16 or later recommended)
•Operating system: BSD, Solaris, Linux, Windows
Disk Space
Disk space is an important consideration. By 'disk space' I mean the amount of space you are given on the server to host your site and the associated databases.
Disk space is a requirement that is harder to predict. Initially, you will be able to get away with a small amount of space, say 50 Mb. However, over time, the posts in your forum will add significantly to this. All you can do is estimate how busy your forum will be and judge how much space you need from that.
For example, if you think that your forum will generate about 100 posts a day, then that's 36,500 posts a year. On average, this number of posts will take up about 75 Mb of room. If you think that your discussion board will generate 200 posts a day, then you'll need at least 150 Mb of space. 400 posts a day means 146,000 posts a year and an approximate disk consumption of around 300 Mb.
Points to note about disk space
Remember that these figures are average figures. If your site regularly has large posts (in terms of text content) or users are able to attach a lot of attachments to posts, then these figures could rise significantly.
Another point to note is that posts are stored in the database. Different hosts handle disk space versus database space differently, so make sure you know in advance how much disk space and database space you have.
Bandwidth
Bandwidth is the amount of data transfer that your site has. Each time a page is called up by a browser, data extracted from a database or an image retrieved, this adds to your site's bandwidth usage.
For convenience, almost all hosts measure bandwidth over a period of a month in megabytes or gigabytes, so one hosting plan might give you 100 Mb of monthly bandwidth while another might give you 50 Gb. The more bandwidth you have, the more you usually pay and the more room your site has to expand.
Judging how much bandwidth a discussion board will need is tricky for a number of reasons. Yes, it depends on the number of users and the number of posts made, but it also depends on other, harder-to-measure factors. These include:
14