Miscellaneous Hacks - SocialForums 1.4

SocialForums for vBulletin 3.7
Created by Marius Czyz aka Phalynx.

This mod will work *ONLY* with vBulletin 3.7 or higher. It will not run on vBulletin 3.6.x due to non existent feature of "social groups".

Support will be only given for people who clicked Mark as INSTALLED.

Description
Not satisfied with vBulletin social groups messaging function? With SocialForums your social group leaders can create a standard forum for their group.
A group leader can only create a forum if the group has at least 5 members - this can be changed via settings. Optionally the group leader can be a moderator of such a social forum.

Permissions
Since 1.3 there are advanced permissions active (Forum and Archive). This includes read/write public and private (moderated/invite only) socialforums and creation of forum. As this needs two additional queries on every page you can disable this.

Demo
None, see screenshots

Installation
This product is fully phrased and uses template hooks. No file changes or manual template edits needed.
1. Upload bitfield_socialforums.xml to existing folder /includes/xml/
2. Upload functions_socialforums.php to existing folder /includes/
3. Fresh Installation: Just import the product. Upgrade: Import the product, allow overwrite. No forums get lost!
4. Check settings, especially for parent forum. Don't forget to set permissions via usergroups!

Troubleshooting
Q: I don't see a link to create a forum. Why?
A: Check permissions for the usergroup, espacially if the user is allowed to create forum.
A: Check if the usergroup meet min users requirement, see AdminCP/Settings/SocialForums.

Q: My users see the forums, but they shouldn't!
A: Check permissions for the usergroup, if the users usergroup is set to "can see".
A: Did you disabled the restriction mode? Enable it.

Todo
- By deleting a group the forum should also be deleted/archived. Currently this has to be done manually.

Known Issues
- On big boards with hundreds of social groups this mod can really impact the performance because of the mass of new created forums. If you still want to use this mod use the "Minimum Members" feature with a higher value. Using the permission check there are additional two queries on every page.

History
1.4.6, 6th October 2008
- Permissions are now also active in Archive

1.4.2, 27th May 2008
- Added: If a group has a linked forum the grouplisting has the last post date and count of postings (with permission check).
- Added: Recent threads in linked forum on group home
- Added: Private groups: Link to forum only shown to members of group
- Changed: Enabled permissions for unregistered usergroup. Unregistered Users are not more explicit denied without a check of it's usergroup

1.3.1, 23th May 2008
- Fixed: Not existing array

1.3.0, 23th May 2008
- Added: Permissions are now active. This includes read/write public and private (moderated/invite only) socialforums and creation of forum. Please check permissions for every usergroup! As this needs two additional queries on every page you can disable this.
- Added: Checks for permission before the creation link will be displayed
- Changed: Default View Age set to "Show all Threads"

1.2.1 8th April 2008:
- Added: Group messaging can be disabled via options (previously: always disabled)

1.2.0 4th April 2008:
- Added: Groupleader can now be moderator of group forum
- Added: Minimum Members that are required for own forum
- Added: Group messaging will be automatically hide for group that has own forum
- Added: Forums are created with more allowances
- Added: By deleting a forum the linked socialgroup get's updated
- Added: Forum's description contains link back to social group
- Added: By changing group's name it synchronize it with the forum's name

1.0/1.1 1st April 2008:
- Initial releases

[MaxiMal]

it is necessary to make addition of moderators by the button
(if there was a version earlier 1.1)

for safety:

$forumdm->set_bitfield('options', 'active', '1');
$forumdm->set_bitfield('options', 'allowposting', '1');
$forumdm->set_bitfield('options', 'cancontainthreads', '1');
$forumdm->set_bitfield('options', 'moderatenewpost', '0');
$forumdm->set_bitfield('options', 'moderatenewthread', '0');
$forumdm->set_bitfield('options', 'moderateattach', '0');
$forumdm->set_bitfield('options', 'allowbbcode', '1');
$forumdm->set_bitfield('options', 'allowimages', '0');
$forumdm->set_bitfield('options', 'allowhtml', '0');
$forumdm->set_bitfield('options', 'allowsmilies', '1');
$forumdm->set_bitfield('options', 'allowicons', '1');
$forumdm->set_bitfield('options', 'allowratings', '1');
$forumdm->set_bitfield('options', 'countposts', '0');
$forumdm->set_bitfield('options', 'canhavepassword', '1');
$forumdm->set_bitfield('options', 'indexposts', '1');
$forumdm->set_bitfield('options', 'styleoverride', '0');
$forumdm->set_bitfield('options', 'showonforumjump', '0');
$forumdm->set_bitfield('options', 'prefixrequired', '0');
//////////////
$moddm->set_bitfield('permissions', 'caneditposts', '1');
$moddm->set_bitfield('permissions', 'candeleteposts', '1');
$moddm->set_bitfield('permissions', 'canopenclose', '1');
$moddm->set_bitfield('permissions', 'caneditthreads', '1');
$moddm->set_bitfield('permissions', 'canmanagethreads', '1');
$moddm->set_bitfield('permissions', 'canannounce', '0');
$moddm->set_bitfield('permissions', 'canmoderateposts', '1');
$moddm->set_bitfield('permissions', 'canmoderateattachments', '1');
$moddm->set_bitfield('permissions', 'canmassmove', '0');
$moddm->set_bitfield('permissions', 'canmassprune', '0');
$moddm->set_bitfield('permissions', 'canviewips', '0');
$moddm->set_bitfield('permissions', 'canviewprofile', '0');
$moddm->set_bitfield('permissions', 'canbanusers', '0');
$moddm->set_bitfield('permissions', 'canunbanusers', '0');
$moddm->set_bitfield('permissions', 'newthreademail', '0');
$moddm->set_bitfield('permissions', 'newpostemail', '0');
$moddm->set_bitfield('permissions', 'cansetpassword', '0');
$moddm->set_bitfield('permissions', 'canremoveposts', '0');
$moddm->set_bitfield('permissions', 'caneditsigs', '0');
$moddm->set_bitfield('permissions', 'caneditavatar', '0');
$moddm->set_bitfield('permissions', 'caneditpoll', '0');
$moddm->set_bitfield('permissions', 'caneditprofilepic', '0');
$moddm->set_bitfield('permissions', 'caneditreputation', '0');

[traxxadd]

I love this mod do you have a donate button id like to donate some money for this great mod

[FleaBag]

Yeah this is looking pretty sweet.

[Reeve of shinra]

Very nice -- would love to see a future option where forums are only visiable to group members.

[Koroku]

Can you please fix permissions so that the admin group (or maybe even make it so you can chose group id #s that automatically have permission) is able to view/post in the social forums?

I like this hack, but I don't really want to give my members a free-for-all...

[nutnut]

This works great, thanks!

[Phalynx]

Originally Posted by MaxiMal

it is necessary to make addition of moderators by the button
(if there was a version earlier 1.1)

for safety:

It is not very helpful to post all settings. Please post only relevant.

HTML is already disabled in next version.

Originally Posted by traxxadd

I love this mod do you have a donate button id like to donate some money for this great mod

You can send me money via PayPal. Use this eMail: contact AT marius DOT de

Originally Posted by Reeve of shinra

Very nice -- would love to see a future option where forums are only visiable to group members.

Already on my Todo-list.

Originally Posted by Koroku

Can you please fix permissions so that the admin group (or maybe even make it so you can chose group id #s that automatically have permission) is able to view/post in the social forums?

I like this hack, but I don't really want to give my members a free-for-all...

That's something that has to be discussed. In vBulletin you can have private forums where admins don't have access. That's a feature not a bug.

[jilly]

there are two jpgs in the zip download, but no description on what to do with them?

[Varsh]

Just ignore those pics, they're the same screenshots as you see in the OP.

[Koroku]

Originally Posted by Phalynx

That's something that has to be discussed. In vBulletin you can have private forums where admins don't have access. That's a feature not a bug.

Could you at least make it an option of some sort? "Let admins have access to all Socialforums? Y/N" or something?