phpBB: A User Guide

Table of Contents

phpBB:A User Guide

Credits

About the Authors

Preface

What This Book Covers

Conventions

Reader Feedback

Customer Support

Downloading the Example Code for the Book

Errata

Questions

1. Introduction to phpBB

Online Communities

Building the Community—The Tools

The Name

The Environment

Why phpBB?

History

Development

Example phpBB Sites

A Standard phpBB Layout

Standard Sites with Different Templates

Sites with Standard Style and Modified Features

GaiaOnline

Summary

2. Installing and Configuring phpBB

Pre-Installation

Requirements

The Attack Plan

Time For Action—Setting Up the Environment on Your Local Computer

Finishing Pre-Install Touch—The Database

Setting Up the Database for Local Installations

Time For Action—Creating the Forum Database with phpMyAdmin

What Just Happened

Time For Action—Creating the Forum Database Using the Command Prompt

Setting Up the Database for Remote Installations

phpBB Pre-Installation Checklist

Installation

Troubleshooting the Installation

Symptom

Reason

Solution

Symptom

Reason

Solution

Symptom

Reason

Solution

Symptom

Reason 1

Solution

Reason 2

Solution

Symptom

Reason 1

Solution

Reason 2

Solution

Time For Action—Deleting phpBB Tables using phpMyAdmin

Time For Action—Deleting phpBB Tables Using the Command Prompt

Post-Installation Tasks

Time For Action—Deleting Unneeded Directories

What Just Happened?

Basic Configuration

Time For Action—Initial Configuration Using the Administration Panel

What Just Happened?

Setting Up the avatars Directory

Security Tips

Administrator Password

Disallow Remote Connections to the Database

MySQL Account

config.php

.htaccess Protection for the Administration Panel

Finding Help

Summary

3. User Experience: Visitors

Overview

Registration

Step 1

Step 2

Step 3

Logging In

Editing Your Profile

Time For Action—Creating and Editing The Dude Profile

What Just Happened?

Posting

Anatomy of a Posting

Replying

Starting a New Topic

Formatting a Posting

Time For Action—Formatting a Post

What Just Happened

Editing a Posting

Deleting a Posting

Searching

Sending and Receiving Private Messages (PM)

Time For Action—The Dude PMs the Administrator

What Just Happened?

Voting in Polls

Staying Current with the Topics

Viewing Information about Other Users

Memberlist

Usergroups

Who Is Online

4. UserExperience: Moderators and Administrators

Moderator Experience

Time For Action—Assigning Moderator Privileges to a User

What Just Happened?

Managing Postings

Editing and Deleting

Editing the First Posting in a Topic

Viewing Poster’s IP Address

Managing Topics

Deleting, Locking, and Unlocking Topics

Moving Topics

Time For Action—Creating a Forum

What Just Happened?

Splitting Topics

Doing It All Together—The Moderator Control Panel

Administrator Experience

Administration Panel Overview

Forum Admin

Forum Management

Creating New Forums and Categories

Time For Action—Creating a New Category

What Just Happened

Time For Action—Creating a New Forum

What Just Happened

Fine Tuning Existing Forums and Categories

Editing

Deleting

Changing Display Order

Time For Action—Tweaking Display Order

What Just Happened

Using the Resync Options

Who Can Do What—Setting Up Forum Permissions

Time For Action—Setting Forum Permissions in Simple Mode

What Just Happened?

Pruning

Time For Action—Pruning a Forum

What Just Happened?

Systems Administration Using General Admin Options

Configuration

Database Backup and Restore

Time For Action—Backing Up Your Board Data

What Just Happened

Time For Action—Restoring Your Database from a Backup Copy

What Just Happened

Mass Email

Smilies

Filtering Words Using Word Censors

Time For Action—Creating a Word Filter

What Just Happened

Introduction to User Management

Editing User Profiles

Deleting Users

Permissions

Banning Users

Disallowing Users

Summary

5. Customizing Your Forum

phpBB Styles

Structure of a Style

Style Elements

Style Storage

Editing phpBB Files

Installing a New Style

Creating a Copy Style

Time For Action—Creating a Copy Style

What Just Happened?

Installing One Element at a Time

Troubleshooting

Style Does Not Appear in Administration

Configuration File Cannot Be Opened

Removing an Installed Style

Create or Customize

Customizing through the Stylesheet

Editing the Stylesheet in the Admin Panel

Time For Action—Editing the Stylesheet

What Just Happened?

Editing Other Theme Components

Allowed Values

Commonly Used and Altered Elements

Table Cell Colors

Font Colors

Changing CSS Styles to Change the Look of Your Site

Using External Stylesheets

Customizing through Images

Installing New Images to Change the Look of Your Site

Hacking phpBB

MODs and Hacks

phpBB Modification

Installing a Modification

Time For Action—Installing a Small Modification

What Just Happened?

Installing a Downloaded Modification

The Copy Action

The SQL Action and Editing the Database

The Open Action

The Find Action

The Addition Actions

The In-Line Actions

The Last Action

The Trouble with Templates

Uninstalling Modifications

Time For Action—Uninstalling a Small Modification

What Just Happened?

Removing Other Changes

Example Modifications

Moving Elements

Adding New Elements to Your Forum

Time For Action—Adding a Menu Link

What Just Happened?

Adding New Languages

Summary

6. Forum Administration

Making Your Board Multi-Lingual

Time For Action—Adding Spanish Support to Your Forum

What Just Happened?

Avatars: Enabling and Configuring

Managing Smilies

Smilies’ Properties

Smilies Administration Panel

Editing or Deleting a Smilie

Adding New Smilies

Time For Action—Adding a New Smilie Using an Existing Image

What Just Happened?

Time For Action—Adding a Custom Smilie

What Just Happened?

Adding Smilies with a .pak File

Time For Action—Adding Smilies Using a .pak File

What Just Happened?

Creating a .pak File

Time For Action—Creating a .pak File

What Just Happened?

Assigning Ranks

Time For Action—Creating Automatic Ranks

What Just Happened?

Time For Action—Creating and Assigning a Special Rank

What Just Happened?

Understanding Forum Permissions

Permission Types and Permission Levels

Simple and Advanced Mode of Setting Permissions

Time For Action—Creating and Fine-Tuning a Private Forum

What Just Happened

Understanding User Permissions

Time For Action—Making The Dude a Private User of The Dudes Forum

What Just Happened?

Usergroups and Group Permissions

Time For Action—Creating a New Group

What Just Happened?

Time For Action—Editing a Group

What Just Happened?

Group Permissions

Time For Action—Setting Group Permissions

What Just Happened?

Second Look into Database Backups and Restore

Using phpMyAdmin

Time For Action—Creating an SQL Database Dump

What Just Happened?

Using MySQL Command-Line Tools

Creating Backups with mysqldump

Using the mysql Utility to Restore a Database

Time For Action—Creating a Database Copy from a SQL Dump

What Just Happened?

Other Tools

The Board’s Human Side: Flamewars and Banning

Index

phpBB: A User Guide

Stoyan Stefanov

Jeremy Rogers

phpBB:A User Guide

Copyright © 2006 Packt Publishing

All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, without the prior written permission of the publisher, except in the case of brief quotations embedded in critical articles or reviews.

Every effort has been made in the preparation of this book to ensure the accuracy of the information presented. However, the information contained in this book is sold without warranty, either express or implied. Neither the authors, Packt Publishing, nor its dealers or distributors will be held liable for any damages caused or alleged to be caused directly or indirectly by this book.

Packt Publishing has endeavored to provide trademark information about all the companies and products mentioned in this book by the appropriate use of capitals. However, Packt Publishing cannot guarantee the accuracy of this information.

First published: January 2006

Published by Packt Publishing Ltd.

32 Lincoln Road

Olton

Birmingham, B27 6PA, UK.

ISBN 1-904811-91-4

www.packtpub.com

Cover Design by www.visionwt.com

This book is an abridged version of Building Online Forums with phpBB 2, (ISBN 1904811132), focussing on a complete set of topics to get your phpBB installation up and running, and then showing you how to manage and modify your forum.

Credits

Authors

Stoyan Stefanov

Jeremy Rogers

Reviewers

Stefan Koopmanschap

Patrick O’Keefe

Technical Editor

Niranjan Jahagirdar

Editorial Manager

Dipali Chittar

Development Editor

Douglas Paterson

Indexer

Niranjan Jahagirdar

Proofreader

Chris Smith

Production Coordinator

Manjiri Nadkarni

Cover Designer

Helen Wood

About the Authors

Stoyan Stefanov is a web developer and a project manager from Montreal, Canada. He has studied in the Technical University of Sofia, Bulgaria, and McGill University, Montreal. He is a Zend Certified Engineer, with more than five years of professional web-development experience and has worked on award-winning websites for companies of all sizes—from multinational corporations to two-man startups.

He volunteers his spare time administering and programming a Bulgarian-speaking phpBB-powered online community, and contributing to the PHP community through code and articles.

Jeremy Rogers has been developing web-based applications in PHP and other languages for a little more than six years. Shortly after discovering phpBB in early 2002 and deploying it on a video-game website, he began tinkering with and learning about the internal workings of the software. Since then, he has authored dozens of expansions and tutorials related to phpBB. Jeremy currently serves the phpBB community as a phpBBHacks.com Support Team member, a capacity in which he has answered thousands of questions regarding the software, its applications, and related topics.

I would like to thank Patrick O’Keefe, for opening the doors to a wide world that led me here.

Preface

phpBB is a free, open-source Internet community application, with outstanding discussion forums and membership management. Written in the PHP scripting language, and making use of the popular MySQL database, phpBB is a standard among web-hosting companies throughout the world, and is one of the most widely used bulletin-board packages in the world. phpBB short-circuits the need for you to be a web development master in order to create and manage massive online communities.

This book is an abridged version of Building Online Forums with phpBB 2, (ISBN 1904811132), focusing on a complete set of topics to help you set up and run your own phpBB-powered online community. In easy to follow language and with clear instructions, you will learn how to install your own system, tackle basic forum administration tasks, and customize the forum.

What This Book Covers

The book starts with an overview of phpBB and online communities.Chapter 1 also gives some background information to phpBB, and gives you an idea of what you can achieve with phpBB with some real-life examples of phpBB-powered communities.

Chapter 2 walks you through a full installation of phpBB, including the necessary preparation work and post-installation tasks. It also looks at configuring the installation, and troubleshooting tips to get you started with your new forum and online community as quickly as possible.

After you are set up and running,Chapter 3 andChapter 4 dive straight into the phpBB environment, familiarizing you with the basics of configuring your site, creating forums and users, and introducing you to the basics of phpBB administration. In order to fully understand the different features and their administration, the chapter starts with a tour of phpBB from the user and administrator points of view.

Chapter 5 looks at some more ways to customize your forum’s appearance and features. Making these customizations is essential to giving your community a unique identity that makes it stand out among other online forums. The appearance of a forum is mainly controlled by phpBB’s styling system, which manages the colors, images, and visual layout of the forum. In this chapter, you will learn about the basics of a phpBB 2.0 style, adding and removing styles, fixing common style installation problems, customizing styles, and adding new features, including modifications, to the forum.

Chapter 6 completes your mastery of phpBB administration. You will learn about making your board multi-lingual, configuring avatars, managing smilies, forum, user, and group permissions, as well as the human side of forum administration—moderation, flamewars, and banning.

Conventions

In this book, you will find a number of styles of text that distinguish between different kinds of information. Here are some examples of these styles, and an explanation of their meaning.

There are three styles for code. Code words in text are shown as follows: We can include other contexts through the use of the include directive.

A block of code will be set as follows:

CREATE TABLE phpbb_tracker (

tracker_id mediumint(8) DEFAULT ‘0’ NOT NULL,

tracker1 tinyint(1) DEFAULT ‘0’ NOT NULL,

tracker2 varchar(40) NOT NULL,

PRIMARY KEY (tracker_id),

);

When we wish to draw your attention to a particular part of a code block, the relevant lines or items will be made bold:

CREATE TABLE phpbb_tracker (

tracker_id mediumint(8) DEFAULT ‘0’ NOT NULL,

tracker1 tinyint(1) DEFAULT ‘0’ NOT NULL,

tracker2 varchar(40) NOT NULL,

PRIMARY KEY (tracker_id),

);

Any command-line input and output is written as follows:

mysqldump -u dbuser -pdbpass forums > mydump.sql

New terms and important words are introduced in a bold-type font. Words that you see on the screen, in menus or dialog boxes for example, appear in our text like this: clicking the Next button moves you to the next screen.

Note

Warnings or important notes appear in a box like this.

Tip

Tips and tricks appear like this.

Reader Feedback

Feedback from our readers is always welcome. Let us know what you think about this book, what you liked or may have disliked. Reader feedback is important for us to develop titles that you really get the most out of.

To send us general feedback, simply drop an e-mail to <[email protected]>, making sure to mention the book title in the subject of your message.

If there is a book that you need and would like to see us publish, please send us a note in the SUGGEST A TITLE form on www.packtpub.com or e-mail .

If there is a topic that you have expertise in and you are interested in either writing or contributing to a book, see our author guide on www.packtpub.com/authors.

Customer Support

Now that you are the proud owner of a Packt book, we have a number of things to help you to get the most from your purchase.

Downloading the Example Code for the Book

Visit http://www.packtpub.com/support, and select this book from the list of titles to download any example code or extra resources for this book. The files available for download will then be displayed.

Note

The downloadable files contain instructions on how to use them.

Errata

Although we have taken every care to ensure the accuracy of our contents, mistakes do happen. If you find a mistake in one of our books—maybe a mistake in text or code—we would be grateful if you would report this to us. By doing this you can save other readers from frustration, and help to improve subsequent versions of this book. If you find any errata, report them by visiting http://www.packtpub.com/support, selecting your book, clicking on the Submit Errata link, and entering the details of your errata. Once your errata have been verified, your submission will be accepted and the errata added to the list of existing errata. The existing errata can be viewed by selecting your title from http://www.packtpub.com/support.

Questions

You can contact us at <[email protected]> if you are having a problem with some aspect of the book, and we will do our best to address it.

Chapter 1. Introduction to phpBB

An online bulletin board in essence is an Internet-enabled version of the bulletin boards found in stores and other public areas. It’s basically just a place where people leave messages for others to read. Well, the online bulletin board applications have become much more powerful and sophisticated than that, but the