Thread Prefixes

Thread Prefixes

Version: 1.5.5
vBulletin Version: 3.5.4
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.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
• forumdisplay_announcement
• newthread
• search_forums
• search_results
• SUBSCRIBE
• threadadmin_editthread
• threadbit
• 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

[jokerz]

Hi Mike,

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

I'd like to ask you first before I download this hack. I have used Thread Category Hack in vBulletin 3.0x so should I follow the 'UPDATE PRODUCT' instead of 'INSTALLATION' (in your description first post)?

Cheers.

[MaTraX]

Great modification. I`ve been waiting for it since the 3.5 rc1
Installed of course

[Mystics]

Originally Posted by jokerz

should I follow the 'UPDATE PRODUCT' instead of 'INSTALLATION'?

No, you have to do a normal installation.

[jluerken]

Mystics it would be nice to have the following AJAX Change for your Hacks.

If a thread has a prefix a double click should open a drop down list with all prefixes available in this forum so that you can change it on the fly.

Actually I have to edit
- open thread
- edit thread
- change category

Doing this with ajax would be much faster or? :-)

[jokerz]

Do you have uninstall instruction from the old 3.0x? You can PM me or post here.
I upgraded 3.0.7 to 3.5.1 - I used this hack in 3.0.7 and you had variable [threadcategories] and now the new one is [threadprefix]. I may have still [threadcategories] in some templates.

This is very less to modify files/templates than the old version. Good job

[jokerz]

You know sticky thread like rules. I edited my post and kept asking me to select the threadprefix.

"Please select an appropriate thread prefix from the drop down list beside the subject field."

I tried to change the setting and still not work. So I clicked 'no' in prefix required and turned it back on. Can you please tell me which setting that I can leave prefix in blank instead select prefix for me as adminstrator.

[Mystics]

Originally Posted by jokerz

Do you have uninstall instruction from the old 3.0x? You can PM me or post here.

All new phrases/settings/templates of the old hack will be automatically deleted during the installation of the new version. If you still have templates from 3.0.x you have to search for "threadcat" to see if you still have the old modifications in there. You also can take a look in the file categoryinstall_text.php from the old hack.

Originally Posted by jokerz

Can you please tell me which setting that I can leave prefix in blank instead select prefix for me as adminstrator.

There is no setting for this.

Hm, should I exclude admins always from this? Maybe I will change it in 1.5.3.

[AxEsLoCkEd]

is it possible to convert this for a language system (like there will be English German French) and a user field on profile options page and at registration pages that will allow the member to choose which language he/she wants to view lets say if someone does only know german end french than they will be able to filter english posts, if someone only knows english than they will be able to filter german and french ?

[Alien]

I'd love to use this WITH images instead as previously mentioned by another member...

I'd like to maintain the existing post icon layout and functionality, and just add this as an ability inside our news forum to display an icon showing the category of news it is and display that on forumdisplay in ADDITION to the post icons. Any tips? I can't insert html for the image inside the admincp field for naming your prefix?

[The Wise One]

just what i was looking for. very nice. installed.