PN_phpBB_14 v1.7.4.0== release date:= xx/xx/2002
----------------------------------------------------------------------

1. Administration

1.1 Forums Administration
This is where you can administer your phpBB_14 forums.

1.1.1 phpBB_14

Forum Wide Options allows you to:
a. Configure who you want the email to come from when someone subscribes to a topic and gets an email showing a new post.
b. Set the Character Set that will be used in the e-mail headers.
c. Set the -Hot Topics- threshold.
d. Set the number of posts per topic that will be displayed per page.
e. Set the number of topics displayed per page in a given forum.
f. Set the path to the image graphics used in phpBB_14.
'Sync':
Allows you to synchronize the PN users, forums and topics indexes to fix any discrepancies that might exist.

1.1.3 Add a Category
Categories are the top level of the individual forums.
'Add':
After clicking on 'Add', you will be give a space to type in the name of your new category. Click 'Submit' when done entering your text.
'Edit':
This will allow you to 'Edit' or 'Delete' any categories that have been previously made.
'Re-Order':
Allows you to re-order the Categories.
'Delete':
This will allow you to 'Edit' or 'Delete' any categories that have been previously made.

1.1.4 Add a Forum:
Forums are the various 'sub-categories' that your individual discussion will be kept in.
'Add':
After clicking on 'Add', you will be give a space to type in the name and description of your new Forum. Highlight who you want to moderate this Forum and which Category you want the forum to be in. Note that the PostNuke 'Permissions' must still be set correctly for the 'moderator'. Click 'Submit' when done entering your text.
'Edit':
This will allow you to 'Edit' or 'Delete' any Forums that have been previously made.
'Re-Order':
Allows you to re-order the Forums within individual Categories
'Delete':
This will allow you to 'Edit' or 'Delete' any Forumsthat have been previously made.

1.1.5 Users Ranks
You have the ability to create various 'Ranks' for users based on the number of posts they generate.
'Add':
After clicking on 'Add', you will be give a space to type in the name and description of a new User Rank.
'Edit':
This will allow you to 'Edit' or 'Delete' any Users Ranks that have been previously made.
'Delete':
This will allow you to 'Edit' or 'Delete' any Users Ranks that have been previously made.

1.1.6 Honorary Ranks
You have the ability to create 'Ranks' for special members. This could be 'Webmaster', 'Associate', 'Client', etc.
'Add':
After clicking on 'Add', you will be give a space to type in the name and description of a new Honorary Rank.
'Edit':
This will allow you to 'Edit' or 'Delete' any Honorary Ranks that have been previously made.
'Assign':
This will allow you to 'Assign' any Honorary Ranks that have been previously made.
'Delete':
This will allow you to 'Edit' or 'Delete' any Honorary Ranks that have been previously made.

1.1.7 Bad Words Filtering
'Add':
Here you can add/edit/delete bad words that will be filtered and replaced with others on your site
'Edit':
Here you can add/edit/delete bad words that will be filtered and replaced with others on your site
'Delete':
Here you can add/edit/delete bad words that will be filtered and replaced with others on your site

1.2 Using PostNuke permissions with the phpBB_14 bulletin board.
This chapter assumes that you already know Rogue permissions principles.
phpBB_14 implements four levels/instances of controlling access rights to the module.
These are:
Category
Forum
StatsBlock
You are therefore able to control how a user or a user group may use your forum.
Note: Earlier versions of phpBB_14 had the option of setting a forumtype to be 'private|public'. This option is not used any more. Only Rogue permissions will be checked when accessed.

This is also correct regarding moderator access to forums and categories. Moderator access is checked against MODERATE_ACCESS in PostNuke permission system for any given user or group. Setting the moderator parameter inside phpBB_14 administration panel, is not currently in use. The parameter will be deprecated in future versions.

Following are some examples on how to use the PostNuke 0.71x permission system in the phpBB_14 module. We will use these names in the examples to give you a "realworld" examples:
Category: General
Forum: Chitchat and discussion
Usergroup: Mygroup
User: JimDude


EXAMPLE 1.
Cut off Unregistered users from accessing private forum. Unregistered users will not even see that a private forum exists.
Go to Administration/Permissions/New group permission

Group Component Instance Permissions level
Unregistered phpBB_14::Forum Chitchat:: None

Because upper lines override lower, the newly created group permission should be above this line:
Group Component Instance Permissions level
Unregistered .* .* Read


EXAMPLE 2.
Cut off Unregistered users to a whole category. All forums inside the category will be inaccessible.

Group Component Instance Permissions level
Unregistered phpBB_14::Category General:: None

Because upper lines override lower, the newly created group permission should be above this line:
Group Component Instance Permissions level
Unregistered .* .* Read


EXAMPLE 3.
Let Unregistered users view forums in a category, but not post or reply to posts.
(as the smart eye sees, dropping the following line, will cause unregistered users to have read-access to all categories)

Group Component Instance Permissions level
Unregistered phpBB_14::Category General:: Read

Because upper lines override lower, the newly created group permission should be above this line:
Group Component Instance Permissions level
Unregistered .* .* Read


EXAMPLE 4.
Let a closed Usergroup access all forums in a category. All users not in this group fully cut off.

The first thing to do is to create the Usergroup and populate it with users (we will not show how to do this here).

Group Component Instance Permissions level
Mygroup phpBB_14::Category General:: Edit
All groups phpBB_14::Category General:: None

Because upper lines override lower, the newly created group permissions should be above BOTH of these lines:
Group Component Instance Permissions level
Users .* .* Comment
Unregistered .* .* Read


EXAMPLE 5.
Assign moderator rights to a specific user. This is done in two parts.
First you have to define the user as a moderator of the forum, using the phpBB_14 admin pane. (Note, this is only for viewing purposes in the forums at this time...)
Next, you have to give the same user moderator rights in the PostNuke
permission system. This is done using this scheme:

User Component Instance Permissions level
JimDude phpBB_14::Forum Chitchat:: Moderate

NB! Be very careful of using USER permissions. They will always override any group permissions. If you do something wrong, you may end up shutting your self out! Always use other usernames that your ADMIN name, when playing around with user permissions!!


EXAMPLE 6.
Assign a user to be moderator for two forums.
This is done in two parts. First you assign the user as moderator to both the forums, using the phpBB_14 admin pane.
Next, you have to give the same user moderator rights in the PostNuke permission system. This is done using this scheme:

User Component Instance Permissions level
JimDude phpBB_14::Forum (ChitChat|discussion):: Moderate

Note:
Be very careful when using USER permissions. They will always override any group permissions. If you do something wrong, you may end up shutting your self out! Always use other usernames than your ADMIN name, when playing around with user permissions!!

We also suggest looking at the PostNuke permissions documentation:
http://centre.ics.uci.edu/~grape/modules.php?op=modload&name=Wiki&file=index&pagename=PERMISSIONS

----------------------------------------------------------------------
1.3 Setting up Statistics block

You can activate and place this block, using standard Rogue Blocks administrating.
Create a new block of type 'phpBB_14/phpBB_14 Statistics'. Configure it to with the PostNuke 'Edit' feature to meet your needs.
Also see 2.3.5

----------------------------------------------------------------------
1.4 Setting up Search Include

The search routine for phpBB_14 is included in the module core and needs no special set-up to be used with PostNuke.