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.