Translations of this page: en bg cs de fi fr hu it ja pl ru tr zh

This is an old revision of the document!

Table of Contents

PunBB 1.3 usage

WARNING: PunBB 1.3 is still under development. DO NOT use it in production mode.

Installation

Requirements

  • A webserver (preferably Apache).
  • PHP 4.3.0 or later (PHP 5 included).
  • MySQL 4.1.2 or later, PostgreSQL 7.0 or later or SQLite 2.
    • MySQL: PunBB will not work at all with any version prior to 4.1.2.
    • PostgreSQL: PunBB 1.3 should work fine with any version greater than 7.0.
    • SQLite: PunBB 1.3 should work with any SQLite 2 version. SQLite 3 is not supported
  • A database where forum data is to be stored.

Steps to install PunBB 1.3

  1. Download the latest revision of PunBB 1.3 from the Subversion repository or Trac browser (click "Zip Archive: link in the footer).
  2. Copy/upload all contents of the directory upload/ into the directory served by your web server (e.g. /home/user/example.com/punbb/).
  3. Run install.php from the forum root directory (e.g. open http://example.com/forum/install.php in your browser). Follow the instructions.

After the forum has been created, remove PunBB’s installation script (install.php) from the forum root for security reasons and install available hotfix extensions. (You will be informed about this after logging in with admin privileges).

Please report any problems you might encounter during installation in the PunBB Forums.

After a successful installation you may wish to enable URL Rewriting" fancy URL Rewriting. For other ideas, take a look at usage#First Steps" First Steps.

Migration from 1.2.* to 1.3

Follow these instructions to migrate from your current PunBB 1.2.* installation to 1.3.

NOTE: Make a backup of your current forum directory before proceeding. Also, don't forget to make a backup of your forum database. Use the tool mysqldump for MySQL and pg_dump if you are using PostgreSQL. If you're using SQLite, just make a backup copy of the SQLite database file. You can also make database backups via most administration tools such as MySQL Administrator, phpMyAdmin and phpPgAdmin.
  1. Download PunBB 1.3 and extract the archive on your hard disk.
  2. Replace1) your old 1.2 directory with the contents of the directory upload/ of version 1.3. Keep old config.php and img/avatars dir.
  3. Open forum index and follow instructions.

You should now be running PunBB 1.3.

TODO: Move this section to PunBB 1.3 FAQ.

Installing an extension for PunBB 1.3

  1. Download an extension’s archive from the PunBB extensions repository or other place. Extract it into your forum’s extensions directory, e.g. /home/user/example.com/punbb/extensions where /home/user/example.com/punbb/ is absolute server path to your forum installation.
  2. Log into the forum and go to Administration console, Extensions section, choose Install extensions tab (http://example.com/punbb/admin/extensions.php?section=install). The downloaded extension will be listed there.
  3. Click the Install extension link to install the extension.

To manage the extensions installed in your forum, go to Extensions / Manage extensions (http://example.com/punbb/admin/extensions.php).

NOTE: You may use the pun_admin_repository extension to download and install extension with one click. (TO BE UPDATED)

Administration

Forum groups

You can create new or edit existing groups at the page <FORUM>/admin/groups.php.

Group creation

  • Choose base-group for your group.
  • Press “Add new group” button.
  • Choose permissions for new group.
  • Press “Save” button.

SEF URL's

The mechanism of SEF:

  • Request some URL
  • Server Apache read file .htaccess in the root of Forum directory. (For others servers refer to its documentation).
  • Load of rewrite.php.
  • Translation request URL in standard according to SEF rules.
  • Load needed file.

You can change URL scheme via forum administration console.

  • Go to <FORUM>/admin/settings.php?section=setup.
  • You will see URL Scheme section here.
  • Rename file ”.htaccess.dist” from Fourm root direstory to ”.htaccess”.
  • Choose URL scheme you needed and click “Save changes” button.
1) files replacing tip in PunBB Forums

Personal Tools