# If you want to add users in bulk to DBabble's internal database, fill in this file 
# with the user list and type "dbabblesvr -addusers"
# ---
# If user names already exist, new entries will be ignored (unless you use "dbabblesvr -setusers")
# ---
# Syntax is username [field_name=field_value [field_name=field_value]] ...
# everything is optional apart from username. 
# If you do not specify an initial password for new users, it defaults to the same as their user name.
# If you do not specify an initial display name for new users, it defaults to be same as their user name.
# If field values need to contain spaces, you can enclose them in quotes (")
# ---
# For a list of valid field names, see user_fields.dat
# ---
# To assign a user to belong to a user group, first create the user group from within DBabble, 
# and record the user group id, then add the field "ugroups=ugid[,ugid...]". 
# The user will be added to the user group with permissions the same as the user group default members.
# ---
# To assign a user to belong to a discussion group or chat room, first create the group from within DBabble, 
# and record the group id from the modifying page for that group, then add the field "groups=gid[,gid...]". 
# The user will then be subscribed to the discussion group or chat room.
# ---
# To assign some users to be in the users friends list, add a comma separated list of friend user names, which must already exist.
# If you need to assign friends that will be created later in this same file, run the command a second time using -setusers
# For example "friends=test1,test2"
# ---
# This takes about 1 second per 10 users.
# If you uncomment the following line, it will take about 1 second per 1000 users, but newly created users will not have thier friends list initialised, or be subscribed to default groups, or receive initial broadcast instant messages.
#do_fast
# ---
# ---
# For example (remove starting # and space to use)

# test100 pass=testpass display="test 100" email=test100@test.com permissions=1

# If you have forgotten a password, you could use something like this to reset it:

# test101 pass=testpass

# If you have you have forgotten who has administrator access, you could use something like this
# to give test102 administrator permissions:

# test102 permissions=0 f_root=true

# test103 ugroups=11,12 friends=test101,test102


# Subscribe user test104 to the chat rooms or discussion groups with group-ids 3 and 5:

# test104 groups=3,5

# ---------------
# Here is an example creating a user group. Uncomment the $ugroup lines to take effect
# Create the user group:
#$ugroup name="Test User Group 1" restricted_communication=0 non_members_can_find=1 add_friends=0

# Set permissions for new members:
#$ugroup name="Test User Group 1" member_receive_messages=0 member_can_see=1 member_can_find=1 member_can_send_to=1 member_view_members=1 member_can_change_receive_flag=0 member_can_remove_self=0 member_can_change_ugroup=0

# Add users John and Bob using "new member" permissions
#$ugroup name="Test User Group 1" member=John member=Bob

# Add user 'Matt' with user group administrator permissions, by first setting "new member" permissions to administrator
#$ugroup name="Test User Group 1" member_receive_messages=1 member_can_see=1 member_can_find=1 member_can_send_to=1 member_view_members=1 member_can_change_receive_flag=1 member_can_remove_self=1 member_can_change_ugroup=1
#$ugroup name="Test User Group 1" member=Matt

# Reset the default permissions fo new members to something else since non-members are allowed to find this group and add themselves
#$ugroup name="Test User Group 1" member_receive_messages=0 member_can_see=1 member_can_find=1 member_can_send_to=1 member_view_members=1 member_can_change_receive_flag=0 member_can_remove_self=0 member_can_change_ugroup=0

# ---------------
# Here is an example creating a chat room. Uncomment the $chat_room lines to take effect

#$chat_room name="Test Chat Room" ismoderated=0 ispersistent=1 isprivate=1
#$chat_room name="Test Chat Room" member=John member=Bob

# ---------------
# Here is an example creating a forum. Uncomment the $forum lines to take effect

#$forum name="Test Forum" update=1 ismoderated=0 usenet="test.forum" ispull=1 isprivate=0
#$forum name="Test Forum" member_im=0 member_email=1 member=John member=Bob

# ---------------
# Fields available when creating chat rooms and forums include: 
# ispullonly (pull from external news group but don't send back)
# isnntp (make available via nntp)
# defaultpost (default users can post to group)
# ismoderated (a moderated group)
# isprivate (a private group)
# usenet (email name or nntp news group name)
# ugroup (integer value or name of user-group that users must be members of to see this group)
# days (days to keep articles before they expire)
# update (use to update the properties of a group. If this flag isn't present, it won't modify properties of an existing group)
# member_im (member receives instant message copies of articles posted)
# member_email (member receives email copies of articles posted)
# member_moderate (member can moderate the group)
# member_admin (member can modify the group)
# member_can_add (member can add other members to the group)
# member_banned (member is banned from the group)
# member_remove (remove listed members from the group)
# member_can_post (member can post articles to the group)

# Any omitted field when specifying a forum or chat room settings is assumed to
# take on it's default value. So, when specifying forum settings, ismoderated=0
# is actually redundant as the default for a forum is to be unmoderated.



