The following documentation was contributed by a DiscusWare customer. While the information herein has been reviewed for accuracy, it should be noted that no support is provided for the manual modification of Discus data files.
To get a
summary of access rights to each topic, you can read the"topicprv.txt"
file in discus_admin_#####\data.
The fields
are delimited by colons. The first
field represents the topic number. The
second field represents the type (p=posting, r=reading, o=options, q=queue,
cr=category). The other fields depend
on the type and are shown below. Values
in square brackets only appear if the options has been selected in Access Manager. Values in round brackets indicate that one
of the values is present. Values not
enclosed in brackets will always appear in the file.
topic#:p:[IP
address]:[groups]:[moderators]:[special password]
topic#:r:[IP
address]:[groups]:[moderators]:[special password]
topic#:o:[a][e][f][p]i(0-2)j(0-2)
topic#:q:[p][u][m][s]
[category#:cr:[topic#]:::]
p: Field is set in Access Manager > Topic
# > Posting Privileges
[IP address]: set by selecting Restricted Posting > By IP
address
[groups]: set by selecting Restricted Posting >
Registered Users
[moderators]: set by selecting Restricted Posting > Moderators
[special password]: set by selecting Restricted Posting
> With special password
r: Field is set in Access Manager > Topic
# > Reading Privileges
[IP address]: set by selecting Restricted Reading > By IP
address
[groups]: set by selecting Restricted Reading >
Registered Users
[moderators]: set by selecting Restricted Reading > Moderators
[special password]: set by selecting Restricted Reading
> With special password
o: Field is set in Access Manager > Topic
# > Posting Options
[a]: set
by enabling General Options > Disable anonymous posting
[e]: set
by enabling General Options > Disable e-mail address on post
[f]: set
by enabling General Options > Disable full name on post
[p]: set
by enabling General Options > Disable link to profile on post
i(0): set by enabling Display IP address on Posts > Never
i(1): set by enabling Display IP address on Posts > All posts
i(2): set by enabling Display IP address on Posts > Posts by the
public (Unregistered guests)
j(0): set by enabling Display IP address on Posts > Follow above
rule for IP display on anonymous posts
j(1): set by enabling Display IP address on Posts > Never display
IP address on anonymous posts
j(2): set by enabling Display IP address on Posts > Always display
IP address on anonymous posts
q: Field is set in Access Manager > Topic
# > Moderated Posting (Message Queue)
[p]: set
by enabling Queue messages posted by > The public (unregistered guests)
[u]: set
by enabling Queue messages posted by > Registered users
[m]: set
by enabling Queue messages posted by > Moderators
[s]: set
by enabling Queue messages posted by > Anyone using the "special
password"
cr: Field is set in Access
Manager > Category #
If the
"Never Displayed" option is enabled in "Access Manager
> Category # > Category Access Settings", there will be no entry
for that category in the topicprv.txt file.
[topic#]: set by selecting Category Access Settings > Displayed if
access is granted to any of these topics
Examples
from a typical "topicprv.txt" file:
75:cr:::: Category 75; Always displayed
76:cr:103:::: Category 76; Displayed if access
is granted to topic 103
103:p:::: Topic 103; All posting disabled.
103:r:*::: Topic 103; Public reading enabled.
103:o:i0j0 Topic 103; Never display IP address on posts;
Follow above rule for IP display on anonymous posts
103:q: queued messages not enabled
104:p::::es34d4e4 Topic 104; Restricted posting by special
password only (password is encrypted).
104:r::group1:mod1: Topic 104; Restricted reading by moderator
"mod1" and group "group1".
104:o:afi0j2 Topic
104; Disable anonymous posting; Disable full name on post; Never display IP
address on posts; Always display IP address on anonymous posts
104:q:s Topic 104; Queue messages posted by anyone
using the "special password"
107:p::group1,group2:: Topic 107; Restricted posting by groups
"group1" and "group2".
107:r:192.168.1.1::: Topic 107; Restricted posting by IP
102.168.1.1 only.
107:o:ai2j2 Topic
107; Disable anonymous posting; Display IP address on posts by unregistered
guests; Always display IP address on anonymous posts
107:q:ps Topic 107; Queue messages posted by unregistered
guests; Queue messages posted by anyone using the "special password"
Thanks to Charles Kingsley for contributing this documentation.