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 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. Replace your old 1.2 directory with the contents of the directory upload/ of version 1.3.
  3. Copy the file db_update.php from the version 1.3 ‘extras’ folder and paste it into the root directory of version 1.2. (TO BE UPDATED)
  4. Enter the URL leading to db_update.php in the address bar of your browser and press the ‘Start update’ button in the window that has opened.
  5. Follow instructions.

You should now be running PunBB 1.3

After the installation is complete remove db_update.php from the root directory for security reasons. (TO BE UPDATED)

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 [wiki:pun_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.

Personal Tools