Miscellaneous Hacks - Thread Prefixes

Thread Prefixes

Version: 1.6.2
vBulletin Version: 3.6.10
Developer: Michael (Mystics) Koenig (www.vbulletin-germany.com)
Modification-Language: English & German & French (thanks to ReadWrite - Note: Readme has not yet been translated to french.)
Install-difficulty: Medium
File-edits: 5
Template-edits: 10


Brief Description of the Modification

This modification allows your users to choose a thread prefix for each thread. To do this you are able to select an appropriate prefix from a list beside the title while posting a new thread - for example 'Help', 'Problem', 'Search' etc.

This prefix will be displayed in front of the thread title. The result will be for example:
Problem - I can't find this setting

Problem is the thread prefix, I can't find this setting is the title of the thread.

The prefixes displayed in this list may be defined by a moderator for each of his moderated forums (Forum Tools -> Manage Thread Prefixes); of course an administrator and a super moderator is allowed to do this for every forum.


Features

• Moderators are able to create own prefixes for each of their moderated forums.
  (Forum -> Forum Tools -> Manage Thread Prefixes -> threadprefix.php)
• Display of the prefixes on forum display, search results, subscribed threads and within the thread itself.
• It is possible to change the prefix with editing the first post of a thread or with the thread tools available for moderators at any time.

Settings in Admin CP

• Maximum prefixes per forum
• Thread Prefix required: Users have to select a thread prefix for their threads. You can select this globally for all forums or on a per forum basis.
• Default Thread Prefixes: You may set default prefixes which will either be shown only in forums without own prefixes or be shown in addition to existing prefixes
• Show Thread Prefixes in extra column or in front of the thread title in the same column
• Alignment of the prefixes (if 'Show in extra column' is enabled): Align left, align right, center
• Show Prefix in 'Last Post' column
• Prefix HTML Markup: Specify an HTML tag with which to display the prefixes (bold, italic, red etc.)
• Allow Thread Prefix search: If enabled, the prefixes of all forums the user has access to will be grouped in a list and displayed in the search engine.
• Per Forum:
  • Allow Thread Prefixes in this Forum
  • Thread Prefix Required in this Forum.

Screenshots

See attachments.


Version-History

1.6.2 (2008-05-24 - 9:30 pm CET)

• Fixed XSS security issue:
  Import the updated xml file (product-threadprefix_*.xml) to fix the security issue!
• Changes for vBulletin 3.6.10 (Updated Template modifications)
• Bugfix: It's possible again to search for prefixes
• Installation script prefixinstall.php now works with IE7 too.

1.6.1 (2006-08-29 - 11:30 pm CET)

• Bugfix: It's possible again to change the prefix by editing the first post of a thread.
• Bugfix: The prefix will be forwarded correctly and without an error to the advanced editor while editing the first post via AJAX.
• New: Thread Prefixes for discussion threads for user infractions and reported posts.
  You can enter those thread prefixes within your vBulletin settings.
• New: Ability to sort the thread prefixes in descending order.
  (Forum Tools -> Manage Thread Prefixes)
• New: Version check for the Thread Prefix Product within the AdminCP.
• Import the updated xml file (product-threadprefix_*.xml) and upload the updated file /upload/threadprefix.php to your server.

1.6.0 (2006-08-04 - 07:00 pm CET)

• Changes for vBulletin 3.6.0
• Because you have to upload all files of vBulletin 3.6, there are no instructions for the update. Just follow the standard instructions for the file and template changes.
• Fixed error within the search engine.
• New: Prefixes are displayed within Content Syndication (external.php)
• Do not forget to import the updated xml file (product-threadprefix_*.xml)!

1.5.5 (2006-04-09 - 03:00 pm CET)

• Fixed database error within the search engine.
  (if prefix was selected and results were shown as posts)
• Just import the updated xml file.

1.5.4 (2006-03-20 - 01:30 am CET)

• Fixed small error within the search engine.
• Just import the updated xml file.

1.5.3 (2006-03-19 - 03:30 pm CET)

• Changes in includes/class_dm_threadpost.php for vB 3.5.4
• Changes in includes/functions_threadprefix.php for vB 3.5.4
• New: Search for prefixes only is now possible (without keywords)
• New: Prefixes are displayed in "Similar Threads"
• New: Separator between prefix and thread title within threads/emails may now be defined in your Admin Control Panel (used to be always " - ").
• New: Save Thread Prefix in Search Preferences

1.5.2 (2005-11-03 - 07:30 pm CET)

• Missing phrase: updateprefixes
• Fixed small error in /threadprefix.php

1.5.1 (2005-11-02 - 09:30 pm CET)

• First version for vBulletin 3.5.1

1.5.0 (2005-11-02 - 09:30 pm CET)

• First version for vBulletin 3.5.0 (only one file edit more because of a missing hook)

Installation

1. Upload all files from the upload directory to your vBulletin directory on your server.
   
   Overview of the files and corresponding directories:
   • /threadprefix.php
   • /admincp/prefixinstall.php
   • /admincp/prefixinstall_text.php
   • /includes/functions_threadprefix.php
2. Import the file "product-threadprefix_english.xml" with 'Manage Products':
   Admin Control Panel -> Plugin System -> Manage Products ->
   [Add/Import Product] -> Select file -> Import
3. Open this file with your browser:
   http://www.yourdomain.com/forum/admincp/prefixinstall.php
4. Log in as administrator and follow the instructions

Time needed for installation: approx. 30 min.
Tested for version: 3.5.0 (and above).

Note: If you have used the Thread Category / Prefix Hack in vBulletin 3.0.x, don't worry: all existing prefixes will be imported during the installation. You just have to re-do your thread prefix settings in your vBulletin Options.

Update Product

1. Upload all files from the upload directory to your vBulletin directory on your server.
   
   Overview of the files and corresponding directories:
   • /threadprefix.php
   • /admincp/prefixinstall.php
   • /admincp/prefixinstall_text.php
   • /includes/functions_threadprefix.php
2. Import the file "product-threadprefix_english.xml" with 'Manage Products':
   Admin Control Panel -> Plugin System -> Manage Products ->
   [Add/Import Product] -> Select file -> Import
   
   You have to select 'Allow Overwrite' -> 'Yes' before clicking on Import!
3. Open this file with your browser:
   http://www.yourdomain.com/forum/admincp/prefixinstall.php
4. Log in, select the version you want to update from (at Step 2 -> 'Update Modification') and follow the instructions.

Short overview of the needed modifications

1. Files that need to be edited:

• /showthread.php (Display prefix in 'Similar Threads')
• /clientscript/vbulletin_textedit.js (JavaScript error message if no prefix was selected)
• /includes/class_dm_threadpost.php (Prefix within emails to moderators)
• /includes/functions_databuild.php (Update prefix in column 'Last Post' for mod functions)
• /includes/functions_online.php (Display prefix in 'Who's online')
  
  It is your decision if you need the above functions or if you decide do use the product without file modifications!
  You don't have to do the file modifications as the product will work even though without them!

2. New files:

• /threadprefix.php
• /includes/functions_threadprefix.php

3. Templates that need to be edited:

• editpost
• FORUMDISPLAY
• newthread
• search_forums
• search_results
• SUBSCRIBE
• threadadmin_editthread
• threadbit
• threadbit_announcement
• threadbit_deleted

4. New templates:

• threadprefix_listbit
• threadprefix_modify

5. New phrases:

• Too many to list them all - they will be created automatically while importing the xml file

Final words

If the modification doesn't work correct after installation, please verify all modifications you have made within the files and the templates. Be sure you have uploaded all edited and new files.

The modification was tested extensive and will function properly if installed correct.

Thanks to ReadWrite for his french translation.

Special Thanks to Andreas for his help with the hooks.

Have fun with the modification!

Please click Install if you have installed it

Mike

[pollon]

Originally Posted by IsMaR

is there any way from preventing moderators from editing prefixes and just have it set by supermod or admin?

Do you mean setting/editing/deleting prefixes from a forum ???

If so you have to do a very easy template modification:

in FORUMDISPLAY find:

<if condition="$foruminfo['allowprefix']">
<div><label for="fa_cat"><input type="radio" name="do" id="fa_cat" value="manageprefix" />$vbphrase[manage_threadprefix]</label></div>
</if>

Replace with:

<if condition="is_member_of($bbuserinfo, X, Y, Z)"><if condition="$foruminfo['allowprefix']">
<div><label for="fa_cat"><input type="radio" name="do" id="fa_cat" value="manageprefix" />$vbphrase[manage_threadprefix]</label></div>
</if></if>

You must change X, Y, Z with the number of usergroups allowed to edit prefixes. In this way Moderators can't see the link to edit prefixes in "Forum tools".
It worked on my forum

[IsMaR]

Originally Posted by pollon

Do you mean setting/editing/deleting prefixes from a forum ???

If so you have to do a very easy template modification:

in FORUMDISPLAY find:

<if condition="$foruminfo['allowprefix']">
<div><label for="fa_cat"><input type="radio" name="do" id="fa_cat" value="manageprefix" />$vbphrase[manage_threadprefix]</label></div>
</if>

Replace with:

<if condition="is_member_of($bbuserinfo, X, Y, Z)"><if condition="$foruminfo['allowprefix']">
<div><label for="fa_cat"><input type="radio" name="do" id="fa_cat" value="manageprefix" />$vbphrase[manage_threadprefix]</label></div>
</if></if>

You must change X, Y, Z with the number of usergroups allowed to edit prefixes. In this way Moderators can't see the link to edit prefixes in "Forum tools".
It worked on my forum

oh wow nice... thanks

[NFLfbJunkie]

Originally Posted by dbirosel

how do i remove the Prefix Category from the New Posts?

Thread Title - Prefix

This has been asked a few times and want to know if there is a solution. This is my last thing to do to get this MOD functioning on my board. Does it have something to do with the "Prefix Markup (within threads and emails)" option in the AdminCP? The following two examples are suggested:

Examples:
{1} -  results to Prefix - Title.
[{1}]&nbsp; results to [Prefix] Title</SPAN>.

What would produce Title [Prefix]? I have played with different combinations and can not seem to figure this out. I would like to do away with the prefix from the thread title altogether, but Title [Prefix] looks better than the above two options.

[patrickb]

Is it possible to add an option to the user's profile so that by default, the threads are automatically filtered?

I am trying to use this mod for a multi lingual site, and I would have each thread tagged per language. So whenever the user browses the site, he would see the threads that correspond to his language, if he chooses to.

Is this possible?

[NFLfbJunkie]

Something I noticed while playing around with this MOD on this site is when you filter for a MOD by a prefix and end up on say page 2 of the filtered threads, and then select another thread prefix, it takes you to page 2 of that thread prefix's thread and not page 1. Is there a fix to this?

[kira]

Originally Posted by Junkie

What would produce Title [Prefix]? I have played with different combinations and can not seem to figure this out. I would like to do away with the prefix from the thread title altogether, but Title [Prefix] looks better than the above two options.

Hi Junkie. Can you clarify -- where exactly do you want Title [Prefix] to show this way? On the threads list in forumdisplay? Or within the thread itself? Or both?

Generally speaking, you'd need to find this code:

<if condition="$show['threadprefix'] == 1">
                <if condition="$thread['threadprefix']">$prefixmarkup[0]$thread[threadprefix]$prefixmarkup[1]</if>
            </if>

And move it after the thread title code. For example, in threadbit template (which affects how the thread title displays on forumdisplay), the thread title and prefix code section originally should look something like this:

$thread[movedprefix]
$thread[typeprefix]
<if condition="$show['threadprefix'] == 1">
                <if condition="$thread['threadprefix']">$prefixmarkup[0]$thread[threadprefix]$prefixmarkup[1]</if>
            </if>
$thread[moderatedprefix]
<a href="showthread.php?$session[sessionurl]t=$thread[threadid]$thread[highlight]" id="thread_title_$thread[realthreadid]"<if condition="$show['gotonewpost']"> style="font-weight:bold"</if>>$thread[threadtitle]</a>

To move the thread prefix (but not the "moved" or "moderated" prefixes) display after the thread title, you'd want the above section to look like this:

$thread[movedprefix]
$thread[typeprefix]
$thread[moderatedprefix]
<a href="showthread.php?$session[sessionurl]t=$thread[threadid]$thread[highlight]" id="thread_title_$thread[realthreadid]"<if condition="$show['gotonewpost']"> style="font-weight:bold"</if>>$thread[threadtitle]</a> <if condition="$show['threadprefix'] == 1">
                <if condition="$thread['threadprefix']">$prefixmarkup[0]$thread[threadprefix]$prefixmarkup[1]</if>
            </if>

If you let me know exactly where you want this change, I can give you more detailed instructions. Hope this makes sense!

[NFLfbJunkie]

I would like to totally remove the prefix [Football] (while still having the thread prefix active for the forum the thread is in) and just have the title of the thread (within the thread itself). Also, would you know how I could change the size of the thread title so it stands out a little more? I really appreciate all of your coding help.

[kira]

Originally Posted by Junkie

I would like to totally remove the prefix [Football] (while still having the thread prefix active for the forum the thread is in) and just have the title of the thread (within the thread itself).

Oh, that's no problem then! You'll laugh at how easy this is when I show you.

1. In your admincp, go down to Plugins & Products, and click on Plugin Manager.

2. When the plugin manager opens, look in the section called Product : Thread Prefixes and disable the following two options (by unchecking their checkboxes):

Prefix: Display Prefix in Front of Title (Post)

Prefix: Display Prefix in Front of Title (Thread)

3. Scroll down and click the Save Active Status button.

Voila! Prefixes gone in the thread. Let me know if this works for you.

Also, would you know how I could change the size of the thread title so it stands out a little more? I really appreciate all of your coding help.

My pleasure, Junkie. There's a simple template mod by raiderlax called Title of Thread (Standing Out in Middle) here that does what you're looking for. Very easy, just adding a couple of lines to the SHOWTHREAD template. Don't forget to click "installed" on his template mod to let him know it was helpful.

[Alfa1]

Is it possible to make a product of this hack?

The reason that I ask is that since there are a lot of template edits, a lot can go wrong with both installing and uninstalling.

I really like this hack and the possibilities it gives. vb versions like 3.6.6 that make you loose all template edits with upgrading will likely come more often, now that Jelsoft works on various official add-ons.

[NFLfbJunkie]

Kira, I never thought about shutting off the products. Thanks. As for your suggestion to consider Raiderlax'd MOD, I would really like to change the font size of the thread title of the first post with all other posts being their normal size. I don't even know if this is possible.