Miscellaneous Hacks - Limit Thread Prefix by Usergroup

/*================================================= =====================*\
|| ################################################## ################## ||
|| # ---------------- LIMIT THREAD PREFIX BY USERGROUP -------------- # ||
|| # ---------------------- CREATED BY OPSERTY ---------------------- # ||
|| # This modification may not be redistributed without prior consent # ||
|| ################################################## ################## ||
\*================================================ ======================*/


WARNING: THIS MODIFICATION REQUIRES FILE EDITS.
Please follow all instructions carefully before attempting to use this modification

What does this modification do?
This modification allow you to control which Usergroups have access to use certain prefix sets. For example in a Help/Bug Report forum, you may only want to allow staff to prefix problems into categories.

Why does this modification require file edits?
The AdminCP has a minimal number of hook locations onto which to attach plugins, this is done for security and stability reasons by the vBulletin team. Therefore it has not been possible to make this modification 'file edit' free.

What versions of vBulletin does this modification work with?
This modification has been tested to work with 3.7.1, however it will most probably also work on 3.7.0. Please note I cannot offer support for help with this modification on 3.7.0 so if you experience problems it will be best to upgrade to 3.7.1 and then see if your errors are resolved.

How to install:
(These instructions are detailed also in the README file attached in the ZIP Archive.)


1. IMPORT PRODUCT
------------------------------------------------

Import the product as normal through the AdminCP.

AdminCP > Plugins & Products > Manage Products


2. UPLOAD FILE
------------------------------------------------

Upload functions_opserty_prefix_ugps.php to the '/includes/' directory of your forum root


3. MAKE FILE EDIT (1)
------------------------------------------------

Download and Open admincp/prefix.php from your vBulletin installation. (Code additions have been highlighted in Green)

You will need to edit the file in a plain text editor, notepad or wordpad will do fine.

Find (approx. Line 303):

PHP Code:

$prefixsetdm->set('displayorder', $vbulletin->GPC['displayorder']);
$prefixsetdm->set_info('title', $vbulletin->GPC['title']);

$prefixsetdm->save(); 


Replace with:

$prefixsetdm->set('displayorder', $vbulletin->GPC['displayorder']);
$prefixsetdm->set_info('title', $vbulletin->GPC['title']);

require_once(DIR . '/includes/functions_opserty_prefix_ugps.php');
process_selected_groups();

$prefixsetdm->save();

3. MAKE FILE EDIT (2)
------------------------------------------------

Find (approx. Line 448):

PHP Code:


    if (empty($enabled_forums))
    {
        // default to selecting "none"
        $enabled_forums = array(-1);
    }

    print_forum_chooser($vbphrase['use_prefix_set_in_these_forums'], 'forumids[]', $enabled_forums, $vbphrase['none'], false, true);
    
    print_submit_row(); 


Replace with:

    if (empty($enabled_forums))
    {
        // default to selecting "none"
        $enabled_forums = array(-1);
    }

    print_forum_chooser($vbphrase['use_prefix_set_in_these_forums'], 'forumids[]', $enabled_forums, $vbphrase['none'], false, true);
    
    require_once(DIR . '/includes/functions_opserty_prefix_ugps.php');
    show_usergroup_list($prefixset['allowedugps']);
    
    print_submit_row();

]


4. UPLOAD
------------------------------------------------

Upload the newly edited prefix.php to your server and test away =]

If you receive PHP Parse errors it means you have probably edited prefix.php incorrectly, download a new copy of prefix.php from vBulletin.com and try editing the file again.

Remember to undo file edits and remove files, if you uninstall this product in order to avoid errors in future.

I have done my best to test this modification, however if you notice any bugs please post them in this thread so I can look into them.

Please do not private message me for support with this modification, all support will be given through this thread ONLY.

[Opserty]

No problem. I'm glad my first modification has been bug free

[Slaxi]

thanks. Very nice mod!

[zhabbo]

Excuse me, but how do you actually edit the permissions?

[Opserty]

You can set the permissions when adding/editing the Prefix Set.

[zhabbo]

Eh? I took a look at that, and there was nothing there.

[zhabbo]

OK, found it. Thanks for support and release.

[superjeff]

Thank you for this!

[Opserty]

You are most welcome

[RLShare]

Thanks alot for this Opserty, using this I was able to create a front page/semi-CMS where the staff can control whats shown and where its shown on the front page by using certain prefixes on threads. It saved me alot of work.

[Opserty]

No problem.

Note as of 4th Aug. vBulletin has announced a similar feature in 3.8 development update:

Thread Prefix Permissions
For those who want to be able to limit the ability of their users to access thread prefixes and prefix sets, vBulletin 3.8 now gives you that ability.

As such, further development of this modification seems unlikely. I will however try to ensure that any bugs are fixed.