Thread Prefix

[RateU]

With XThreads, we can create thread prefix. More than that, we can filter the threads based on their prefix.

Here is a simple way to do that:

1. Create a Custom Thread Fields with this settings:

• Title: Prefix
• Key: prefix
• Applicable Forums: 'select a forum that we want the prefix to be applied'
• Input Field Type: Listbox
• Field Input Height: 1
  If we want multi prefix for a single thread, fill the Field Input Height with a value that greater than 1.
• Values List:
  Code:

  Prefix 1 Prefix 2 Prefix 3

  ---

  Name it as our need.

• Editable by / Required Field?: Everyone (Required)
• Allow Filtering: Yes
• Display Format:
  Code:

  [{VALUE}]

  ---

  If we want multi prefix, this will be the "main" display format.

• Allow multiple values for this field: No
  If we want multi prefix for a single threads, choose Yes
• Multiple Value Delimiter:
  Code:

  ,

  ---

  The Multiple Value Delimiter setting will be displayed if we choose Yes in Allow multiple values for this field setting. This is separator for each prefix.

• Display Item Format:
  Code:

  {VALUE}

  ---

  The Display Item Format setting will be displayed if we choose Yes in Allow multiple values for this field setting. This is the display format for each prefix.

• Formatting Map List:
  
  Code:

  Prefix 1{|}<a href="{$forumurl?}filtertf_prefix=Prefix 1"><span style="color: red;">Prefix 1</span></a> Prefix 2{|}<a href="{$forumurl?}filtertf_prefix=Prefix 2"><span style="color: green;">Prefix 2</span></a> Prefix 3{|}<a href="{$forumurl?}filtertf_prefix=Prefix 3"><span style="color: blue;">Prefix 3</span></a>

  ---

2. We need to edit our forumdisplay_thread template. The basic concept for this edit process is, adding {$GLOBALS['threadfields']['prefix']} variable into the forumdisplay_thread template. The prefix will be displayed wherever we put the variable in the template.

In this example, we will put the prefix before Thread Subject:
We can find this code in our forumdisplay_thread template (based on the default template):

HTML Code

<span>{$prefix} {$gotounread}<a href="{$thread['threadlink']}" class="{$inline_edit_class} {$new_class}" id="tid_{$inline_edit_tid}">{$thread['subject']}</a>{$thread['multipage']}</span>

---

Then, add the {$GLOBALS['threadfields']['prefix']} variable. So, the code will be like this:

HTML Code

{$GLOBALS['threadfields']['prefix']} <span>{$prefix} {$gotounread}<a href="{$thread['threadlink']}" class="{$inline_edit_class} {$new_class}" id="tid_{$inline_edit_tid}">{$thread['subject']}</a>{$thread['multipage']}</span>

---

Additional info:

• The filtering url has a general structure:
  

  Quote:{$forumurl?}filtertf_Key_for_the_field=Name of each prefix

  In the example above:
  Key_for_the_field = prefix
  Name of each prefix = Prefix1, Prefix 2, and Prefix 3.
  
  So, the filtering URL will be like this:
  

  Quote:{$forumurl?}filtertf_prefix=Prefix 1
  {$forumurl?}filtertf_prefix=Prefix 2
  {$forumurl?}filtertf_prefix=Prefix 3

• We can do some experiment with these three settings if we want multi prefix: Display Format, Multiple Value Delimiter and Display Item Format.
  
  Example 1:
  Display Format = [{VALUE}]
  Multiple Value Delimiter = , (plus one space)
  Display Item Format = {VALUE}
  Result:

  Quote:[Prefix 1, Prefix 2, Prefix 3] Thread Title

  
  Example 2:
  Display Format = {VALUE}
  Multiple Value Delimiter = one space
  Display Item Format = [{VALUE}]
  Result:

  Quote:[Prefix 1] [Prefix 2] [Prefix 3] Thread Title

  
  Example 3:
  Display Format = {VALUE}
  Multiple Value Delimiter = one space|one space
  Display Item Format = {VALUE}
  Result:

  Quote:Prefix 1 | Prefix 2 | Prefix 3 Thread Title

• We can use image for the output of each prefix.
  Display Format = {VALUE}
  Multiple Value Delimiter = one space
  Display Item Format = {VALUE}
  Formatting Map List:
  Code:

  Prefix 1{|}<a href="{$forumurl?}filtertf_prefix=Prefix 1"><img src="image_url_for_prefix_1" alt="Prefix 1" title="Display Prefix 1 Only" /></a> Prefix 2{|}<a href="{$forumurl?}filtertf_prefix=Prefix 2"><img src="image_url_for_prefix_2" alt="Prefix 2" title="Display Prefix 2 Only" /></a> Prefix 3{|}<a href="{$forumurl?}filtertf_prefix=Prefix 3"><img src="image_url_for_prefix_3" alt="Prefix 3" title="Display Prefix 3 Only" /></a>

  ---

• We can use the Prefix Filtering system as category for our XThreads application.